milo-cli 0.3.0__tar.gz → 0.3.1__tar.gz

{milo_cli-0.3.0 → milo_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: milo-cli
-Version: 0.3.0
+Version: 0.3.1
 Summary: Template-driven CLI applications for free-threaded Python
 License-Expression: MIT
 Project-URL: Homepage, https://lbliii.github.io/milo-cli/
@@ -18,7 +18,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown
-Requires-Dist: kida-templates<0.8.0,>=0.7.0
+Requires-Dist: kida-templates<0.10.0,>=0.9.0
 Provides-Extra: docs
 Requires-Dist: bengal>=0.3.2; extra == "docs"
 Provides-Extra: yaml

{milo_cli-0.3.0 → milo_cli-0.3.1}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "milo-cli"
-version = "0.3.0"
+version = "0.3.1"
 description = "Template-driven CLI applications for free-threaded Python"
 readme = "README.md"
 requires-python = ">=3.14"
 license = "MIT"
-dependencies = ["kida-templates>=0.7.0,<0.8.0"]
+dependencies = ["kida-templates>=0.9.0,<0.10.0"]
 keywords = ["cli", "terminal", "forms", "free-threading", "template", "elm"]
 classifiers = [
     "Development Status :: 3 - Alpha",

{milo_cli-0.3.0 → milo_cli-0.3.1}/src/milo/__init__.py

@@ -161,7 +161,7 @@ def _Py_mod_gil() -> int:  # noqa: N802
     return 0
 
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 __all__ = [
     "BUILTIN_ACTIONS",
     "CLI",

{milo_cli-0.3.0 → milo_cli-0.3.1}/src/milo/templates/components/command_list.kida

@@ -5,7 +5,7 @@
         title     -- optional section title (default: "Commands")
         grouped   -- optional bool, if true group by first tag (default: false)
 -#}
-{%- from "components/_defs.kida" import section, command_row, tag_list -%}
+{%- from "./_defs.kida" import section, command_row, tag_list -%}
 
 {{ section(title | default("Commands")) }}
 {% for cmd in commands %}

{milo_cli-0.3.0 → milo_cli-0.3.1}/src/milo/templates/components/help_page.kida

@@ -10,7 +10,7 @@
         examples     -- list of example dicts: {command, description} (optional)
         epilog       -- footer text (optional)
 -#}
-{%- from "components/_defs.kida" import header, section, command_row, example_block, def_list -%}
+{%- from "./_defs.kida" import header, section, command_row, example_block, def_list -%}
 
 {% set version ??= "" %}
 {% set description ??= "" %}

{milo_cli-0.3.0 → milo_cli-0.3.1}/src/milo/templates/error.kida

@@ -1,9 +1,10 @@
-{% try %}
+{%- set error ??= "Unknown error" -%}
+{%- set code ??= "" -%}
+{%- set template_name ??= "" -%}
+{%- set hint ??= "" -%}
+{%- set docs_url ??= "" -%}
 {{ "error" | red | bold }}{% if code %} {{ code | yellow }}{% endif %}
 {{ error | dim }}
 {% if template_name %}  {{ "template:" | dim }} {{ template_name }}{% endif %}
 {% if hint %}  {{ "hint:" | cyan }} {{ hint }}{% endif %}
 {% if docs_url %}  {{ "docs:" | dim }} {{ docs_url }}{% endif %}
-{% fallback %}
-error: {{ error }}
-{% end %}

{milo_cli-0.3.0 → milo_cli-0.3.1}/src/milo_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: milo-cli
-Version: 0.3.0
+Version: 0.3.1
 Summary: Template-driven CLI applications for free-threaded Python
 License-Expression: MIT
 Project-URL: Homepage, https://lbliii.github.io/milo-cli/
@@ -18,7 +18,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown
-Requires-Dist: kida-templates<0.8.0,>=0.7.0
+Requires-Dist: kida-templates<0.10.0,>=0.9.0
 Provides-Extra: docs
 Requires-Dist: bengal>=0.3.2; extra == "docs"
 Provides-Extra: yaml

{milo_cli-0.3.0 → milo_cli-0.3.1}/src/milo_cli.egg-info/SOURCES.txt

@@ -120,6 +120,7 @@ tests/test_readme_example_index.py
 tests/test_reducers.py
 tests/test_registry_crud.py
 tests/test_registry_v2.py
+tests/test_release_status.py
 tests/test_scaffold.py
 tests/test_schema_v2.py
 tests/test_state.py

{milo_cli-0.3.0 → milo_cli-0.3.1}/src/milo_cli.egg-info/requires.txt

@@ -1,4 +1,4 @@
-kida-templates<0.8.0,>=0.7.0
+kida-templates<0.10.0,>=0.9.0
 
 [docs]
 bengal>=0.3.2

milo_cli-0.3.1/tests/test_release_status.py

@@ -0,0 +1,193 @@
+"""Tests for scripts/release_status.py."""
+
+from __future__ import annotations
+
+import importlib.util
+import sys
+from pathlib import Path
+
+
+def _load_release_status_script():
+    script = Path(__file__).parent.parent / "scripts" / "release_status.py"
+    spec = importlib.util.spec_from_file_location("release_status", script)
+    assert spec is not None
+    assert spec.loader is not None
+    module = importlib.util.module_from_spec(spec)
+    sys.modules[spec.name] = module
+    spec.loader.exec_module(module)
+    return module
+
+
+def _facts(**overrides):
+    release_status = _load_release_status_script()
+    base = {
+        "package_name": "milo-cli",
+        "pyproject_version": "0.3.1",
+        "module_version": "0.3.1",
+        "lock_version": "0.3.1",
+        "head_sha": "abc1234",
+        "local_tags": ("v0.3.0",),
+        "remote_tags": ("refs/tags/v0.3.0",),
+        "pypi_version": "",
+        "changelog_versions": ("0.3.1", "0.3.0"),
+        "release_note_versions": ("0.3.1", "0.3.0"),
+        "pending_fragments": (),
+        "empty_fragments": (),
+        "changed_since_current_tag": (),
+        "changed_released_notes": (),
+        "tag_diff_warnings": (),
+        "remote_checked": True,
+        "pypi_checked": False,
+    }
+    base.update(overrides)
+    return release_status.ReleaseFacts(**base)
+
+
+class TestReleaseStatus:
+    def test_allows_next_patch_after_released_tag(self):
+        release_status = _load_release_status_script()
+
+        report = release_status.analyze_release_state(_facts())
+
+        messages = [check.message for check in report.checks]
+        assert report.has_errors is False
+        assert report.latest_released_version == "0.3.0"
+        assert report.suggested_next_version == "0.3.1"
+        assert any("Current version 0.3.1 is newer" in msg for msg in messages)
+
+    def test_rejects_metadata_left_on_already_released_version(self):
+        release_status = _load_release_status_script()
+
+        report = release_status.analyze_release_state(
+            _facts(
+                pyproject_version="0.3.0",
+                module_version="0.3.0",
+                lock_version="0.3.0",
+                changelog_versions=("0.3.0",),
+                release_note_versions=("0.3.0",),
+                changed_since_current_tag=("CHANGELOG.md", "site/content/releases/0.3.0.md"),
+            )
+        )
+
+        messages = [check.message for check in report.checks]
+        assert report.has_errors is True
+        assert any("Version 0.3.0 is already released/tagged" in msg for msg in messages)
+        assert any("Release surfaces for already-tagged 0.3.0 changed" in msg for msg in messages)
+        assert report.suggested_next_version == "0.3.1"
+
+    def test_rejects_version_drift_between_metadata_files(self):
+        release_status = _load_release_status_script()
+
+        report = release_status.analyze_release_state(_facts(module_version="0.3.0"))
+
+        assert report.has_errors is True
+        assert any("disagrees with src/milo/__init__.py" in c.message for c in report.checks)
+
+    def test_rejects_version_already_on_pypi(self):
+        release_status = _load_release_status_script()
+
+        report = release_status.analyze_release_state(
+            _facts(
+                local_tags=(),
+                remote_tags=(),
+                pypi_version="0.3.1",
+                pypi_checked=True,
+            )
+        )
+
+        assert report.has_errors is True
+        assert any("Version 0.3.1 is already released/tagged" in c.message for c in report.checks)
+
+    def test_warns_about_pending_fragments(self):
+        release_status = _load_release_status_script()
+
+        report = release_status.analyze_release_state(
+            _facts(pending_fragments=("template-check.fixed.md",))
+        )
+
+        assert any(
+            check.level == "warn" and "Pending changelog fragments" in check.message
+            for check in report.checks
+        )
+
+    def test_rejects_empty_changelog_fragments(self):
+        release_status = _load_release_status_script()
+
+        report = release_status.analyze_release_state(
+            _facts(
+                pending_fragments=("empty.fixed.md",),
+                empty_fragments=("empty.fixed.md",),
+            )
+        )
+
+        assert report.has_errors is True
+        assert any("Empty changelog fragments found" in c.message for c in report.checks)
+
+    def test_warns_when_prior_release_notes_changed(self):
+        release_status = _load_release_status_script()
+
+        report = release_status.analyze_release_state(
+            _facts(changed_released_notes=("site/content/releases/0.3.0.md",))
+        )
+
+        assert any(
+            check.level == "warn" and "Already-tagged release note files changed" in check.message
+            for check in report.checks
+        )
+
+    def test_warns_when_tag_diff_cannot_be_checked(self):
+        release_status = _load_release_status_script()
+
+        report = release_status.analyze_release_state(
+            _facts(tag_diff_warnings=("Release tag v0.3.0 exists on origin but is not local.",))
+        )
+
+        assert any(
+            check.level == "warn" and "exists on origin" in check.message for check in report.checks
+        )
+
+    def test_remote_only_current_tag_reports_missing_local_diff(self, tmp_path):
+        release_status = _load_release_status_script()
+
+        changed, warnings = release_status._read_changed_since_current_tag(
+            tmp_path,
+            "0.3.1",
+            (),
+            ("refs/tags/v0.3.1",),
+        )
+
+        assert changed == ()
+        assert warnings == (
+            "Release tag v0.3.1 exists on origin but is not available locally; "
+            "run with --fetch-tags to check release-surface drift.",
+        )
+
+    def test_remote_only_historical_tag_reports_missing_local_diff(self, tmp_path):
+        release_status = _load_release_status_script()
+        note = tmp_path / "site" / "content" / "releases" / "0.3.0.md"
+        note.parent.mkdir(parents=True)
+        note.write_text("release notes\n", encoding="utf-8")
+
+        changed, warnings = release_status._read_changed_released_notes(
+            tmp_path,
+            "0.3.1",
+            (),
+            ("refs/tags/v0.3.0",),
+        )
+
+        assert changed == ()
+        assert warnings == (
+            "Release tag v0.3.0 exists on origin but is not available locally; "
+            "run with --fetch-tags to check site/content/releases/0.3.0.md "
+            "for historical edits.",
+        )
+
+    def test_reads_empty_fragments_from_disk(self, tmp_path):
+        release_status = _load_release_status_script()
+        fragment_dir = tmp_path / "changelog.d"
+        fragment_dir.mkdir()
+        (fragment_dir / ".gitkeep").write_text("", encoding="utf-8")
+        (fragment_dir / "empty.fixed.md").write_text(" \n", encoding="utf-8")
+        (fragment_dir / "full.fixed.md").write_text("Fixed the release guard.\n", encoding="utf-8")
+
+        assert release_status._read_empty_fragments(tmp_path) == ("empty.fixed.md",)

{milo_cli-0.3.0 → milo_cli-0.3.1}/tests/test_templates.py

@@ -2,6 +2,19 @@
 
 from __future__ import annotations
 
+import importlib.util
+from pathlib import Path
+
+
+def _load_check_templates_script():
+    script = Path(__file__).parent.parent / "scripts" / "check_templates.py"
+    spec = importlib.util.spec_from_file_location("check_templates", script)
+    assert spec is not None
+    assert spec.loader is not None
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
 
 class TestGetEnv:
     def test_returns_environment(self):
@@ -203,3 +216,42 @@ class TestComponentTemplatesIncluded:
         except Exception:
             # If kida can't parse it, that's OK -- the point is the file is found
             pass
+
+
+class TestTemplateCheckScript:
+    def test_milo_aware_check_accepts_terminal_filters(self, tmp_path):
+        """The local checker uses Milo's terminal environment, not raw kida defaults."""
+        check_templates = _load_check_templates_script()
+        (tmp_path / "ok.kida").write_text('{{ "ok" | bold }}', encoding="utf-8")
+
+        errors = check_templates._check_root(tmp_path, "tmp")
+
+        assert errors == []
+
+    def test_milo_aware_check_flags_unified_end_tags(self, tmp_path):
+        check_templates = _load_check_templates_script()
+        (tmp_path / "bad.kida").write_text("{% if value %}ok{% end %}", encoding="utf-8")
+
+        errors = check_templates._check_root(tmp_path, "tmp")
+
+        assert len(errors) == 1
+        assert "bad.kida:1" in errors[0]
+        assert "strict: unified {% end %} closes 'if'" in errors[0]
+        assert "prefer {% endif %}" in errors[0]
+
+    def test_milo_aware_check_flags_fragile_same_folder_imports(self, tmp_path):
+        check_templates = _load_check_templates_script()
+        components = tmp_path / "components"
+        components.mkdir()
+        (components / "_defs.kida").write_text("{% def item() %}x{% enddef %}", encoding="utf-8")
+        (components / "page.kida").write_text(
+            '{% from "components/_defs.kida" import item %}{{ item() }}',
+            encoding="utf-8",
+        )
+
+        errors = check_templates._check_root(tmp_path, "tmp")
+
+        assert len(errors) == 1
+        assert "components/page.kida:1" in errors[0]
+        assert "lint/fragile-path" in errors[0]
+        assert 'prefer "./_defs.kida"' in errors[0]