copier-python 0.1.0__tar.gz

copier_python-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+# Python
+__pycache__/
+*.egg-info/
+*.py[cod]
+
+# uv and packaging
+.venv/
+/build/
+/dist/
+uv.lock
+
+# Development tools
+.cache/
+.coverage*
+.pytest_cache/
+.ruff_cache/
+/htmlcov/
+/site/
+coverage.xml

copier_python-0.1.0/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+[Unreleased]: https://github.com/smkent/copier-python/commits/main/

copier_python-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,30 @@
+# Contributing to copier-python
+
+## Development setup
+
+### Prerequisites
+
+- [Astral's **uv** Python project manager][uv]
+- [`poethepoet`][poe] task runner: `uv tool install poethepoet`
+
+### Project setup
+
+```sh
+git clone https://github.com/smkent/copier-python
+cd copier-python
+uv sync
+uv run poe setup  # Enables pre-commit hooks
+```
+
+## Common tasks
+
+| Command | Description |
+|---|---|
+| `poe docs` | Run documentation server locally |
+| `poe lint` | Run all formatters and static checks |
+| `poe lt` | Run all formatters, static checks and tests (`lint` and `test`) |
+| `poe snapup` | Update test snapshots |
+| `poe test` | Run tests |
+
+[poe]: https://poethepoet.naln1.net/
+[uv]: https://docs.astral.sh/uv/

copier_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stephen Kent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

copier_python-0.1.0/MAINTAINING.md

@@ -0,0 +1,68 @@
+# Maintaining copier-python
+
+## First time setup
+
+These steps only need to be completed once after the project is first created.
+
+### GitHub Repository
+
+[Settings → General][repo-settings]:
+
+- [x] Allow merge commits
+- [ ] Allow squash merging
+- [ ] Allow rebase merging
+- [x] Automatically delete head branches
+
+[Settings → Branches][repo-settings-branches] → Add branch protection rule
+for the Default branch (`main`):
+
+- [x] Restrict deletions
+- [x] Require a pull request before merging
+- [x] Block force pushes
+
+### Renovate
+
+Ensure the [Renovate app][renovate] is installed on your account, then
+enable it for `smkent/copier-python`.
+
+### PyPI publishing
+
+This project uses [trusted publishing][pypi-trusted-publishing] so no API tokens
+need to be stored as secrets.
+
+1. On PyPI, add a (pending) trusted publisher in your
+   [Trusted Publisher Management][pypi-publishing-settings] settings:
+     - Publisher: GitHub Actions
+     - Owner: `smkent`
+     - Repository: `copier-python`
+     - Workflow: `release.yaml`
+     - Environment: `pypi`
+2. Create the `pypi` environment in the GitHub repository:
+   [Settings → Environments][repo-settings-envs] → New environment → `pypi`
+3. Publish a release by pushing a tag:
+   ```sh
+   git tag 0.1.0  # or your desired first version number
+   git push --tags
+   ```
+
+### GitHub Pages
+
+[Settings → Pages][repo-settings-pages] → Source → GitHub Actions
+
+## Releasing
+
+1. Update `CHANGELOG.md`: move items from `[Unreleased]` into a new version
+   section and update the comparison link at the bottom
+2. Commit and tag:
+   ```sh
+   git tag X.Y.Z
+   git push --tags
+   ```
+
+[pypi-publishing-settings]: https://pypi.org/manage/account/publishing/
+[pypi-trusted-publishing]: https://docs.pypi.org/trusted-publishers/
+[renovate]: https://github.com/apps/renovate
+[repo-settings]: https://github.com/smkent/copier-python/settings
+[repo-settings-envs]: https://github.com/smkent/copier-python/settings/environments
+[repo-settings-branches]: https://github.com/smkent/copier-python/settings/branches
+[repo-settings-pages]: https://github.com/smkent/copier-python/settings/pages

copier_python-0.1.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: copier-python
+Version: 0.1.0
+Summary: Copier template for Python projects with modern tooling
+Project-URL: Homepage, https://github.com/smkent/copier-python
+Project-URL: Repository, https://github.com/smkent/copier-python
+Project-URL: Issues, https://github.com/smkent/copier-python/issues
+Author-email: Stephen Kent <smkent@smkent.net>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# copier-python
+
+[Copier][copier] template for Python projects with modern tooling
+
+[![License](https://img.shields.io/github/license/smkent/copier-python)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/copier-python)](https://pypi.org/project/copier-python/)
+[![Python](https://img.shields.io/pypi/pyversions/copier-python)](https://pypi.org/project/copier-python/)
+[![CI](https://github.com/smkent/copier-python/actions/workflows/ci.yml/badge.svg)](https://github.com/smkent/copier-python/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/smkent/copier-python/branch/main/graph/badge.svg)](https://codecov.io/gh/smkent/copier-python)
+[![Renovate](https://img.shields.io/badge/renovate-enabled-brightgreen?logo=renovatebot)](https://renovatebot.com)
+[![GitHub stars](https://img.shields.io/github/stars/smkent/copier-python?style=social)](https://github.com/smkent/copier-python)
+
+## Prerequisites
+
+- [Astral's **uv** Python project manager][uv]
+- [Copier][copier]: `uv tool install copier`
+
+## Usage
+
+```sh
+copier copy "gh:smkent/copier-python" /new/project/path
+```
+
+[copier]: https://copier.readthedocs.io
+[uv]: https://docs.astral.sh/uv/
+
+## Credits
+
+This template was inspired by [pawamoy/copier-uv][copier-uv] and
+[ritwiktiwari/copier-astral][copier-astral] -- Thanks!
+
+[copier-uv]: https://github.com/pawamoy/copier-uv
+[copier-astral]: https://github.com/ritwiktiwari/copier-astral

copier_python-0.1.0/README.md

@@ -0,0 +1,33 @@
+# copier-python
+
+[Copier][copier] template for Python projects with modern tooling
+
+[![License](https://img.shields.io/github/license/smkent/copier-python)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/copier-python)](https://pypi.org/project/copier-python/)
+[![Python](https://img.shields.io/pypi/pyversions/copier-python)](https://pypi.org/project/copier-python/)
+[![CI](https://github.com/smkent/copier-python/actions/workflows/ci.yml/badge.svg)](https://github.com/smkent/copier-python/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/smkent/copier-python/branch/main/graph/badge.svg)](https://codecov.io/gh/smkent/copier-python)
+[![Renovate](https://img.shields.io/badge/renovate-enabled-brightgreen?logo=renovatebot)](https://renovatebot.com)
+[![GitHub stars](https://img.shields.io/github/stars/smkent/copier-python?style=social)](https://github.com/smkent/copier-python)
+
+## Prerequisites
+
+- [Astral's **uv** Python project manager][uv]
+- [Copier][copier]: `uv tool install copier`
+
+## Usage
+
+```sh
+copier copy "gh:smkent/copier-python" /new/project/path
+```
+
+[copier]: https://copier.readthedocs.io
+[uv]: https://docs.astral.sh/uv/
+
+## Credits
+
+This template was inspired by [pawamoy/copier-uv][copier-uv] and
+[ritwiktiwari/copier-astral][copier-astral] -- Thanks!
+
+[copier-uv]: https://github.com/pawamoy/copier-uv
+[copier-astral]: https://github.com/ritwiktiwari/copier-astral

copier_python-0.1.0/copier_python/__init__.py

@@ -0,0 +1,8 @@
+"""Copier template for Python projects with modern tooling."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version(__name__)
+except PackageNotFoundError:
+    __version__ = "0.0.0"

copier_python-0.1.0/docs/api.md

@@ -0,0 +1,3 @@
+# API Reference
+
+::: copier_python

copier_python-0.1.0/docs/changelog.md

@@ -0,0 +1,5 @@
+---
+icon: lucide/history
+---
+
+--8<-- "CHANGELOG.md"

copier_python-0.1.0/docs/contributing.md

@@ -0,0 +1,5 @@
+---
+icon: lucide/code
+---
+
+--8<-- "CONTRIBUTING.md"

copier_python-0.1.0/docs/index.md

@@ -0,0 +1,5 @@
+---
+icon: lucide/book-open
+---
+
+--8<-- "README.md"

copier_python-0.1.0/docs/license.md

@@ -0,0 +1,9 @@
+---
+icon: lucide/scale
+---
+
+# License
+
+```
+--8<-- "LICENSE"
+```

copier_python-0.1.0/docs/maintaining.md

@@ -0,0 +1,5 @@
+---
+icon: lucide/construction
+---
+
+--8<-- "MAINTAINING.md"

copier_python-0.1.0/pyproject.toml

@@ -0,0 +1,219 @@
+[build-system]
+requires = ["hatchling", "uv-dynamic-versioning"]
+build-backend = "hatchling.build"
+
+[project]
+name = "copier-python"
+dynamic = ["version"]
+description = "Copier template for Python projects with modern tooling"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [
+    { name = "Stephen Kent", email = "smkent@smkent.net" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Documentation",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+keywords = []
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/smkent/copier-python"
+Repository = "https://github.com/smkent/copier-python"
+Issues = "https://github.com/smkent/copier-python/issues"
+
+[dependency-groups]
+dev = [
+    "copier>=9",
+    "poethepoet>=0.42",
+    "prek>=0.3",
+    "pysentry-rs>=0.4",
+    "pytest>=9.0",
+    "pytest-cov>=7.0",
+    "pytest-sugar>=1.0",
+    "syrupy>=4.0",
+    "ruff>=0.15",
+    "ty>=0.0.26",
+]
+docs = [
+    "mkdocstrings[python]>=1",
+    "zensical>=0.0.30",
+]
+
+[tool.hatch.build.targets.sdist]
+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"},
+    {cmd = "uv sync"},
+    {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.lt]
+sequence = [{ref = "lint"}, {ref = "test"}]
+help = "Run all formatters, static checks and tests"
+
+[tool.poe.tasks.setup]
+cmd = "prek install"
+help = "Install git hooks"
+
+[tool.poe.tasks.snapup]
+cmd = "pytest --snapshot-update"
+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.pytest]
+addopts = [
+    "-ra",
+    "--cov",
+    "--strict-config",
+    "--strict-markers",
+]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["copier_python"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]
+
+[tool.ruff]
+line-length = 79
+output-format = "concise"
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "ANN401",  # Dynamically typed expressions (typing.Any) are disallowed
+    "COM812",  # Trailing comma missing
+    "D1",  # Missing docstring presence rules
+    "EM",  # flake8-errmsg
+    "G004",  # Logging statement uses f-string
+    "PLR",  # pylint Refactor
+    "S607",  # Starting a process with a partial executable path
+    "TD",  # flake8-todos
+    "TRY003", # Avoid specifying long messages outside the exception class
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["copier_python"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "ARG",  # flake8-unused-arguments
+    "S101",  # Use of assert detected
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ty.terminal]
+error-on-warning = true
+output-format = "concise"
+
+[tool.uv]
+default-groups = ["dev", "docs"]
+
+[tool.uv-dynamic-versioning]
+pattern = "default-unprefixed"
+fallback-version = "0.0.0"

copier_python-0.1.0/tests/__snapshots__/test_contributing.ambr

@@ -0,0 +1,68 @@
+# serializer version: 1
+# name: test_maintaining_features[docs]
+  '''
+  # Contributing to PKFire
+  
+  ## Development setup
+  
+  ### Prerequisites
+  
+  - [Astral's **uv** Python project manager][uv]
+  - [`poethepoet`][poe] task runner: `uv tool install poethepoet`
+  
+  ### Project setup
+  
+  ```sh
+  git clone https://github.com/ness/PKFire
+  cd PKFire
+  uv sync
+  uv run poe setup  # Enables pre-commit hooks
+  ```
+  
+  ## Common tasks
+  
+  | Command | Description |
+  |---|---|
+  | `poe docs` | Run documentation server locally |
+  | `poe lint` | Run all formatters and static checks |
+  | `poe lt` | Run all formatters, static checks and tests (`lint` and `test`) |
+  | `poe test` | Run tests |
+  
+  [poe]: https://poethepoet.naln1.net/
+  [uv]: https://docs.astral.sh/uv/
+  
+  '''
+# ---
+# name: test_maintaining_features[no_docs]
+  '''
+  # Contributing to PKFire
+  
+  ## Development setup
+  
+  ### Prerequisites
+  
+  - [Astral's **uv** Python project manager][uv]
+  - [`poethepoet`][poe] task runner: `uv tool install poethepoet`
+  
+  ### Project setup
+  
+  ```sh
+  git clone https://github.com/ness/PKFire
+  cd PKFire
+  uv sync
+  uv run poe setup  # Enables pre-commit hooks
+  ```
+  
+  ## Common tasks
+  
+  | Command | Description |
+  |---|---|
+  | `poe lint` | Run all formatters and static checks |
+  | `poe lt` | Run all formatters, static checks and tests (`lint` and `test`) |
+  | `poe test` | Run tests |
+  
+  [poe]: https://poethepoet.naln1.net/
+  [uv]: https://docs.astral.sh/uv/
+  
+  '''
+# ---