Brendon Smith (br3ndonland)
Welcome! This is a template repository for Python projects, engineered for use as a GitHub template repository. To use the template, click on "Use this template" or browse to template-python/generate. GitHub will create a new repository without the commit history from this one.
The template-python repo name can be replaced with a one-line terminal command: git grep -l 'template-python' | xargs sed -i '' 's/template-python/repo-name/g' (replace repo-name with the name of the repository you generate). There may also be a few edits to the pyproject.toml needed. See the quickstart section for more.
Another common approach, especially for Python, is to use cookiecutter. In a cookiecutter repo, the developer adds template variables throughout, like {{cookiecutter.repo_name}}. When a user runs cookiecutter using the template repository, the template variables are replaced with the information the user provides. This repo is simple enough that I haven't needed to add cookiecutter yet.
Copier is similar to cookiecutter, with some additional benefits. Copier is being refactored in preparation for version 6, and I may consider updating this repo for Copier 6.
❯ cd path/to/repo
# Replace instances of template-python with new repo name
# In the command below, use your repo name instead of 'repo-name'
❯ git grep -l 'template-python' | xargs sed -i '' 's|template-python|repo-name|g'
❯ git grep -l 'templatepython' | xargs sed -i '' 's|templatepython|repo-name|g'
# Install virtual environment with poetry: https://python-poetry.org/docs/
❯ poetry install
❯ poetry shell
# Install pre-commit hooks
.venv ❯ pre-commit install
# Try running the tests
.venv ❯ pytestSee CONTRIBUTING.md.