|
9 | 9 | [](https://pypi.python.org/pypi/ellar-sql) |
10 | 10 |
|
11 | 11 | ## Project Status |
12 | | - |
13 | | -- [ ] Overall Completion - 85% done |
14 | | -- [ ] Tests - 90% Complete |
15 | | -- [x] Model class that transforms to SQLAlchemy Models or DeclarativeBase based on configuration |
16 | | -- [x] Pydantic-like way to exporting model to dictionary object eg:`model.dict(exclude={'x', 'y', 'z'})` |
17 | | -- [x] Support multiple database useful in models and queries |
18 | | -- [x] Session management during request scope and outside request |
19 | | -- [x] Service to manage SQLAlchemy Engine and Session creation, and Migration for async and sync Engines and Sessions |
20 | | -- [x] Async first approach to database migration using Alembic |
21 | | -- [x] Expose all Alembic commands to Ellar CLI |
22 | | -- [x] Module to config and setup SQLAlchemy dependencies and migration path |
23 | | -- [x] SQLAlchemy Pagination for both Templating and API routes |
24 | | -- [x] File and Image SQLAlchemy Columns integration with ellar storage |
| 12 | +- [x] Production Ready |
25 | 13 | - [ ] SQLAlchemy Django Like Query |
26 | | -- [ ] Documentation |
27 | 14 |
|
28 | 15 | ## Introduction |
29 | | -Ellar SQLAlchemy Module simplifies the integration of SQLAlchemy and Alembic migration tooling into your ellar application. |
| 16 | +EllarSQL Module adds support for `SQLAlchemy` and `Alembic` package to your Ellar application |
30 | 17 |
|
31 | 18 | ## Installation |
32 | 19 | ```shell |
33 | | -$(venv) pip install ellar-sqlalchemy |
| 20 | +$(venv) pip install ellar-sql |
34 | 21 | ``` |
35 | 22 |
|
36 | 23 | ## Features |
37 | | -- Automatic table name |
38 | | -- Session management during request and after request |
39 | | -- Support both async/sync SQLAlchemy operations in Session, Engine, and Connection. |
40 | | -- Multiple Database Support |
41 | | -- Database migrations for both single and multiple databases either async/sync database engine |
| 24 | + |
| 25 | +- Migration |
| 26 | +- Single/Multiple Database |
| 27 | +- Pagination |
| 28 | +- Compatible with SQLAlchemy tools |
| 29 | + |
42 | 30 |
|
43 | 31 | ## **Usage** |
44 | 32 | In your ellar application, create a module called `db` or any name of your choice, |
@@ -104,7 +92,7 @@ from .controllers import DbController |
104 | 92 | }, |
105 | 93 | echo=True, |
106 | 94 | migration_options={ |
107 | | - 'directory': '__main__/migrations' |
| 95 | + 'directory': 'my_migrations_folder' |
108 | 96 | }, |
109 | 97 | models=['db.models.users'] |
110 | 98 | ) |
|
0 commit comments