copier-python 0.19.1__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.19.1 → 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.19.1 → copier_python-0.20.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: copier-python
-Version: 0.19.1
+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
@@ -81,6 +81,11 @@ copier copy "gh:smkent/copier-python" /new/project/path
 * [**pytest**][pytest] test framework with [**codecov.io**][codecovio] support
 * [**Zensical**][zensical] project documentation with automatic deployment to
   [**GitHub Pages**][github-pages]
+* Contribution terms including selectable LLM use policy, with commit message
+  checks by [**commit-check**][commit-check]
+
+    [![commit-check][commit-check-badge]][commit-check]
+
 
 ## Credits
 
@@ -96,6 +101,8 @@ Licensed under the MIT License
 
 [astral]: https://astral.sh
 [codecovio]: https://codecov.io
+[commit-check]: https://commit-check.com
+[commit-check-badge]: https://commit-check.com/badge.svg
 [copier-astral]: https://ritwiktiwari.github.io/copier-astral/
 [copier-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-purple.json
 [copier-update]: https://copier.readthedocs.io/en/stable/updating/

{copier_python-0.19.1 → copier_python-0.20.1}/README.md

@@ -51,6 +51,11 @@ copier copy "gh:smkent/copier-python" /new/project/path
 * [**pytest**][pytest] test framework with [**codecov.io**][codecovio] support
 * [**Zensical**][zensical] project documentation with automatic deployment to
   [**GitHub Pages**][github-pages]
+* Contribution terms including selectable LLM use policy, with commit message
+  checks by [**commit-check**][commit-check]
+
+    [![commit-check][commit-check-badge]][commit-check]
+
 
 ## Credits
 
@@ -66,6 +71,8 @@ Licensed under the MIT License
 
 [astral]: https://astral.sh
 [codecovio]: https://codecov.io
+[commit-check]: https://commit-check.com
+[commit-check-badge]: https://commit-check.com/badge.svg
 [copier-astral]: https://ritwiktiwari.github.io/copier-astral/
 [copier-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-purple.json
 [copier-update]: https://copier.readthedocs.io/en/stable/updating/

{copier_python-0.19.1 → 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.19.1 → copier_python-0.20.1}/tests/conftest.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import subprocess
 import warnings
-from pathlib import Path
+from functools import partial
 from typing import TYPE_CHECKING, Any
 
 import copier
@@ -11,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",
@@ -38,7 +37,7 @@ def ensure_env() -> None:
     setup_env()
 
 
-@pytest.fixture(autouse=True)
+@pytest.fixture(autouse=True, scope="session")
 def disallow_subprocess(
     request: pytest.FixtureRequest,
 ) -> Iterator[DisallowCallable]:
@@ -46,18 +45,19 @@ def disallow_subprocess(
         yield mock
 
 
-@pytest.fixture
+@pytest.fixture(scope="session")
 def allow_subprocess(disallow_subprocess: DisallowCallable) -> Iterator[None]:
     with disallow_subprocess.pause():
         yield
 
 
-@pytest.fixture
-def render_template(
-    tmp_path: Path, disallow_subprocess: DisallowCallable
+@pytest.fixture(scope="session")
+def session_render_template(
+    disallow_subprocess: DisallowCallable,
 ) -> Callable[..., Path]:
     def _render(
         *,
+        tmp_path: Path,
         vcs_ref: str = "HEAD",
         previous_answers: dict[str, Any] | None = None,
         **kwargs: Any,
@@ -82,7 +82,7 @@ def 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,
@@ -93,3 +93,11 @@ def render_template(
         return worktree
 
     return _render
+
+
+@pytest.fixture
+def render_template(
+    session_render_template: Callable[..., Path],
+    tmp_path: Path,
+) -> Callable[..., Path]:
+    return partial(session_render_template, tmp_path=tmp_path)

copier_python-0.20.1/tests/template/__snapshots__/test_agents.ambr

@@ -0,0 +1,71 @@
+# serializer version: 1
+# name: test_agents[accepted-with-disclosure]
+  '''
+  # 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.
+  
+  '''
+# ---
+# name: test_agents[accepted]
+  '''
+  # 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)
+  
+  '''
+# ---
+# name: test_agents[not-accepted]
+  '''
+  # 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)
+  
+  # LLM use
+  
+  This project does not accept code or text generated by an LLM. Everything
+  submitted to the project, including code, commit messages, and pull request or
+  issue text, must be written by the user (who is the contributor). Explain,
+  review, run commands, and help plan instead.
+  
+  '''
+# ---