Public recordCritical
Software health reportschema 0.11.0 · metrics 1.13.0 · 2026-07-17 00:48 UTC
PyCQA / pydocstyle
docstring style checker
PyCQA/pydocstyle holds a health index of 19 out of 100, placing it in the Critical band. It scores highest on Engineering Quality (84/100) and lowest on Security (1/100). The repository is archived, so no further maintenance is expected.
19
overall / 100Software health index
Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At risk ceiling of 49. AI Readiness sits outside the overall score.
19
Excellent85-100Exemplary; meets essentially all checked criteria
Good70-84Healthy; minor gaps
Moderate50-69Acceptable with notable gaps; review recommended
At risk30-49Significant weaknesses; adoption warrants caution
Critical1-29Severe problems (abandoned, single-maintainer, no hygiene)
Score profile
Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.
Abandonment Policy applies a 40% multiplier to weighted overall health and gives it a ceiling of 29.
Ownership
Python Code Quality AuthorityOrganization
1,013 followers29 public repossince Sep 2014
This repository is backed by an organization — shared, accountable stewardship that can outlive any single maintainer.
Package ecosystems
| Registry | Package | Version | Downloads / mo | Versions | Last publish |
|---|---|---|---|---|---|
| PyPI | pydocstyle | 6.3.0 | - | 22 | 1276 days ago |
Metrics by category
Vitality
Is the project alive — is code being written and are releases shipping?
21
Development activity
1Critical
Abandonment alert
Work has arrived and nobody has attended to it
archived on GitHub by its maintainersOverall rating: Critical ceiling
Silence alone is never the finding — a small, finished library may need no commits for years. This alert requires both: no human commit for a long time, and obligations the project is visibly not discharging. Automated commits do not count as maintenance.
How abandonment is assessedHow it's scored
| 0/36 | Push recency — last push 986 days ago |
| 0/36 | Commit cadence — 0/52 weeks with commits |
| 0/18 | Commit volume — 0 commits in the last year |
| 0/10 | OpenSSF Scorecard: Maintained — no data |
Inputs used
| commits_last_year | 0 |
| human_commit_share | — |
| days_since_last_push | 986 |
| active_weeks_last_year | 0 |
Release discipline
52Moderate
How it's scored
| 27/27 | Ships releases — 17 releases published |
| 0/36 | Release recency — latest release 1,276 days ago |
| 19.8/27 | Release cadence — a release every ~97.6 days |
| 0/10 | OpenSSF Scorecard: Signed-Releases — no data |
Inputs used
| releases_count | 17 |
| latest_release_tag | 6.3.0 |
| releases_from_tags | no |
| days_since_latest_release | 1,276 |
| mean_days_between_releases | 97.6 |
Community & Adoption
Does the project have users, downloads, attention, and a welcoming setup for contributors?
63
Popularity & adoption
68Moderate
How it's scored
| 49.4/60 | Stars — 1,117 stars |
| 19/25 | Forks — 190 forks |
| 0/15 | Watchers — 2 watchers |
Inputs used
| forks | 190 |
| stars | 1,117 |
| watchers | 2 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Community health
57Moderate
How it's scored
| 22.5/22.5 | README |
| 22.5/22.5 | License — recognized license (MIT) |
| 0/18 | CONTRIBUTING guide |
| 0/13.5 | Code of conduct |
| 0/7.2 | Issue template |
| 6.3/6.3 | PR template |
Inputs used
| has_readme | yes |
| has_license | yes |
| has_contributing | no |
| has_issue_template | no |
| has_code_of_conduct | no |
| has_pull_request_template | yes |
Sustainability & Governance
Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?
61
Maintainer resilience (bus factor)
37At risk
How it's scored
| 9/54 | Bus factor — 1 contributor(s) cover half of all commits |
| 10.9/22.5 | Commit distribution — top contributor authored 52% of commits |
| 13.5/13.5 | Contributor breadth — 85 contributors |
| 0/10 | OpenSSF Scorecard: Contributors — no data |
Inputs used
| bus_factor | 1 |
| contributors_sampled | 85 |
| top_contributor_share | 0.515 |
How it's scored
| 31.1/46.8 | Issue resolution — 67% of issues closed |
| 29/38.3 | PR acceptance — 235/310 decided PRs merged |
| 0/15 | OpenSSF Scorecard: Code-Review — no data |
Inputs used
| merged_prs | 235 |
| open_issues | 113 |
| closed_issues | 225 |
| issue_closed_ratio | 0.666 |
| closed_unmerged_prs | 75 |
Ownership & stewardship
74Good
How it's scored
| 30/30 | Ownership backing — organization-owned |
| 0/20 | Verified domain |
| 21.6/25 | Owner reach — 1,013 followers of PyCQA |
| 22.8/25 | Track record — 29 public repos, account ~11 yr old |
Inputs used
| followers | 1,013 |
| owner_type | Organization |
| is_verified | — |
| owner_login | PyCQA |
| public_repos | 29 |
| account_age_days | 4,325 |
Package maintenance
69Moderate
How it's scored
| 25/25 | Published & resolvable — 1 package(s) on pypi |
| 4/35 | Publish recency — latest publish 1,276 days ago |
| 20/20 | Version history — 22 published versions |
| 20/20 | Not deprecated — active, not deprecated or yanked |
Inputs used
| packages | pydocstyle |
| ecosystems | pypi |
| any_deprecated | no |
| min_days_since_publish | 1,276 |
Engineering Quality
Are baseline engineering and documentation practices in place?
84
Engineering practices
80Good
How it's scored
| 24/24 | CI workflows — 3 workflow(s) |
| 24/24 | Tests present |
| 16/16 | Linter config — tox.ini |
| 0/9.6 | Pre-commit hooks |
| 0/6.4 | .editorconfig |
| 0/20 | OpenSSF Scorecard: CI-Tests — no data |
Inputs used
| has_ci | yes |
| has_tests | yes |
| has_editorconfig | no |
| has_linter_config | yes |
| has_precommit_config | no |
Documentation
90Excellent
How it's scored
| 30/30 | README |
| 25/25 | Documentation directory |
| 15/15 | Documentation / homepage site — http://pydocstyle.org |
| 10/10 | Repository description |
| 10/10 | Topics — 3 topics |
| 0/10 | Wiki |
Inputs used
| topics | python, linter, docstrings |
| has_wiki | no |
| homepage | http://pydocstyle.org |
| has_readme | yes |
| has_docs_dir | yes |
| has_description | yes |
Security
Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?
1
Security posture
1Critical
How it's scored
| 0/30 | Security policy (SECURITY.md) |
| 0/25 | Dependabot config |
| 0/25 | Dependency lockfiles — published library — lockfiles are an application concern, not expected |
| 0/20 | CodeQL workflow |
Inputs used
| source | file_signals |
| lockfiles | poetry.lock |
| manifests | pyproject.toml, requirements.txt |
| has_codeql_workflow | no |
| has_security_policy | no |
| has_dependabot_config | no |
Excluded from scoring (no data or not applicable): Dependency lockfiles. Remaining weights renormalized.
AI Readiness
How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.
50
Agent context & guidance
1Critical
How it's scored
| 0/45 | Agent instructions — no CLAUDE.md / AGENTS.md / editor rules |
| 0/15 | Machine-readable docs (llms.txt) |
| 0/40 | Legible commit history — no data |
Inputs used
| has_llms_txt | no |
| legible_history_share | — |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.
Verify loop (build / test / typecheck)
85Excellent
How it's scored
| 18/18 | One-command bootstrap — Makefile, docs/Makefile |
| 22/22 | Automated tests |
| 11/11 | Lint / format config — tox.ini |
| 0/11 | Static type checking |
| 10/10 | Reproducible environment — lockfile |
| 0/10 | Demonstrated agent practice — no data |
| 0/8 | Automated maintenance — no data |
| 0/10 | OpenSSF Scorecard: Pinned-Dependencies — no data |
Inputs used
| has_nix | no |
| has_tests | yes |
| lockfiles | poetry.lock |
| has_dockerfile | no |
| typed_language | no |
| bootstrap_files | Makefile, docs/Makefile |
| has_devcontainer | no |
| has_linter_config | yes |
| typecheck_configs | — |
| agent_commit_share | — |
| toolchain_manifests | — |
| dependency_bot_commit_share | — |
Excluded from scoring (no data or not applicable): Demonstrated agent practice, Automated maintenance. Remaining weights renormalized.
Code legibility for models
55Moderate
How it's scored
| 0/45 | Type-checkable code — Python without a type-check config |
| 55/55 | Manageable file sizes — 0/38 source files over 60KB |
Inputs used
| primary_language | Python |
| largest_source_bytes | 47,225 |
| source_files_sampled | 38 |
| oversized_source_files | 0 |
Key facts
1,117GitHub stars
85contributors
0commits, last 12 months
986days since last push
17releases
1bus factor
113open issues
PyPIpackage ecosystems
Data collection warnings
- OpenSSF Scorecard timed out after 240s; skipping Scorecard checks
More detail
Direct dependencies 3
| Registry | Package | Version constraint | Manifest |
|---|---|---|---|
| PyPI | snowballstemmer | >=2.2.0 | pyproject.toml |
| PyPI | tomli | >=1.2.3 | pyproject.toml |
| PyPI | importlib-metadata | >=2.0.0,<5.0.0 | pyproject.toml |
All dependencies 18
Full resolved dependency set from the GitHub dependency graph: 6 direct and 12 indirect (transitive) packages. The transitive closure is complete when the repository commits a lockfile.
| Registry | Package | Version | Relation |
|---|---|---|---|
| PyPI | importlib-metadata | — | direct |
| PyPI | importlib-metadata | 4.8.3 | direct |
| PyPI | snowballstemmer | — | direct |
| PyPI | snowballstemmer | 2.2.0 | direct |
| PyPI | tomli | — | direct |
| PyPI | tomli | 1.2.3 | direct |
| PyPI | - | — | indirect |
| PyPI | black | 22.3 | indirect |
| PyPI | isort | 5.4.2 | indirect |
| PyPI | jinja2 | — | indirect |
| PyPI | mypy | 0.930 | indirect |
| PyPI | pytest | 6.2.5 | indirect |
| PyPI | sphinx | — | indirect |
| PyPI | sphinx-rtd-theme | — | indirect |
| PyPI | tox | — | indirect |
| PyPI | types-setuptools | — | indirect |
| PyPI | typing-extensions | 4.1.1 | indirect |
| PyPI | zipp | 3.6.0 | indirect |
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"python",
"linter",
"docstrings"
],
"is_fork": false,
"size_kb": 1012,
"has_wiki": false,
"homepage": "http://pydocstyle.org",
"languages": {
"Python": 260682,
"Makefile": 98
},
"pushed_at": "2023-11-03T22:28:46Z",
"created_at": "2012-01-31T17:18:23Z",
"owner_type": "Organization",
"updated_at": "2026-07-02T15:54:37Z",
"description": "docstring style checker",
"is_archived": true,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "master",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": "http://meta.pycqa.org",
"name": "Python Code Quality Authority",
"type": "Organization",
"login": "PyCQA",
"company": null,
"location": "Everywhere",
"followers": 1013,
"avatar_url": "https://avatars.githubusercontent.com/u/8749848?v=4",
"created_at": "2014-09-12T12:56:02Z",
"is_verified": null,
"public_repos": 29,
"account_age_days": 4325
},
"activity": {
"releases_count": 17,
"commits_last_year": 0,
"latest_release_at": "2023-01-17T20:28:28Z",
"latest_release_tag": "6.3.0",
"releases_from_tags": false,
"days_since_last_push": 986,
"active_weeks_last_year": 0,
"days_since_latest_release": 1276,
"mean_days_between_releases": 97.6
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": false,
"health_percentage": 50,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": true
},
"ecosystem": {
"packages": [
{
"name": "pydocstyle",
"exists": true,
"license": "MIT",
"keywords": [
"Development Status :: 5 - Production/Stable",
"Environment :: Console",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.6",
"Programming Language :: Python :: 3.7",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/pydocstyle/",
"is_deprecated": false,
"latest_version": "6.3.0",
"repository_url": "https://github.com/PyCQA/pydocstyle",
"versions_count": 22,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": null,
"first_published_at": "2016-01-30T18:53:47.289130Z",
"latest_published_at": "2023-01-17T20:29:19.838803Z",
"latest_version_yanked": null,
"days_since_latest_publish": 1276
}
]
},
"popularity": {
"forks": 190,
"stars": 1117,
"watchers": 2,
"open_issues_and_prs": 121
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [
"Makefile",
"docs/Makefile"
],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [],
"largest_source_bytes": 47225,
"source_files_sampled": 38,
"oversized_source_files": 0,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"pyproject.toml",
"requirements.txt"
],
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "snowballstemmer",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.2.0"
},
{
"name": "tomli",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.2.3"
},
{
"name": "importlib-metadata",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.0.0,<5.0.0"
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "importlib-metadata",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "importlib-metadata",
"direct": true,
"version": "4.8.3",
"ecosystem": "pypi"
},
{
"name": "snowballstemmer",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "snowballstemmer",
"direct": true,
"version": "2.2.0",
"ecosystem": "pypi"
},
{
"name": "tomli",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "tomli",
"direct": true,
"version": "1.2.3",
"ecosystem": "pypi"
},
{
"name": "-",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "black",
"direct": false,
"version": "22.3",
"ecosystem": "pypi"
},
{
"name": "isort",
"direct": false,
"version": "5.4.2",
"ecosystem": "pypi"
},
{
"name": "jinja2",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mypy",
"direct": false,
"version": "0.930",
"ecosystem": "pypi"
},
{
"name": "pytest",
"direct": false,
"version": "6.2.5",
"ecosystem": "pypi"
},
{
"name": "sphinx",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "sphinx-rtd-theme",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "tox",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "types-setuptools",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "typing-extensions",
"direct": false,
"version": "4.1.1",
"ecosystem": "pypi"
},
{
"name": "zipp",
"direct": false,
"version": "3.6.0",
"ecosystem": "pypi"
}
],
"collected": true,
"truncated": false,
"total_count": 18,
"direct_count": 6,
"indirect_count": 12
}
},
"maintainership": {
"issues": {
"open_prs": 8,
"merged_prs": 235,
"open_issues": 113,
"closed_ratio": 0.666,
"closed_issues": 225,
"closed_unmerged_prs": 75
},
"bus_factor": 1,
"top_contributors": [
{
"type": "User",
"login": "Nurdok",
"commits": 336,
"avatar_url": "https://avatars.githubusercontent.com/u/80665?u=1172e1e699c6ce7daa2a003fdadbe5e2362453c8&v=4"
},
{
"type": "User",
"login": "shacharoo",
"commits": 80,
"avatar_url": "https://avatars.githubusercontent.com/u/13560060?u=63b366c36edc8f325279d13160d826a3977af76e&v=4"
},
{
"type": "User",
"login": "sambhav",
"commits": 46,
"avatar_url": "https://avatars.githubusercontent.com/u/16130816?u=d4d09eb877fdd82ef40567cff3611cd0341f60f7&v=4"
},
{
"type": "User",
"login": "dpursehouse",
"commits": 22,
"avatar_url": "https://avatars.githubusercontent.com/u/836426?v=4"
},
{
"type": "User",
"login": "andrewsomething",
"commits": 11,
"avatar_url": "https://avatars.githubusercontent.com/u/46943?u=1ae9230385c42442515059953928caa618a7dd4d&v=4"
},
{
"type": "User",
"login": "JensRantil",
"commits": 11,
"avatar_url": "https://avatars.githubusercontent.com/u/730342?u=84f97039006558834aadc9d3e9f50ffa686b8fd3&v=4"
},
{
"type": "User",
"login": "lordmauve",
"commits": 10,
"avatar_url": "https://avatars.githubusercontent.com/u/617224?u=4ed9d681fcf3ee8766527ef730b201fc339cf163&v=4"
},
{
"type": "User",
"login": "glennmatthews",
"commits": 8,
"avatar_url": "https://avatars.githubusercontent.com/u/5603551?u=aeb82c68b75837a6043df546cb680c7b2c7b25d2&v=4"
},
{
"type": "User",
"login": "larsoner",
"commits": 7,
"avatar_url": "https://avatars.githubusercontent.com/u/2365790?v=4"
},
{
"type": "User",
"login": "sigmavirus24",
"commits": 5,
"avatar_url": "https://avatars.githubusercontent.com/u/240830?u=cfe7ddccc58238bedb4176ff2a8dbc200c6a314d&v=4"
}
],
"contributors_sampled": 85,
"top_contributor_share": 0.515
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"pre-release.yml",
"release.yml",
"test.yml"
],
"has_docs_dir": true,
"linter_configs": [
"tox.ini"
],
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [
"poetry.lock"
],
"scorecard": null,
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/PyCQA/pydocstyle",
"host": "github.com",
"name": "pydocstyle",
"owner": "PyCQA"
},
"metrics": {
"overall": {
"key": "overall",
"band": "critical",
"name": "Overall health",
"note": "Abandonment Policy applies a 40% multiplier to weighted overall health and gives it a ceiling of 29.",
"notes": [
{
"code": "abandonment_overall_adjustment",
"params": {
"cap": 29,
"pct": 40
}
}
],
"value": 19,
"inputs": {
"security": 1,
"vitality": 21,
"community": 63,
"governance": 61,
"engineering": 84,
"abandonment_cap": 29,
"abandonment_state": "declared",
"abandonment_multiplier": 40,
"weighted_overall_before_abandonment": 48,
"overall_after_abandonment_multiplier": 19
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "critical",
"name": "Vitality",
"value": 21,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "critical",
"name": "Development activity",
"note": null,
"notes": [],
"value": 1,
"inputs": {
"commits_last_year": 0,
"human_commit_share": null,
"days_since_last_push": 986,
"active_weeks_last_year": 0
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 986 days ago",
"points": 0,
"status": "missed",
"details": [
{
"code": "push_recency",
"params": {
"days": 986
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "0/52 weeks with commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 0
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "0 commits in the last year",
"points": 0,
"status": "missed",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 0
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "OpenSSF Scorecard unavailable",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "moderate",
"name": "Release discipline",
"note": null,
"notes": [],
"value": 52,
"inputs": {
"releases_count": 17,
"latest_release_tag": "6.3.0",
"releases_from_tags": false,
"days_since_latest_release": 1276,
"mean_days_between_releases": 97.6
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "17 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 17
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 1276 days ago",
"points": 0,
"status": "missed",
"details": [
{
"code": "release_recency",
"params": {
"days": 1276
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~97.6 days",
"points": 19.8,
"status": "partial",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 97.6
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "OpenSSF Scorecard unavailable",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "at_risk",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"cap": 29,
"state": "declared",
"guards": [],
"signals": [],
"red_flag": true,
"multiplier_pct": 40,
"declared_reason": "archived",
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": null,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "the repository is archived on GitHub",
"points": 40,
"status": "partial",
"details": [
{
"code": "abandonment_archived",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "moderate",
"name": "Community & Adoption",
"value": 63,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "moderate",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 68,
"inputs": {
"forks": 190,
"stars": 1117,
"watchers": 2,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "1,117 stars",
"points": 49.4,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 1117
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "190 forks",
"points": 19,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 190
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "2 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 2
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "moderate",
"name": "Community health",
"note": null,
"notes": [],
"value": 57,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 6.3,
"status": "met",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 61,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "at_risk",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 37,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 85,
"top_contributor_share": 0.515
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 52% of commits",
"points": 10.9,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 52
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "85 contributors",
"points": 13.5,
"status": "met",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 85
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "OpenSSF Scorecard unavailable",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 71,
"inputs": {
"merged_prs": 235,
"open_issues": 113,
"closed_issues": 225,
"issue_closed_ratio": 0.666,
"closed_unmerged_prs": 75
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "67% of issues closed",
"points": 31.1,
"status": "partial",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 67
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "235/310 decided PRs merged",
"points": 29,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 235,
"decided": 310
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "OpenSSF Scorecard unavailable",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "good",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 74,
"inputs": {
"followers": 1013,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "PyCQA",
"public_repos": 29,
"account_age_days": 4325
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "organization-owned",
"points": 30,
"status": "met",
"details": [
{
"code": "owner_organization",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "1,013 followers of PyCQA",
"points": 21.6,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 1013,
"login": "PyCQA"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "29 public repos, account ~11 yr old",
"points": 22.8,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 29
}
},
{
"code": "account_age_years",
"params": {
"years": 11
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "moderate",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 69,
"inputs": {
"packages": [
"pydocstyle"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 1276
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 1276 days ago",
"points": 4,
"status": "partial",
"details": [
{
"code": "publish_recency",
"params": {
"days": 1276
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "22 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 22
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "good",
"name": "Engineering Quality",
"value": 84,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "good",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 80,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "3 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 3
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": "tox.ini",
"points": 16,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "tox.ini"
}
}
],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "OpenSSF Scorecard unavailable",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"topics": [
"python",
"linter",
"docstrings"
],
"has_wiki": false,
"homepage": "http://pydocstyle.org",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "http://pydocstyle.org",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "3 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 3
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "critical",
"name": "Security",
"value": 1,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "critical",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Dependency lockfiles. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"dependency_lockfiles"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 1,
"inputs": {
"source": "file_signals",
"lockfiles": [
"poetry.lock"
],
"manifests": [
"pyproject.toml",
"requirements.txt"
],
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
},
"components": [
{
"key": "security_policy_security_md",
"name": "Security policy (SECURITY.md)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 30
},
{
"key": "dependabot_config",
"name": "Dependabot config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 25
},
{
"key": "dependency_lockfiles",
"name": "Dependency lockfiles",
"detail": "published library — lockfiles are an application concern, not expected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "lockfiles_not_expected",
"params": {}
}
],
"max_points": 25
},
{
"key": "codeql_workflow",
"name": "CodeQL workflow",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 11
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "moderate",
"name": "AI Readiness",
"value": 50,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "critical",
"name": "Agent context & guidance",
"note": "Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"legible_commit_history"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 1,
"inputs": {
"has_llms_txt": false,
"legible_history_share": null,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "excellent",
"name": "Verify loop (build / test / typecheck)",
"note": "Excluded from scoring (no data or not applicable): Demonstrated agent practice, Automated maintenance. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"demonstrated_agent_practice",
"automated_maintenance"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 85,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"poetry.lock"
],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [
"Makefile",
"docs/Makefile"
],
"has_devcontainer": false,
"has_linter_config": true,
"typecheck_configs": [],
"agent_commit_share": null,
"toolchain_manifests": [],
"dependency_bot_commit_share": null
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": "Makefile, docs/Makefile",
"points": 18,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "Makefile, docs/Makefile"
}
}
],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": "tox.ini",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "tox.ini"
}
}
],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "OpenSSF Scorecard unavailable",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "moderate",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 55,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 47225,
"source_files_sampled": 38,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python without a type-check config",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_typecheck_config_language",
"params": {
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/38 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 38,
"oversized": 0
}
}
],
"max_points": 55
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"OpenSSF Scorecard timed out after 240s; skipping Scorecard checks"
],
"report_type": "repository",
"generated_at": "2026-07-17T00:48:25.602633Z",
"schema_version": "0.11.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/p/PyCQA/pydocstyle.svg",
"full_name": "PyCQA/pydocstyle",
"license_state": "standard",
"license_spdx": "MIT"
}Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.
Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v1.13.0, schema v0.11.0 — full methodology · metrics wiki.
How one result sits in the wider record: aggregate statistics — PyPI.