vibetuner 2.8.3__py3-none-any.whl → 2.9.1__py3-none-any.whl

vibetuner/cli/__init__.py

@@ -9,6 +9,7 @@ import typer
 from rich.console import Console
 
 from vibetuner.cli.run import run_app
+from vibetuner.cli.scaffold import scaffold_app
 from vibetuner.config import settings
 from vibetuner.logging import LogLevel, setup_logging
 
@@ -61,6 +62,7 @@ def callback(log_level: LogLevel | None = LOG_LEVEL_OPTION) -> None:
 
 
 app.add_typer(run_app, name="run")
+app.add_typer(scaffold_app, name="scaffold")
 
 try:
     import_module("app.cli")

vibetuner/cli/scaffold.py

@@ -0,0 +1,189 @@
+# ABOUTME: Scaffolding commands for creating new projects from the vibetuner template
+# ABOUTME: Uses Copier to generate FastAPI+MongoDB+HTMX projects with interactive prompts
+from pathlib import Path
+from typing import Annotated
+
+import copier
+import typer
+from rich.console import Console
+
+
+console = Console()
+
+scaffold_app = typer.Typer(
+    help="Create new projects from the vibetuner template", no_args_is_help=True
+)
+
+
+def get_template_path() -> Path:
+    """Get the path to the vibetuner template directory."""
+    # This file is at: vibetuner-py/src/vibetuner/cli/scaffold.py
+    # Template is at: ./ (root of repo)
+    current_file = Path(__file__).resolve()
+    # Go up: scaffold.py -> cli -> vibetuner -> src -> vibetuner-py -> repo_root
+    template_path = current_file.parent.parent.parent.parent.parent
+    return template_path
+
+
+@scaffold_app.command(name="new")
+def new(
+    destination: Annotated[
+        Path,
+        typer.Argument(
+            help="Destination directory for the new project",
+            exists=False,
+        ),
+    ],
+    template: Annotated[
+        str | None,
+        typer.Option(
+            "--template",
+            "-t",
+            help="Template source (git URL, local path, or github:user/repo). Defaults to local vibetuner template.",
+        ),
+    ] = None,
+    defaults: Annotated[
+        bool,
+        typer.Option(
+            "--defaults",
+            "-d",
+            help="Use default values for all prompts (non-interactive mode)",
+        ),
+    ] = False,
+    data: Annotated[
+        list[str] | None,
+        typer.Option(
+            "--data",
+            help="Override template variables in key=value format (can be used multiple times)",
+        ),
+    ] = None,
+) -> None:
+    """Create a new project from the vibetuner template.
+
+    Examples:
+
+        # Interactive mode (prompts for all values)
+        vibetuner scaffold new my-project
+
+        # Use defaults for all prompts
+        vibetuner scaffold new my-project --defaults
+
+        # Override specific values
+        vibetuner scaffold new my-project --data project_name="My App" --data python_version="3.13"
+
+        # Use a different template source
+        vibetuner scaffold new my-project --template gh:alltuner/vibetuner
+        vibetuner scaffold new my-project --template /path/to/template
+    """
+    # Determine template source
+    if template is None:
+        template_src = get_template_path()
+        console.print(f"[dim]Using local template: {template_src}[/dim]")
+    else:
+        template_src = template
+        console.print(f"[dim]Using template: {template_src}[/dim]")
+
+    # Parse data overrides
+    data_dict = {}
+    if data:
+        for item in data:
+            if "=" not in item:
+                console.print(f"[red]Error: Invalid data format '{item}'. Expected key=value[/red]")
+                raise typer.Exit(code=1)
+            key, value = item.split("=", 1)
+            data_dict[key] = value
+
+    # When using defaults, provide sensible default values for required fields
+    if defaults:
+        default_values = {
+            "company_name": "Acme Corp",
+            "author_name": "Developer",
+            "author_email": "dev@example.com",
+            "supported_languages": [],
+        }
+        # Merge: user overrides take precedence over defaults
+        data_dict = {**default_values, **data_dict}
+
+    # Run copier
+    try:
+        console.print(f"\n[green]Creating new project in: {destination}[/green]\n")
+
+        copier.run_copy(
+            src_path=str(template_src),
+            dst_path=destination,
+            data=data_dict if data_dict else None,
+            defaults=defaults,
+            quiet=defaults,  # Suppress prompts when using defaults
+            unsafe=True,  # Allow running post-generation tasks
+        )
+
+        console.print(f"\n[green]✓ Project created successfully![/green]")
+        console.print(f"\nNext steps:")
+        console.print(f"  cd {destination}")
+        console.print(f"  just dev")
+
+    except Exception as e:
+        console.print(f"[red]Error creating project: {e}[/red]")
+        raise typer.Exit(code=1)
+
+
+@scaffold_app.command(name="update")
+def update(
+    path: Annotated[
+        Path,
+        typer.Argument(
+            help="Path to the project to update",
+        ),
+    ] = Path.cwd(),
+    skip_answered: Annotated[
+        bool,
+        typer.Option(
+            "--skip-answered",
+            "-s",
+            help="Skip questions that have already been answered",
+        ),
+    ] = True,
+) -> None:
+    """Update an existing project to the latest template version.
+
+    This will update the project's files to match the latest template version,
+    while preserving your answers to the original questions.
+
+    Examples:
+
+        # Update current directory
+        vibetuner scaffold update
+
+        # Update specific directory
+        vibetuner scaffold update /path/to/project
+
+        # Re-prompt for all questions
+        vibetuner scaffold update --no-skip-answered
+    """
+    if not path.exists():
+        console.print(f"[red]Error: Directory does not exist: {path}[/red]")
+        raise typer.Exit(code=1)
+
+    # Check if it's a copier project
+    answers_file = path / ".copier-answers.yml"
+    if not answers_file.exists():
+        console.print(
+            f"[red]Error: Not a copier project (missing .copier-answers.yml)[/red]"
+        )
+        console.print(f"[yellow]Directory: {path}[/yellow]")
+        raise typer.Exit(code=1)
+
+    try:
+        console.print(f"\n[green]Updating project: {path}[/green]\n")
+
+        copier.run_update(
+            dst_path=path,
+            skip_answered=skip_answered,
+            unsafe=True,  # Allow running post-generation tasks
+        )
+
+        console.print(f"\n[green]✓ Project updated successfully![/green]")
+
+    except Exception as e:
+        console.print(f"[red]Error updating project: {e}[/red]")
+        raise typer.Exit(code=1)

vibetuner-2.9.1.dist-info/METADATA

@@ -0,0 +1,236 @@
+Metadata-Version: 2.3
+Name: vibetuner
+Version: 2.9.1
+Summary: Core Python framework and blessed dependencies for production-ready FastAPI + MongoDB + HTMX projects
+Keywords: fastapi,mongodb,htmx,web-framework,scaffolding,oauth,background-jobs
+Author: All Tuner Labs, S.L.
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Framework :: FastAPI
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Dist: aioboto3>=15.5.0
+Requires-Dist: arel>=0.4.0
+Requires-Dist: asyncer>=0.0.10
+Requires-Dist: authlib>=1.6.5
+Requires-Dist: beanie[zstd]>=2.0.0
+Requires-Dist: click>=8.3.0
+Requires-Dist: copier>=9.9.0,<9.9.1
+Requires-Dist: email-validator>=2.3.0
+Requires-Dist: fastapi[standard-no-fastapi-cloud-cli]>=0.121.0
+Requires-Dist: granian[pname]>=2.5.6
+Requires-Dist: httpx[http2]>=0.28.1
+Requires-Dist: itsdangerous>=2.2.0
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic[email]>=2.12.3
+Requires-Dist: pydantic-extra-types[pycountry]>=2.10.6
+Requires-Dist: pydantic-settings>=2.11.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: redis[hiredis]>=7.0.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: sse-starlette>=3.0.3
+Requires-Dist: starlette-babel>=1.0.3
+Requires-Dist: starlette-htmx>=0.1.1
+Requires-Dist: streaq[web]<6.0.0
+Requires-Dist: typer-slim[standard]>=0.20.0
+Requires-Dist: babel>=2.17.0 ; extra == 'dev'
+Requires-Dist: cloudflare>=4.3.1 ; extra == 'dev'
+Requires-Dist: djlint>=1.36.4 ; extra == 'dev'
+Requires-Dist: dunamai>=1.25.0 ; extra == 'dev'
+Requires-Dist: gh-bin>=2.81.0 ; extra == 'dev'
+Requires-Dist: granian[pname,reload]>=2.5.6 ; extra == 'dev'
+Requires-Dist: just-bin>=1.43.0 ; extra == 'dev'
+Requires-Dist: pre-commit>=4.3.0 ; extra == 'dev'
+Requires-Dist: pysemver>=0.5.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.14.3 ; extra == 'dev'
+Requires-Dist: rumdl>=0.0.171 ; extra == 'dev'
+Requires-Dist: semver>=3.0.4 ; extra == 'dev'
+Requires-Dist: taplo>=0.9.3 ; extra == 'dev'
+Requires-Dist: ty>=0.0.1a25 ; extra == 'dev'
+Requires-Dist: types-aioboto3[s3,ses]>=15.5.0 ; extra == 'dev'
+Requires-Dist: types-authlib>=1.6.5.20251005 ; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12.20250915 ; extra == 'dev'
+Requires-Dist: uv-bump>=0.3.1 ; extra == 'dev'
+Requires-Python: >=3.11
+Project-URL: Documentation, https://github.com/alltuner/vibetuner#readme
+Project-URL: Homepage, https://github.com/alltuner/vibetuner
+Project-URL: Issues, https://github.com/alltuner/vibetuner/issues
+Project-URL: Repository, https://github.com/alltuner/vibetuner
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# vibetuner
+
+**Core Python framework and blessed dependencies for Vibetuner projects**
+
+This package provides the complete Python framework and curated dependency set for building modern web applications with Vibetuner. It includes everything from FastAPI and MongoDB integration to authentication, background jobs, and CLI tools.
+
+## What is Vibetuner?
+
+Vibetuner is a production-ready scaffolding tool for FastAPI + MongoDB + HTMX web applications. This package (`vibetuner`) is the Python component that provides:
+
+- Complete web application framework built on FastAPI
+- MongoDB integration with Beanie ODM
+- OAuth and magic link authentication out of the box
+- Background job processing with Redis + Streaq
+- CLI framework with Typer
+- Email services, blob storage, and more
+
+**This package is designed to be used within projects generated by the Vibetuner scaffolding tool.** For standalone use, you'll need to set up the project structure manually.
+
+## Installation
+
+```bash
+# In a Vibetuner-generated project (automatic)
+uv sync
+
+# Add to an existing project
+uv add vibetuner
+
+# With development dependencies
+uv add vibetuner[dev]
+```
+
+## Quick Start
+
+The recommended way to use Vibetuner is via the scaffolding tool:
+
+```bash
+# Create a new project with all the framework code
+uvx vibetuner scaffold new my-project
+cd my-project
+just dev
+```
+
+This will generate a complete project with:
+- Pre-configured FastAPI application
+- Authentication system (OAuth + magic links)
+- MongoDB models and configuration
+- Frontend templates and asset pipeline
+- Docker setup for development and production
+- CLI commands and background job infrastructure
+
+## What's Included
+
+### Core Framework (`src/vibetuner/`)
+
+- **`frontend/`**: FastAPI app, routes, middleware, auth
+- **`models/`**: User, OAuth, email verification, blob storage models
+- **`services/`**: Email (SES), blob storage (S3)
+- **`tasks/`**: Background job infrastructure
+- **`cli/`**: CLI framework with scaffold, run commands
+- **`config.py`**: Pydantic settings management
+- **`mongo.py`**: MongoDB/Beanie setup
+- **`logging.py`**: Structured logging configuration
+
+### Blessed Dependencies
+
+- **FastAPI** (0.121+): Modern, fast web framework
+- **Beanie**: Async MongoDB ODM with Pydantic
+- **Authlib**: OAuth 1.0/2.0 client
+- **Granian**: High-performance ASGI server
+- **Redis** + **Streaq**: Background task processing
+- **Typer**: CLI framework
+- **Rich**: Beautiful terminal output
+- **Loguru**: Structured logging
+- **Pydantic**: Data validation and settings
+
+See [pyproject.toml](./pyproject.toml) for the complete dependency list.
+
+## CLI Tools
+
+When installed, provides the `vibetuner` command:
+
+```bash
+# Create new project from template
+vibetuner scaffold new my-project
+vibetuner scaffold new my-project --defaults
+
+# Update existing project
+vibetuner scaffold update
+
+# Run development server (in generated projects)
+vibetuner run dev frontend
+vibetuner run dev worker
+
+# Run production server (in generated projects)
+vibetuner run prod frontend
+vibetuner run prod worker
+```
+
+## Development Dependencies
+
+The `[dev]` extra includes all tools needed for development:
+
+- **Ruff**: Fast linting and formatting
+- **djlint**: Template linting
+- **Babel**: i18n message extraction
+- **pre-commit**: Git hooks
+- **Type stubs**: For aioboto3, authlib, PyYAML
+- And more...
+
+## Usage in Generated Projects
+
+In a Vibetuner-generated project, import from `vibetuner`:
+
+```python
+# Use core models
+from vibetuner.models import UserModel, OAuthAccountModel
+
+# Use services
+from vibetuner.services.email import send_email
+
+# Use configuration
+from vibetuner.config import settings
+
+# Extend core routes
+from vibetuner.frontend import app
+
+# Add your routes
+@app.get("/api/hello")
+async def hello():
+    return {"message": "Hello World"}
+```
+
+## Documentation
+
+For complete documentation, guides, and examples, see the main Vibetuner repository:
+
+**📖 [Vibetuner Documentation](https://github.com/alltuner/vibetuner#readme)**
+
+## Package Ecosystem
+
+Vibetuner consists of three packages that work together:
+
+1. **vibetuner** (this package): Python framework and dependencies
+2. **[@alltuner/vibetuner](https://www.npmjs.com/package/@alltuner/vibetuner)**: JavaScript/CSS build dependencies
+3. **Scaffolding template**: Copier template for project generation
+
+All three are version-locked and tested together to ensure compatibility.
+
+## Contributing
+
+Contributions welcome! See the main repository for contribution guidelines:
+
+**🤝 [Contributing to Vibetuner](https://github.com/alltuner/vibetuner/blob/main/CONTRIBUTING.md)**
+
+## License
+
+MIT License - Copyright (c) 2025 All Tuner Labs, S.L.
+
+See [LICENSE](https://github.com/alltuner/vibetuner/blob/main/LICENSE) for details.
+
+## Links
+
+- **Main Repository**: https://github.com/alltuner/vibetuner
+- **Documentation**: https://github.com/alltuner/vibetuner#readme
+- **Issues**: https://github.com/alltuner/vibetuner/issues
+- **PyPI**: https://pypi.org/project/vibetuner/
+- **npm Package**: https://www.npmjs.com/package/@alltuner/vibetuner

{vibetuner-2.8.3.dist-info → vibetuner-2.9.1.dist-info}/RECORD

@@ -1,7 +1,8 @@
 vibetuner/__init__.py,sha256=rFIVCmxkKTT_g477V8biCw0lgpudyuUabXhYxg189lY,90
 vibetuner/__main__.py,sha256=Ye9oBAgXhcYQ4I4yZli3TIXF5lWQ9yY4tTPs4XnDDUY,29
-vibetuner/cli/__init__.py,sha256=-DM7TxG9FJKCjTXpNNVSKwtl_Nn3TEg_2OYRJNsLObY,1741
+vibetuner/cli/__init__.py,sha256=bipsxcOO2uxLGq-7TYVZsEOiknY3M54Kjh2W4pUXPDg,1834
 vibetuner/cli/run.py,sha256=mHvZypizNfVwdLo7k8SvBO7HPUF4Vka9hjJlECZCGfA,5009
+vibetuner/cli/scaffold.py,sha256=Fm6QPEPB0KsRGOBJz_HbR6mnQxA11_KpRQOSw5hW7VM,5950
 vibetuner/config.py,sha256=R3u23RHv5gcVuU27WEo-8MrSZYbqSNbALJJKR3ACaQQ,3714
 vibetuner/context.py,sha256=VdgfX-SFmVwiwKPFID4ElIRnFADTlagqsh9RKXNiLCs,725
 vibetuner/frontend/AGENTS.md,sha256=mds0nTl3RBblTA7EFhC9dxx86mn1FH5ESXNSj_1R1Jk,3253
@@ -79,6 +80,7 @@ vibetuner/templates/markdown/CLAUDE.md,sha256=jcvoQNazCj-t54s0gr-4_qyxLMP8iPf2ur
 vibetuner/templates.py,sha256=xRoMb_oyAI5x4kxfpg56UcLKkT8e9HVn-o3KFAu9ISE,5094
 vibetuner/time.py,sha256=3_DtveCCzI20ocTnAlTh2u7FByUXtINaUoQZO-_uZow,1188
 vibetuner/versioning.py,sha256=UAHGoNsv3QEPAJgHyt_Q8I26SW7ng2FnZlX2-0M6r6U,156
-vibetuner-2.8.3.dist-info/WHEEL,sha256=5w2T7AS2mz1-rW9CNagNYWRCaB0iQqBMYLwKdlgiR4Q,78
-vibetuner-2.8.3.dist-info/METADATA,sha256=RT4aN5-l8lL4n_1ybXh5_yScbic1jSdnKp6HzWH2EUA,1956
-vibetuner-2.8.3.dist-info/RECORD,,
+vibetuner-2.9.1.dist-info/WHEEL,sha256=5w2T7AS2mz1-rW9CNagNYWRCaB0iQqBMYLwKdlgiR4Q,78
+vibetuner-2.9.1.dist-info/entry_points.txt,sha256=aKIj9YCCXizjYupx9PeWkUJePg3ncHke_LTS5rmCsfs,49
+vibetuner-2.9.1.dist-info/METADATA,sha256=EY8HWtayYDABK9eJqTO0-7OiWIDDPPN9iZEdRnsm9yI,8042
+vibetuner-2.9.1.dist-info/RECORD,,

vibetuner-2.9.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+vibetuner = vibetuner.cli:app
+

vibetuner-2.8.3.dist-info/METADATA

@@ -1,48 +0,0 @@
-Metadata-Version: 2.3
-Name: vibetuner
-Version: 2.8.3
-Summary: Blessed Python dependencies for Vibetuner projects
-Requires-Dist: aioboto3>=15.5.0
-Requires-Dist: arel>=0.4.0
-Requires-Dist: asyncer>=0.0.10
-Requires-Dist: authlib>=1.6.5
-Requires-Dist: beanie[zstd]>=2.0.0
-Requires-Dist: click>=8.3.0
-Requires-Dist: email-validator>=2.3.0
-Requires-Dist: fastapi[standard-no-fastapi-cloud-cli]>=0.121.0
-Requires-Dist: granian[pname]>=2.5.6
-Requires-Dist: httpx[http2]>=0.28.1
-Requires-Dist: itsdangerous>=2.2.0
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: pydantic[email]>=2.12.3
-Requires-Dist: pydantic-extra-types[pycountry]>=2.10.6
-Requires-Dist: pydantic-settings>=2.11.0
-Requires-Dist: pyyaml>=6.0.3
-Requires-Dist: redis[hiredis]>=7.0.1
-Requires-Dist: rich>=14.2.0
-Requires-Dist: sse-starlette>=3.0.3
-Requires-Dist: starlette-babel>=1.0.3
-Requires-Dist: starlette-htmx>=0.1.1
-Requires-Dist: streaq[web]<6.0.0
-Requires-Dist: typer-slim[standard]>=0.20.0
-Requires-Dist: babel>=2.17.0 ; extra == 'dev'
-Requires-Dist: cloudflare>=4.3.1 ; extra == 'dev'
-Requires-Dist: copier>=9.9.0,<9.9.1 ; extra == 'dev'
-Requires-Dist: djlint>=1.36.4 ; extra == 'dev'
-Requires-Dist: dunamai>=1.25.0 ; extra == 'dev'
-Requires-Dist: gh-bin>=2.81.0 ; extra == 'dev'
-Requires-Dist: granian[pname,reload]>=2.5.6 ; extra == 'dev'
-Requires-Dist: just-bin>=1.43.0 ; extra == 'dev'
-Requires-Dist: pre-commit>=4.3.0 ; extra == 'dev'
-Requires-Dist: pysemver>=0.5.0 ; extra == 'dev'
-Requires-Dist: ruff>=0.14.3 ; extra == 'dev'
-Requires-Dist: rumdl>=0.0.171 ; extra == 'dev'
-Requires-Dist: semver>=3.0.4 ; extra == 'dev'
-Requires-Dist: taplo>=0.9.3 ; extra == 'dev'
-Requires-Dist: ty>=0.0.1a25 ; extra == 'dev'
-Requires-Dist: types-aioboto3[s3,ses]>=15.5.0 ; extra == 'dev'
-Requires-Dist: types-authlib>=1.6.5.20251005 ; extra == 'dev'
-Requires-Dist: types-pyyaml>=6.0.12.20250915 ; extra == 'dev'
-Requires-Dist: uv-bump>=0.3.1 ; extra == 'dev'
-Requires-Python: >=3.11
-Provides-Extra: dev