vibetuner 2.6.1__py3-none-any.whl → 2.7.0__py3-none-any.whl

vibetuner/templates/frontend/login.html.jinja

@@ -0,0 +1,84 @@
+{% extends "base/skeleton.html.jinja" %}
+{% block title %}
+    {{ _("Sign In") }}
+{% endblock title %}
+{% block body %}
+    <div class="min-h-screen bg-gradient-to-br from-primary to-secondary flex items-center justify-center p-4">
+        <div class="card w-full max-w-md bg-base-100 shadow-2xl backdrop-blur-sm bg-opacity-95">
+            <div class="card-body">
+                <!-- Header -->
+                <div class="text-center mb-8">
+                    <h1 class="text-3xl font-bold text-base-content mb-2">{{ _("Welcome Back") }}</h1>
+                    <p class="text-base-content/70">{{ _("Choose your preferred sign-in method") }}</p>
+                </div>
+                <!-- OAuth Providers -->
+                {% if has_oauth and providers %}
+                    <div class="space-y-3 mb-6">
+                        {% for provider in providers %}
+                            <a href="{{ url_for('login_with_' + provider) }}{%- if next %}?next={{ next }}{%- endif %}"
+                               class="btn btn-outline btn-block justify-start gap-3 hover:btn-primary group transition-all duration-300 hover:scale-[1.02]">
+                                <span>{{ _("Continue with %(provider)s") | format(provider=provider.title()) }}</span>
+                            </a>
+                        {% endfor %}
+                    </div>
+                {% endif %}
+                <!-- Divider -->
+                {% if has_oauth and providers and has_email %}<div class="divider text-base-content/50">{{ _("OR") }}</div>{% endif %}
+                <!-- Email Magic Link -->
+                {% if has_email %}
+                    <div class="bg-base-200/50 rounded-2xl p-6 border border-base-300/50">
+                        <form method="post"
+                              class="space-y-4"
+                              action="{{ url_for("send_magic_link") }}">
+                            {% if next %}<input type="hidden" name="next" value="{{ next }}" />{% endif %}
+                            <div class="form-control">
+                                <label class="label" for="email">
+                                    <span class="label-text font-medium">{{ _("Email Address") }}</span>
+                                </label>
+                                <div class="relative">
+                                    <input type="email"
+                                           id="email"
+                                           name="email"
+                                           class="input input-bordered w-full pr-12 focus:input-primary transition-all duration-300"
+                                           placeholder="{{ _("Enter your email address") }}"
+                                           required
+                                           autocomplete="email" />
+                                    <div class="absolute inset-y-0 right-0 flex items-center pr-3">
+                                        <svg class="w-5 h-5 text-base-content/40"
+                                             fill="none"
+                                             stroke="currentColor"
+                                             viewBox="0 0 24 24">
+                                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 8l7.89 4.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" />
+                                        </svg>
+                                    </div>
+                                </div>
+                            </div>
+                            <button type="submit"
+                                    class="btn btn-primary btn-block gap-2 group hover:scale-[1.02] transition-all duration-300">
+                                <svg class="w-5 h-5 group-hover:rotate-12 transition-transform"
+                                     fill="none"
+                                     stroke="currentColor"
+                                     viewBox="0 0 24 24">
+                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z" />
+                                </svg>
+                                <span>{{ _("Send Magic Link") }}</span>
+                            </button>
+                            <div class="alert alert-info bg-info/10 border-info/20">
+                                <svg class="w-5 h-5 text-info shrink-0"
+                                     fill="none"
+                                     stroke="currentColor"
+                                     viewBox="0 0 24 24">
+                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+                                </svg>
+                                <div class="text-sm">
+                                    <p class="font-medium text-info">{{ _("No password required!") }}</p>
+                                    <p class="text-info/80">{{ _("We'll send you a secure link to sign in instantly.") }}</p>
+                                </div>
+                            </div>
+                        </form>
+                    </div>
+                {% endif %}
+            </div>
+        </div>
+    </div>
+{% endblock body %}

vibetuner/templates/frontend/meta/browserconfig.xml.jinja

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<browserconfig>
+    <msapplication>
+        <tile>
+            <square150x150logo
+                src="{{ url_for('favicons', path='mstile-150x150.png').path }}" />
+            <TileColor>#b91d47</TileColor>
+        </tile>
+    </msapplication>
+</browserconfig>

vibetuner/templates/frontend/meta/robots.txt.jinja

@@ -0,0 +1,3 @@
+User-agent: *
+Disallow: /auth
+Disallow: /user

vibetuner/templates/frontend/meta/site.webmanifest.jinja

@@ -0,0 +1,7 @@
+{
+"name": "{{ project_name }}",
+"short_name": "{{ project_slug }}",
+"theme_color": "#ffffff",
+"background_color": "#ffffff",
+"display": "standalone"
+}

vibetuner/templates/frontend/meta/sitemap.xml.jinja

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+    <url>
+        <loc>https://{{ fqdn }}/</loc>
+    </url>
+</urlset>

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

@@ -0,0 +1,85 @@
+{% extends "base/skeleton.html.jinja" %}
+{% block title %}
+    {{ _("Edit 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-2xl mx-auto">
+                <!-- Page Header -->
+                <div class="mb-8">
+                    <h1 class="text-3xl font-bold text-gray-900">{{ _("Edit Profile") }}</h1>
+                    <p class="text-gray-600 mt-2">{{ _("Update your account information and preferences") }}</p>
+                </div>
+                <!-- Edit Form -->
+                <div class="bg-white shadow-lg rounded-lg p-6">
+                    <form method="post" action="{{ url_for("user_edit_submit") }}">
+                        <div class="space-y-6">
+                            <!-- Name Field -->
+                            <div>
+                                <label for="name" class="block text-sm font-medium text-gray-700 mb-2">{{ _("Display Name") }}</label>
+                                <input type="text"
+                                       id="name"
+                                       name="name"
+                                       value="{{ user.name or '' }}"
+                                       class="w-full px-4 py-2 border border-gray-300 rounded-md focus:ring-2 focus:ring-blue-500 focus:border-blue-500"
+                                       required />
+                                <p class="text-sm text-gray-600 mt-1">{{ _("This name will be displayed throughout the application") }}</p>
+                            </div>
+                            <!-- Language Preference -->
+                            <div>
+                                <label for="language" class="block text-sm font-medium text-gray-700 mb-2">{{ _("Preferred Language") }}</label>
+                                <select id="language"
+                                        name="language"
+                                        class="w-full px-4 py-2 border border-gray-300 rounded-md focus:ring-2 focus:ring-blue-500 focus:border-blue-500">
+                                    <option value="">{{ _("Use browser default") }}</option>
+                                    {% for lang_code, lang_name in locale_names.items() %}
+                                        <option value="{{ lang_code }}"
+                                                {% if current_language and current_language == lang_code %}selected{% endif %}>
+                                            {{ lang_name }}
+                                        </option>
+                                    {% endfor %}
+                                </select>
+                                <p class="text-sm text-gray-600 mt-1">{{ _("This will override browser language detection") }}</p>
+                            </div>
+                            <!-- Email (read-only) -->
+                            <div>
+                                <label for="email" class="block text-sm font-medium text-gray-700 mb-2">{{ _("Email Address") }}</label>
+                                <input type="email"
+                                       id="email"
+                                       value="{{ user.email or '' }}"
+                                       class="w-full px-4 py-2 bg-gray-50 border border-gray-300 rounded-md text-gray-600"
+                                       readonly />
+                                <p class="text-sm text-gray-600 mt-1">{{ _("Email cannot be changed and is managed through your OAuth provider") }}</p>
+                            </div>
+                        </div>
+                        <!-- Form Actions -->
+                        <div class="flex justify-between items-center mt-8 pt-6 border-t border-gray-200">
+                            <a href="{{ url_for("user_profile") }}" class="btn btn-ghost">{{ _("Cancel") }}</a>
+                            <button type="submit" class="btn btn-primary">{{ _("Save Changes") }}</button>
+                        </div>
+                    </form>
+                </div>
+                <!-- Additional Info Card -->
+                <div class="mt-6 bg-blue-50 border border-blue-200 rounded-lg p-4">
+                    <div class="flex items-start">
+                        <div class="flex-shrink-0">
+                            <svg class="h-5 w-5 text-blue-600"
+                                 xmlns="http://www.w3.org/2000/svg"
+                                 viewBox="0 0 20 20"
+                                 fill="currentColor">
+                                <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7-4a1 1 0 11-2 0 1 1 0 012 0zM9 9a1 1 0 000 2v3a1 1 0 001 1h1a1 1 0 100-2v-3a1 1 0 00-1-1H9z" clip-rule="evenodd" />
+                            </svg>
+                        </div>
+                        <div class="ml-3">
+                            <h3 class="text-sm font-medium text-blue-900">{{ _("About Language Preferences") }}</h3>
+                            <p class="mt-1 text-sm text-blue-700">
+                                {{ _("Your language preference will take priority over URL parameters, cookies, and browser settings. Leave empty to use automatic detection.") }}
+                            </p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+{% endblock body %}

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

@@ -0,0 +1,156 @@
+{% 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/markdown/AGENTS.md

@@ -0,0 +1,29 @@
+# Core Markdown Templates - DO NOT MODIFY
+
+**⚠️ IMPORTANT**: Package-managed files. Changes will be lost on package updates.
+
+## How to Override
+
+**NEVER modify files in this directory!** Instead:
+
+1. Copy template to your project's `templates/markdown/`
+2. Maintain the same directory structure
+3. Your version overrides automatically
+
+### Example
+
+```bash
+# Core template (if exists, bundled in vibetuner package):
+vibetuner/templates/markdown/default/template.md.jinja
+
+# Your override (CREATE THIS in your project):
+templates/markdown/default/template.md.jinja
+```
+
+## Template Structure
+
+Currently, no core markdown templates are provided by the package.
+
+This directory is a placeholder for potential future package markdown templates.
+
+All markdown templates should be created in `templates/markdown/`.

vibetuner/templates/markdown/CLAUDE.md

@@ -0,0 +1,29 @@
+# Core Markdown Templates - DO NOT MODIFY
+
+**⚠️ IMPORTANT**: Package-managed files. Changes will be lost on package updates.
+
+## How to Override
+
+**NEVER modify files in this directory!** Instead:
+
+1. Copy template to your project's `templates/markdown/`
+2. Maintain the same directory structure
+3. Your version overrides automatically
+
+### Example
+
+```bash
+# Core template (if exists, bundled in vibetuner package):
+vibetuner/templates/markdown/default/template.md.jinja
+
+# Your override (CREATE THIS in your project):
+templates/markdown/default/template.md.jinja
+```
+
+## Template Structure
+
+Currently, no core markdown templates are provided by the package.
+
+This directory is a placeholder for potential future package markdown templates.
+
+All markdown templates should be created in `templates/markdown/`.

vibetuner/templates.py

@@ -0,0 +1,152 @@
+from pathlib import Path
+from typing import Any, Dict, Optional
+
+from jinja2 import Environment, FileSystemLoader, TemplateNotFound
+
+from .paths import (
+    app_templates,
+    core_templates,
+    email_templates,
+    frontend_templates,
+    markdown_templates,
+)
+
+
+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 email_templates
+    if namespace == "markdown":
+        return markdown_templates
+    if namespace == "frontend":
+        return frontend_templates
+
+    # Default for unknown or None namespace
+    # Only include app_templates if project root has been set
+    paths = []
+    if app_templates is not None:
+        paths.append(app_templates)
+    paths.append(core_templates)
+    return paths
+
+
+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,8 @@
+__version__ = "0.0.0-default"
+
+try:
+    from .._version import version as __version__  # type: ignore
+except ImportError:
+    pass
+
+version = __version__

{vibetuner-2.6.1.dist-info → vibetuner-2.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: vibetuner
-Version: 2.6.1
+Version: 2.7.0
 Summary: Blessed Python dependencies for Vibetuner projects
 Requires-Dist: aioboto3>=15.5.0
 Requires-Dist: arel>=0.4.0
@@ -34,6 +34,7 @@ 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.170 ; extra == 'dev'
 Requires-Dist: semver>=3.0.4 ; extra == 'dev'