Skip to content

Commit f3f955c

Browse files
committed
updated README.md
1 parent b89c5cf commit f3f955c

File tree

3 files changed

+14
-28
lines changed

3 files changed

+14
-28
lines changed

README.md

Lines changed: 10 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -9,36 +9,24 @@
99
[![PyPI version](https://img.shields.io/pypi/pyversions/ellar-sql.svg)](https://pypi.python.org/pypi/ellar-sql)
1010

1111
## 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
2513
- [ ] SQLAlchemy Django Like Query
26-
- [ ] Documentation
2714

2815
## 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
3017

3118
## Installation
3219
```shell
33-
$(venv) pip install ellar-sqlalchemy
20+
$(venv) pip install ellar-sql
3421
```
3522

3623
## 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+
4230

4331
## **Usage**
4432
In your ellar application, create a module called `db` or any name of your choice,
@@ -104,7 +92,7 @@ from .controllers import DbController
10492
},
10593
echo=True,
10694
migration_options={
107-
'directory': '__main__/migrations'
95+
'directory': 'my_migrations_folder'
10896
},
10997
models=['db.models.users']
11098
)

docs/index.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,11 @@ we recommend referring to the comprehensive [SQLAlchemy documentation](https://d
2626
## **Feature Highlights**
2727
EllarSQL comes packed with a set of awesome features designed:
2828

29-
- **Migration Mastery**: Enjoy an async-first migration solution that seamlessly handles both single and multiple database setups and for both async and sync database engines configuration.
29+
- **Migration**: Enjoy an async-first migration solution that seamlessly handles both single and multiple database setups and for both async and sync database engines configuration.
3030

31-
- **Database Diversity**: Dive into the world of multiple databases with ease. EllarSQL provides an intuitive setup for models with different databases, allowing you to manage your data across various sources effortlessly.
31+
- **Single/Multiple Database**: EllarSQL provides an intuitive setup for models with different databases, allowing you to manage your data across various sources effortlessly.
3232

33-
- **Pagination Perfection**: EllarSQL introduces SQLAlchemy Paginator for API/Templated routes, along with support for other fantastic SQLAlchemy pagination tools.
34-
35-
- **Extra Column Field**: EllarSQL spices things up with additional column types like **GUID**, **IPAddress**, **File**, and **Image** Fields.
33+
- **Pagination**: EllarSQL introduces SQLAlchemy Paginator for API/Templated routes, along with support for other fantastic SQLAlchemy pagination tools.
3634

3735
- **Unlimited Compatibility**: EllarSQL plays nice with the entire SQLAlchemy ecosystem. Whether you're using third-party tools or exploring the vast SQLAlchemy landscape, EllarSQL seamlessly integrates with your preferred tooling.
3836

ellar_sql/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
"""Ellar SQLAlchemy Module - Adds support for SQLAlchemy and Alembic package to your Ellar web Framework"""
1+
"""EllarSQL Module adds support for SQLAlchemy and Alembic package to your Ellar application"""
22

33
__version__ = "0.0.1"
44

0 commit comments

Comments
 (0)