vega-framework 0.1.29__py3-none-any.whl → 0.1.31__py3-none-any.whl

vega_framework-0.1.31.dist-info/METADATA

@@ -0,0 +1,349 @@
+Metadata-Version: 2.4
+Name: vega-framework
+Version: 0.1.31
+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: fastapi (>=0.109,<0.110)
+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)
+Requires-Dist: uvicorn (>=0.27,<0.28)
+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.
+
+## Why Vega?
+
+Traditional Python frameworks show you **how to build** but don't enforce **how to architect**. Vega provides:
+
+- ✅ **Clean Architecture** - Enforced separation of concerns
+- ✅ **Dependency Injection** - Zero boilerplate, type-safe DI
+- ✅ **Business Logic First** - Pure, testable, framework-independent
+- ✅ **CLI Scaffolding** - Generate entire projects and components
+- ✅ **Async Support** - Full async/await for CLI and web
+- ✅ **FastAPI & SQLAlchemy** - Built-in integrations when needed
+
+**[Read the Philosophy →](docs/explanation/philosophy.md)** to understand why architecture matters.
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install vega-framework
+```
+
+### Create Your First Project
+
+```bash
+# Create project
+vega init my-app
+cd my-app
+
+# Install dependencies
+poetry install
+
+# Generate components
+vega generate entity User
+vega generate repository UserRepository --impl memory
+vega generate interactor CreateUser
+
+# Run your app
+poetry run python main.py
+```
+
+### Your First Use Case
+
+```python
+# domain/interactors/create_user.py
+from vega.patterns import Interactor
+from vega.di import bind
+
+class CreateUser(Interactor[User]):
+    def __init__(self, name: str, email: str):
+        self.name = name
+        self.email = email
+
+    @bind
+    async def call(self, repository: UserRepository) -> User:
+        # Pure business logic - no framework code!
+        user = User(name=self.name, email=self.email)
+        return await repository.save(user)
+
+# Usage - clean and simple
+user = await CreateUser(name="John", email="john@example.com")
+```
+
+**[See Full Quick Start →](docs/tutorials/quickstart.md)**
+
+## Key Concepts
+
+### Clean Architecture Layers
+
+```
+┌─────────────────────────────────────┐
+│      Presentation (CLI, Web)        │  User interfaces
+├─────────────────────────────────────┤
+│      Application (Workflows)        │  Multi-step operations
+├─────────────────────────────────────┤
+│      Domain (Business Logic)        │  Core business rules
+├─────────────────────────────────────┤
+│      Infrastructure (Technical)     │  Databases, APIs
+└─────────────────────────────────────┘
+```
+
+**[Learn Clean Architecture →](docs/explanation/architecture/clean-architecture.md)**
+
+### Core Patterns
+
+- **[Interactor](docs/explanation/patterns/interactor.md)** - Single-purpose use case
+- **[Mediator](docs/explanation/patterns/mediator.md)** - Complex workflow orchestration
+- **[Repository](docs/explanation/patterns/repository.md)** - Data persistence abstraction
+- **[Service](docs/explanation/patterns/service.md)** - External service abstraction
+
+### Dependency Injection
+
+```python
+# Define what you need (domain)
+class UserRepository(Repository[User]):
+    async def save(self, user: User) -> User:
+        pass
+
+# Implement how it works (infrastructure)
+@injectable(scope=Scope.SINGLETON)
+class PostgresUserRepository(UserRepository):
+    async def save(self, user: User) -> User:
+        # PostgreSQL implementation
+        pass
+
+# Wire it together (config)
+container = Container({
+    UserRepository: PostgresUserRepository
+})
+```
+
+**[Learn Dependency Injection →](docs/explanation/core/dependency-injection.md)**
+
+## CLI Commands
+
+### Project Management
+
+```bash
+vega init my-app                      # Create new project
+vega init my-api --template fastapi   # Create with FastAPI
+vega doctor                           # Validate architecture
+vega update                           # Update framework
+```
+
+### Code Generation
+
+```bash
+# Domain layer
+vega generate entity Product
+vega generate repository ProductRepository --impl sql
+vega generate interactor CreateProduct
+
+# Application layer
+vega generate mediator CheckoutWorkflow
+
+# Presentation layer
+vega generate router Product          # FastAPI (requires: vega add web)
+vega generate command create-product  # CLI
+
+# Infrastructure
+vega generate model Product           # SQLAlchemy (requires: vega add db)
+```
+
+### Add Features
+
+```bash
+vega add web         # Add FastAPI web support
+vega add sqlalchemy  # Add database support
+```
+
+### Database Migrations
+
+```bash
+vega migrate init                    # Initialize database
+vega migrate create -m "add users"   # Create migration
+vega migrate upgrade                 # Apply migrations
+vega migrate downgrade              # Rollback
+```
+
+**[See All CLI Commands →](docs/reference/cli/overview.md)**
+
+## Event System
+
+Built-in event-driven architecture support:
+
+```python
+from vega.events import Event, subscribe
+
+# Define event
+@dataclass(frozen=True)
+class UserCreated(Event):
+    user_id: str
+    email: str
+
+# Subscribe to event
+@subscribe(UserCreated)
+async def send_welcome_email(event: UserCreated):
+    await email_service.send(event.email, "Welcome!")
+
+# Publish event
+await UserCreated(user_id="123", email="test@test.com").publish()
+```
+
+**[Learn Event System →](docs/explanation/events/overview.md)**
+
+## Documentation
+
+### Getting Started
+- [Installation](docs/how-to/install.md)
+- [Quick Start](docs/tutorials/quickstart.md)
+- [Project Structure](docs/explanation/project-structure.md)
+
+### Core Concepts
+- [Philosophy](docs/explanation/philosophy.md) - Why Vega exists
+- [Clean Architecture](docs/explanation/architecture/clean-architecture.md) - Architecture principles
+- [Dependency Injection](docs/explanation/core/dependency-injection.md) - DI system
+- [Patterns](docs/explanation/patterns/interactor.md) - Interactor, Mediator, Repository, Service
+
+### Guides
+- [Building Domain Layer](docs/how-to/build-domain-layer.md) - Business logic first
+- [CLI Reference](docs/reference/cli/overview.md) - All CLI commands
+- [Events System](docs/explanation/events/overview.md) - Event-driven architecture
+
+### Reference
+- [Changelog](docs/reference/CHANGELOG.md)
+- [Roadmap](docs/reference/ROADMAP.md)
+
+**[Browse All Documentation →](docs/README.md)**
+
+## Perfect For
+
+- E-commerce platforms
+- Financial systems
+- Enterprise SaaS applications
+- AI/RAG applications
+- Complex workflow systems
+- Multi-tenant applications
+- Any project requiring clean architecture
+
+## Example Project
+
+```
+my-app/
+├── domain/                    # Business logic
+│   ├── entities/             # Business objects
+│   ├── repositories/         # Data interfaces
+│   ├── services/             # External service interfaces
+│   └── interactors/          # Use cases
+├── application/              # Workflows
+│   └── mediators/            # Complex orchestrations
+├── infrastructure/           # Implementations
+│   ├── repositories/         # Database code
+│   └── services/             # API integrations
+├── presentation/             # User interfaces
+│   ├── cli/                  # CLI commands
+│   └── web/                  # FastAPI routes
+├── config.py                 # Dependency injection
+├── settings.py               # Configuration
+└── main.py                   # Entry point
+```
+
+## Why Clean Architecture?
+
+**Without Vega:**
+```python
+# ❌ Business logic mixed with framework code
+@app.post("/orders")
+async def create_order(request: Request):
+    data = await request.json()
+    order = OrderModel(**data)  # SQLAlchemy
+    session.add(order)
+    stripe.Charge.create(...)   # Stripe
+    return {"id": order.id}
+```
+
+**Problems:**
+- Can't test without FastAPI, database, and Stripe
+- Can't reuse for CLI or other interfaces
+- Business rules are unclear
+- Tightly coupled to specific technologies
+
+**With Vega:**
+```python
+# ✅ Pure business logic (Domain)
+class PlaceOrder(Interactor[Order]):
+    @bind
+    async def call(
+        self,
+        order_repo: OrderRepository,
+        payment_service: PaymentService
+    ) -> Order:
+        # Pure business logic - testable, reusable
+        order = Order(...)
+        await payment_service.charge(...)
+        return await order_repo.save(order)
+
+# ✅ FastAPI route (Presentation) - just wiring
+@router.post("/orders")
+async def create_order_api(request: CreateOrderRequest):
+    return await PlaceOrder(...)
+
+# ✅ CLI command (Presentation) - same logic
+@click.command()
+async def create_order_cli(...):
+    return await PlaceOrder(...)
+```
+
+**Benefits:**
+- ✅ Test business logic without any infrastructure
+- ✅ Same logic works for Web, CLI, GraphQL, etc.
+- ✅ Swap databases without changing business code
+- ✅ Clear business rules and operations
+
+## Community & Support
+
+- **GitHub Issues**: [Report bugs and request features](https://github.com/RobyFerro/vega-framework/issues)
+- **Documentation**: [Complete guides and API reference](docs/README.md)
+- **Examples**: Check `examples/` directory for working code
+
+## Contributing
+
+Contributions are welcome! This framework is extracted from production code and battle-tested in real-world applications.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+**Built with ❤️ for developers who care about architecture.**
+
+[Get Started →](docs/tutorials/quickstart.md) | [Read Philosophy →](docs/explanation/philosophy.md) | [View Documentation →](docs/README.md)
+
+

{vega_framework-0.1.29.dist-info → vega_framework-0.1.31.dist-info}/RECORD

@@ -2,24 +2,26 @@ vega/__init__.py,sha256=A05RwOYXooAZUz3GnbJ--ofLXgtRZK9gaSmsLVRdGPY,1811
 vega/cli/__init__.py,sha256=NCzOOyhKHqLeN1r80ekhMfkQwBdAQXKcKiKoNwYPNiY,304
 vega/cli/commands/__init__.py,sha256=UH7MdYduBG_YoulgdiWkUCtcgGLzuYRGFzxaqoa0pyg,19
 vega/cli/commands/add.py,sha256=5Li588W1KWQqCKV0VZSURx4J3I8dQE297c4V_3anf5U,6465
-vega/cli/commands/generate.py,sha256=Rb4hXPHm_pFEKFViWJ2sMzyUNJWCCoTjLq2H2GvruGc,33720
-vega/cli/commands/init.py,sha256=kBRtntHT7e-y9uOwZm9o9IUED64e_pO5fBEsIx5m-X8,5592
+vega/cli/commands/generate.py,sha256=S3qNE40exn1dSub8kM8Vp-Tpn9ByK2UBjaVA6LadAos,38172
+vega/cli/commands/init.py,sha256=Ro35QfCKeo-Nm_rJkRT-DaX0nH7_bGc_ewX5Q1eqpP8,5860
 vega/cli/commands/migrate.py,sha256=00swKeVhmKr1_1VJhg3GpIMcJ6Jfgz5FUpmJoLf5qSQ,3805
 vega/cli/commands/update.py,sha256=0zRWkHvQwKGlJL9XF3bi--dThkFapyNOugL6AgGr6Ic,5897
 vega/cli/commands/web.py,sha256=tkaMzrENiV044JdPtCSRmzX_vVpnumlDeTG6YH3DWo4,3450
-vega/cli/main.py,sha256=GNqNB6kX_c2a7d68B3g4_oFyWjxTf8ZaoPH7TaYiSmk,5136
+vega/cli/main.py,sha256=0hSar-MFpu3tp2QDOite4LGVpAhCTojuRZhPDiilEFQ,5476
 vega/cli/scaffolds/__init__.py,sha256=WFJf2H_4UWL89gDxX8PXKkTVSVOfw7hFfyaPWKokp1g,217
 vega/cli/scaffolds/fastapi.py,sha256=a_vZVSfMgyteRURFZAShbtjSRMOSM4YeEIKKvBtAOfo,3788
 vega/cli/scaffolds/sqlalchemy.py,sha256=il5JqiA8LSQKnNoOYfAFD82rdYx5l_ZsqsjHnplYohw,6164
-vega/cli/templates/__init__.py,sha256=axjR2Nk8Cy36owrXiHxDOFn9CCd6-Z7Ri5UvOcK1CoM,1876
+vega/cli/templates/__init__.py,sha256=1Udc3hlhj3pJYQGk4NVpg0u9us040YarL_adlomJTf4,2018
 vega/cli/templates/cli/command.py.j2,sha256=Z8K9DRfppsco9uID_uG8EKVyWYD_1x-KYqLZY4BJKzM,1097
 vega/cli/templates/cli/command_simple.py.j2,sha256=PshUZyKtkazSEtaf6E1__hQbX07pz6ojxTXK4TgtUEw,531
 vega/cli/templates/cli/commands_init.py.j2,sha256=iZGnWmJoFUGM1pUMQGYLNplgwgwo8D48vT1hzBcHUEQ,300
-vega/cli/templates/components.py,sha256=nb8B9ha7-vYqnv6dpkI6ruL_Uo6cvJVdcDUseUACpdE,7631
+vega/cli/templates/components.py,sha256=93fzDB6DJUq4_wPaM1ao8RgHxlm6giMSu4JIP8ULOS4,8541
 vega/cli/templates/domain/entity.py.j2,sha256=dl5rzuJMnTRqOdU5SYV2o_OPGy9l6DNf_symCcjdjK0,344
+vega/cli/templates/domain/event.py.j2,sha256=hfNTrlhtwgyiid5oCIBOeVkb6t4K5IOCx7cd0cQi7mQ,667
+vega/cli/templates/domain/event_handler.py.j2,sha256=F8uYJp4WbbAjUk74raD01WcgjU0NVPqtD_9wx2aC4lM,664
 vega/cli/templates/domain/interactor.py.j2,sha256=Hv6whUyW67smjMRw_HuvC3_-q7g32dEUOFZdmi5xkrc,684
 vega/cli/templates/domain/mediator.py.j2,sha256=gdEDNscYaB3wOemaVrFr3qKVE5sTS5wRVvbxrrfBemY,694
-vega/cli/templates/domain/repository_interface.py.j2,sha256=FDlK10yYim6wHMk44IVncoo6RPO0TWDeHWpPjgLlaLo,577
+vega/cli/templates/domain/repository_interface.py.j2,sha256=90jPcokr7GPbfzma_k5GFYFAKk8RZ52SMTmnrC6bnQg,584
 vega/cli/templates/domain/service_interface.py.j2,sha256=Pq-wwGvGbns9Z_2lqL8Xi2_G-MMU-0JjAuGW94H6mrE,330
 vega/cli/templates/infrastructure/model.py.j2,sha256=zNY4m7BZJeQhdu_bTFY6WIhizsYW4eJY6PS1DCs0vbE,796
 vega/cli/templates/infrastructure/repository_impl.py.j2,sha256=Rmip4Swh3wdJRioVOWKgJVQgl45Y9STu3M-oviaOrPM,488
@@ -30,6 +32,7 @@ vega/cli/templates/project/.gitignore,sha256=7JSDihCtBznd-QxQ4wUtHM9fnbYnbw6PK4A
 vega/cli/templates/project/ARCHITECTURE.md.j2,sha256=HunrJ_9LlPxd5-GONaJxjoLlw-XfjYaLpsVHFa72Yf4,25868
 vega/cli/templates/project/README.md.j2,sha256=tZtMKhyKjfCq5JTECHihISu0VjYd254t-7y2kJ0nbKY,4589
 vega/cli/templates/project/config.py.j2,sha256=1Iva9JEz5ej_WmTbRVBvOfSBhYUKIzN88p6GYKR0m4s,866
+vega/cli/templates/project/events_init.py.j2,sha256=dp9yc8_Du6lv62vum_Br0p030I4TKZAkZG29mj4AZaM,1057
 vega/cli/templates/project/main.py.j2,sha256=wpIWNcj0N42KI1crdn0aDISZ6aRt9LjX7FDzJxEE8OM,572
 vega/cli/templates/project/main_fastapi.py.j2,sha256=5xXB7_OR1-3vkTAkvRvSh3GpL5NWnUEId3bSOOd9qxA,613
 vega/cli/templates/project/main_standard.py.j2,sha256=j2z6u93_ObiOquzYQM1sZex50Z1cAwHOEG1-0REImRI,617
@@ -62,18 +65,26 @@ vega/di/container.py,sha256=o4cpxCx53wWSNLcrr8Qt9tc7_YiDtHpYvUrdruNVwEc,5467
 vega/di/decorators.py,sha256=WypsUa9sqojwCCnZ6jXdOob6G6vL4wIx3df_WbUV8Ks,9733
 vega/di/errors.py,sha256=TITDvwkL05b_O7sygJvTx8aSegUXBgF2EqEhVxRuuGE,148
 vega/di/scope.py,sha256=1yorvknVwmYGcDpNGsQDgob1jZQ5QoHdibbBH1SLcwQ,4652
-vega/discovery/__init__.py,sha256=s1MCuJQnCX1C0_YuAhKLHqhkpCRgeSrtAPfNbuboD20,180
+vega/discovery/__init__.py,sha256=nTq5wapJxg2ZZ2rylp1xY3Phq7OQYjXskIy2Ld8wQSw,251
 vega/discovery/commands.py,sha256=U1adQJXqBi88c2lkx8gMWzNE1hj8od72QLEKxjNq7gM,3375
+vega/discovery/events.py,sha256=TF8pjYE6gyJJRpOW8Pqvc0Gpu1n1iIHh3UBqzD8kGRI,3051
 vega/discovery/routes.py,sha256=WiNhNynbKewOrXv7D5fY03I3Oh_yfwEZbkeS8WGyQpU,4347
+vega/events/README.md,sha256=3dp-ZwVxKURIl3FfokzMzVj12wlMImvWaWKx9Y46U7w,13934
+vega/events/SYNTAX_GUIDE.md,sha256=LFnxGOi-IzpOkpW5RERxL-jjMlVmJEIfdXN7_w0DJKY,8577
+vega/events/__init__.py,sha256=yt-0idaDMDfAFiQcRjI-VrDTunKGkYrMV9QFJ244p0Y,800
+vega/events/bus.py,sha256=uALNVeGOyis2ZLCUQn7d87U3UzBO1-0HYO0GErxCmmM,12116
+vega/events/decorators.py,sha256=UF2dQ2GOoXeGuScWBNsePP66ZCIZznJalZVX3i4ome0,5720
+vega/events/event.py,sha256=PfsIl8-6dZR2J1aS7VV9ZQn1CzxvNZOcbP-dil49z9U,4964
+vega/events/middleware.py,sha256=jNltBxeF42-XnC_uVB9OD0BLNRBirudOPeOUYa-fGv8,7862
 vega/patterns/__init__.py,sha256=UlrgFy8OQkAjgqRLFCOcnTHFKODfZH4FA4_33hq0GgQ,1150
-vega/patterns/interactor.py,sha256=QWy20KpWlgL6dav5IgHsfKFNHsTU0igyt4hWQxh_qXc,2366
+vega/patterns/interactor.py,sha256=kRJaFp2eUwHZ-cTQ5y7FoF59yEUo2J9yzL9mo_JbLfI,4030
 vega/patterns/mediator.py,sha256=n5rqu1ZD0iljbAHct4mRPFPHaKVPWQJF-Ps9egYQ41g,2306
 vega/patterns/repository.py,sha256=uYUyLs-O8OqW1Wb9ZqIo8UUcCjZ5UFuHors_F2iDg9A,1480
 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.29.dist-info/METADATA,sha256=j6GYkEGW5ByHxaHOp-882JIN9x_wZEVi6yn2DVvYrpE,12349
-vega_framework-0.1.29.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-vega_framework-0.1.29.dist-info/entry_points.txt,sha256=p3gyTmPYjNRLbuiKS-hG3ytWd-ssBweFy6VZ-F9FTNk,42
-vega_framework-0.1.29.dist-info/licenses/LICENSE,sha256=wlHh1MBTcs2kSQr99P30mZ61s7uh7Cp9Rk0YiJxots0,1084
-vega_framework-0.1.29.dist-info/RECORD,,
+vega_framework-0.1.31.dist-info/METADATA,sha256=dMlyl1DCYbJCpOEG7a8zZzKMs8kZst-xp5vea7EfAbI,11105
+vega_framework-0.1.31.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+vega_framework-0.1.31.dist-info/entry_points.txt,sha256=p3gyTmPYjNRLbuiKS-hG3ytWd-ssBweFy6VZ-F9FTNk,42
+vega_framework-0.1.31.dist-info/licenses/LICENSE,sha256=wlHh1MBTcs2kSQr99P30mZ61s7uh7Cp9Rk0YiJxots0,1084
+vega_framework-0.1.31.dist-info/RECORD,,