Metadata-Version: 2.4
Name: flaxon
Version: 0.2.7
Summary: An async-first Python full-stack framework with integrated Teloce interfaces
Author-email: Aldane Hutchinson <aldanehutchinson5@gmail.com>
Maintainer-email: Aldane Hutchinson <aldanehutchinson5@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/aldanedev-create/Flaxon-Backend-Framework
Project-URL: Repository, https://github.com/aldanedev-create/Flaxon-Backend-Framework
Project-URL: Bug Tracker, https://github.com/aldanedev-create/Flaxon-Backend-Framework/issues
Project-URL: Changelog, https://github.com/aldanedev-create/Flaxon-Backend-Framework/blob/main/CHANGELOG.md
Keywords: python,framework,web,full-stack,asgi,async,api,websocket,rest,json,yaml
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Framework :: AsyncIO
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: tortoise-orm==1.1.7
Requires-Dist: python-dotenv<2,>=1.0
Requires-Dist: teloce-py>=0.2.6
Requires-Dist: minifyjs<0.2,>=0.1.3
Provides-Extra: postgres
Requires-Dist: asyncpg<1,>=0.29; extra == "postgres"
Provides-Extra: yaml
Requires-Dist: pyyaml>=6.0.0; extra == "yaml"
Provides-Extra: server
Requires-Dist: uvicorn>=0.30.0; extra == "server"
Provides-Extra: templates
Requires-Dist: jinja2>=3.1.0; extra == "templates"
Provides-Extra: standard
Requires-Dist: uvicorn>=0.30.0; extra == "standard"
Requires-Dist: jinja2>=3.1.0; extra == "standard"
Requires-Dist: pyyaml>=6.0.0; extra == "standard"
Provides-Extra: pydantic
Requires-Dist: pydantic>=2.0; extra == "pydantic"
Provides-Extra: mcp
Requires-Dist: fastmcp>=3.0; extra == "mcp"
Provides-Extra: admin
Requires-Dist: nh3>=0.2.17; extra == "admin"
Requires-Dist: Pillow>=10.0.0; extra == "admin"
Requires-Dist: python-magic>=0.4.27; extra == "admin"
Requires-Dist: argon2-cffi>=23.1.0; extra == "admin"
Requires-Dist: webauthn>=2.0.0; extra == "admin"
Provides-Extra: policy
Requires-Dist: casbin>=1.40.0; extra == "policy"
Provides-Extra: scheduler
Requires-Dist: APScheduler>=3.10.4; extra == "scheduler"
Provides-Extra: production
Requires-Dist: nh3>=0.2.17; extra == "production"
Requires-Dist: Pillow>=10.0.0; extra == "production"
Requires-Dist: python-magic>=0.4.27; extra == "production"
Requires-Dist: argon2-cffi>=23.1.0; extra == "production"
Requires-Dist: webauthn>=2.0.0; extra == "production"
Requires-Dist: casbin>=1.40.0; extra == "production"
Requires-Dist: APScheduler>=3.10.4; extra == "production"
Requires-Dist: redis>=5.0.0; extra == "production"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: pytest-xdist>=3.5.0; extra == "dev"
Requires-Dist: pytest-timeout>=2.3.0; extra == "dev"
Requires-Dist: aiosqlite>=0.20.0; extra == "dev"
Requires-Dist: redis>=5.0.0; extra == "dev"
Requires-Dist: ruff>=0.5.0; extra == "dev"
Requires-Dist: mypy>=1.10.0; extra == "dev"
Requires-Dist: types-pyyaml>=6.0.0; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Requires-Dist: tox>=4.15.0; extra == "dev"
Requires-Dist: bandit>=1.7.9; extra == "dev"
Requires-Dist: pip-audit>=2.7.3; extra == "dev"
Requires-Dist: mkdocs>=1.6.0; extra == "dev"
Requires-Dist: mkdocs-material>=9.5.0; extra == "dev"
Requires-Dist: mkdocs-autorefs>=1.3.0; extra == "dev"
Requires-Dist: mkdocstrings>=0.25.0; extra == "dev"
Requires-Dist: mkdocstrings-python>=1.10.0; extra == "dev"
Requires-Dist: mkdocs-minify-plugin>=0.8.0; extra == "dev"
Provides-Extra: security
Requires-Dist: cryptography>=42.0.0; extra == "security"
Requires-Dist: qrcode[pil]>=7.4.0; extra == "security"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.6.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.5.0; extra == "docs"
Requires-Dist: mkdocs-autorefs>=1.3.0; extra == "docs"
Requires-Dist: mkdocstrings>=0.25.0; extra == "docs"
Requires-Dist: mkdocstrings-python>=1.10.0; extra == "docs"
Requires-Dist: mkdocs-minify-plugin>=0.8.0; extra == "docs"
Provides-Extra: benchmark
Requires-Dist: pytest-benchmark>=4.0.0; extra == "benchmark"
Dynamic: license-file

<div align="center">
  <a href="https://flaxon-website.vercel.app/">
    <img src="https://raw.githubusercontent.com/aldanedev-create/flaxon/main/assets/flaxon.png" alt="Flaxon logo" width="200">
  </a>
  <h1>Flaxon</h1>
  <p><strong>The Python full-stack framework.</strong></p>
  <p>Simple Python. Serious Applications.</p>

  <a href="https://pypi.org/project/flaxon/"><img src="https://img.shields.io/pypi/v/flaxon.svg?style=for-the-badge" alt="PyPI version"></a>
  <a href="https://github.com/aldanedev-create/flaxon/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="MIT License"></a>
  <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/badge/code%20style-ruff-000000.svg?style=for-the-badge" alt="Code style: Ruff"></a>
</div>

## Getting Started

Flaxon is an async-first Python full-stack framework with built-in Admin, CMS, authentication, database tools, WebSockets, and a modular application system. Build interactive applications with **Teloce**, complete server-rendered applications with **Jinax**, or combine both.

Requires **Python 3.11+**. In an activated virtual environment:

```bash
python -m pip install "flaxon[standard]"
flaxon new my-project --no-venv
cd my-project
python -m pip install -e .
python management.py makemigrations
python management.py migrate
python management.py setup-admin
python management.py runserver
```



Open [localhost:8000](http://127.0.0.1:8000/) to see your application. The starter includes a welcome interface, feature modules, custom CLI commands, migrations, and a protected Admin dashboard.

See the [getting started guide](https://github.com/aldanedev-create/flaxon/blob/main/docs/getting-started.md) for the complete setup.

## Documentation

Visit the [Flaxon documentation](https://flaxon-website.vercel.app/docs.html) or browse the [repository guides](https://github.com/aldanedev-create/flaxon/blob/main/docs/index.md).

- [Teloce full-stack applications](https://github.com/aldanedev-create/flaxon/blob/main/docs/api/teloce.md)
- [Jinax server-rendered applications](https://github.com/aldanedev-create/flaxon/blob/main/docs/guides/jinax.md)
- [Admin and CMS](https://github.com/aldanedev-create/flaxon/blob/main/docs/guides/admin-cms.md)
- [Modules](https://github.com/aldanedev-create/flaxon/blob/main/docs/guides/Modules.md)
- [Deployment](https://github.com/aldanedev-create/flaxon/blob/main/docs/deployment.md)

## Examples

Explore the [example applications](https://github.com/aldanedev-create/flaxon/tree/main/examples), including a [modular Teloce shop](https://github.com/aldanedev-create/flaxon/tree/main/examples/teloce_modules_shop), [taskboard](examples/teloce_taskboard/), and [school portal](https://github.com/aldanedev-create/flaxon/tree/main/examples/school_portal).

## Community and Contributing

Created and maintained by **Aldane Hutchinson**. Contributions, documentation improvements, and examples are welcome.

Report bugs and suggest features through [GitHub Issues](https://github.com/aldanedev-create/flaxon/issues). Read the [contribution guidelines](https://github.com/aldanedev-create/flaxon/blob/main/CONTRIBUTING.md) and [Code of Conduct](https://github.com/aldanedev-create/flaxon/blob/main/CODE_OF_CONDUCT.md) to get involved.

## Security

Report vulnerabilities privately following [SECURITY.md](https://github.com/aldanedev-create/flaxon/blob/main/SECURITY.md).

## License

[MIT](LICENSE).

Models and Python migrations are integrated through Tortoise ORM. See the [settings and management guide](docs/guides/orm.md).
