vega-framework 0.1.24__tar.gz → 0.1.26__tar.gz

{vega_framework-0.1.24 → vega_framework-0.1.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vega-framework
-Version: 0.1.24
+Version: 0.1.26
 Summary: Enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications.
 License: MIT
 License-File: LICENSE
@@ -19,10 +19,12 @@ 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

{vega_framework-0.1.24 → vega_framework-0.1.26}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "vega-framework"
-version = "0.1.24"
+version = "0.1.26"
 description = "Enterprise-ready Python framework that enforces Clean Architecture for building maintainable and scalable applications."
 authors = ["Roberto Ferro"]
 license = "MIT"
@@ -42,6 +42,8 @@ pydantic-settings = "^2.0"
 click = "^8.0"
 jinja2 = "^3.1"
 toml = "^0.10"
+uvicorn = "^0.27"
+fastapi = "^0.109"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.0"

{vega_framework-0.1.24 → vega_framework-0.1.26}/vega/cli/commands/add.py

@@ -58,39 +58,18 @@ def add_web_feature(project_path: Path, project_name: str):
     presentation_dir = project_path / "presentation"
     if not presentation_dir.exists():
         presentation_dir.mkdir(parents=True, exist_ok=True)
-        (presentation_dir / "__init__.py").write_text("")
         click.echo(f"  + Created presentation/")
 
     # Create FastAPI scaffold
     create_fastapi_scaffold(project_path, project_name, overwrite=overwrite)
 
-    # Update main.py to use web command
-    main_file = project_path / "main.py"
-    if main_file.exists():
-        click.echo("\n[!] Update main.py to add web command:")
-        click.echo("    Add the following to your main.py CLI group:\n")
-        click.echo(click.style('''
-@cli.command()
-@click.option('--host', default='0.0.0.0', help='Host to bind')
-@click.option('--port', default=8000, help='Port to bind')
-@click.option('--reload', is_flag=True, help='Enable auto-reload')
-def web(host: str, port: int, reload: bool):
-    """Start FastAPI web server"""
-    import uvicorn
-    from presentation.web.main import app
-
-    click.echo(f"Starting web server on http://{host}:{port}")
-    uvicorn.run(app, host=host, port=port, reload=reload)
-''', fg='cyan'))
-
     click.echo(f"\n{click.style('SUCCESS: FastAPI web scaffold added!', fg='green', bold=True)}\n")
     click.echo("Next steps:")
     click.echo("  1. Add FastAPI dependencies:")
     click.echo("     poetry add fastapi uvicorn[standard]")
-    click.echo("  2. Update your main.py with the web command (see above)")
-    click.echo("  3. Run the server:")
-    click.echo("     python main.py web --reload")
-    click.echo("  4. Visit http://localhost:8000/api/health/status")
+    click.echo("  2. Run the server:")
+    click.echo("     vega web run --reload")
+    click.echo("  3. Visit http://localhost:8000/api/health/status")
 
 
 def add_sqlalchemy_feature(project_path: Path, project_name: str):
@@ -111,6 +90,13 @@ def add_sqlalchemy_feature(project_path: Path, project_name: str):
     # Create SQLAlchemy scaffold
     create_sqlalchemy_scaffold(project_path, project_name, overwrite=overwrite)
 
+    # Ask if user wants an example repository
+    create_example = click.confirm("\nDo you want to create an example User repository with SQLAlchemy implementation?", default=True)
+
+    if create_example:
+        click.echo("\n[*] Creating example User repository...")
+        _create_user_example_repository(project_path, project_name)
+
     click.echo(f"\n{click.style('SUCCESS: SQLAlchemy database support added!', fg='green', bold=True)}\n")
     click.echo("Next steps:")
     click.echo("  1. Add DATABASE_URL to your settings.py:")
@@ -123,3 +109,54 @@ def add_sqlalchemy_feature(project_path: Path, project_name: str):
     click.echo('     vega migrate create -m "Initial migration"')
     click.echo("  5. Apply migrations:")
     click.echo("     vega migrate upgrade")
+
+
+def _create_user_example_repository(project_path: Path, project_name: str):
+    """Create example User entity, repository, and SQLAlchemy implementation"""
+    from vega.cli.commands.generate import _generate_entity, _generate_repository, _generate_sqlalchemy_model, _generate_infrastructure_repository
+    from vega.cli.utils import to_pascal_case, to_snake_case
+
+    # Suppress verbose output temporarily by redirecting
+    import sys
+    from io import StringIO
+
+    # Generate User entity
+    click.echo("  + Creating User entity...")
+    _generate_entity(project_path, project_name, 'User', 'user')
+
+    # Generate UserRepository interface (without next steps)
+    click.echo("  + Creating UserRepository interface...")
+    original_stdout = sys.stdout
+    sys.stdout = StringIO()  # Suppress "Next steps" output
+
+    try:
+        _generate_repository(project_path, project_name, 'UserRepository', 'user_repository', implementation=None)
+    finally:
+        sys.stdout = original_stdout
+
+    # Generate SQLAlchemy UserModel
+    click.echo("  + Creating UserModel (SQLAlchemy)...")
+    sys.stdout = StringIO()  # Suppress verbose output
+    try:
+        _generate_sqlalchemy_model(project_path, project_name, 'User', 'user')
+    finally:
+        sys.stdout = original_stdout
+
+    # Generate SQLAlchemy repository implementation
+    click.echo("  + Creating SQLAlchemyUserRepository implementation...")
+    _generate_infrastructure_repository(
+        project_path,
+        'UserRepository',
+        'user_repository',
+        'User',
+        'user',
+        'sql'
+    )
+
+    click.echo(click.style("\n  ✓ Example User repository created!", fg='green'))
+    click.echo("\nGenerated files:")
+    click.echo("  - domain/entities/user.py")
+    click.echo("  - domain/repositories/user_repository.py")
+    click.echo("  - infrastructure/models/user.py")
+    click.echo("  - infrastructure/repositories/sqlalchemy_user_repository.py")
+    click.echo("\nNext step: Update config.py to register SQLAlchemyUserRepository in SERVICES dict")

{vega_framework-0.1.24 → vega_framework-0.1.26}/vega/cli/commands/init.py

@@ -53,18 +53,9 @@ def init_project(project_name: str, template: str, parent_path: str):
             from vega.cli.templates import render_cli_commands_init
             content = render_cli_commands_init()
             (dir_path / "__init__.py").write_text(content)
-        else:
-            (dir_path / "__init__.py").write_text("")
 
         click.echo(f"  + Created {directory}/")
 
-    # Create __init__.py files
-    (project_path / "__init__.py").write_text("")
-    (project_path / "domain" / "__init__.py").write_text("")
-    (project_path / "application" / "__init__.py").write_text("")
-    (project_path / "infrastructure" / "__init__.py").write_text("")
-    (project_path / "presentation" / "__init__.py").write_text("")
-    (project_path / "tests" / "__init__.py").write_text("")
 
     # Create config.py
     config_content = render_template("config.py.j2", project_name=project_name)
@@ -131,8 +122,8 @@ def init_project(project_name: str, template: str, parent_path: str):
 
     if template == "fastapi":
         click.echo(f"\nRun commands:")
-        click.echo(f"  python main.py web          # Start FastAPI server (http://localhost:8000)")
-        click.echo(f"  python main.py web --reload # Start with auto-reload")
+        click.echo(f"  vega web run                # Start FastAPI server (http://localhost:8000)")
+        click.echo(f"  vega web run --reload       # Start with auto-reload")
         click.echo(f"  python main.py hello        # Run CLI command")
         click.echo(f"  python main.py --help       # Show all commands")
     else:

vega_framework-0.1.26/vega/cli/commands/web.py

@@ -0,0 +1,90 @@
+"""Web command - Manage FastAPI web server"""
+import sys
+from pathlib import Path
+
+import click
+
+
+@click.group()
+def web():
+    """Manage FastAPI web server
+
+    Commands to manage the web server for your Vega project.
+    The web module must be added to the project first using 'vega add web'.
+    """
+    pass
+
+
+@web.command()
+@click.option('--host', default='0.0.0.0', help='Host to bind')
+@click.option('--port', default=8000, help='Port to bind')
+@click.option('--reload', is_flag=True, help='Enable auto-reload')
+@click.option('--path', default='.', help='Path to Vega project (default: current directory)')
+def run(host: str, port: int, reload: bool, path: str):
+    """Start the FastAPI web server
+
+    Examples:
+        vega web run
+        vega web run --reload
+        vega web run --host 127.0.0.1 --port 3000
+        vega web run --path ./my-project --reload
+    """
+    project_path = Path(path).resolve()
+
+    # Validate it's a Vega project
+    if not (project_path / "config.py").exists():
+        click.echo(click.style("ERROR: Not a Vega project (config.py not found)", fg='red'))
+        click.echo(f"Path checked: {project_path}")
+        click.echo("\nRun 'vega init <project-name>' to create a new Vega project.")
+        sys.exit(1)
+
+    # Check if web module exists
+    web_main = project_path / "presentation" / "web" / "main.py"
+    if not web_main.exists():
+        click.echo(click.style("ERROR: Web module not found", fg='red'))
+        click.echo("\nThe FastAPI web module is not available in this project.")
+        click.echo("Add it using:")
+        click.echo(click.style("  vega add web", fg='cyan', bold=True))
+        sys.exit(1)
+
+    # Add project path to sys.path so we can import from it
+    if str(project_path) not in sys.path:
+        sys.path.insert(0, str(project_path))
+
+    # Try to import uvicorn
+    try:
+        import uvicorn
+    except ImportError:
+        click.echo(click.style("ERROR: uvicorn not installed", fg='red'))
+        click.echo("\nInstall FastAPI dependencies:")
+        click.echo(click.style("  poetry add fastapi uvicorn[standard]", fg='cyan', bold=True))
+        sys.exit(1)
+
+    # Try to import the app
+    try:
+        from presentation.web.main import app
+    except ImportError as e:
+        click.echo(click.style("ERROR: Failed to import FastAPI app", fg='red'))
+        click.echo(f"\nDetails: {e}")
+        click.echo("\nMake sure:")
+        click.echo("  1. You are in the project directory or use --path")
+        click.echo("  2. The web module is properly configured")
+        click.echo("  3. All dependencies are installed (poetry install)")
+        sys.exit(1)
+
+    click.echo(f"Starting web server on http://{host}:{port}")
+    if reload:
+        click.echo(click.style("Auto-reload enabled", fg='yellow'))
+
+    # Run the server
+    try:
+        uvicorn.run(
+            "presentation.web.main:app",
+            host=host,
+            port=port,
+            reload=reload,
+        )
+    except Exception as e:
+        click.echo(click.style(f"\nERROR: Failed to start server", fg='red'))
+        click.echo(f"Details: {e}")
+        sys.exit(1)

{vega_framework-0.1.24 → vega_framework-0.1.26}/vega/cli/main.py

@@ -9,6 +9,7 @@ from vega.cli.commands.generate import generate_component
 from vega.cli.commands.add import add
 from vega.cli.commands.update import update_vega, check_version
 from vega.cli.commands.migrate import migrate
+from vega.cli.commands.web import web
 
 
 @click.group()
@@ -139,9 +140,10 @@ def update(check, force):
         update_vega(force=force)
 
 
-# Register the add and migrate commands
+# Register the add, migrate and web commands
 cli.add_command(add)
 cli.add_command(migrate)
+cli.add_command(web)
 
 
 if __name__ == '__main__':

{vega_framework-0.1.24 → vega_framework-0.1.26}/vega/cli/templates/project/README.md.j2

@@ -46,8 +46,8 @@ python main.py hello
 python main.py greet --name John
 
 # If using FastAPI template, run the web server
-python main.py web
-python main.py web --reload  # With auto-reload
+vega web run
+vega web run --reload  # With auto-reload
 # Visit http://localhost:8000/api/health/status
 
 # Run tests

vega_framework-0.1.26/vega/cli/templates/project/main.py.j2

@@ -0,0 +1,25 @@
+"""Main entry point for {{ project_name }}"""
+import click
+import config  # noqa: F401 - Import to initialize DI container
+
+# Import your use cases here
+# from domain.interactors.create_user import CreateUser
+
+
+@click.group()
+def cli():
+    """Vega Framework Application"""
+    pass
+
+# Auto-register custom commands from presentation/cli/commands/
+try:
+    from presentation.cli.commands import get_commands
+    for cmd in get_commands():
+        cli.add_command(cmd)
+except ImportError:
+    # cli/commands/ not created yet
+    pass
+
+
+if __name__ == "__main__":
+    cli()

vega_framework-0.1.26/vega/cli/templates/project/main_fastapi.py.j2

@@ -0,0 +1,26 @@
+"""Main entry point for {{ project_name }}"""
+import click
+from vega.cli.utils import async_command
+import config  # noqa: F401 - Import to initialize DI container
+
+# Import your use cases here
+# from domain.interactors.create_user import CreateUser
+
+
+@click.group()
+def cli():
+    """Vega Framework Application"""
+    pass
+
+# Auto-register custom commands from presentation/cli/commands/
+try:
+    from presentation.cli.commands import get_commands
+    for cmd in get_commands():
+        cli.add_command(cmd)
+except ImportError:
+    # cli/commands/ not created yet
+    pass
+
+
+if __name__ == "__main__":
+    cli()

vega_framework-0.1.26/vega/cli/templates/project/main_standard.py.j2

@@ -0,0 +1,26 @@
+"""Main entry point for {{ project_name }}"""
+import click
+from vega.cli.utils import async_command
+import config  # noqa: F401 - Import to initialize DI container
+
+# Import your use cases here
+# from domain.interactors.create_user import CreateUser
+
+
+@click.group()
+def cli():
+    """Vega Framework CLI Application"""
+    pass
+
+# Auto-register custom commands from presentation/cli/commands/
+try:
+    from presentation.cli.commands import get_commands
+    for cmd in get_commands():
+        cli.add_command(cmd)
+except ImportError:
+    # cli/commands/ not created yet
+    pass
+
+
+if __name__ == "__main__":
+    cli()

vega_framework-0.1.24/vega/cli/templates/project/main.py.j2

@@ -1,110 +0,0 @@
-"""Main entry point for {{ project_name }}"""
-{% if template == "fastapi" -%}
-import click
-import config  # noqa: F401 - Import to initialize DI container
-
-
-@click.group()
-def cli():
-    """Vega Framework Application - CLI and Web"""
-    pass
-
-
-@cli.command()
-@click.option('--host', default='0.0.0.0', help='Host to bind')
-@click.option('--port', default=8000, help='Port to bind')
-@click.option('--reload', is_flag=True, help='Enable auto-reload')
-def web(host: str, port: int, reload: bool):
-    """Start FastAPI web server"""
-    import uvicorn
-    from presentation.web.main import app
-
-    click.echo(f"Starting web server on http://{host}:{port}")
-    uvicorn.run(
-        app,
-        host=host,
-        port=port,
-        reload=reload,
-    )
-
-
-@cli.command()
-def hello():
-    """Example CLI command"""
-    click.echo("Hello from Vega Framework!")
-    click.echo("Add your CLI commands in presentation/cli/commands/")
-
-
-# Auto-register custom commands from presentation/cli/commands/
-try:
-    from presentation.cli.commands import get_commands
-    for cmd in get_commands():
-        cli.add_command(cmd)
-except ImportError:
-    # cli/commands/ not created yet
-    pass
-
-
-if __name__ == "__main__":
-    cli()
-{% else -%}
-import asyncio
-import click
-import config  # noqa: F401 - Import to initialize DI container
-
-# Import your use cases here
-# from domain.interactors.create_user import CreateUser
-
-
-@click.group()
-def cli():
-    """Vega Framework CLI Application"""
-    pass
-
-
-@cli.command()
-def hello():
-    """Example CLI command"""
-    click.echo("Hello from Vega Framework!")
-    click.echo("Add your CLI commands in presentation/cli/commands/")
-
-
-@cli.command()
-@click.option('--name', default='World', help='Name to greet')
-def greet(name: str):
-    """Example command with parameter"""
-    click.echo(f"Hello, {name}!")
-
-
-# Uncomment this block if you enable FastAPI support
-# @cli.command()
-# @click.option('--host', default='0.0.0.0', help='Host to bind')
-# @click.option('--port', default=8000, help='Port to bind')
-# @click.option('--reload', is_flag=True, help='Enable auto-reload')
-# def web(host: str, port: int, reload: bool):
-#     """Start FastAPI web server"""
-#     import uvicorn
-#     from presentation.web.main import app
-#
-#     click.echo(f"Starting web server on http://{host}:{port}")
-#     uvicorn.run(
-#         app,
-#         host=host,
-#         port=port,
-#         reload=reload,
-#     )
-
-
-# Auto-register custom commands from presentation/cli/commands/
-try:
-    from presentation.cli.commands import get_commands
-    for cmd in get_commands():
-        cli.add_command(cmd)
-except ImportError:
-    # cli/commands/ not created yet
-    pass
-
-
-if __name__ == "__main__":
-    cli()
-{% endif -%}

vega_framework-0.1.24/vega/cli/templates/project/main_fastapi.py.j2

@@ -1,76 +0,0 @@
-"""Main entry point for {{ project_name }}"""
-import click
-from vega.cli.utils import async_command
-import config  # noqa: F401 - Import to initialize DI container
-
-# Import your use cases here
-# from domain.interactors.create_user import CreateUser
-
-
-@click.group()
-def cli():
-    """Vega Framework Application - CLI and Web"""
-    pass
-
-
-@cli.command()
-@click.option('--host', default='0.0.0.0', help='Host to bind')
-@click.option('--port', default=8000, help='Port to bind')
-@click.option('--reload', is_flag=True, help='Enable auto-reload')
-def web(host: str, port: int, reload: bool):
-    """Start FastAPI web server"""
-    import uvicorn
-    from presentation.web.main import app
-
-    click.echo(f"Starting web server on http://{host}:{port}")
-    uvicorn.run(
-        app,
-        host=host,
-        port=port,
-        reload=reload,
-    )
-
-
-@cli.command()
-def hello():
-    """Example CLI command"""
-    click.echo("Hello from Vega Framework!")
-    click.echo("Add your CLI commands in presentation/cli/commands/")
-
-
-@cli.command()
-@click.option('--name', required=True, help='User name')
-@click.option('--email', required=True, help='User email')
-@async_command
-async def create_user(name: str, email: str):
-    """
-    Example async CLI command that uses an interactor.
-
-    This demonstrates how to use async/await with Click commands
-    to execute interactors and other async operations.
-
-    Usage:
-        python main.py create-user --name="John Doe" --email="john@example.com"
-    """
-    # Import your interactor
-    # from domain.interactors.create_user import CreateUser
-    # user = await CreateUser(name=name, email=email)
-    # click.echo(f"Created user: {user.id} - {user.name}")
-
-    # Placeholder implementation
-    click.echo(f"Creating user: {name} ({email})")
-    click.echo("Note: Replace this with your actual CreateUser interactor")
-
-
-# Auto-register custom commands from presentation/cli/commands/
-try:
-    from presentation.cli.commands import get_commands
-    for cmd in get_commands():
-        cli.add_command(cmd)
-except ImportError:
-    # cli/commands/ not created yet
-    pass
-
-
-if __name__ == "__main__":
-    cli()

vega_framework-0.1.24/vega/cli/templates/project/main_standard.py.j2

@@ -1,84 +0,0 @@
-"""Main entry point for {{ project_name }}"""
-import click
-from vega.cli.utils import async_command
-import config  # noqa: F401 - Import to initialize DI container
-
-# Import your use cases here
-# from domain.interactors.create_user import CreateUser
-
-
-@click.group()
-def cli():
-    """Vega Framework CLI Application"""
-    pass
-
-
-@cli.command()
-def hello():
-    """Example CLI command"""
-    click.echo("Hello from Vega Framework!")
-    click.echo("Add your CLI commands in presentation/cli/commands/")
-
-
-@cli.command()
-@click.option('--name', default='World', help='Name to greet')
-def greet(name: str):
-    """Example command with parameter"""
-    click.echo(f"Hello, {name}!")
-
-
-@cli.command()
-@click.option('--name', required=True, help='User name')
-@click.option('--email', required=True, help='User email')
-@async_command
-async def create_user(name: str, email: str):
-    """
-    Example async command that uses an interactor.
-
-    This demonstrates how to use async/await with Click commands
-    to execute interactors and other async operations.
-
-    Usage:
-        python main.py create-user --name="John Doe" --email="john@example.com"
-    """
-    # Import your interactor
-    # from domain.interactors.create_user import CreateUser
-    # user = await CreateUser(name=name, email=email)
-    # click.echo(f"Created user: {user.id} - {user.name}")
-
-    # Placeholder implementation
-    click.echo(f"Creating user: {name} ({email})")
-    click.echo("Note: Replace this with your actual CreateUser interactor")
-
-
-# Uncomment this block if you enable FastAPI support
-# @cli.command()
-# @click.option('--host', default='0.0.0.0', help='Host to bind')
-# @click.option('--port', default=8000, help='Port to bind')
-# @click.option('--reload', is_flag=True, help='Enable auto-reload')
-# def web(host: str, port: int, reload: bool):
-#     """Start FastAPI web server"""
-#     import uvicorn
-#     from presentation.web.main import app
-#
-#     click.echo(f"Starting web server on http://{host}:{port}")
-#     uvicorn.run(
-#         app,
-#         host=host,
-#         port=port,
-#         reload=reload,
-#     )
-
-
-# Auto-register custom commands from presentation/cli/commands/
-try:
-    from presentation.cli.commands import get_commands
-    for cmd in get_commands():
-        cli.add_command(cmd)
-except ImportError:
-    # cli/commands/ not created yet
-    pass
-
-
-if __name__ == "__main__":
-    cli()