copier-python 0.20.0__tar.gz → 0.20.1__tar.gz

copier_python-0.20.1/AGENTS.md

@@ -0,0 +1,30 @@
+# Environment/Tools
+
+* `mise` manages dev tools and tasks, including `uv` which manages Python and dependencies.
+* Use `uv add`/`uv run python` instead of bare `pip`/`python`
+* `mise install`: After-clone setup (install tools, dependencies, pre-commit hooks)
+* `mise run lint`: Pre-commit hooks (via `pre-commit`-compatible `prek`) including lint, format, type check (ruff, ty)
+* `mise run test`: Run tests (accepts pytest arguments)
+* `mise run lt`: Lint+test (no arguments)
+* `mise run snapup`: Update test snapshots (syrupy, accepts pytest arguments)
+
+# Commit conventions
+
+* Keep commit messages concise and in plain language, so a maintainer can
+  quickly understand the change. Use a short subject, and add a body only when
+  the change needs explaining, in a few lines about why. Don't list changed
+  files, restate the diff, or report test results.
+* If a commit contains code or text largely generated by an LLM, add an
+  `Assisted-by: <tool>:<model>` trailer, for example with `git commit --trailer`.
+* Don't add `Co-authored-by` or `Signed-off-by` lines for LLM tools, links to
+  LLM sessions, or promotional lines such as "Generated with [...]".
+
+# Submitting contributions
+
+* You may commit locally without asking. Before submitting anything, such as
+  pushing commits or creating or editing a pull request, issue, or comment,
+  show the user (who is the contributor) exactly what will be submitted, and
+  wait for their explicit approval. Submit it as approved. This includes but is
+  not limited to commit messages, titles, and bodies.
+* Keep titles and descriptions short and specific. Don't restate what the diff
+  already shows.

{copier_python-0.20.0 → copier_python-0.20.1}/CONTRIBUTING.md

@@ -21,3 +21,15 @@ licensed under the project's license, the
 [MIT License](https://github.com/smkent/copier-python/blob/main/LICENSE),
 with no additional terms,
 and that you have the right to submit it under that license.
+
+## LLM use
+
+A contributor is always the author of their contributions.
+You must read, review, and understand everything you submit, including
+LLM-generated code or text, and be able to explain it on request.
+
+If a commit contains code or text largely generated by an LLM, add an
+`Assisted-by: <tool>:<model>` trailer to its message. This can be done
+automatically with `git commit --trailer="Assisted-by: <tool>:<model>"`.
+
+Do not use `Co-authored-by:` for LLM attribution. LLMs are tools, not authors.

{copier_python-0.20.0 → copier_python-0.20.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: copier-python
-Version: 0.20.0
+Version: 0.20.1
 Summary: Copier template for Python projects with modern tooling
 Project-URL: Homepage, https://smkent.github.io/copier-python
 Project-URL: Repository, https://github.com/smkent/copier-python

{copier_python-0.20.0 → copier_python-0.20.1}/pyproject.toml

@@ -45,6 +45,7 @@ Issues = "https://github.com/smkent/copier-python/issues"
 [dependency-groups]
 dev = [
   "bump-my-version>=1.3.0",
+  "commit-check>=2.18",
   "copier>=9",
   "poethepoet>=0.46",
   "pysentry-rs>=0.4",

{copier_python-0.20.0 → copier_python-0.20.1}/tests/conftest.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 import subprocess
 import warnings
 from functools import partial
-from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
 import copier
@@ -12,12 +11,11 @@ import yaml
 
 from copier_python.__main__ import setup_env
 
-from .utils import DisallowCallable
+from .utils import DisallowCallable, template
 
 if TYPE_CHECKING:
     from collections.abc import Callable, Iterator
-
-TEMPLATE_ROOT = Path(__file__).parent.parent
+    from pathlib import Path
 
 DEFAULT_DATA: dict[str, Any] = {
     "project_name": "PKFire",
@@ -84,7 +82,7 @@ def session_render_template(
             )
             with disallow_subprocess.pause():
                 copier.run_copy(
-                    src_path=str(TEMPLATE_ROOT),
+                    src_path=str(template.dir),
                     dst_path=str(worktree),
                     data=data,
                     vcs_ref=vcs_ref,

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/__snapshots__/test_pre_commit.ambr

@@ -52,7 +52,7 @@
           pass_filenames: false
         - id: commit-check
           name: commit-check
-          entry: uv run commit-check --message
+          entry: uv run commit-check --no-banner --message
           language: system
           stages: [commit-msg]
   
@@ -163,7 +163,7 @@
           pass_filenames: false
         - id: commit-check
           name: commit-check
-          entry: uv run commit-check --message
+          entry: uv run commit-check --no-banner --message
           language: system
           stages: [commit-msg]
   

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_agents.py

@@ -6,11 +6,11 @@ from pathlib import Path
 import pytest
 from syrupy.assertion import SnapshotAssertion
 
-from tests.utils import choices
+from tests.utils import template
 
 
 @pytest.mark.parametrize(
-    "llm_contribution_policy", choices["llm_contribution_policy"]
+    "llm_contribution_policy", template.choices.llm_contribution_policy
 )
 def test_agents(
     render_template: Callable[..., Path],

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_commit_check.py

@@ -4,7 +4,7 @@ from typing import TYPE_CHECKING
 
 import pytest
 
-from tests.utils import TEMPLATE_ROOT
+from tests.utils import template
 
 if TYPE_CHECKING:
     from collections.abc import Callable
@@ -25,5 +25,5 @@ def test_commit_check_config(
 ) -> None:
     rendered = render_template(project_visibility=project_visibility)
     assert (rendered / config_path).read_text() == (
-        TEMPLATE_ROOT / "includes" / "commit-check.toml"
+        template.dir / "includes" / "commit-check.toml"
     ).read_text()

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_contributing.py

@@ -6,7 +6,7 @@ from pathlib import Path
 import pytest
 from syrupy.assertion import SnapshotAssertion
 
-from tests.utils import choices
+from tests.utils import template
 
 
 @pytest.mark.parametrize(
@@ -14,7 +14,7 @@ from tests.utils import choices
     [pytest.param(True, id="docs"), pytest.param(False, id="no_docs")],
 )
 @pytest.mark.parametrize(
-    "llm_contribution_policy", choices["llm_contribution_policy"]
+    "llm_contribution_policy", template.choices.llm_contribution_policy
 )
 def test_contributing_features(
     render_template: Callable[..., Path],
@@ -30,7 +30,9 @@ def test_contributing_features(
     assert (rendered / "CONTRIBUTING.md").read_text() == snapshot
 
 
-@pytest.mark.parametrize("copyright_license", choices["copyright_license"])
+@pytest.mark.parametrize(
+    "copyright_license", template.choices.copyright_license
+)
 def test_contributing_license(
     render_template: Callable[..., Path],
     snapshot: SnapshotAssertion,

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_docs.py

@@ -6,7 +6,7 @@ from pathlib import Path
 import pytest
 from syrupy.assertion import SnapshotAssertion
 
-from tests.utils import choices
+from tests.utils import template
 
 
 @pytest.mark.parametrize(
@@ -66,7 +66,9 @@ def test_docs_development_features(
         ).read_text() == snapshot
 
 
-@pytest.mark.parametrize("copyright_license", choices["copyright_license"])
+@pytest.mark.parametrize(
+    "copyright_license", template.choices.copyright_license
+)
 def test_docs_license(
     render_template: Callable[..., Path],
     snapshot: SnapshotAssertion,

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_license.py

@@ -7,10 +7,12 @@ import pytest
 import yaml
 from syrupy.assertion import SnapshotAssertion
 
-from tests.utils import TEMPLATE_ROOT, choices
+from tests.utils import template
 
 
-@pytest.mark.parametrize("copyright_license", choices["copyright_license"])
+@pytest.mark.parametrize(
+    "copyright_license", template.choices.copyright_license
+)
 def test_license(
     render_template: Callable[..., Path],
     snapshot: SnapshotAssertion,
@@ -35,10 +37,12 @@ def test_license_default(
     )
 
 
-@pytest.mark.parametrize("copyright_license", choices["copyright_license"])
+@pytest.mark.parametrize(
+    "copyright_license", template.choices.copyright_license
+)
 def test_license_choices_have_templates(copyright_license: str) -> None:
     assert (
-        TEMPLATE_ROOT / "includes" / "licenses" / copyright_license
+        template.dir / "includes" / "licenses" / copyright_license
     ).is_file()
 
 

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_pre_commit.py

@@ -4,7 +4,7 @@ from typing import TYPE_CHECKING
 
 import pytest
 
-from tests.utils import choices
+from tests.utils import template
 
 if TYPE_CHECKING:
     from collections.abc import Callable
@@ -14,7 +14,7 @@ if TYPE_CHECKING:
 
 
 @pytest.mark.parametrize(
-    "llm_contribution_policy", choices["llm_contribution_policy"]
+    "llm_contribution_policy", template.choices.llm_contribution_policy
 )
 def test_pre_commit_config(
     render_template: Callable[..., Path],

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_pyproject.py

@@ -6,7 +6,7 @@ from pathlib import Path
 import pytest
 from syrupy.assertion import SnapshotAssertion
 
-from tests.utils import choices
+from tests.utils import template
 
 
 @pytest.mark.parametrize("project_visibility", ["public", "private"])
@@ -63,7 +63,9 @@ def test_pyproject_versions(
     assert (rendered / "pyproject.toml").read_text() == snapshot
 
 
-@pytest.mark.parametrize("copyright_license", choices["copyright_license"])
+@pytest.mark.parametrize(
+    "copyright_license", template.choices.copyright_license
+)
 def test_pyproject_licenses(
     render_template: Callable[..., Path],
     snapshot: SnapshotAssertion,

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_readme.py

@@ -6,7 +6,7 @@ from pathlib import Path
 import pytest
 from syrupy.assertion import SnapshotAssertion
 
-from tests.utils import choices
+from tests.utils import template
 
 
 @pytest.mark.parametrize(
@@ -41,7 +41,9 @@ def test_readme_features(
 
 
 @pytest.mark.parametrize("project_visibility", ["public", "private"])
-@pytest.mark.parametrize("copyright_license", choices["copyright_license"])
+@pytest.mark.parametrize(
+    "copyright_license", template.choices.copyright_license
+)
 def test_readme_project_visibility(
     render_template: Callable[..., Path],
     snapshot: SnapshotAssertion,

{copier_python-0.20.0 → copier_python-0.20.1}/tests/template/test_structure.py

@@ -6,7 +6,7 @@ from typing import TYPE_CHECKING, Any
 
 import pytest
 
-from tests.utils import choices
+from tests.utils import template
 
 if TYPE_CHECKING:
     from collections.abc import Callable
@@ -48,8 +48,10 @@ def structure_test(
     return StructureTest(render_template=render_template)
 
 
-@pytest.mark.parametrize("project_type", choices["project_type"])
-@pytest.mark.parametrize("project_visibility", choices["project_visibility"])
+@pytest.mark.parametrize("project_type", template.choices.project_type)
+@pytest.mark.parametrize(
+    "project_visibility", template.choices.project_visibility
+)
 @pytest.mark.parametrize(
     "enable_coverage",
     [pytest.param(True, id="coverage"), pytest.param(False, id="no_coverage")],
@@ -140,7 +142,9 @@ def test_structure(
     structure_test(case)
 
 
-@pytest.mark.parametrize("copyright_license", choices["copyright_license"])
+@pytest.mark.parametrize(
+    "copyright_license", template.choices.copyright_license
+)
 def test_structure_license(
     structure_test: StructureTest,
     copyright_license: str,
@@ -157,9 +161,11 @@ def test_structure_license(
 
 
 @pytest.mark.parametrize(
-    "llm_contribution_policy", choices["llm_contribution_policy"]
+    "llm_contribution_policy", template.choices.llm_contribution_policy
+)
+@pytest.mark.parametrize(
+    "project_visibility", template.choices.project_visibility
 )
-@pytest.mark.parametrize("project_visibility", choices["project_visibility"])
 def test_structure_contributing(
     structure_test: StructureTest,
     project_visibility: str,

{copier_python-0.20.0 → copier_python-0.20.1}/tests/utils.py

@@ -3,7 +3,9 @@ from __future__ import annotations
 import sys
 from contextlib import contextmanager
 from dataclasses import dataclass, field
+from functools import cached_property
 from pathlib import Path
+from types import SimpleNamespace
 from typing import TYPE_CHECKING, Any
 from unittest.mock import MagicMock, patch
 
@@ -20,9 +22,6 @@ if TYPE_CHECKING:
     import pytest
 
 
-TEMPLATE_ROOT = Path(__file__).parent.parent
-
-
 @dataclass
 class DisallowCallable:
     request: pytest.FixtureRequest
@@ -69,12 +68,28 @@ class DisallowCallable:
             self.mock_attr.assert_not_called()
 
 
-choices = {
-    k: list(choices.values()) if isinstance(choices, dict) else choices
-    for k, v in yaml.safe_load(
-        (TEMPLATE_ROOT / "copier.yaml").read_text()
-    ).items()
-    if isinstance(v, dict)
-    and (choices := v.get("choices"))
-    and isinstance(choices, (dict, list))
-}
+class Template:
+    @cached_property
+    def dir(self) -> Path:
+        return Path(__file__).parent.parent
+
+    @cached_property
+    def config(self) -> dict[str, Any]:
+        return yaml.safe_load((self.dir / "copier.yaml").read_text())
+
+    @cached_property
+    def choices(self) -> SimpleNamespace:
+        return SimpleNamespace(
+            **{
+                k: list(choices.values())
+                if isinstance(choices, dict)
+                else choices
+                for k, v in self.config.items()
+                if isinstance(v, dict)
+                and (choices := v.get("choices"))
+                and isinstance(choices, (dict, list))
+            }
+        )
+
+
+template = Template()

copier_python-0.20.0/AGENTS.md

@@ -1,9 +0,0 @@
-# Environment/Tools
-
-* `mise` manages dev tools and tasks, including `uv` which manages Python and dependencies.
-* Use `uv add`/`uv run python` instead of bare `pip`/`python`
-* `mise install`: After-clone setup (install tools, dependencies, pre-commit hooks)
-* `mise run lint`: Pre-commit hooks (via `pre-commit`-compatible `prek`) including lint, format, type check (ruff, ty)
-* `mise run test`: Run tests (accepts pytest arguments)
-* `mise run lt`: Lint+test (no arguments)
-* `mise run snapup`: Update test snapshots (syrupy, accepts pytest arguments)