{"id":42969062,"url":"https://github.com/georgedouzas/copier-modern-python","last_synced_at":"2026-02-21T04:01:17.988Z","repository":{"id":142680254,"uuid":"613565947","full_name":"georgedouzas/copier-modern-python","owner":"georgedouzas","description":"Copier template for modern Python projects.","archived":false,"fork":false,"pushed_at":"2026-01-13T07:52:58.000Z","size":293,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-31T14:35:20.483Z","etag":null,"topics":["bootstrapping","copier","copier-template","nox","pdm","python","scaffolding","template","uv"],"latest_commit_sha":null,"homepage":"https://georgedouzas.github.io/copier-modern-python/","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/georgedouzas.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["georgedouzas"]}},"created_at":"2023-03-13T20:28:21.000Z","updated_at":"2026-01-17T09:02:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"c4c95964-7bfd-438e-b04f-daad9456ee87","html_url":"https://github.com/georgedouzas/copier-modern-python","commit_stats":null,"previous_names":["georgedouzas/copier-modern-python"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/georgedouzas/copier-modern-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgedouzas%2Fcopier-modern-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgedouzas%2Fcopier-modern-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgedouzas%2Fcopier-modern-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgedouzas%2Fcopier-modern-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/georgedouzas","download_url":"https://codeload.github.com/georgedouzas/copier-modern-python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgedouzas%2Fcopier-modern-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29672753,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T03:11:15.450Z","status":"ssl_error","status_checked_at":"2026-02-21T03:10:34.920Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrapping","copier","copier-template","nox","pdm","python","scaffolding","template","uv"],"created_at":"2026-01-31T00:22:19.476Z","updated_at":"2026-02-21T04:01:17.917Z","avatar_url":"https://github.com/georgedouzas.png","language":"Jinja","funding_links":["https://github.com/sponsors/georgedouzas"],"categories":[],"sub_categories":[],"readme":"# Copier Modern Python\n\n[Copier](https://github.com/copier-org/copier) template for modern Python projects.\n\nThis template provides a comprehensive, production-ready Python project structure with modern tooling and best practices. It\nsupports both [PDM](https://github.com/pdm-project/pdm) and [uv](https://github.com/astral-sh/uv) package managers, includes\nautomated testing and quality checks, comprehensive documentation setup, and CI/CD workflows for multiple Git providers.\n\n## Features\n\nDuring the Copier generation process, you'll be prompted to select your preferences for package management, Git provider,\nlicensing, and other options. The template then generates a customized project structure with only the tools and configurations\nyou need.\n\n### Package Management\n\nChoose between two modern Python package managers. [PDM](https://github.com/pdm-project/pdm) offers cutting-edge dependency\nmanagement with PEP 582 support, allowing you to avoid virtual environments entirely. [uv](https://github.com/astral-sh/uv)\nprovides blazing-fast package installation and resolution, significantly reducing setup times. Both managers handle dependency\nlocking, virtual environment management, and script execution seamlessly.\n\n### Task Runner\n\n[Nox](https://github.com/wntrblm/nox) replaces traditional Makefiles with Python-based automation. The template includes\npre-configured sessions for testing across multiple Python versions, code formatting, quality checks, and documentation building.\nThis ensures consistent development workflows across different environments and team members.\n\n### Documentation\n\nAutomatic documentation generation using [MkDocs](https://github.com/mkdocs/mkdocs) with the beautiful\n[Material](https://squidfunk.github.io/mkdocs-material) theme. The [mkdocstrings](https://mkdocstrings.github.io/) plugin extracts\nAPI documentation directly from your docstrings, keeping documentation in sync with code. Includes example pages, custom CSS, and\nresponsive design out of the box.\n\n### Code Quality \u0026 Formatting\n\nEnforce consistent code style with [black](https://github.com/psf/black) for uncompromising formatting and\n[docformatter](https://github.com/PyCQA/docformatter) for PEP 257 compliant docstrings. [Ruff](https://github.com/astral-sh/ruff)\nprovides extremely fast linting with hundreds of rules, replacing multiple toolsin a single, performant package.\n[interrogate](https://interrogate.readthedocs.io/en/latest/) ensures your code is properly documented by checking docstring\ncoverage.\n\n### Security \u0026 Safety\n\nProactive security scanning with [safety](https://github.com/pyupio/safety) to detect known vulnerabilities in dependencies and\n[bandit](https://github.com/PyCQA/bandit) to identify common security issues in your code. These tools integrate into CI/CD\npipelines to catch security problems before deployment.\n\n### Type Checking\n\n[mypy](https://github.com/python/mypy) provides static type analysis to catch type-related bugs before runtime. The template\nincludes sensible defaults and excludes common directories like tests and generated documentation.\n\n### Testing\n\nComprehensive testing setup with [pytest](https://github.com/pytest-dev/pytest) and essential plugins.\n[coverage](https://github.com/coveragepy/coveragepy) tracks code coverage with HTML reports. Tests run in parallel for faster\nfeedback during development.\n\n### Development Workflow\n\n[pre-commit](https://github.com/pre-commit/pre-commit) hooks automatically run quality checks before each commit, preventing\nbroken code from entering the repository. [git-changelog](https://github.com/pawamoy/git-changelog) generates beautiful changelogs\nfrom conventional commit messages, automating release documentation.\n\n### Platform Support\n\nSupports all major Git providers with pre-configured CI/CD workflows. Choose from GitHub Actions, GitLab CI, Azure Pipelines, or\nBitbucket Pipelines. Includes automated testing, quality checks, documentation deployment, and PyPI publishing. License selection\ncovers all popular open-source licenses with proper SPDX identifiers.\n\n## Prerequisites\n\nBefore using this template, ensure you have the following tools installed:\n\n### Required Tools\n\n- [Python](https://www.python.org/) (\u003e= 3.11)\n- [Git](https://git-scm.com/) (\u003e= 2.30.0)\n- [Copier](https://github.com/copier-org/copier)\n\n### Package Manager\n\nChoose one of the following:\n\n- [PDM](https://github.com/pdm-project/pdm) (\u003e= 2.9.0)\n- [uv](https://github.com/astral-sh/uv) (\u003e= 0.1.0)\n\n### Git Provider CLI Tools\n\nDepending on your chosen Git provider, install the corresponding CLI tool for automated releases:\n\n- [GitHub](https://cli.github.com/)\n- [GitLab](https://gitlab.com/gitlab-org/cli)\n- [Azure](https://docs.microsoft.com/en-us/cli/azure/)\n- [Atlassian](https://developer.atlassian.com/cloud/acli)\n\n## Usage\n\n### Creating a New Project\n\nTo create a new Python project using this template:\n\n```bash\ncopier copy \"gh:georgedouzas/copier-modern-python.git\" /path/to/your/new/project\n```\n\nThe template will prompt you for various configuration options including:\n\n- Project name and description\n- Author information\n- Package manager preference (PDM or uv)\n- Git provider (GitHub, GitLab, Azure DevOps, Bitbucket, or None)\n- License selection\n- Python version requirements\n- Publishing preferences\n\n### Updating an Existing Project\n\nTo update your project with the latest template version:\n\n```bash\ncd /path/to/your/project\ncopier update\n```\n\nThis will apply any template updates while preserving your project-specific configurations.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeorgedouzas%2Fcopier-modern-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeorgedouzas%2Fcopier-modern-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeorgedouzas%2Fcopier-modern-python/lists"}