vibetuner 2.26.6__py3-none-any.whl

vibetuner/templates/frontend/user/profile.html.jinja

@@ -0,0 +1,157 @@
+{% extends "base/skeleton.html.jinja" %}
+
+{% block title %}
+    {{ _("User Profile") }}
+{% endblock title %}
+{% block body %}
+    <div class="min-h-screen bg-gray-50">
+        <div class="container mx-auto px-4 py-8">
+            <div class="max-w-4xl mx-auto">
+                <!-- Page Header -->
+                <div class="mb-8">
+                    <h1 class="text-3xl font-bold text-gray-900">{{ _("User Profile") }}</h1>
+                    <p class="text-gray-600 mt-2">{{ _("Manage your account information and settings") }}</p>
+                </div>
+                <!-- Profile Card -->
+                <div class="bg-white shadow-lg rounded-lg overflow-hidden">
+                    <!-- Profile Header -->
+                    <div class="bg-gradient-to-r from-blue-500 to-indigo-600 px-6 py-8">
+                        <div class="flex items-center space-x-4">
+                            <!-- Avatar -->
+                            {% if user.picture or (user.oauth_accounts and user.oauth_accounts[0].picture) %}
+                                <img src="{{ user.picture or user.oauth_accounts[0].picture }}"
+                                     alt="{{ user.email }}"
+                                     width="80"
+                                     height="80"
+                                     class="w-20 h-20 rounded-full object-cover border-4 border-white shadow-lg" />
+                            {% else %}
+                                <div class="w-20 h-20 bg-white rounded-full flex items-center justify-center text-3xl font-bold text-gray-700 shadow-lg">
+                                    {{ user.email[0].upper() if user.email }}
+                                </div>
+                            {% endif %}
+                            <!-- User Info -->
+                            <div class="text-white">
+                                <h2 class="text-2xl font-semibold">{{ user.email }}</h2>
+                                <p class="text-blue-100">{{ _("Member since") }} {{ user.db_insert_dt | timeago }}</p>
+                            </div>
+                        </div>
+                    </div>
+                    <!-- Profile Content -->
+                    <div class="p-6">
+                        <!-- Account Information Section -->
+                        <div class="mb-8">
+                            <h3 class="text-xl font-semibold text-gray-800 mb-4">{{ _("Account Information") }}</h3>
+                            <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+                                <!-- Email -->
+                                <div>
+                                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ _("Email Address") }}</label>
+                                    <div class="bg-gray-50 px-4 py-3 rounded-md">
+                                        <p class="text-gray-900">{{ user.email }}</p>
+                                    </div>
+                                </div>
+                                <!-- User ID -->
+                                <div>
+                                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ _("User ID") }}</label>
+                                    <div class="bg-gray-50 px-4 py-3 rounded-md">
+                                        <p class="text-gray-900 font-mono text-sm">{{ user.id }}</p>
+                                    </div>
+                                </div>
+                                <!-- Created Date -->
+                                <div>
+                                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ _("Account Created") }}</label>
+                                    <div class="bg-gray-50 px-4 py-3 rounded-md">
+                                        <p class="text-gray-900">{{ user.db_insert_dt | format_datetime }}</p>
+                                    </div>
+                                </div>
+                                <!-- Last Updated -->
+                                <div>
+                                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ _("Last Updated") }}</label>
+                                    <div class="bg-gray-50 px-4 py-3 rounded-md">
+                                        <p class="text-gray-900">{{ user.db_update_dt | format_datetime }}</p>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                        <!-- OAuth Accounts Section -->
+                        {% if user.oauth_accounts %}
+                            <div class="mb-8">
+                                <h3 class="text-xl font-semibold text-gray-800 mb-4">{{ _("Connected Accounts") }}</h3>
+                                <div class="space-y-3">
+                                    {% for account in user.oauth_accounts %}
+                                        <div class="flex items-center justify-between bg-gray-50 px-4 py-3 rounded-md">
+                                            <div class="flex items-center space-x-3">
+                                                {% if account.picture %}
+                                                    <img src="{{ account.picture }}"
+                                                         alt="{{ account.provider }}"
+                                                         width="40"
+                                                         height="40"
+                                                         class="w-10 h-10 rounded-full object-cover" />
+                                                {% else %}
+                                                    <div class="w-10 h-10 bg-gray-200 rounded-full flex items-center justify-center">
+                                                        <span class="text-gray-600 font-medium">{{ account.provider[0].upper() }}</span>
+                                                    </div>
+                                                {% endif %}
+                                                <div>
+                                                    <p class="font-medium text-gray-900">{{ account.provider|title }}</p>
+                                                    <p class="text-sm text-gray-600">{{ account.email or _("No email") }}</p>
+                                                </div>
+                                            </div>
+                                            <span class="text-sm text-green-600 font-medium">{{ _("Connected") }}</span>
+                                        </div>
+                                    {% endfor %}
+                                </div>
+                            </div>
+                        {% endif %}
+                        <!-- Actions -->
+                        <div class="border-t pt-6">
+                            <div class="flex flex-col sm:flex-row gap-4">
+                                <button class="btn btn-primary"
+                                        hx-get="/user/edit"
+                                        hx-target="#main-content"
+                                        hx-swap="innerHTML">{{ _("Edit Profile") }}</button>
+                                <a href="{{ url_for('auth_logout') }}" class="btn btn-outline btn-error">{{ _("Sign Out") }}</a>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <!-- Additional Settings Card -->
+                <div class="mt-6 bg-white shadow-lg rounded-lg p-6">
+                    <h3 class="text-xl font-semibold text-gray-800 mb-4">{{ _("Account Settings") }}</h3>
+                    <div class="space-y-4">
+                        <!-- Language Setting -->
+                        <div class="flex items-center justify-between">
+                            <div>
+                                <p class="font-medium text-gray-900">{{ _("Preferred Language") }}</p>
+                                <p class="text-sm text-gray-600">{{ _("Your preferred language for the interface") }}</p>
+                            </div>
+                            <div class="text-gray-900">
+                                {% if user.user_settings.language %}
+                                    <span class="badge badge-primary">{{ user.user_settings.language|upper }}</span>
+                                {% else %}
+                                    <span class="text-gray-500">{{ _("Not set") }}</span>
+                                {% endif %}
+                            </div>
+                        </div>
+                        <!-- Additional settings can be added here as the UserSettings model is extended -->
+                        <!-- Email Notifications -->
+                        <div class="flex items-center justify-between">
+                            <div>
+                                <p class="font-medium text-gray-900">{{ _("Email Notifications") }}</p>
+                                <p class="text-sm text-gray-600">{{ _("Receive updates about your account") }}</p>
+                            </div>
+                            <input type="checkbox" class="toggle toggle-primary" checked />
+                        </div>
+                        <!-- Privacy Settings -->
+                        <div class="flex items-center justify-between">
+                            <div>
+                                <p class="font-medium text-gray-900">{{ _("Profile Visibility") }}</p>
+                                <p class="text-sm text-gray-600">{{ _("Make your profile visible to others") }}</p>
+                            </div>
+                            <input type="checkbox" class="toggle toggle-primary" />
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+{% endblock body %}

vibetuner/templates.py

@@ -0,0 +1,146 @@
+from pathlib import Path
+from typing import Any, Dict, Optional
+
+from jinja2 import Environment, FileSystemLoader, TemplateNotFound
+
+from . import paths
+
+
+def _get_base_paths_for_namespace(
+    namespace: str | None,
+    template_path: Path | list[Path] | None,
+) -> list[Path]:
+    """Get base template paths based on namespace and template_path."""
+    if template_path is not None:
+        return [template_path] if isinstance(template_path, Path) else template_path
+
+    # Map known namespaces to their predefined paths
+    if namespace == "email":
+        return paths.email_templates
+    if namespace == "markdown":
+        return paths.markdown_templates
+    if namespace == "frontend":
+        return paths.frontend_templates
+
+    # Default for unknown or None namespace
+    # Only include app_templates if project root has been set
+    path_list = []
+    if paths.app_templates is not None:
+        path_list.append(paths.app_templates)
+    path_list.append(paths.core_templates)
+    return path_list
+
+
+def _build_search_paths(
+    base_paths: list[Path],
+    namespace: str | None,
+    template_path: Path | list[Path] | None,
+) -> list[Path]:
+    """Build list of directories to search for templates."""
+    search_paths: list[Path] = []
+    known_namespaces = ("email", "markdown", "frontend")
+
+    for base_path in base_paths:
+        # If namespace is known and we're using default paths, they already include it
+        if namespace in known_namespaces and template_path is None:
+            if base_path.is_dir():
+                search_paths.append(base_path)
+        elif namespace:
+            # Append namespace to path for custom namespaces or explicit paths
+            ns_path = base_path / namespace
+            if ns_path.is_dir():
+                search_paths.append(ns_path)
+        else:
+            if base_path.is_dir():
+                search_paths.append(base_path)
+
+    return search_paths
+
+
+def _render_template_with_env(
+    env: Environment,
+    jinja_template_name: str,
+    lang: str | None,
+    context: dict[str, Any],
+) -> str:
+    """Render template using Jinja environment with language fallback."""
+    # Try language-specific folder first
+    if lang:
+        try:
+            template = env.get_template(f"{lang}/{jinja_template_name}")
+            return template.render(**context)
+        except TemplateNotFound:
+            pass
+
+    # Fallback to default folder
+    template = env.get_template(f"default/{jinja_template_name}")
+    return template.render(**context)
+
+
+def render_static_template(
+    template_name: str,
+    *,
+    template_path: Path | list[Path] | None = None,
+    namespace: Optional[str] = None,
+    context: Optional[Dict[str, Any]] = None,
+    lang: Optional[str] = None,
+) -> str:
+    """Render a Jinja template with optional i18n and namespace support.
+
+    This simplified functional helper replaces the old ``TemplateRenderer``
+    class while adding **namespace** awareness:
+
+    1. Optionally switch to *template_path / namespace* if that directory
+       exists, letting you segment templates per tenant, brand, or feature
+       module without changing call‑sites.
+    2. Within the selected base directory attempt ``<lang>/<name>.jinja``
+       when *lang* is provided.
+    3. Fallback to ``default/<name>.jinja``.
+
+    Args:
+        template_name: Base filename without extension (e.g. ``"invoice"``).
+        template_path: Root directory or list of directories containing template
+            collections. When a list is provided, searches in order (project templates
+            override package templates). Defaults to the package's bundled templates.
+        namespace: Optional subfolder under *template_path* to confine the
+            lookup. Ignored when the directory does not exist.
+        context: Variables passed to the template while rendering.
+        lang: Language code such as ``"en"`` or ``"es"`` for localized
+            templates.
+
+    Returns:
+        The rendered template as a string.
+
+    Raises:
+        TemplateNotFound: When no suitable template could be located after all
+            fallbacks.
+    """
+
+    context = context or {}
+
+    # Determine base paths from namespace and template_path
+    base_paths = _get_base_paths_for_namespace(namespace, template_path)
+
+    # Build search paths from base paths
+    search_paths = _build_search_paths(base_paths, namespace, template_path)
+
+    if not search_paths:
+        raise TemplateNotFound(
+            f"No valid template paths found for namespace '{namespace}'"
+        )
+
+    # Create Jinja environment with search paths
+    env = Environment(  # noqa: S701
+        loader=FileSystemLoader(search_paths),
+        trim_blocks=True,
+        lstrip_blocks=True,
+    )
+
+    # Render template with language fallback
+    jinja_template_name = f"{template_name}.jinja"
+    try:
+        return _render_template_with_env(env, jinja_template_name, lang, context)
+    except TemplateNotFound as err:
+        raise TemplateNotFound(
+            f"Template '{jinja_template_name}' not found under '{search_paths}'."
+        ) from err

vibetuner/time.py

@@ -0,0 +1,57 @@
+from datetime import (
+    UTC,
+    datetime,
+    timedelta,
+)
+from enum import StrEnum, auto
+
+
+class Unit(StrEnum):
+    """Return units for `.age_in()`."""
+
+    SECONDS = auto()
+    MINUTES = auto()
+    HOURS = auto()
+    DAYS = auto()
+    WEEKS = auto()
+
+    @property
+    def factor(self) -> int:
+        return {
+            Unit.SECONDS: 1,
+            Unit.MINUTES: 60,
+            Unit.HOURS: 3_600,
+            Unit.DAYS: 86_400,
+            Unit.WEEKS: 604_800,
+        }[self]
+
+
+def now() -> datetime:
+    return datetime.now(UTC)
+
+
+def age_in_days(dt: datetime) -> int:
+    # Ensure dt is timezone-aware, if it isn't already
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=UTC)
+
+    return int((now() - dt).total_seconds() / 60 / 60 / 24)
+
+
+def age_in_minutes(dt: datetime) -> int:
+    # Ensure dt is timezone-aware, if it isn't already
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=UTC)
+
+    return int((now() - dt).total_seconds() / 60)
+
+
+def age_in_timedelta(dt: datetime) -> timedelta:
+    # Ensure dt is timezone-aware, if it isn't already
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=UTC)
+
+    return now() - dt
+
+
+# Custom functions below

vibetuner/versioning.py

@@ -0,0 +1,12 @@
+from vibetuner.logging import logger
+
+
+__version__ = "0.0.0-default"
+
+try:
+    from app._version import version as __version__  # type: ignore
+except (ImportError, ModuleNotFoundError) as e:
+    # Log warning for both ImportError and ModuleNotFoundError as requested
+    logger.warning(f"Failed to import app._version: {e}. Using default version.")
+
+version = __version__

vibetuner-2.26.6.dist-info/METADATA

@@ -0,0 +1,241 @@
+Metadata-Version: 2.3
+Name: vibetuner
+Version: 2.26.6
+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.1
+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.2
+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.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.83.0 ; extra == 'dev'
+Requires-Dist: granian[pname,reload]>=2.6.0 ; 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.5 ; extra == 'dev'
+Requires-Dist: rumdl>=0.0.176 ; 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>