version.py

"""
Version information for GitHub Traffic Tracker.

This file is automatically updated by git pre-commit hooks.
Format: VERSION_BRANCH_BUILD-YYYYMMDD-COMMITHASH

Example: 0.1.0-alpha_main_1-20260226-abc1234

Components:
- VERSION: Semantic version (MAJOR.MINOR.PATCH-PHASE)
- BRANCH: Git branch name
- BUILD: Commit count
- YYYYMMDD: Commit date
- COMMITHASH: Short commit hash
"""

# Semantic version components
MAJOR = 0
MINOR = 3
PATCH = 10

# Optional release phase (alpha, beta, rc1, rc2, etc.)
# Set to None for stable releases
PHASE = None  # Options: None, "alpha", "beta", "rc1", "rc2", etc.
# NOTE: temporarily None to make 0.3.10 installable via `pip install` without
# --pre. The project is still in alpha overall — see #52 (display version) and
# #77 (git-repokit-common subtree port) for the proper fix.
PROJECT_PHASE = "alpha"  # Project-wide maturity: "prealpha", "alpha", "beta", "stable"

# Full version string - updated by git pre-commit hook
# DO NOT EDIT THIS LINE MANUALLY
# Note: Hash reflects the commit this version builds upon (HEAD at commit time)
# The hash will be one commit behind after the commit is created (git limitation)
__version__ = "0.3.10_main_28-20260410-92be410"


def get_version():
    """Return the full version string including branch and build info."""
    return __version__


def get_base_version():
    """Return the semantic version string (MAJOR.MINOR.PATCH) with optional phase."""
    # Extract base version from __version__ string to maintain single source of truth
    # Format: VERSION_BRANCH_BUILD-DATE-HASH
    # Example: 0.8.0_private_13-20250922-ad442287 -> 0.8.0
    if "_" in __version__:
        base = __version__.split("_")[0]
    else:
        # Fallback if __version__ doesn't have expected format
        base = f"{MAJOR}.{MINOR}.{PATCH}"

    # Add phase if specified
    if PHASE:
        base = f"{base}-{PHASE}"

    return base


def get_version_dict():
    """Return version information as a dictionary."""
    parts = __version__.split("_")
    if len(parts) >= 3:
        base_version = parts[0]
        branch = parts[1]
        # Handle remaining parts which include build-date-hash
        build_info = "_".join(parts[2:])
        build_parts = build_info.split("-")

        return {
            "full": __version__,
            "base": base_version,
            "branch": branch,
            "build": build_parts[0] if len(build_parts) > 0 else "",
            "date": build_parts[1] if len(build_parts) > 1 else "",
            "commit": build_parts[2] if len(build_parts) > 2 else "",
        }

    # Fallback for malformed version strings
    return {
        "full": __version__,
        "base": get_base_version(),
        "branch": "unknown",
        "build": "0",
        "date": "",
        "commit": "",
    }


def get_pip_version():
    """
    Return PEP 440 compliant version for pip/setuptools.

    Converts our version format to PEP 440:
    - Main branch: 0.8.0_main_13-20250922-hash → 0.8.0
    - Dev branch: 0.8.0_private_13-20250922-hash → 0.8.0.dev13
    - Feature branch: 0.8.0_feature_13-20250922-hash → 0.8.0.dev13+feature
    """
    if "_" not in __version__:
        return get_base_version()

    parts = __version__.split("_")
    base = parts[0]
    branch = parts[1] if len(parts) > 1 else "unknown"

    if branch == "main":
        # Release version
        return base
    else:
        # Development version
        build_info = "_".join(parts[2:]) if len(parts) > 2 else ""
        build_num = build_info.split("-")[0] if "-" in build_info else "0"
        return f"{base}.dev{build_num}"


# For convenience in imports
VERSION = get_version()
BASE_VERSION = get_base_version()
PIP_VERSION = get_pip_version()