vega-framework 0.1.16

Enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications.

Vega Framework

An enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications.

Features

• ✅ Automatic Dependency Injection - Zero boilerplate, type-safe DI
• ✅ Clean Architecture Patterns - Interactor, Mediator, Repository, Service
• ✅ Async/Await Support - Full async support for CLI and web
• ✅ Scope Management - Singleton, Scoped, Transient lifetimes
• ✅ Type-Safe - Full type hints support
• ✅ Framework-Agnostic - Works with any domain (web, AI, IoT, fintech, etc.)
• ✅ CLI Scaffolding - Generate projects and components instantly
• ✅ FastAPI Integration - Built-in web scaffold with routing and middleware
• ✅ SQLAlchemy Support - Database management with async support and migrations
• ✅ Lightweight - No unnecessary dependencies

Installation

pip install vega-framework

Quick Start

# Create new project
vega init my-app

# Generate components
vega generate entity User
vega generate repository UserRepository
vega generate interactor CreateUser

# Create FastAPI project
vega init my-api --template fastapi

CLI Commands

Initialize Project

vega init <project_name> [--template basic|fastapi|ai-rag] [--path .]

Creates a new Vega project with Clean Architecture structure:

• domain/ - Entities, repositories, services, interactors
• application/ - Mediators and workflows
• infrastructure/ - Repository and service implementations
• config.py - DI container setup
• settings.py - Application configuration

Generate Components

vega generate entity <Name>
vega generate repository <Name> [--impl memory|sql]
vega generate service <Name>
vega generate interactor <Name>
vega generate mediator <Name>
vega generate router <Name>          # Requires FastAPI
vega generate middleware <Name>      # Requires FastAPI
vega generate model <Name>           # Requires SQLAlchemy
vega generate command <Name>         # CLI command (async by default)
vega generate command <Name> --impl sync  # Synchronous CLI command

Add Features

# Add FastAPI web scaffold
vega add web

# Add SQLAlchemy database support
vega add sqlalchemy
# or
vega add db

Database Migrations (SQLAlchemy)

# Initialize database
vega migrate init

# Create a new migration
vega migrate create -m "migration message"

# Apply migrations
vega migrate upgrade [--revision head]

# Rollback migrations
vega migrate downgrade [--revision -1]

# Show current revision
vega migrate current

# Show migration history
vega migrate history

Validate Project

vega doctor [--path .]

Validates project structure, DI configuration, and architecture compliance.

Async CLI Commands

Vega provides seamless async/await support in CLI commands, allowing you to execute interactors directly.

Generate a CLI Command

# Generate an async command (default)
vega generate command CreateUser

# Generate a synchronous command
vega generate command ListUsers --impl sync

The generator will prompt you for:

• Command description
• Options and arguments
• Whether it will use interactors

Manual Command Example

import click
from vega.cli.utils import async_command

@click.command()
@click.option('--name', required=True)
@async_command
async def create_user(name: str):
    """Create a user using an interactor"""
    import config  # Initialize DI container
    from domain.interactors.create_user import CreateUser

    user = await CreateUser(name=name)
    click.echo(f"Created: {user.name}")

This enables the same async business logic to work in both CLI and web (FastAPI) contexts.

Use Cases

Perfect for:

• AI/RAG applications
• E-commerce platforms
• Fintech systems
• Mobile backends
• Microservices
• CLI tools
• Any Python application requiring clean architecture

License

MIT

Contributing

Contributions welcome! This framework is extracted from production code and battle-tested.