Metadata-Version: 2.1
Name: fastapi_sqlmodel_crud
Version: 0.3.0
Summary: fastapi-sqlmodel-crud is a program which is based on fastapi+sqlmodel and used to quickly build the Create, Read, Update, Delete generic API interface.
Keywords: sqlmodel,fastapi-sqlmodel-crud,fastapi-amis-admin,fastapi-crud,fastapi-sqlmodel
Author-email: Atomi <1456417373@qq.com>
Maintainer-email: Atomi <1456417373@qq.com>
Requires-Python: >=3.6.1
Description-Content-Type: text/markdown
Classifier: Framework :: FastAPI
Classifier: Environment :: Web Environment
Classifier: Topic :: System :: Systems Administration
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: fastapi>=0.68.0
Requires-Dist: sqlmodel>=0.0.8
Requires-Dist: ujson>=4.0.1
Requires-Dist: sqlalchemy-database>=0.1.0,<0.2.0
Requires-Dist: pytest >=6.2.4,<7.0.0 ; extra == "test"
Requires-Dist: aiosqlite ; extra == "test"
Requires-Dist: pytest-asyncio>=0.17 ; extra == "test"
Requires-Dist: httpx ; extra == "test"
Project-URL: Documentation, https://docs.gh.amis.work/crud/SQLModelCrud/
Project-URL: FastAPI-Amis-Admin, https://github.com/amisadmin/fastapi_amis_admin
Project-URL: Source, https://github.com/amisadmin/fastapi_amis_admin
Provides-Extra: test

## Project Introduction

`fastapi-sqlmodel-crud` is a project based on `FastAPI`+`SQLModel`, which is used to quickly build Create, Read, Update, Delete common API interfaces.

## Install

```bash
pip install fastapi-sqlmodel-crud 
```

## Simple example

**main.py**:

```python
from typing import Optional
from fastapi import FastAPI
from sqlalchemy.ext.asyncio import AsyncEngine, create_async_engine
from sqlmodel import SQLModel, Field
from fastapi_amis_admin.crud import SQLModelCrud


# 1. Create SQLModel model
class Article(SQLModel, table=True):
    id: int = Field(default=None, primary_key=True, nullable=False)
    title: str = Field(title='ArticleTitle', max_length=200)
    description: Optional[str] = Field(default='', title='ArticleDescription', max_length=400)
    status: bool = Field(None, title='status')
    content: str = Field(title='ArticleContent')


# 2. Create AsyncEngine
database_url = 'sqlite+aiosqlite:///amisadmin.db'
engine: AsyncEngine = create_async_engine(database_url, future=True)

# 3. Register crud route
article_crud = SQLModelCrud(model=Article, engine=engine).register_crud()

app = FastAPI(debug=True)

# 4. Include the router
app.include_router(article_crud.router)


# 5. Create model database table (first run)
@app.on_event("startup")
async def startup():
    async with engine.begin() as conn:
        await conn.run_sync(SQLModel.metadata.create_all)

```

## Development documentation

- https://docs.gh.amis.work/crud/SQLModelCrud/

## Dependent projects

- [FastAPI](https://fastapi.tiangolo.com)

- [SQLModel](https://sqlmodel.tiangolo.com/)

## Licence

The project follows the Apache2.0 license agreement.
