Публічний реєстр
Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-09-14 21:13 UTC

PyCQA / docformatter

Formats docstrings to follow PEP 257

PythonMIT★ 598 зірок⑂ 92 форкиз трав. 2012 р.Переглянути на GitHub ↗
ТипІнструмент командного рядкаБібліотекаяк це визначено
#python#formatter#docstring#autoformat

PyCQA/docformatter має індекс здоров’я 81 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Engineering Quality (92/100), найнижчий — Vitality (54/100). Останнє оновлення було 35 днів тому. Більшість нещодавньої роботи виконує один учасник.

81
загалом / 100
Відмінний

Індекс здоров'я програмного забезпечення

Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).

81
Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям
Відмінний80-92Сильний за всіма напрямами; незначні прогалини
Добрий65-79Здоровий; прогалини обмежені та керовані
Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку
Слабкий35-49Суттєві недоліки в кількох сферах
У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності
Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)
ЖиттєздатністьСпільнота тавпровадженняСталість таврядуванняІнженернаякістьБезпекаГотовність доШІ

Профіль оцінок

Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.

Зважений загальний бал 69 калібровано до 81 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).

Власність

Python Code Quality AuthorityОрганізація
1 027 підписників29 публічних репозиторіївз вер. 2014 р.

За цим репозиторієм стоїть організація — спільна, підзвітна опіка, здатна пережити будь-якого окремого мейнтейнера.

Пакетні екосистеми

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
PyPIdocformatter1.7.81 411 02365139 днів томуpep-257pep257styleformatterdocstrings

Метрики за категоріями

Життєздатність

Чи живий проєкт — чи пишеться код і чи виходять релізи?

54Помірний · 21% загального індексу

Активність розробки

46Слабкий
Як обчислюється оцінка
18/36Свіжість push — останній push 35 дн. тому
4.8/36Ритм комітів — 7/52 тижнів із комітами
13.5/18Обсяг комітів — 31 комітів за останній рік
10/10OpenSSF Scorecard: Maintained — 18 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year31
human_commit_share0,82
days_since_last_push35
active_weeks_last_year7

Дисципліна релізів

67Добрий
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 15 релізів
27/36Свіжість релізів — останній реліз 146 дн. тому
12.6/27Ритм релізів — реліз кожні ~120,4 дн.
0/10OpenSSF Scorecard: Signed-Releases — Project has not signed or included provenance with any releases.
Використані вхідні дані
releases_count15
latest_release_tagv1.7.8
releases_from_tagsні
days_since_latest_release146
mean_days_between_releases120,4

Спільнота та впровадження

Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?

68Добрий · 17% загального індексу

Популярність і впровадження

65Добрий
Як обчислюється оцінка
45/60Зірки — 598 зірок
16.3/25Форки — 92 форків
3.3/15Спостерігачі — 5 спостерігачів
Використані вхідні дані
forks92
stars598
watchers5
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

Здоров'я спільноти

50Помірний
Як обчислюється оцінка
22.5/22.5README
22.5/22.5Ліцензія — визнана ліцензія (MIT)
0/18Настанови CONTRIBUTING
0/13.5Кодекс поведінки
0/7.2Шаблон issue
0/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges4
has_contributingні
has_issue_templateні
has_code_of_conductні
readme_badge_servicesshields.io
has_pull_request_templateні

Впровадження в екосистемі (завантаження)

100Винятковий
Як обчислюється оцінка
80/80Щомісячні завантаження — 1 411 023 завантажень/місяць у pypi
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packagesdocformatter
dependents—
ecosystemspypi
total_downloads—
monthly_downloads1 411 023
unverified_packages_excluded—
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

Сталість та врядування

Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?

71Добрий · 23% загального індексу

Стійкість мейнтейнерів (бас-фактор)

40Слабкий
Як обчислюється оцінка
9/54Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
7.4/22.5Розподіл комітів — головний контриб’ютор — автор 67% комітів
13.5/13.5Широта контриб’юторів — 40 контриб’юторів
10/10OpenSSF Scorecard: Contributors — project has 5 contributing companies or organizations
Використані вхідні дані
bus_factor1
contributors_sampled40
top_contributor_share0,673

Реактивність на issue та PR

83Відмінний
Як обчислюється оцінка
35.7/42Вирішення issue — закрито 85% issue
27.4/30Прийняття PR — злито 161/176 вирішених PR
0/13Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
9/15OpenSSF Scorecard: Code-Review — Found 12/20 approved changesets -- score normalized to 6
Використані вхідні дані
merged_prs161
open_issues29
closed_issues164
prs_merged_7d0
prs_decided_7d0
prs_merged_30d0
prs_decided_30d0
issue_closed_ratio0,85
closed_unmerged_prs15
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.

Власність та опіка

74Добрий
Як обчислюється оцінка
30/30Підтримка власника — у власності організації
0/20Верифікований домен
21.7/25Охоплення власника — 1 027 підписників у PyCQA
22.8/25Послужний список — 29 публічних репозиторіїв, вік облікового запису ~12 р.
Використані вхідні дані
followers1 027
owner_typeOrganization
is_verifiedні
owner_loginPyCQA
public_repos29
account_age_days4 385

Супровід пакетів

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно — 1 пакет(ів) у pypi
35/35Свіжість публікацій — остання публікація 139 дн. тому
20/20Історія версій — 65 опублікованих версій
20/20Не застарілий — активний, не deprecated і не yanked
Використані вхідні дані
packagesdocformatter
ecosystemspypi
any_deprecatedні
min_days_since_publish139

Інженерна якість

Чи наявні базові інженерні практики та документація?

92Відмінний · 19% загального індексу

Інженерні практики

94Винятковий
Як обчислюється оцінка
24/24Процеси CI — 7 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера — pyproject.toml ([tool.ruff], [tool.pylint], [tool.black], [tool.isort]), tox.ini
9.6/9.6Pre-commit-хуки
0/6.4.editorconfig
20/20OpenSSF Scorecard: CI-Tests — 23 out of 23 merged PRs checked by a CI test -- score normalized to 10
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configтак
has_precommit_configтак

Документація

90Відмінний
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінка — https://pypi.python.org/pypi/docformatter
10/10Опис репозиторію
10/10Теми — 4 тем
0/10Wiki
Використані вхідні дані
topicspython, formatter, docstring, autoformat
has_wikiні
homepagehttps://pypi.python.org/pypi/docformatter
docs_sitehttps://pypi.python.org/pypi/docformatter
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?

64Помірний · 16% загального індексу

Стан безпеки

55Помірний
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — немає даних
2.5/2.5CI-Tests — 23 out of 23 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
4.5/7.5Code-Review — Found 12/20 approved changesets -- score normalized to 6
2.5/2.5Contributors — project has 5 contributing companies or organizations
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5Ліцензія — license file detected
7.5/7.5Maintained — 18 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
0/5Packaging — немає даних
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — Project has not signed or included provenance with any releases.
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
6/7.5Vulnerabilities — 2 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate5,5
Виключено з оцінювання (немає даних або не застосовно): Branch-Protection, Packaging. Залишкові ваги перенормовано.

Сповіщення про залежності

100Винятковий
Як обчислюється оцінка
35/35Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
25/25Непрямі залежності без відомих сповіщень — жодна непряма залежність не має відомих сповіщень
0/40Немає задавнених сповіщень — жодне сповіщення не має дати публікації
Використані вхідні дані
sourceosv
advisories0
affected_packages0
assessed_packages1
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
Виключено з оцінювання (немає даних або не застосовно): Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено з runtime-замиканням залежностей pypi:docformatter@1.7.8 — тим, що тягне за собою встановлення опублікованого пакета, — 1 пакетів. Досяжність не аналізується.

Готовність до ШІ

Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.

57Помірний · 4% загального індексу

Контекст і настанови для агентів

40Слабкий
Як обчислюється оцінка
0/45Інструкції для агентів — немає CLAUDE.md / AGENTS.md / правил редактора
0/15Машиночитана документація (llms.txt)
40/40Читабельна історія комітів — намір зазначено у 79 з 82 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtні
llms_txt_url—
legible_history_share0,963
agent_instruction_files—
agent_instruction_max_bytes—

Цикл верифікації (збірка / тести / перевірка типів)

71Добрий
Як обчислюється оцінка
18/18Розгортання однією командою — docs/Makefile
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера — pyproject.toml ([tool.ruff], [tool.pylint], [tool.black], [tool.isort]), tox.ini
0/11Статична перевірка типів
10/10Відтворюване середовище — lockfile
2/10Підтверджена практика роботи з агентами — 1 з останніх 100 комітів створено агентом або з його зазначенням
8/8Автоматизоване супроводження — 18 з останніх 100 комітів — автоматичні оновлення залежностей
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Використані вхідні дані
has_nixні
has_testsтак
lockfilespoetry.lock
has_dockerfileні
typed_languageні
bootstrap_filesdocs/Makefile
has_devcontainerні
has_linter_configтак
typecheck_configs—
agent_commit_share0,01
toolchain_manifests—
dependency_bot_commit_share0,18

Читабельність коду для моделей

55Помірний
Як обчислюється оцінка
0/45Типізований код — Python без конфігурації перевірки типів
55/55Керовані розміри файлів — 0/47 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes38 830
source_files_sampled47
oversized_source_files0

Ключові факти

598зірок GitHub
40контриб'юторів
31комітів за останні 12 місяців
35днів від останнього пушу
15релізів
1бас-фактор
29відкритих issue
PyPIпакетних екосистем

Попередження щодо збору даних

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • pypi download statistics for 'docformatter' unavailable this scan (stats endpoint failed after retries); adoption may be under-evidenced
  • pypi download figures for docformatter carried forward from the previous scan (stats endpoint unavailable this scan)

Докладніше

Історія зірок і форків 0 ★ / 92 ⇿
0Зірки
92Форки
15Релізи

Коли додано кожну зірку й форк — зібрано з GitHub і згруповано за днями. Кумулятивне зростання розміщено просто над денними додаваннями, з яких воно складається, тож їх видно одне проти одного: рівномірне органічне накопичення виглядає зовсім інакше, ніж різкий короткочасний сплеск. Там, де цю різницю можна виміряти, її подано як автентичність росту.

0204060801009162014-042020-062026-08
Мажорні 0Мінорні 2Патчі 13

Кожна точка охоплює 12 днів.

OpenSSF Scorecard 5.5 / 10
5.5сукупно

Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-09-14 21:13 UTC

10Binary-Artifactsno binaries found in the repo
н/дBranch-Protectioninternal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
10CI-Tests23 out of 23 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
6Code-ReviewFound 12/20 approved changesets -- score normalized to 6
10Contributorsproject has 5 contributing companies or organizations
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained18 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
н/дPackagingpackaging workflow not detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
0Signed-ReleasesProject has not signed or included provenance with any releases.
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
8Vulnerabilities2 existing vulnerabilities detected
Прямі залежності 2
РеєстрПакетОбмеження версіїМаніфест
PyPIcharset_normalizer^3.0.0pyproject.toml
PyPItomli^2.0.0pyproject.toml
Усі залежності 87

Повний розв'язаний набір залежностей із графа залежностей GitHub: 2 прямих і 85 непрямих (транзитивних) пакетів. Транзитивне замикання є повним, коли в репозиторії закомічено lockfile.

РеєстрПакетВерсіяЗв'язок
PyPIcharset-normalizer3.4.2пряма
PyPItomli2.2.1пряма
PyPIalabaster0.7.16непряма
PyPIannotated-types0.7.0непряма
PyPIastroid3.3.11непряма
PyPIautopep82.3.2непряма
PyPIbabel2.17.0непряма
PyPIbackports-tarfile1.2.0непряма
PyPIblack26.3.1непряма
PyPIcachetools6.1.0непряма
PyPIcertifi2025.7.14непряма
PyPIcffi2.0.0непряма
PyPIchardet5.2.0непряма
PyPIclick8.2.1непряма
PyPIcolorama0.4.6непряма
PyPIcoverage7.9.2непряма
PyPIcryptography50.0.0непряма
PyPIdill0.4.0непряма
PyPIdistlib0.4.0непряма
PyPIdocutils0.19непряма
PyPIexceptiongroup1.3.0непряма
PyPIfilelock3.20.3непряма
PyPIid1.5.0непряма
PyPIidna3.15непряма
PyPIimagesize1.4.1непряма
PyPIimportlib-metadata8.7.0непряма
PyPIiniconfig2.1.0непряма
PyPIisort6.0.1непряма
PyPIjaraco-classes3.4.0непряма
PyPIjaraco-context6.0.1непряма
PyPIjaraco-functools4.2.1непряма
PyPIjeepney0.9.0непряма
PyPIjinja23.1.6непряма
PyPIkeyring25.6.0непряма
PyPImarkdown-it-py3.0.0непряма
PyPImarkupsafe3.0.2непряма
PyPImccabe0.7.0непряма
PyPImdurl0.1.2непряма
PyPImock5.2.0непряма
PyPImore-itertools10.7.0непряма
PyPImypy1.17.0непряма
PyPImypy-extensions1.1.0непряма
PyPInh30.3.0непряма
PyPIpackaging25.0непряма
PyPIpathspec1.1.1непряма
PyPIplatformdirs4.3.8непряма
PyPIpluggy1.6.0непряма
PyPIpycodestyle2.14.0непряма
PyPIpycparser2.22непряма
PyPIpydantic2.11.7непряма
PyPIpydantic-core2.33.2непряма
PyPIpydocstyle6.3.0непряма
PyPIpygments2.20.0непряма
PyPIpylint3.3.7непряма
PyPIpyproject-api1.9.1непряма
PyPIpytest9.0.3непряма
PyPIpytest-cov6.2.1непряма
PyPIpytest-order1.3.0непряма
PyPIpytokens0.4.1непряма
PyPIpywin32-ctypes0.2.3непряма
PyPIreadme-renderer43.0непряма
PyPIrequests2.33.0непряма
PyPIrequests-toolbelt1.0.0непряма
PyPIrfc39862.0.0непряма
PyPIrich14.0.0непряма
PyPIrstcheck6.2.5непряма
PyPIrstcheck-core1.2.2непряма
PyPIruff0.12.4непряма
PyPIsecretstorage3.3.3непряма
PyPIshellingham1.5.4непряма
PyPIsnowballstemmer3.0.1непряма
PyPIsphinx6.2.1непряма
PyPIsphinxcontrib-applehelp2.0.0непряма
PyPIsphinxcontrib-devhelp2.0.0непряма
PyPIsphinxcontrib-htmlhelp2.1.0непряма
PyPIsphinxcontrib-jsmath1.0.1непряма
PyPIsphinxcontrib-qthelp2.0.0непряма
PyPIsphinxcontrib-serializinghtml2.0.0непряма
PyPItomlkit0.13.3непряма
PyPItox4.28.1непряма
PyPItwine6.1.0непряма
PyPItyper0.16.0непряма
PyPItyping-extensions4.14.1непряма
PyPItyping-inspection0.4.1непряма
PyPIurllib32.7.0непряма
PyPIvirtualenv20.36.1непряма
PyPIzipp3.23.0непряма
Сповіщення про залежності 0

Встановлення pypi:docformatter@1.7.8 тягне 1 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.

Жодне відоме сповіщення не стосується оцінених залежностей.

Сповіщення означає, що версія, записана в графі залежностей, потрапляє в уражений діапазон. Досяжність не аналізується, а граф містить піниї розробки й тестування — знахідка може стосуватися інструментів, а не поставленого коду.

Звіт у форматі JSON машиночитний

Зворотний зв’язок

Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.

Повідомлення збережеться під час входу.

Пов’язані записи

Перевірені репозиторії, що мають спільні каталожні теги або екосистеми з PyCQA/docformatter. Читати поруч →

100psf/blackThe uncompromising Python code formatterВинятковий100PrefectHQ/prefectPrefect is a workflow orchestration framework for building resilient data pipelines in Python.Винятковий100numpy/numpyThe fundamental package for scientific computing with Python.Винятковий100scikit-learn/scikit-learnscikit-learn: machine learning in PythonВинятковий100deepset-ai/haystackOpen-source AI orchestration framework for building context-engineered, production-ready LLM applications. Design modular pipelines and agent workflows with explicit control over retrieval, routing, memory, and generation. Built for scalable agents, RAG, multimodal applications, semantic search, and conversational systems.Винятковий100matplotlib/matplotlibmatplotlib: plotting with PythonВинятковий

Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.

Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.34.0 — повна методологія · вікі метрик.

Як окремий результат виглядає на тлі всього реєстру: сукупна статистика — PyPI.