copier-python 0.12.0__tar.gz → 0.13.1__tar.gz

{copier_python-0.12.0 → copier_python-0.13.1}/.gitignore

@@ -4,11 +4,16 @@ __pycache__/
 *.py[cod]
 
 # uv and packaging
-.venv/
+.venv*/
 /build/
 /dist/
 uv.lock
 
+# mise
+mise.local.toml
+.mise.local.toml
+.mise/
+
 # Development tools
 .cache/
 .coverage*

copier_python-0.13.1/AGENTS.md

@@ -0,0 +1,9 @@
+# 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)

{copier_python-0.12.0 → copier_python-0.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: copier-python
-Version: 0.12.0
+Version: 0.13.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
@@ -40,8 +40,13 @@ Description-Content-Type: text/markdown
 
 ## Quick start
 
-With [Astral's **uv**][uv] and [**Copier**][copier] (`uv tool install copier`)
-installed:
+Install required software:
+
+- [**mise-en-place**][mise]: `curl https://mise.run | sh` or
+  [alternate installation method][mise-installation]
+- [**Copier**][copier]: `mise use -g copier` or `uv tool install copier`
+
+Create a new project from the template:
 
 ```sh
 copier copy "gh:smkent/copier-python" /new/project/path
@@ -51,6 +56,10 @@ copier copy "gh:smkent/copier-python" /new/project/path
 
 ## Features
 
+* [**mise-en-place**][mise] ("mise") for development toolchain management
+
+    [![mise][mise-badge]][mise]
+
 * [Astral][astral] toolset: [**uv**][uv], [**ruff**][ruff], and [**ty**][ty]
 
     [![uv][uv-badge]][uv]
@@ -72,8 +81,6 @@ 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]
-* [**Poe the Poet**][poethepoet] for task shortcuts such as
-   `poe lint`, `poe test`
 
 ## Credits
 
@@ -91,7 +98,9 @@ This template was inspired by [pawamoy/copier-uv][copier-uv] and
 [ghcr-docs]: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry
 [github-actions]: https://github.com/features/actions
 [github-pages]: https://pages.github.com
-[poethepoet]: https://poethepoet.natn.io/
+[mise]: https://mise.jdx.dev
+[mise-installation]: https://mise.jdx.dev/installing-mise.html
+[mise-badge]: https://mise-versions.jdx.dev/badge.svg
 [pre-commit]: https://pre-commit.com/
 [prek-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/j178/prek/master/docs/assets/badge-v0.json
 [prek]: https://prek.j178.dev/

{copier_python-0.12.0 → copier_python-0.13.1}/README.md

@@ -10,8 +10,13 @@
 
 ## Quick start
 
-With [Astral's **uv**][uv] and [**Copier**][copier] (`uv tool install copier`)
-installed:
+Install required software:
+
+- [**mise-en-place**][mise]: `curl https://mise.run | sh` or
+  [alternate installation method][mise-installation]
+- [**Copier**][copier]: `mise use -g copier` or `uv tool install copier`
+
+Create a new project from the template:
 
 ```sh
 copier copy "gh:smkent/copier-python" /new/project/path
@@ -21,6 +26,10 @@ copier copy "gh:smkent/copier-python" /new/project/path
 
 ## Features
 
+* [**mise-en-place**][mise] ("mise") for development toolchain management
+
+    [![mise][mise-badge]][mise]
+
 * [Astral][astral] toolset: [**uv**][uv], [**ruff**][ruff], and [**ty**][ty]
 
     [![uv][uv-badge]][uv]
@@ -42,8 +51,6 @@ 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]
-* [**Poe the Poet**][poethepoet] for task shortcuts such as
-   `poe lint`, `poe test`
 
 ## Credits
 
@@ -61,7 +68,9 @@ This template was inspired by [pawamoy/copier-uv][copier-uv] and
 [ghcr-docs]: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry
 [github-actions]: https://github.com/features/actions
 [github-pages]: https://pages.github.com
-[poethepoet]: https://poethepoet.natn.io/
+[mise]: https://mise.jdx.dev
+[mise-installation]: https://mise.jdx.dev/installing-mise.html
+[mise-badge]: https://mise-versions.jdx.dev/badge.svg
 [pre-commit]: https://pre-commit.com/
 [prek-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/j178/prek/master/docs/assets/badge-v0.json
 [prek]: https://prek.j178.dev/

{copier_python-0.12.0 → copier_python-0.13.1}/copier_python/repo.py

@@ -83,17 +83,33 @@ class RepoWorktree:
         with tempfile.TemporaryDirectory() as td:
             repo_dir = Path(td) / "worktree"
             cls.run_in(["git", "clone", repo.url, str(repo_dir)], repo=repo)
-            for cmd in (
+            cls.run_in(
                 [
                     *["git", "remote", "set-url", "--push", "origin"],
                     repo.push_url,
                 ],
-                ["poe", "setup"],
-                ["git", "checkout", "-b", branch],
-            ):
-                cls.run_in(cmd, repo=repo, cwd=repo_dir)
+                repo=repo,
+                cwd=repo_dir,
+            )
+            cls.run_in(
+                (
+                    ["mise", "install"]
+                    if (repo_dir / "mise.toml").is_file()
+                    else ["poe", "setup"]
+                ),
+                repo=repo,
+                cwd=repo_dir,
+            )
+            cls.run_in(
+                ["git", "checkout", "-b", branch], repo=repo, cwd=repo_dir
+            )
             yield cls(path=repo_dir, repo=repo, branch=branch)
 
+    def refresh_tools_lock(self) -> None:
+        if not (self.path / "mise.toml").is_file():
+            return
+        self.run(["mise", "lock"])
+
     @classmethod
     def run_in(
         cls, cmd: list[str], *, repo: RepoTarget, **kwargs: Any
@@ -114,6 +130,16 @@ class RepoWorktree:
         kwargs.setdefault("cwd", self.path)
         return self.run_in(cmd, repo=self.repo, **kwargs)
 
+    def run_task(
+        self, name: str, **kwargs: Any
+    ) -> subprocess.CompletedProcess[str]:
+        task_runner = (
+            ["mise", "run"]
+            if (self.path / "mise.toml").is_file()
+            else ["uv", "run", "poe"]
+        )
+        return self.run([*task_runner, name], **kwargs)
+
     def git_status(self) -> list[str]:
         return self.run(
             ["git", "status", "--porcelain"], capture_output=True

{copier_python-0.12.0 → copier_python-0.13.1}/copier_python/update.py

@@ -51,7 +51,16 @@ class UpdateAction:
                 raise RuntimeError("Conflicts remain, aborting")
 
         try:
-            repo.run(["uv", "run", "poe", "lt"])
+            repo.refresh_tools_lock()
+        except subprocess.CalledProcessError:
+            print(  # noqa: T201
+                "Tool refresh failed."
+                " Fix errors and exit the shell to continue."
+            )
+            repo.shell()
+
+        try:
+            repo.run_task("lt")
         except subprocess.CalledProcessError:
             print(  # noqa: T201
                 "Lint/test failed. Fix errors and exit the shell to continue."

copier_python-0.13.1/docs/development/requirements.md

@@ -0,0 +1,24 @@
+---
+title: Required software
+icon: lucide/bookmark-check
+---
+
+# Required software
+
+- [x] [**git** for version control][git]
+- [x] [**mise**][mise] tool manager: `curl https://mise.run | sh` or
+  [alternate installation method][mise-installation]
+
+    !!! info
+
+        `mise` ensures additional software is available, such as:
+
+        * A [supported version][python-versions] of [**Python**][python]
+        * [Astral's **uv** Python project manager][uv]
+
+[git]: https://git-scm.com
+[mise-installation]: https://mise.jdx.dev/installing-mise.html
+[mise]: https://mise.jdx.dev
+[python-versions]: https://devguide.python.org/versions/
+[python]: https://python.org
+[uv]: https://docs.astral.sh/uv/

{copier_python-0.12.0 → copier_python-0.13.1}/docs/development/workflow.md

@@ -7,12 +7,16 @@ icon: lucide/braces
 
 ## Cloning the repository
 
-Run `poe setup` in new repository clones to enable git hooks:
-
 ```sh
 git clone https://github.com/smkent/copier-python
 cd copier-python
-poe setup  # Enables git hooks
+```
+
+Run `mise install` in new repository clones to install tools, dependencies, and
+git hooks:
+
+```sh
+mise install
 ```
 
 ## Local template usage
@@ -30,13 +34,13 @@ uncommitted changes.
 
 ## Development tools
 
-* `poe lint`: Run formatters and static checks
-* `poe test`: Run tests
+* `mise run lint`: Run formatters and static checks
+* `mise run test`: Run tests
 
 The `lint` and `test` tasks can also be run as a single combined command with:
 
 ```sh
-poe lt
+mise run lt
 ```
 
 ### Test snapshots
@@ -46,7 +50,7 @@ When templates are modified, the snapshots need to be updated. Update test
 snapshots by running:
 
 ```sh
-poe snapup
+mise run snapup
 ```
 
 ## Documentation server
@@ -54,11 +58,11 @@ poe snapup
 Start the development server with:
 
 ```sh
-poe docs
+mise run docs
 ```
 
 The documentation site will be served at:
 
 [**http://localhost:8000**](http://localhost:8000){ .md-button .md-button--primary target="_blank" }
 
-To use a different bind host/port, run `poe --help docs` for arguments info.
+To use a different bind host/port, run `mise run docs --help` for usage info.

{copier_python-0.12.0 → copier_python-0.13.1}/docs/project-creation.md

@@ -45,13 +45,13 @@ Set **Repository name** to your chosen project name.
 To complete project initialization, run:
 
 ```sh
-poe init
+mise run init
 ```
 
 This will:
 
 1. Create the local git repository
-2. Install dependencies and git hooks (same as `poe setup`)
+2. Install tools, dependencies, and git hooks (same as `mise install`)
 3. Create an initial commit with the newly created project contents
 4. Add your GitHub repository as the `origin` remote
    (when `project_visibility: public`)

{copier_python-0.12.0 → copier_python-0.13.1}/docs/project-development.md

@@ -7,23 +7,27 @@ icon: lucide/braces
 
 ## Cloning the repository
 
-Run `poe setup` in new repository clones to enable git hooks:
-
 ```sh
 git clone https://github.com/<github_user>/<project_name>
 cd project_name
-poe setup  # Enables git hooks
+```
+
+Run `mise install` in new repository clones to install tools, dependencies, and
+git hooks:
+
+```sh
+mise install
 ```
 
 ## Development tools
 
-* `poe lint`: Run formatters and static checks
-* `poe test`: Run tests
+* `mise run lint`: Run formatters and static checks
+* `mise run test`: Run tests
 
 The `lint` and `test` tasks can also be run as a single combined command with:
 
 ```sh
-poe lt
+mise run lt
 ```
 
 ## Documentation server
@@ -31,11 +35,11 @@ poe lt
 Start the development server with:
 
 ```sh
-poe docs
+mise run docs
 ```
 
 The documentation site will be served at:
 
 [**http://localhost:8000**](http://localhost:8000){ .md-button .md-button--primary target="_blank" }
 
-To use a different bind host/port, run `poe --help docs` for arguments info.
+To use a different bind host/port, run `mise run docs --help` for usage info.

{copier_python-0.12.0 → copier_python-0.13.1}/docs/project-release.md

@@ -7,11 +7,11 @@ icon: lucide/rocket
 
 Release version numbers should follow [Semantic Versioning][semver].
 
-To create a release, run `poe release` with one of `patch`, `minor`, or `major`
-corresponding to the version number component to update:
+To create a release, run `mise run release` with one of `patch`, `minor`, or
+`major` corresponding to the version number component to update:
 
 ```sh
-poe release patch|minor|major
+mise run release patch|minor|major
 ```
 
 A new tag with the new release version number will be created automatically

{copier_python-0.12.0 → copier_python-0.13.1}/docs/project-setup.md

@@ -10,7 +10,7 @@ icon: lucide/settings
     these instructions are also present in your new project along with links
     directly to your project's specific settings pages! To view:
 
-    1. Start the local documentation server: `poe docs`
+    1. Start the local documentation server: `mise run docs`
     2. In your browser:
 
         1. Open **<http://localhost:8000>**

{copier_python-0.12.0 → copier_python-0.13.1}/docs/releasing.md

@@ -7,11 +7,11 @@ icon: lucide/rocket
 
 Release version numbers should follow [Semantic Versioning][semver].
 
-To create a release, run `poe release` with one of `patch`, `minor`, or `major`
-corresponding to the version number component to update:
+To create a release, run `mise run release` with one of `patch`, `minor`, or
+`major` corresponding to the version number component to update:
 
 ```sh
-poe release patch|minor|major
+mise run release patch|minor|major
 ```
 
 A new tag with the new release version number will be created automatically

copier_python-0.13.1/docs/requirements.md

@@ -0,0 +1,28 @@
+---
+title: Required software
+icon: lucide/bookmark-check
+---
+
+# Required software
+
+- [x] [**git** for verson control][git]
+- [x] [**mise**][mise] tool manager: `curl https://mise.run | sh` or
+  [alternate installation method][mise-installation]
+
+    !!! info
+
+        `mise` ensures additional software is available, such as:
+
+        * A [supported version][python-versions] of [**Python**][python]
+        * [Astral's **uv** Python project manager][uv]
+
+- [x] [**Copier**][copier]: `mise use -g copier`
+  / `uv tool install copier` / `pipx install copier`
+
+[copier]: https://copier.readthedocs.io
+[git]: https://git-scm.com
+[mise-installation]: https://mise.jdx.dev/installing-mise.html
+[mise]: https://mise.jdx.dev
+[python-versions]: https://devguide.python.org/versions/
+[python]: https://python.org
+[uv]: https://docs.astral.sh/uv/

{copier_python-0.12.0 → copier_python-0.13.1}/pyproject.toml

@@ -49,7 +49,6 @@ dev = [
     "bump-my-version>=1.3.0",
     "copier>=9",
     "poethepoet>=0.46",
-    "prek>=0.4",
     "pysentry-rs>=0.4",
     "pytest>=9",
     "pytest-cov>=7",
@@ -77,110 +76,6 @@ include = ["/copier_python", "/tests", "*.md", "LICENSE"]
 [tool.hatch.version]
 source = "uv-dynamic-versioning"
 
-[tool.poe.executor]
-type = "uv"
-
-[tool.poe.tasks.audit]
-cmd = "pysentry-rs"
-help = "Run dependencies security audit"
-
-[tool.poe.tasks.build]
-cmd = "uv build"
-help = "Build distribution package"
-
-[tool.poe.tasks.docs-build]
-cmd = "zensical build -c"
-help = "Build documentation site"
-
-[tool.poe.tasks.docs]
-sequence = [
-    {ref = "docs-build"},
-    {cmd = "zensical serve -a \"${host}:${port}\""},
-]
-help = "Run documentation site locally"
-
-[tool.poe.tasks.docs.args.host]
-options = ['--host', '-h']
-help = "Bind IP"
-default = "localhost"
-
-[tool.poe.tasks.docs.args.port]
-positional = true
-help = "Bind Port"
-default = "8000"
-
-[tool.poe.tasks.init]
-sequence = [
-    {shell = "[ ! -d .git ] || { echo \"git repository already exists\"; exit 1; }"},
-    {cmd = "git init"},
-    {ref = "setup"},
-    {cmd = "git remote add origin https://github.com/smkent/copier-python"},
-    {cmd = "git config --local remote.origin.pushurl git@github.com:smkent/copier-python.git"},
-    {cmd = "git add ."},
-    {cmd = "git commit -m 'Create project from template'"},
-]
-help = "Initialize git repository once on project creation"
-
-[tool.poe.tasks.lint]
-cmd = "prek run --all-files"
-help = "Run all formatters and static checks"
-
-[tool.poe.tasks.release]
-cmd = "bump-my-version bump -v"
-help = "Create and push a release tag (patch/minor/major)"
-
-[tool.poe.tasks.lt]
-sequence = [{ref = "lint"}, {ref = "test"}]
-help = "Run all formatters, static checks and tests"
-
-[tool.poe.tasks.setup]
-sequence = [
-    {cmd = "uv sync"},
-    {cmd = "prek install"},
-]
-help = "Install project dependencies and git hooks"
-
-[tool.poe.tasks.snapup]
-cmd = "pytest --snapshot-update --numprocesses 0"
-help = "Update test snapshots"
-
-[tool.poe.tasks.test]
-cmd = "pytest"
-help = "Run tests"
-
-[tool.poe.tasks.test-versions]
-sequence = ["test-py310", "test-py311", "test-py312", "test-py313", "test-py314"]
-help = "Run tests across all Python versions"
-
-[tool.poe.tasks.test-py310]
-cmd = "pytest"
-executor = {isolated = true, python = "3.10"}
-help = "Run tests using Python 3.10"
-
-[tool.poe.tasks.test-py311]
-cmd = "pytest"
-executor = {isolated = true, python = "3.11"}
-help = "Run tests using Python 3.11"
-
-[tool.poe.tasks.test-py312]
-cmd = "pytest"
-executor = {isolated = true, python = "3.12"}
-help = "Run tests using Python 3.12"
-
-[tool.poe.tasks.test-py313]
-cmd = "pytest"
-executor = {isolated = true, python = "3.13"}
-help = "Run tests using Python 3.13"
-
-[tool.poe.tasks.test-py314]
-cmd = "pytest"
-executor = {isolated = true, python = "3.14"}
-help = "Run tests using Python 3.14"
-
-[tool.poe.tasks.ti]
-cmd = "pytest --numprocesses 0 --no-cov -vv"
-help = "Run tests with debug friendly options"
-
 [tool.pytest]
 addopts = [
     "-ra",

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

@@ -0,0 +1,15 @@
+# serializer version: 1
+# name: test_agents
+  '''
+  # 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)
+  
+  '''
+# ---

{copier_python-0.12.0 → copier_python-0.13.1}/tests/template/__snapshots__/test_contributing.ambr

@@ -39,22 +39,22 @@
   
   ### Prerequisites
   
-  - [x] A [supported version][python-versions] of [**Python**][python]
-  - [x] [**git** for verson control][git]
-  - [x] [Astral's **uv** Python project manager][uv]: `pip install uv` or
-    [other supported method][uv-installation]
-  - [x] [**Copier**][copier]: `uv tool install copier`
-  - [x] [Poe the Poet][poethepoet] (recommended): `uv tool install poethepoet`
+  - [x] [**git** for version control][git]
+  - [x] [**mise**][mise] tool manager: `curl https://mise.run | sh` or
+    [alternate installation method][mise-installation]
   
-      This provides `poe` without the `uv run` prefix,
-      e.g. `poe test` instead of `uv run poe test`
+      !!! info
+  
+          `mise` ensures additional software is available, such as:
+  
+          * A [supported version][python-versions] of [**Python**][python]
+          * [Astral's **uv** Python project manager][uv]
   
-  [copier]: https://copier.readthedocs.io
   [git]: https://git-scm.com
-  [poethepoet]: https://poethepoet.natn.io/
+  [mise-installation]: https://mise.jdx.dev/installing-mise.html
+  [mise]: https://mise.jdx.dev
   [python-versions]: https://devguide.python.org/versions/
   [python]: https://python.org
-  [uv-installation]: https://docs.astral.sh/uv/getting-started/installation/
   [uv]: https://docs.astral.sh/uv/
   
   ### Project development workflow
@@ -66,21 +66,22 @@
   cd PKFire
   ```
   
-  Run `poe setup` in new repository clones to enable git hooks:
+  Run `mise install` in new repository clones to install tools, dependencies, and
+  git hooks:
   
   ```sh
-  poe setup  # Enables git hooks
+  mise install
   ```
   
   #### Development tools
   
-  * `poe lint`: Run formatters and static checks
-  * `poe test`: Run tests
+  * `mise run lint`: Run formatters and static checks
+  * `mise run test`: Run tests
   
   The `lint` and `test` tasks can also be run as a single combined command with:
   
   ```sh
-  poe lt
+  mise run lt
   ```
   
   ### Test snapshots
@@ -89,7 +90,7 @@
   updated by running:
   
   ```sh
-  poe snapup
+  mise run snapup
   ```
   
   ### Applying copier-python template updates