Pattern is a modern, opinionated, cookiecutter template for your next Python project. Included is modern tooling and dependencies with sensible rules and settings. Also included is all the boilerplate documentation, GitHub actions, and project extras you would need to create good foundation for your next python project.

• View our full documentation.

Create new project:

uvx cookiecutter gh:wyattferguson/pattern

Alternatively you can use Cruft:

uvx cruft create gh:wyattferguson/pattern

Then just follow the prompts, pick the tools you want to install, and watch the magic happen.

Everything comes pre-configured to work out of the box. On setup you can pick and choose what extras to install or to leave behind.

• 📦 UV - Package and project manager
• 🦀 Ruff - Linter and code formatter.
• 🐛 Typechecking with Ty or Mypy.
• 🧪 Pytest - Testing
• 🔭 Coverage - Test coverage.
• 🍧 Nox - Testing in multiple Python environments.
• 🛩️ Taskipy - Task runner for CLI shortcuts.
• 📼 Portray - Doc generation and Github Pages deployment.
• 🥡 PyPI package publishing.
• 🍹 GitHub Templates for documentation, feature requests, general reports, bug reports, and pull requests.
• 🌵 Pre-commit - Linting, formatting, and common bug checks on Git commits.
• 📑 Changelog, Code of Conduct, Contributing Guide, and Citation templates.
• 🐋 Docker support including extensive dockerignore file.
• 🍸 VSCode - Settings and extension integrations.
• 🤖 Dependabot - Dependency scanning for new versions and security alerts.
• 🧙‍♂️ Semantic Pull Requests - Enforce pull request titles
• 🚚 Cruft Support - Automatic template updates and validation.

If this cookiecutter isn't your cup of tea, you might like one of these alternatives.

• Fpgmaas cookiecutter-uv - fpgmaas version of a cookiecutter using UV.
• Bosd uv-hypermodern-python - bosd version of a cookiecutter uv project with github deployments.
• Cookiecutter pypackage - Cookiecutter template for a Python package.
• Neuroinformatics cookiecutter - Utility to create a basic Python project structure with tests, CI etc.

Contributions or suggestions are more then welcome! If you'd like to enhance to this project, please submit a pull request. For major changes, please open an issue first to discuss what you would like to change.

View our full documentation.

MIT License

Created by Wyatt Ferguson

For any questions or comments heres how you can reach me: