vibetuner 2.32.0__tar.gz

vibetuner-2.32.0/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.3
+Name: vibetuner
+Version: 2.32.0
+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.1
+Requires-Dist: click>=8.3.1
+Requires-Dist: copier>=9.11.0,<9.11.1
+Requires-Dist: email-validator>=2.3.0
+Requires-Dist: fastapi[standard-no-fastapi-cloud-cli]>=0.122.0
+Requires-Dist: granian[pname]>=2.6.0
+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.4
+Requires-Dist: pydantic-extra-types[pycountry]>=2.10.6
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: redis[hiredis]>=7.1.0
+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.83.1 ; extra == 'dev'
+Requires-Dist: granian[pname,reload]>=2.6.0 ; extra == 'dev'
+Requires-Dist: just-bin>=1.43.1 ; extra == 'dev'
+Requires-Dist: prek>=0.2.19 ; extra == 'dev'
+Requires-Dist: pysemver>=0.5.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.14.6 ; extra == 'dev'
+Requires-Dist: rumdl>=0.0.182 ; extra == 'dev'
+Requires-Dist: semver>=3.0.4 ; extra == 'dev'
+Requires-Dist: taplo>=0.9.3 ; extra == 'dev'
+Requires-Dist: ty>=0.0.1a28 ; 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-Dist: pytest>=9.0.1 ; extra == 'test'
+Requires-Dist: pytest-asyncio>=1.3.0 ; extra == 'test'
+Requires-Python: >=3.11
+Project-URL: Changelog, https://github.com/alltuner/vibetuner/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://vibetuner.alltuner.com/
+Project-URL: Homepage, https://vibetuner.alltuner.com/
+Project-URL: Issues, https://github.com/alltuner/vibetuner/issues
+Project-URL: Repository, https://github.com/alltuner/vibetuner
+Provides-Extra: dev
+Provides-Extra: test
+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
+- **Babel**: i18n message extraction
+- **pre-commit**: Git hooks (prek is a fast pre-commit drop-in replacement)
+- **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://vibetuner.alltuner.com/)**
+
+## 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://vibetuner.alltuner.com/>
+- **Issues**: <https://github.com/alltuner/vibetuner/issues>
+- **PyPI**: <https://pypi.org/project/vibetuner/>
+- **npm Package**: <https://www.npmjs.com/package/@alltuner/vibetuner>

vibetuner-2.32.0/README.md

@@ -0,0 +1,172 @@
+# 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
+- **Babel**: i18n message extraction
+- **pre-commit**: Git hooks (prek is a fast pre-commit drop-in replacement)
+- **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://vibetuner.alltuner.com/)**
+
+## 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://vibetuner.alltuner.com/>
+- **Issues**: <https://github.com/alltuner/vibetuner/issues>
+- **PyPI**: <https://pypi.org/project/vibetuner/>
+- **npm Package**: <https://www.npmjs.com/package/@alltuner/vibetuner>

vibetuner-2.32.0/pyproject.toml

@@ -0,0 +1,96 @@
+[project]
+name = "vibetuner"
+description = "Core Python framework and blessed dependencies for production-ready FastAPI + MongoDB + HTMX projects"
+version = "2.32.0"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "All Tuner Labs, S.L." }]
+keywords = ["fastapi", "mongodb", "htmx", "web-framework", "scaffolding", "oauth", "background-jobs"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Framework :: FastAPI",
+  "Topic :: Internet :: WWW/HTTP :: WSGI :: Application",
+  "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+  # These are the base dependencies of AllTuner's blessed stack
+  "aioboto3>=15.5.0",
+  "arel>=0.4.0",
+  "asyncer>=0.0.10",
+  "authlib>=1.6.5",
+  "beanie[zstd]>=2.0.1",
+  "click>=8.3.1",
+  "copier>=9.11.0,<9.11.1",
+  "email-validator>=2.3.0",
+  "fastapi[standard-no-fastapi-cloud-cli]>=0.122.0",
+  "granian[pname]>=2.6.0",
+  "httpx[http2]>=0.28.1",
+  "itsdangerous>=2.2.0",
+  "loguru>=0.7.3",
+  "pydantic[email]>=2.12.4",
+  "pydantic-extra-types[pycountry]>=2.10.6",
+  "pydantic-settings>=2.12.0",
+  "pyyaml>=6.0.3",
+  "redis[hiredis]>=7.1.0",
+  "rich>=14.2.0",
+  "sse-starlette>=3.0.3",
+  "starlette-babel>=1.0.3",
+  "starlette-htmx>=0.1.1",
+  "streaq[web]<6.0.0",
+  "typer-slim[standard]>=0.20.0",
+]
+
+[project.scripts]
+vibetuner = "vibetuner.cli:app"
+
+[project.urls]
+Homepage = "https://vibetuner.alltuner.com/"
+Documentation = "https://vibetuner.alltuner.com/"
+Repository = "https://github.com/alltuner/vibetuner"
+Issues = "https://github.com/alltuner/vibetuner/issues"
+Changelog = "https://github.com/alltuner/vibetuner/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = [
+  # These are the development dependencies of AllTuner's blessed stack
+  "babel>=2.17.0",
+  "cloudflare>=4.3.1",
+  "djlint>=1.36.4",
+  "dunamai>=1.25.0",
+  "gh-bin>=2.83.1",
+  "granian[pname,reload]>=2.6.0",
+  "just-bin>=1.43.1",
+  "prek>=0.2.19",
+  "pysemver>=0.5.0",
+  "ruff>=0.14.6",
+  "rumdl>=0.0.182",
+  "semver>=3.0.4",
+  "taplo>=0.9.3",
+  "ty>=0.0.1a28",
+  "types-aioboto3[s3,ses]>=15.5.0",
+  "types-authlib>=1.6.5.20251005",
+  "types-pyyaml>=6.0.12.20250915",
+  "uv-bump>=0.3.1",
+]
+test = [
+  # Testing dependencies
+  "pytest>=9.0.1",
+  "pytest-asyncio>=1.3.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.9,<0.10"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+# Exclude development documentation files from the built package
+# These files are for repository contributors, not end users
+wheel-exclude = ["**/AGENTS.md", "**/CLAUDE.md"]

vibetuner-2.32.0/src/vibetuner/__init__.py

@@ -0,0 +1,2 @@
+# Your code goes here (add your code between this line and the EOF comment)
+# End of file

vibetuner-2.32.0/src/vibetuner/__main__.py

@@ -0,0 +1,4 @@
+from .cli import app
+
+
+app()

vibetuner-2.32.0/src/vibetuner/cli/__init__.py

@@ -0,0 +1,124 @@
+# ABOUTME: Core CLI setup with AsyncTyper wrapper and base configuration
+# ABOUTME: Provides main CLI entry point and logging configuration
+import importlib.metadata
+import inspect
+from functools import partial, wraps
+from importlib import import_module
+
+import asyncer
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from vibetuner.cli.run import run_app
+from vibetuner.cli.scaffold import scaffold_app
+from vibetuner.logging import LogLevel, logger, setup_logging
+
+
+console = Console()
+
+
+class AsyncTyper(typer.Typer):
+    def __init__(self, *args, **kwargs):
+        kwargs.setdefault("no_args_is_help", True)
+        super().__init__(*args, **kwargs)
+
+    @staticmethod
+    def maybe_run_async(decorator, f):
+        if inspect.iscoroutinefunction(f):
+
+            @wraps(f)
+            def runner(*args, **kwargs):
+                return asyncer.runnify(f)(*args, **kwargs)
+
+            decorator(runner)
+        else:
+            decorator(f)
+        return f
+
+    def callback(self, *args, **kwargs):
+        decorator = super().callback(*args, **kwargs)
+        return partial(self.maybe_run_async, decorator)
+
+    def command(self, *args, **kwargs):
+        decorator = super().command(*args, **kwargs)
+        return partial(self.maybe_run_async, decorator)
+
+
+def _get_app_help():
+    try:
+        from vibetuner.config import settings
+
+        return f"{settings.project.project_name.title()} CLI"
+    except (RuntimeError, ImportError):
+        return "Vibetuner CLI"
+
+
+app = AsyncTyper(help=_get_app_help())
+
+LOG_LEVEL_OPTION = typer.Option(
+    LogLevel.INFO,
+    "--log-level",
+    "-l",
+    case_sensitive=False,
+    help="Set the logging level",
+)
+
+
+@app.callback()
+def callback(log_level: LogLevel | None = LOG_LEVEL_OPTION) -> None:
+    """Initialize logging and other global settings."""
+    setup_logging(level=log_level)
+
+
+@app.command()
+def version(
+    show_app: bool = typer.Option(
+        False,
+        "--app",
+        "-a",
+        help="Show app settings version even if not in a project directory",
+    ),
+) -> None:
+    """Show version information."""
+    try:
+        # Get vibetuner package version
+        vibetuner_version = importlib.metadata.version("vibetuner")
+    except importlib.metadata.PackageNotFoundError:
+        vibetuner_version = "unknown"
+
+    # Create table for nice display
+    table = Table(title="Version Information")
+    table.add_column("Component", style="cyan", no_wrap=True)
+    table.add_column("Version", style="green", no_wrap=True)
+
+    # Always show vibetuner package version
+    table.add_row("vibetuner package", vibetuner_version)
+
+    # Show app version if requested or if in a project
+    try:
+        from vibetuner.config import CoreConfiguration
+
+        settings = CoreConfiguration()
+        table.add_row(f"{settings.project.project_name} settings", settings.version)
+    except Exception:
+        if show_app:
+            table.add_row("app settings", "not in project directory")
+        # else: don't show app version if not in project and not requested
+
+    console.print(table)
+
+
+app.add_typer(run_app, name="run")
+app.add_typer(scaffold_app, name="scaffold")
+
+try:
+    import_module("app.cli")
+except ModuleNotFoundError:
+    # Silent pass for missing app.cli module (expected in some projects)
+    pass
+except ImportError as e:
+    # Log warning for any import error (including syntax errors, missing dependencies, etc.)
+    logger.warning(
+        f"Failed to import app.cli: {e}. User CLI commands will not be available."
+    )