dazzlecmd 0.2.1a0__py3-none-any.whl

dazzlecmd/__init__.py

@@ -0,0 +1,3 @@
+"""dazzlecmd - Unified CLI for the DazzleTools collection."""
+
+from dazzlecmd._version import __version__, __app_name__, DISPLAY_VERSION

dazzlecmd/__main__.py

@@ -0,0 +1,8 @@
+"""Allow running as: python -m dazzlecmd"""
+
+import sys
+
+from dazzlecmd.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

dazzlecmd/_version.py

@@ -0,0 +1,94 @@
+"""
+Version information for dazzlecmd.
+
+This file is the canonical source for version numbers.
+The __version__ string is automatically updated by git hooks
+with build metadata (branch, build number, date, commit hash).
+
+Format: MAJOR.MINOR.PATCH[-PHASE]_BRANCH_BUILD-YYYYMMDD-COMMITHASH
+Example: 0.1.0_main_4-20260211-a1b2c3d4
+
+To manually update: ./scripts/update-version.sh
+To bump version: edit MAJOR, MINOR, PATCH below
+
+Version levels:
+  PROJECT_PHASE: Global project maturity (prealpha -> alpha -> beta -> stable).
+                 Changes rarely, when the overall project hits a threshold.
+  PHASE:         Per-MINOR feature set maturity (alpha -> beta -> None).
+                 Drops when a MINOR's feature set is complete.
+                 Example: BETA 0.5.1-alpha = project is beta, 0.5.x features in progress.
+"""
+
+# Version components - edit these for version bumps
+MAJOR = 0
+MINOR = 2
+PATCH = 1
+PHASE = "alpha"  # Per-MINOR feature set: None, "alpha", "beta", "rc1", etc.
+PROJECT_PHASE = "prealpha"  # Project-wide: "prealpha", "alpha", "beta", "stable"
+
+# Auto-updated by git hooks - do not edit manually
+__version__ = "0.2.1-alpha_main_12-20260316-b15ec326"
+__app_name__ = "dazzlecmd"
+
+
+def get_version():
+    """Return the full version string including branch and build info."""
+    return __version__
+
+
+def get_display_version():
+    """Return a human-friendly version string with project phase.
+
+    Example: 'PREALPHA 0.1.0-alpha' or 'BETA 0.5.1' or '1.0.0'
+    """
+    base = get_base_version()
+    if PROJECT_PHASE and PROJECT_PHASE != "stable":
+        return f"{PROJECT_PHASE.upper()} {base}"
+    return base
+
+
+def get_base_version():
+    """Return the semantic version string (MAJOR.MINOR.PATCH[-PHASE])."""
+    if "_" in __version__:
+        return __version__.split("_")[0]
+    base = f"{MAJOR}.{MINOR}.{PATCH}"
+    if PHASE:
+        base = f"{base}-{PHASE}"
+    return base
+
+
+def get_pip_version():
+    """
+    Return PEP 440 compliant version for pip/setuptools.
+
+    Converts our version format to PEP 440:
+    - Main branch: 0.1.2-alpha_main_6-20260212-hash -> 0.1.2a0
+    - Dev branch: 0.1.2-alpha_dev_6-20260212-hash -> 0.1.2a0.dev6
+    - Feature branch: 0.1.2_feature_6-20260212-hash -> 0.1.2.dev6+feature
+    """
+    base = f"{MAJOR}.{MINOR}.{PATCH}"
+
+    # Map phase to PEP 440 pre-release segment
+    phase_map = {"alpha": "a0", "beta": "b0"}
+    if PHASE:
+        base += phase_map.get(PHASE, PHASE)
+
+    if "_" not in __version__:
+        return base
+
+    parts = __version__.split("_")
+    branch = parts[1] if len(parts) > 1 else "unknown"
+
+    if branch == "main":
+        return base
+    else:
+        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()
+DISPLAY_VERSION = get_display_version()