Metadata-Version: 2.1
Name: sqlalchemy-risingwave
Version: 0.0.2
Summary: RisingWave dialect for SQLAlchemy
Home-page: https://github.com/risingwavelabs/risingwave
Author: RisingWave Labs
Author-email: risingwave@dev.com
License: http://www.apache.org/licenses/LICENSE-2.0
Project-URL: Source, https://github.com/risingwavelabs/sqlalchemy-risingwave
Project-URL: Tracker, https://github.com/risingwavelabs/sqlalchemy-risingwave/issues
Keywords: SQLAlchemy RisingWave
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
License-File: LICENSE

# RisingWave dialect for SQLAlchemy

## Prerequisites

For psycopg2 support you must install either:

* [psycopg2](https://pypi.org/project/psycopg2/), which has some
  [prerequisites](https://www.psycopg.org/docs/install.html#prerequisites) of
  its own.

* [psycopg2-binary](https://pypi.org/project/psycopg2-binary/)

(The binary package is a practical choice for development and testing but in
production it is advised to use the package built from sources.)
 
## Install
Recommend install packages locally like below. If directly from PyPI, the version may not be the most updated.

```
python setup.py sdist bdist_wheel # generate dist
pip install -e . # install this package
```

## Usage
`sqlalchemy-risingwave` will work like a plugin to be placed into runtime sqlalchemy lib, so that we can overrides some code path to change the behaviour to better fits these python clients with RisingWave.

See how to use with Superset: [doc](./doc/integrate_with_superset.md)

## Test
We use pytest for unittest.
```
pytest # to run the test
```

## Ref
[Sqlalchemy dialects doc](https://github.com/sqlalchemy/sqlalchemy/blob/main/README.dialects.rst)

[CocoroachDB sqlalchemy](https://github.com/cockroachdb/sqlalchemy-cockroachdb)

