My copier Python project template. Tested with CTT.
I was inspired by https://blog.jaraco.com/skeleton.
The goal of this project is to provide a skeleton for my Python projects, simultaneously trying to take on the following jaraco/skeleton challenges:
- Solve the History is Forever problem.
- The true history is not obscured.
- Existing histories are not broken until the handoff commit is pulled.
- Attribution is not lost.
- Solve the Continuous Integration Mismatch problem.
- Downstream projects and the skeleton itself can have different CI configurations.
- Solve the Commit Integrations Mismatch problem.
- Downstream projects and the skeleton itself can reference different issues and pull requests in their commit histories.
Because the project does not copy the whole history from skeleton, many of the problems are solved by design.
You might use this template or fork it and modify it to your needs.
Configure GitHub CLI
gh auth loginsudo apt update && sudo apt install pipx redis gnome-keyring
pipx install copier keyring
pipx inject copier copier-templates-extensions tomli
SKELETON=gh:skeleton-ci/skeleton-python
-
Make sure that you trust me.
-
Run the following command:
copier copy --trust --vcs-ref HEAD "$SKELETON" path/to/project -
Answer the questions.
-
Change directory to your project:
cd path/to/project -
Happy coding! Your repository is on GitHub and has:
- a release maker (
💲 poe release), - skeleton tool (
💲 poe skeleton [upgrade|patch]), - aesthetic badges in README.md,
- an auto-generated LICENSE file,
- a pre-configured
pyproject.tomlfile, - pre-configured towncrier tasks for changelog generation (
💲 poe [added|changed|deprecated|removed|fixed|security]), - a ready-to-use Poetry virtual environment with all the necessary dev dependencies installed, including poethepoet, pre-commit, mypy, Ruff, etc.
- a pre-configured CI suite for GitHub Actions (including coverage report) and pre-commit.
Almost the same as above.
-
Change directory to your project:
cd path/to/project -
Run the following command:
copier copy --trust --vcs-ref HEAD "$SKELETON" .
-
Answer the questions.
-
Allow copier to overwrite all files.
-
Patch your files (changes were locally reverted for your convenience). Be sure that the codebase is not lost but files maintained by skeleton are updated.
-
Run the following command:
poe skeleton upgrade
-
Happy coding!
poe skeleton upgradeOr, for a specific ref:
poe skeleton upgrade 1.0.0 # Upgrade to skeleton-ci/skeleton-python@1.0.0.
poe skeleton upgrade dev # Upgrade to the latest commit on the dev branch.poe skeleton patch-
Install Poetry and project dependencies.
sudo apt install pipx # If you don't have pipx installed yet. pipx install poetry pipx inject poetry "sync-pre-commit-lock[poetry]" poetry install
-
Install pre-commit hooks.
pre-commit install
-
Test your skeleton.
ctt
This project is licensed under the terms of the MIT License.
@jpsca, for creating Copier.
@pawamoy, for creating a sample poetry project template.
@jaraco, for inspiring me to create my own skeleton, like the one he has.
Read more about copier.
Read more about jaraco/skeleton.
(C) 2023–present Bartosz Sławecki (@bswck).