vibetuner 2.8.0__tar.gz → 2.17.8__tar.gz

vibetuner-2.17.8/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.3
+Name: vibetuner
+Version: 2.17.8
+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.10.3,<9.10.4
+Requires-Dist: email-validator>=2.3.0
+Requires-Dist: fastapi[standard-no-fastapi-cloud-cli]>=0.121.1
+Requires-Dist: granian[pname]>=2.5.7
+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.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: dunamai>=1.25.0 ; extra == 'dev'
+Requires-Dist: gh-bin>=2.83.0 ; extra == 'dev'
+Requires-Dist: granian[pname,reload]>=2.5.7 ; extra == 'dev'
+Requires-Dist: just-bin>=1.43.0 ; extra == 'dev'
+Requires-Dist: pre-commit>=4.4.0 ; extra == 'dev'
+Requires-Dist: pysemver>=0.5.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.14.4 ; extra == 'dev'
+Requires-Dist: rumdl>=0.0.174 ; extra == 'dev'
+Requires-Dist: semver>=3.0.4 ; extra == 'dev'
+Requires-Dist: taplo>=0.9.3 ; extra == 'dev'
+Requires-Dist: ty>=0.0.1a26 ; 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: 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
+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
+- **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.17.8/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
+- **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.17.8/pyproject.toml

@@ -0,0 +1,85 @@
+[project]
+name = "vibetuner"
+description = "Core Python framework and blessed dependencies for production-ready FastAPI + MongoDB + HTMX projects"
+version = "2.17.8"
+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.0",
+  "click>=8.3.0",
+  "copier>=9.10.3,<9.10.4",
+  "email-validator>=2.3.0",
+  "fastapi[standard-no-fastapi-cloud-cli]>=0.121.1",
+  "granian[pname]>=2.5.7",
+  "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.0.1",
+  "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",
+  "dunamai>=1.25.0",
+  "gh-bin>=2.83.0",
+  "granian[pname,reload]>=2.5.7",
+  "just-bin>=1.43.0",
+  "pre-commit>=4.4.0",
+  "pysemver>=0.5.0",
+  "ruff>=0.14.4",
+  "rumdl>=0.0.174",
+  "semver>=3.0.4",
+  "taplo>=0.9.3",
+  "ty>=0.0.1a26",
+  "types-aioboto3[s3,ses]>=15.5.0",
+  "types-authlib>=1.6.5.20251005",
+  "types-pyyaml>=6.0.12.20250915",
+  "uv-bump>=0.3.1",
+]
+
+[build-system]
+requires = ["uv_build>=0.9,<0.10"]
+build-backend = "uv_build"

{vibetuner-2.8.0 → vibetuner-2.17.8}/src/vibetuner/cli/__init__.py

@@ -9,7 +9,7 @@ import typer
 from rich.console import Console
 
 from vibetuner.cli.run import run_app
-from vibetuner.config import settings
+from vibetuner.cli.scaffold import scaffold_app
 from vibetuner.logging import LogLevel, setup_logging
 
 
@@ -43,7 +43,16 @@ class AsyncTyper(typer.Typer):
         return partial(self.maybe_run_async, decorator)
 
 
-app = AsyncTyper(help=f"{settings.project.project_name.title()} CLI")
+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,
@@ -61,8 +70,10 @@ 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")
 except (ImportError, ModuleNotFoundError):
     pass
+# Cache buster

{vibetuner-2.8.0 → vibetuner-2.17.8}/src/vibetuner/cli/run.py

@@ -70,7 +70,6 @@ def dev(
 
         # Define paths to watch for changes
         reload_paths = [
-            Path("src/vibetuner"),
             Path("src/app"),
             Path("templates/frontend"),
             Path("templates/email"),