Ascender Framework - The modern, powerful API framework

Ascender Framework is a powerful, FastAPI-based framework designed to streamline the development of web applications.
Inspired by NestJS and some parts of other DI frameworks, it combines the simplicity of Python with the robust architecture of modern web frameworks.

Official Website

Documentation

Get started! Learn the basics of framework and explore more advanced features and topics.

• Getting Started
• Architecture
• Controllers
• Validators
• Dependency Injection
• CLI Engine
• CLI Command Types
• Creating CLI Commands
• CLI Registration

CLI Usage

• Global CLI (tooling):

  • ascender [command]
  • Examples:
    • ascender new --name --orm-mode <tortoise|sqlalchemy>
    • ascender run serve

• Local project CLI wrapper:

  • ascender run [command]
  • Wraps project entrypoints and CLI scripts (shorter than invoking Python directly)
  • Examples:
    • ascender run serve
    • ascender run tests
    • ascender run tests init # scaffolds basic tests and pytest.ini (planned)

Getting Started

Install Ascender Framework (with its CLI) globally:

pip install ascender-framework

Initialize a project workspace:

ascender new --name <project-name> --orm-mode <tortoise|sqlalchemy>

Run the development server (global):

cd <project-name>
ascender run serve

Project Structure

• src/bootstrap.py: Framework and server configuration
• src/controllers/: Your controllers (e.g., main controller)
• start.py: Initialization/bootstrap entrypoint for the application

Testing

• Unit tests live under src/tests/
• Run tests via the local wrapper:

ascender run tests run

• Initialize a basic testing setup (to be implemented):

ascender run tests init

• src/tests basic tests and pytest.ini will be generated

Contributing

Contributions are welcome! Please read through our contributing guidelines.

• Guidelines

Need help?

If you need any help, want to report a bug, improve documentation or contribute, please open an issue in this repository after reading the guidelines.

License

This project is licensed under the MIT License.