Skip to content

Documentation and Code refactor #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 12 commits into from
Jan 27, 2024
Prev Previous commit
Next Next commit
updated README.md
  • Loading branch information
eadwinCode committed Jan 21, 2024
commit f3f955cbed2e9568fe721a656e708c182749810a
32 changes: 10 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,36 +9,24 @@
[![PyPI version](https://img.shields.io/pypi/pyversions/ellar-sql.svg)](https://pypi.python.org/pypi/ellar-sql)

## Project Status

- [ ] Overall Completion - 85% done
- [ ] Tests - 90% Complete
- [x] Model class that transforms to SQLAlchemy Models or DeclarativeBase based on configuration
- [x] Pydantic-like way to exporting model to dictionary object eg:`model.dict(exclude={'x', 'y', 'z'})`
- [x] Support multiple database useful in models and queries
- [x] Session management during request scope and outside request
- [x] Service to manage SQLAlchemy Engine and Session creation, and Migration for async and sync Engines and Sessions
- [x] Async first approach to database migration using Alembic
- [x] Expose all Alembic commands to Ellar CLI
- [x] Module to config and setup SQLAlchemy dependencies and migration path
- [x] SQLAlchemy Pagination for both Templating and API routes
- [x] File and Image SQLAlchemy Columns integration with ellar storage
- [x] Production Ready
- [ ] SQLAlchemy Django Like Query
- [ ] Documentation

## Introduction
Ellar SQLAlchemy Module simplifies the integration of SQLAlchemy and Alembic migration tooling into your ellar application.
EllarSQL Module adds support for `SQLAlchemy` and `Alembic` package to your Ellar application

## Installation
```shell
$(venv) pip install ellar-sqlalchemy
$(venv) pip install ellar-sql
```

## Features
- Automatic table name
- Session management during request and after request
- Support both async/sync SQLAlchemy operations in Session, Engine, and Connection.
- Multiple Database Support
- Database migrations for both single and multiple databases either async/sync database engine

- Migration
- Single/Multiple Database
- Pagination
- Compatible with SQLAlchemy tools


## **Usage**
In your ellar application, create a module called `db` or any name of your choice,
Expand Down Expand Up @@ -104,7 +92,7 @@ from .controllers import DbController
},
echo=True,
migration_options={
'directory': '__main__/migrations'
'directory': 'my_migrations_folder'
},
models=['db.models.users']
)
Expand Down
8 changes: 3 additions & 5 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,13 +26,11 @@ we recommend referring to the comprehensive [SQLAlchemy documentation](https://d
## **Feature Highlights**
EllarSQL comes packed with a set of awesome features designed:

- **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.
- **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.

- **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.
- **Single/Multiple Database**: EllarSQL provides an intuitive setup for models with different databases, allowing you to manage your data across various sources effortlessly.

- **Pagination Perfection**: EllarSQL introduces SQLAlchemy Paginator for API/Templated routes, along with support for other fantastic SQLAlchemy pagination tools.

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

- **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.

Expand Down
2 changes: 1 addition & 1 deletion ellar_sql/__init__.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
"""Ellar SQLAlchemy Module - Adds support for SQLAlchemy and Alembic package to your Ellar web Framework"""
"""EllarSQL Module adds support for SQLAlchemy and Alembic package to your Ellar application"""

__version__ = "0.0.1"

Expand Down
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy