# ionelmc/cookiecutter-pylibrary

Enhanced cookiecutter template for Python libraries.

Repository: https://github.com/ionelmc/cookiecutter-pylibrary
Canonical: https://ross.abutalabs.com/products/cookiecutter-pylibrary
Language: Python
License: BSD-2-Clause
License Family: permissive
Topics: python, cookiecutter-template, template, cookiecutter
Last push: 2026-04-08T21:40:19+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 76, release rhythm 8, longevity 100
- inputs: {"age_days": 4480, "days_push": 147, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1298, forks 206 (observed 2026-08-28T04:04:17.276535+00:00)

## What it is
A cookiecutter template for scaffolding Python library projects with batteries-included tooling. It generates projects preconfigured with tox, pytest, CI services, coverage reporting, Sphinx docs, and packaging checks.

## Use cases
- scaffold a new python library project
- generate a python package template with tox and pytest setup
- bootstrap a python library with CI and readthedocs configuration
- create a python project with c extension support
- avoid python packaging pitfalls when starting a library

## When to choose
- you are starting a new Python library and want mature packaging defaults out of the box
- you want tox-based multi-version testing, coverage, and CI configs preconfigured
- you need Sphinx documentation ready for ReadTheDocs

## When to avoid
- you are building a web application rather than a library
- you prefer a minimal template you can configure yourself
- your project is not in Python

## Facets
- artifact type: learning-resource
- maturity: active
- function: boilerplate, build-tool, testing, documentation, ci-cd
- domain: developer-tools
- platform: python, cli, cross-platform
- tags: cookiecutter, python-library, project-template, tox, sphinx, packaging, boilerplate, python

## Member repositories
- ionelmc/cookiecutter-pylibrary (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:17.276535+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T08:33:17.373012+00:00, confidence not recorded.
  - readme: https://github.com/ionelmc/cookiecutter-pylibrary (fetched 2026-08-28T04:04:17.276535+00:00, sha 9f48e8848e9b)
- Data as of 2026-08-30T08:39:29.467469+00:00.
