Metadata-Version: 2.1
Name: sqlalchemy-doris
Version: 0.1.0
Summary: Apache Doris dialect for SQLAlchemy
Author-email: actcwlf <actcwlf@qq.com>
License: Apache Software License
Project-URL: Homepage, https://github.com/actcwlf/sqlalchemy-doris
Project-URL: Issues, https://github.com/actcwlf/sqlalchemy-doris/issues
Keywords: Apache Doris,SQLAlchemy
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: sqlalchemy >=1.4
Requires-Dist: sqlalchemy-utils >=0.38.3
Provides-Extra: mysqldb
Requires-Dist: mysqlclient >=2.1.0 ; extra == 'mysqldb'
Provides-Extra: pymysql
Requires-Dist: pymysql ; extra == 'pymysql'

# Apache Doris Dialect for SQLAlchemy

This is an unofficial implementation forked from [pydoris](https://pypi.org/project/pydoris/1.0.1/)

## Features
* support SQLAlchemy 2.
* support pymysql and mysqlclient as driver.

## Installation
Use
```bash
pip install sqlalchemy-doris[pymysql]
```
for pymysql.

Or

```bash
pip install sqlalchemy-doris[mysqldb]
```
for mysqlclient.

Note sqlalchemy-doris uses pymysql as default connector for compatibility. 
If both pymysql and mysqlclient are installed, mysqlclient is preferred.


## Usage
```python

from sqlalchemy import create_engine

engine = create_engine(f"doris+pymysql://{user}:{password}@{host}:{port}/{database}?charset=utf8mb4")
# or
engine = create_engine(f"doris+mysqldb://{user}:{password}@{host}:{port}/{database}?charset=utf8mb4")

```
