vega-framework 0.1.15__py3-none-any.whl → 0.1.17__py3-none-any.whl

vega_framework-0.1.17.dist-info/METADATA

@@ -0,0 +1,483 @@
+Metadata-Version: 2.4
+Name: vega-framework
+Version: 0.1.17
+Summary: Enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications.
+License: MIT
+License-File: LICENSE
+Keywords: clean-architecture,dependency-injection,framework,python,async,vega
+Author: Roberto Ferro
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+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: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: click (>=8.0,<9.0)
+Requires-Dist: jinja2 (>=3.1,<4.0)
+Requires-Dist: pydantic (>=2.0,<3.0)
+Requires-Dist: pydantic-settings (>=2.0,<3.0)
+Requires-Dist: toml (>=0.10,<0.11)
+Project-URL: Documentation, https://vega-framework.readthedocs.io
+Project-URL: Homepage, https://github.com/RobyFerro/vega-framework
+Project-URL: Repository, https://github.com/RobyFerro/vega-framework
+Description-Content-Type: text/markdown
+
+# 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
+
+```bash
+pip install vega-framework
+```
+
+## Quick Start
+
+```bash
+# 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
+
+Vega Framework provides a comprehensive CLI for scaffolding and managing Clean Architecture projects.
+
+### Project Management
+
+#### `vega init` - Initialize New Project
+
+Create a new Vega project with Clean Architecture structure.
+
+```bash
+vega init <project_name> [OPTIONS]
+```
+
+**Options:**
+- `--template <type>` - Project template (default: `basic`)
+  - `basic` - Standard Clean Architecture project with CLI support
+  - `fastapi` - Project with FastAPI web scaffold included
+  - `ai-rag` - AI/RAG application template (coming soon)
+- `--path <directory>` - Parent directory for project (default: current directory)
+
+**Examples:**
+```bash
+vega init my-app
+vega init my-api --template fastapi
+vega init my-ai --template ai-rag --path ./projects
+```
+
+**Creates:**
+- `domain/` - Entities, repositories, services, interactors
+- `application/` - Mediators and workflows
+- `infrastructure/` - Repository and service implementations
+- `presentation/` - CLI and web interfaces
+- `config.py` - DI container configuration
+- `settings.py` - Application settings
+- `pyproject.toml` - Dependencies and project metadata
+
+---
+
+#### `vega doctor` - Validate Project
+
+Validate your Vega project structure and architecture compliance.
+
+```bash
+vega doctor [--path .]
+```
+
+**Options:**
+- `--path <directory>` - Project path to validate (default: current directory)
+
+**Checks:**
+- Correct folder structure
+- DI container configuration
+- Import dependencies
+- Architecture violations
+
+**Example:**
+```bash
+vega doctor
+vega doctor --path ./my-app
+```
+
+---
+
+#### `vega update` - Update Framework
+
+Update Vega Framework to the latest version.
+
+```bash
+vega update [OPTIONS]
+```
+
+**Options:**
+- `--check` - Check for updates without installing
+- `--force` - Force reinstall even if up to date
+
+**Examples:**
+```bash
+vega update              # Update to latest version
+vega update --check      # Check for updates only
+vega update --force      # Force reinstall
+```
+
+---
+
+### Code Generation
+
+#### `vega generate` - Generate Components
+
+Generate Clean Architecture components in your project.
+
+```bash
+vega generate <component_type> <name> [OPTIONS]
+```
+
+**Component Types:**
+
+##### Domain Layer
+
+**`entity`** - Domain Entity (dataclass)
+```bash
+vega generate entity Product
+```
+Creates a domain entity in `domain/entities/`
+
+**`repository`** - Repository Interface
+```bash
+vega generate repository ProductRepository
+vega generate repository Product --impl memory    # With in-memory implementation
+vega generate repository Product --impl sql       # With SQL implementation
+```
+Creates repository interface in `domain/repositories/` and optionally an implementation in `infrastructure/repositories/`
+
+**Alias:** `repo` can be used instead of `repository`
+
+**`service`** - Service Interface
+```bash
+vega generate service EmailService
+vega generate service Email --impl smtp          # With SMTP implementation
+```
+Creates service interface in `domain/services/` and optionally an implementation in `infrastructure/services/`
+
+**`interactor`** - Use Case / Interactor
+```bash
+vega generate interactor CreateProduct
+vega generate interactor GetUserById
+```
+Creates interactor (use case) in `domain/interactors/`
+
+##### Application Layer
+
+**`mediator`** - Workflow / Mediator
+```bash
+vega generate mediator CheckoutFlow
+vega generate mediator OrderProcessing
+```
+Creates mediator (workflow orchestrator) in `application/mediators/`
+
+##### Infrastructure Layer
+
+**`model`** - SQLAlchemy Model *(requires SQLAlchemy)*
+```bash
+vega generate model User
+vega generate model ProductCategory
+```
+Creates SQLAlchemy model in `infrastructure/models/` and registers it in Alembic
+
+##### Presentation Layer
+
+**`router`** - FastAPI Router *(requires FastAPI)*
+```bash
+vega generate router Product
+vega generate router User
+```
+Creates FastAPI router in `presentation/web/routes/` and auto-registers it
+
+**`middleware`** - FastAPI Middleware *(requires FastAPI)*
+```bash
+vega generate middleware Logging
+vega generate middleware Authentication
+```
+Creates FastAPI middleware in `presentation/web/middleware/` and auto-registers it
+
+**`command`** - CLI Command
+```bash
+vega generate command CreateUser                 # Async command (default)
+vega generate command ListUsers --impl sync      # Synchronous command
+```
+Creates CLI command in `presentation/cli/commands/`
+
+The generator will prompt for:
+- Command description
+- Options and arguments
+- Whether it will use interactors
+
+**Options:**
+- `--path <directory>` - Project root path (default: current directory)
+- `--impl <type>` - Generate infrastructure implementation
+  - For `repository`: `memory`, `sql`, or custom name
+  - For `service`: custom implementation name
+  - For `command`: `sync` or `async` (default: async)
+
+**Examples:**
+```bash
+# Domain layer
+vega generate entity Product
+vega generate repository ProductRepository --impl memory
+vega generate service EmailService --impl smtp
+vega generate interactor CreateProduct
+
+# Application layer
+vega generate mediator CheckoutFlow
+
+# Presentation layer (web)
+vega generate router Product
+vega generate middleware Logging
+
+# Presentation layer (CLI)
+vega generate command CreateUser
+vega generate command ListUsers --impl sync
+
+# Infrastructure layer
+vega generate model User
+```
+
+---
+
+### Feature Management
+
+#### `vega add` - Add Features to Project
+
+Add additional features to an existing Vega project.
+
+```bash
+vega add <feature> [OPTIONS]
+```
+
+**Features:**
+
+**`web`** - Add FastAPI Web Scaffold
+```bash
+vega add web
+```
+Adds FastAPI web scaffold to your project:
+- `presentation/web/` - Web application structure
+- `presentation/web/routes/` - API routes
+- `presentation/web/middleware/` - Middleware components
+- `presentation/web/app.py` - FastAPI app factory
+
+**`sqlalchemy` / `db`** - Add SQLAlchemy Database Support
+```bash
+vega add sqlalchemy
+vega add db              # Alias
+```
+Adds SQLAlchemy database support:
+- `infrastructure/database_manager.py` - Database connection manager
+- `infrastructure/models/` - SQLAlchemy models directory
+- `alembic/` - Database migration system
+- `alembic.ini` - Alembic configuration
+
+**Options:**
+- `--path <directory>` - Path to Vega project (default: current directory)
+
+**Examples:**
+```bash
+vega add web
+vega add sqlalchemy
+vega add db --path ./my-project
+```
+
+---
+
+### Database Management
+
+#### `vega migrate` - Database Migration Commands
+
+Manage database schema migrations with Alembic *(requires SQLAlchemy)*.
+
+**`init`** - Initialize Database
+```bash
+vega migrate init
+```
+Creates all database tables based on current models. Use this for initial setup.
+
+**`create`** - Create New Migration
+```bash
+vega migrate create -m "migration message"
+```
+Generates a new migration file by auto-detecting model changes.
+
+**Options:**
+- `-m, --message <text>` - Migration description (required)
+
+**`upgrade`** - Apply Migrations
+```bash
+vega migrate upgrade [--revision head]
+```
+Apply pending migrations to the database.
+
+**Options:**
+- `--revision <id>` - Target revision (default: `head` - latest)
+
+**`downgrade`** - Rollback Migrations
+```bash
+vega migrate downgrade [--revision -1]
+```
+Rollback database migrations.
+
+**Options:**
+- `--revision <id>` - Target revision (default: `-1` - previous)
+
+**`current`** - Show Current Revision
+```bash
+vega migrate current
+```
+Display the current database migration revision.
+
+**`history`** - Show Migration History
+```bash
+vega migrate history
+```
+Display complete migration history with details.
+
+**Examples:**
+```bash
+# Initialize database
+vega migrate init
+
+# Create migration after changing models
+vega migrate create -m "Add user table"
+vega migrate create -m "Add email field to users"
+
+# Apply all pending migrations
+vega migrate upgrade
+
+# Apply migrations up to specific revision
+vega migrate upgrade --revision abc123
+
+# Rollback last migration
+vega migrate downgrade
+
+# Rollback to specific revision
+vega migrate downgrade --revision xyz789
+
+# Check current status
+vega migrate current
+
+# View history
+vega migrate history
+```
+
+---
+
+### Getting Help
+
+**Show Version:**
+```bash
+vega --version
+```
+
+**Show Help:**
+```bash
+vega --help                    # Main help
+vega <command> --help          # Command-specific help
+vega generate --help           # Generate command help
+vega migrate --help            # Migrate command help
+```
+
+**Examples:**
+```bash
+vega init --help
+vega generate --help
+vega add --help
+vega migrate upgrade --help
+```
+
+## Async CLI Commands
+
+Vega provides seamless async/await support in CLI commands, allowing you to execute interactors directly.
+
+### Generate a CLI Command
+
+```bash
+# 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
+
+```python
+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.
+

{vega_framework-0.1.15.dist-info → vega_framework-0.1.17.dist-info}/RECORD

@@ -1,17 +1,19 @@
 vega/__init__.py,sha256=A05RwOYXooAZUz3GnbJ--ofLXgtRZK9gaSmsLVRdGPY,1811
-vega/cli/__init__.py,sha256=UEUU-lMD-G8gElPhFAwGay3TfGe58kKy7Bmc1fsHLR8,81
+vega/cli/__init__.py,sha256=NCzOOyhKHqLeN1r80ekhMfkQwBdAQXKcKiKoNwYPNiY,304
 vega/cli/commands/__init__.py,sha256=UH7MdYduBG_YoulgdiWkUCtcgGLzuYRGFzxaqoa0pyg,19
 vega/cli/commands/add.py,sha256=yiFXD4wb6gc_1nA-ofzt7VQKOaNbeMGNmJ-LQWG6Gh4,5110
-vega/cli/commands/generate.py,sha256=dRX5JEcONYejOCyWBDppZa83GxErSwgIj78vZR1ei0k,25037
+vega/cli/commands/generate.py,sha256=5p_w_1E1UeVvoHiNCZ81Nc00EVT2yNmfsBpM3qIIBr0,30622
 vega/cli/commands/init.py,sha256=JsaDODyvHoYpgisoqxU9sRtDkwZWn84PQ0UzyRjnWw0,5754
-vega/cli/commands/migrate.py,sha256=aez_PXdHkniefOyVWDUPZTT0i3kqUyRVjOIwSJ-ZRP8,3773
+vega/cli/commands/migrate.py,sha256=00swKeVhmKr1_1VJhg3GpIMcJ6Jfgz5FUpmJoLf5qSQ,3805
 vega/cli/commands/update.py,sha256=0zRWkHvQwKGlJL9XF3bi--dThkFapyNOugL6AgGr6Ic,5897
-vega/cli/main.py,sha256=fqRpvN8HhUGqVixCKm5tCnTwj8vdWaud7IArUiwrhbs,4468
+vega/cli/main.py,sha256=AhH560Fin6BDUXpVOJ2rVwt4e7cq2iqrF8XqDmaJjEI,4655
 vega/cli/scaffolds/__init__.py,sha256=WFJf2H_4UWL89gDxX8PXKkTVSVOfw7hFfyaPWKokp1g,217
 vega/cli/scaffolds/fastapi.py,sha256=dA1RRWuS2HjCRh5q8T-VEBU8r8C-IqRbNZW_SqTv1Wg,3760
 vega/cli/scaffolds/sqlalchemy.py,sha256=il5JqiA8LSQKnNoOYfAFD82rdYx5l_ZsqsjHnplYohw,6164
-vega/cli/templates/__init__.py,sha256=3B4_3JguqF720oQahLdGkKH7gdNjXLpyIggrS9BvfLI,1606
-vega/cli/templates/components.py,sha256=a1EEkUQlSrF2ZWk8oqQKNqFYOC2695il9oorcLtwHeA,5949
+vega/cli/templates/__init__.py,sha256=0-jsxHcM4IbJiiZXqszm1XiYRYVcHgOivXdq7jqxBrk,1720
+vega/cli/templates/cli/command.py.j2,sha256=GwZGWFLQsA64w4Qes2a1mcfB65MlPfSRIJs0QuS4Upk,1112
+vega/cli/templates/cli/command_simple.py.j2,sha256=RviSXTP5mfbMkdT8DcDTO9OZKunYpyacHGs-dw6bDhQ,546
+vega/cli/templates/components.py,sha256=NvGJqjP2-EYy52YW8xihQOV0FHeWhqUEFKul5qe1XFY,7231
 vega/cli/templates/domain/entity.py.j2,sha256=dl5rzuJMnTRqOdU5SYV2o_OPGy9l6DNf_symCcjdjK0,344
 vega/cli/templates/domain/interactor.py.j2,sha256=Hv6whUyW67smjMRw_HuvC3_-q7g32dEUOFZdmi5xkrc,684
 vega/cli/templates/domain/mediator.py.j2,sha256=gdEDNscYaB3wOemaVrFr3qKVE5sTS5wRVvbxrrfBemY,694
@@ -23,12 +25,12 @@ vega/cli/templates/infrastructure/service_impl.py.j2,sha256=AgP2oqMbbcd0ctVfiVyO
 vega/cli/templates/loader.py,sha256=cyt9ZOVLwBgv4ijPxoqR4JgFSbdkXCMzviHcq3fdv8Q,2712
 vega/cli/templates/project/.env.example,sha256=BqfRxYeOasgZMz4_B2kybu6areIy9dHCt5BJ6fa56ik,221
 vega/cli/templates/project/.gitignore,sha256=7JSDihCtBznd-QxQ4wUtHM9fnbYnbw6PK4Auh56ofAY,229
-vega/cli/templates/project/ARCHITECTURE.md.j2,sha256=dO4FDsMgR2pG3KGWu2FX0MLgR-IAD8MQ30g6FC_n4Hg,16834
-vega/cli/templates/project/README.md.j2,sha256=mzQyw8fNvCs_IDj0GKi4mrkexI3tGowMQpeIkuTFoZQ,2124
-vega/cli/templates/project/config.py.j2,sha256=3wXkP0vw5kgMtsho5jvHL3JON3lYP26muRilhB3ZzoA,833
+vega/cli/templates/project/ARCHITECTURE.md.j2,sha256=P7NiaGDp3ekPP3Fn5mtlMUWf66qqAAFtZzcmYRXJKis,23737
+vega/cli/templates/project/README.md.j2,sha256=Oea0AiDb_rm-GPsLFAPhYEpMmtHt_pqCRjrreymZj8Y,4601
+vega/cli/templates/project/config.py.j2,sha256=1Iva9JEz5ej_WmTbRVBvOfSBhYUKIzN88p6GYKR0m4s,866
 vega/cli/templates/project/main.py.j2,sha256=WhV5rm2K_jtXrSorChcgwWN7XraRoXwvfYOcQ852lM0,2387
-vega/cli/templates/project/main_fastapi.py.j2,sha256=6Dd9X7gSE5FAYftzxgLkT8CyD5Nc3nvb40KMBx11GP0,1012
-vega/cli/templates/project/main_standard.py.j2,sha256=Wry7cGImSMOgXLiRTPcU8qdhB7yt9N8VUU__BaFU63o,1364
+vega/cli/templates/project/main_fastapi.py.j2,sha256=BRd91YwFbr4H5mBKYClO8NM2VGODh3xaGLdkfkGskUA,1980
+vega/cli/templates/project/main_standard.py.j2,sha256=zvgsJEY79wGlpU1Zl0Hctk6pcayAFWJPHnqnvHepNps,2227
 vega/cli/templates/project/pyproject.toml.j2,sha256=372XOUluFot28oKyAwnKt_hBJEtc7qfULVjmFYq8_FE,643
 vega/cli/templates/project/settings.py.j2,sha256=uHt3qVbzoYZNb1ViD2Bu4SZYYw0jCUx6_m_kauILCCs,522
 vega/cli/templates/sqlalchemy/alembic.ini.j2,sha256=7pcqcXWXU_0lHaokuHlkUNoN20oOw1Dd6HizMG1Cmmk,3472
@@ -45,7 +47,8 @@ vega/cli/templates/web/router.py.j2,sha256=5FgBYTcsdHH24Y9GtlsPWMllwygFO5aaCNCqN
 vega/cli/templates/web/routes_init.py.j2,sha256=uyeuLGRZ-bDY-xefJ1eI9wU1kt9z7lwoVjw_nvY7Vk4,397
 vega/cli/templates/web/user_models.py.j2,sha256=_lbG-oL8-C7Lk3-48YuKR65USD5TV4D9JNoFT9kktIM,1250
 vega/cli/templates/web/users_route.py.j2,sha256=TjKu28jxVY3SwToptjOZoclUnZkobbDOUfOYlDkjs40,1927
-vega/cli/utils/__init__.py,sha256=gXi9WuhOLIubVRSXL_n2yZreMqAvPD9Pmri4yUMdu18,287
+vega/cli/utils/__init__.py,sha256=ZHL88Jjz6KoQYS3ft9a6EXp84giSMO5BJ9DDDSUKtLw,367
+vega/cli/utils/async_support.py,sha256=eU4HVZUCeJclZzpQQoDysiJ_qewwyCtu3C0TcSsuKl4,1511
 vega/cli/utils/messages.py,sha256=EtRWqMD6BUGaIuEWiH0cigpQPEaLOhnURSACSzdxBdA,2399
 vega/cli/utils/naming.py,sha256=9dfTfHug3ecxH_SPq7pVdj_61fFnkEQOp9iVSHmFE8M,3563
 vega/cli/utils/validators.py,sha256=YhQ1KQsALdovMh9zgCsuh_I2Tm9C7fBzBkLb05pgX40,3028
@@ -61,8 +64,8 @@ vega/patterns/repository.py,sha256=uYUyLs-O8OqW1Wb9ZqIo8UUcCjZ5UFuHors_F2iDg9A,1
 vega/patterns/service.py,sha256=buFRgJoeQtZQK22Upb4vh84c1elWKFXWBaB0X4RaruE,1374
 vega/settings/__init__.py,sha256=Eb8PMUyXAlCAQIcL2W8QhTTUHUbVlkAfXdpTUlADo1I,786
 vega/settings/base.py,sha256=bL45hyoa3t-hQOvur860eSo7O833sQMsXJJPwbTVbwE,1321
-vega_framework-0.1.15.dist-info/METADATA,sha256=njOYKhZ-ZKKgedMxXGPg53rZIYjow-HNQ8eDcbm_hzM,4269
-vega_framework-0.1.15.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-vega_framework-0.1.15.dist-info/entry_points.txt,sha256=p3gyTmPYjNRLbuiKS-hG3ytWd-ssBweFy6VZ-F9FTNk,42
-vega_framework-0.1.15.dist-info/licenses/LICENSE,sha256=wlHh1MBTcs2kSQr99P30mZ61s7uh7Cp9Rk0YiJxots0,1084
-vega_framework-0.1.15.dist-info/RECORD,,
+vega_framework-0.1.17.dist-info/METADATA,sha256=p8ze1mklJAIDttekdJ-lRKm9Wz_BDFzcORaFXEHgO2A,12271
+vega_framework-0.1.17.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+vega_framework-0.1.17.dist-info/entry_points.txt,sha256=p3gyTmPYjNRLbuiKS-hG3ytWd-ssBweFy6VZ-F9FTNk,42
+vega_framework-0.1.17.dist-info/licenses/LICENSE,sha256=wlHh1MBTcs2kSQr99P30mZ61s7uh7Cp9Rk0YiJxots0,1084
+vega_framework-0.1.17.dist-info/RECORD,,

vega_framework-0.1.15.dist-info/METADATA

@@ -1,158 +0,0 @@
-Metadata-Version: 2.4
-Name: vega-framework
-Version: 0.1.15
-Summary: Enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications.
-License: MIT
-License-File: LICENSE
-Keywords: clean-architecture,dependency-injection,framework,python,async,vega
-Author: Roberto Ferro
-Requires-Python: >=3.10,<4.0
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-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: Topic :: Software Development :: Libraries :: Application Frameworks
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: click (>=8.0,<9.0)
-Requires-Dist: jinja2 (>=3.1,<4.0)
-Requires-Dist: pydantic (>=2.0,<3.0)
-Requires-Dist: pydantic-settings (>=2.0,<3.0)
-Requires-Dist: toml (>=0.10,<0.11)
-Project-URL: Documentation, https://vega-framework.readthedocs.io
-Project-URL: Homepage, https://github.com/RobyFerro/vega-framework
-Project-URL: Repository, https://github.com/RobyFerro/vega-framework
-Description-Content-Type: text/markdown
-
-# 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
-- ✅ **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
-
-```bash
-pip install vega-framework
-```
-
-## Quick Start
-
-```bash
-# 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
-
-```bash
-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
-
-```bash
-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
-```
-
-### Add Features
-
-```bash
-# Add FastAPI web scaffold
-vega add web
-
-# Add SQLAlchemy database support
-vega add sqlalchemy
-# or
-vega add db
-```
-
-### Database Migrations (SQLAlchemy)
-
-```bash
-# 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
-
-```bash
-vega doctor [--path .]
-```
-
-Validates project structure, DI configuration, and architecture compliance.
-
-## 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.
-