drfast-api 0.1.0__py3-none-any.whl

drfast_api-0.1.0.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.5
+Name: drfast-api
+Version: 0.1.0
+Summary: DRF-inspired async APIs for FastAPI and Tortoise ORM
+Project-URL: Documentation, https://github.com/drfast-api/drfast-api#readme
+Project-URL: Issues, https://github.com/drfast-api/drfast-api/issues
+Project-URL: Source, https://github.com/drfast-api/drfast-api
+Author: DRFast API contributors
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: FastAPI
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: email-validator<3,>=2.2
+Requires-Dist: fastapi-users<16,>=15.0.5
+Requires-Dist: fastapi<1,>=0.115
+Requires-Dist: pydantic-settings<3,>=2.3
+Requires-Dist: pydantic<3,>=2.7
+Requires-Dist: tortoise-orm<2,>=1
+Requires-Dist: uvicorn[standard]<1,>=0.30
+Provides-Extra: docs
+Requires-Dist: sphinx<9,>=8; extra == 'docs'
+Provides-Extra: postgres
+Requires-Dist: asyncpg<1,>=0.29; extra == 'postgres'
+Description-Content-Type: text/markdown
+
+# DRFast API
+
+DRFast API brings familiar Django REST Framework patterns to fully async FastAPI applications backed by Tortoise ORM.
+
+It is pre-1.0 software. The public surface includes serializers, model viewsets, routers, permissions, middleware, settings, Tortoise lifecycle integration, FastAPI Users integration, and the `drfast` management CLI.
+
+## Quick start
+
+```bash
+uv add drfast-api
+drfast startproject config
+cd config
+drfast migrate
+drfast runserver
+```
+
+Generated projects use SQLite locally. Set `DATABASE_URL` to a PostgreSQL URL and install `drfast-api[postgres]` for production.
+
+## Application structure
+
+Projects explicitly list Tortoise model modules in `Settings.installed_apps`. A generated app keeps models, serializers, and views separate:
+
+```python
+class TodoSerializer(ModelSerializer[Todo]):
+	model = Todo
+	id = UUIDField(read_only=True)
+	title = CharField()
+
+
+class TodoViewSet(ModelViewSet):
+	model = Todo
+	serializer_class = TodoSerializer
+	ordering_fields = ("created_at", "title")
+```
+
+Register it with `DefaultRouter`, then include the router in the FastAPI application. Viewset handlers, serializer hooks, permission methods, and middleware hooks are asynchronous.
+
+`drfast` delegates migration operations to Tortoise’s current built-in migration CLI:
+
+```bash
+drfast init
+drfast makemigrations --name add_todos
+drfast migrate
+drfast history
+```
+
+The starter’s authentication uses FastAPI Users with DRFast’s Tortoise adapter. It enables registration and bearer JWT login; password reset and email verification require application-provided delivery hooks before they are enabled.
+
+## Configuration
+
+Copy `.env.example` to `.env` in generated projects. `SECRET_KEY` must be changed and `DEBUG=false` set for production. SQLite is suitable for local development and isolated tests; production should use PostgreSQL, explicit migrations, and an `asyncpg` connection URL.
+
+## Development
+
+```bash
+uv sync
+uv run ruff check .
+uv run mypy src
+uv run pytest
+uv run bandit -q -r src
+uv run pip-audit --skip-editable
+uv run python -m build
+```
+
+The CI workflow also runs Bandit and pip-audit. Configure the PyPI trusted publisher for the `pypi` GitHub environment before tagging a release.
+

drfast_api-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+drfast/__init__.py,sha256=7O0_jEklOaRW5Tm83dj_JgNbCnUE98JMq_rtq8MLLgc,986
+drfast/auth.py,sha256=TUfhQE5HJMt-5VsLy676kguHhyBqIh_n2iTQ-ZaghDU,4232
+drfast/cli.py,sha256=xZoa8x-p7ziwQCbr5efWnUPQ6TeV7nIR3hzZuORZhRw,10031
+drfast/filters.py,sha256=DLimUZfr0Xi47tpaDHvtGtNNQHE9HeSTIsa-I3B6LS4,1079
+drfast/middleware.py,sha256=aVt2WmQCBGhf66UMfkVqoh7b2OCIQlCUrR-bOE54KIs,1550
+drfast/models.py,sha256=3fKDfA7D1m5xIWYOI_ub53yjDj8LsYx65hRHdd7dbmA,1007
+drfast/orm.py,sha256=OeY4ZmJnEfMoT5nI00NhQIMM0WrxlMItLT3j-RH9614,992
+drfast/pagination.py,sha256=fPy6EJhTvx8ABqkkD6i0DMmre1c_e5XlXPpIFAbvFKE,1347
+drfast/permissions.py,sha256=z7L3SfO0JFSw4y_7H5JFZ3mYvarn7zSN9pBtIS3ggmM,1668
+drfast/routers.py,sha256=qugeP9Dz4nWwamAeoppnVAFqBLr3dDjYiCjTHqtxUSc,1051
+drfast/serializers.py,sha256=qMKP2YtWLXltWm8HjZl5Kq_BtJCpShwpWD2ZdV3cv4Y,6663
+drfast/settings.py,sha256=mvbBoKFYi3ajRi_R0bufKmjDckL4M8VBWln6BPc_yZI,1525
+drfast/views.py,sha256=ri0MmxyZaPmEtefNFMklh0mtnmj9cSW9tQDDvvW0PPs,7528
+drfast_api-0.1.0.dist-info/METADATA,sha256=F1VVga6A-zvaFc4R_08TJEqUeowgAaA2eTBieYZEHoI,3458
+drfast_api-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+drfast_api-0.1.0.dist-info/entry_points.txt,sha256=sec3-ioEUxIliXT5ieg1GPPPx-6_rFu2rdC7HbgrKBM,43
+drfast_api-0.1.0.dist-info/licenses/LICENSE,sha256=KxC3m3tg5VegnAc95Ia8Il-8s6fcS15-Yc8uR1vsZrw,1080
+drfast_api-0.1.0.dist-info/RECORD,,

drfast_api-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

drfast_api-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+drfast = drfast.cli:main

drfast_api-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DRFast API contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.