Звіт про здоров'я програмного забезпеченнясхема 0.31.0 · метрики 2.10.0 · 2026-08-19 15:20 UTC

DanielNoord / pydocstringformatter

Automatically format your Python docstrings to conform with PEP 8 and PEP 257

PythonMIT★ 90 зірок⑂ 10 форківз січ. 2022 р.Переглянути на GitHub ↗

ТипІнструмент командного рядкаБібліотекаяк це визначено

DanielNoord/pydocstringformatter має індекс здоров’я 81 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Engineering Quality (86/100), найнижчий — AI Readiness (39/100). Останнє оновлення було 1 день тому. Більшість нещодавньої роботи виконує один учасник.

загалом / 100

Відмінний

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

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

Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям

Відмінний80-92Сильний за всіма напрямами; незначні прогалини

Добрий65-79Здоровий; прогалини обмежені та керовані

Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку

Слабкий35-49Суттєві недоліки в кількох сферах

У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності

Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)

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

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

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

Власність

Daniël van NoordОсобистий обліковий запис

66 підписників15 публічних репозиторіївз серп. 2015 р.@channable

Цей репозиторій належить особистому обліковому запису. Проєкт з єдиним власником несе більший ризик безперервності, ніж підтримуваний організацією.

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

Реєстр	Пакет	Версія	Завантажень / міс	Версії	Остання публікація	Теги
PyPI	pydocstringformatter	1.0.0	-	17	45 днів тому	python docstring format

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

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

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

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

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

86Відмінний

Як обчислюється оцінка

36/36	Свіжість push — останній push 1 дн. тому
23.5/36	Ритм комітів — 34/52 тижнів із комітами
16.4/18	Обсяг комітів — 66 комітів за останній рік
10/10	OpenSSF Scorecard: Maintained — 21 commit(s) and 3 issue activity found in the last 90 days -- score normalized to 10

Використані вхідні дані

commits_last_year	66
human_commit_share	0,13
days_since_last_push	1
active_weeks_last_year	34

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

84Відмінний

Як обчислюється оцінка

27/27	Випускає релізи — опубліковано 18 релізів
36/36	Свіжість релізів — останній реліз 45 дн. тому
12.6/27	Ритм релізів — реліз кожні ~167 дн.
0/10	OpenSSF Scorecard: Signed-Releases — немає даних

Використані вхідні дані

releases_count	18
latest_release_tag	v1.0.0
releases_from_tags	ні
days_since_latest_release	45
mean_days_between_releases	167

Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

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

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

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

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

65Добрий

Як обчислюється оцінка

22.5/22.5	README
22.5/22.5	Ліцензія — визнана ліцензія (MIT)
0/18	Настанови CONTRIBUTING
13.5/13.5	Кодекс поведінки
0/7.2	Шаблон issue
0/6.3	Шаблон PR

Використані вхідні дані

has_readme	так
has_license	так
readme_badges	4
has_contributing	ні
has_issue_template	ні
has_code_of_conduct	так
readme_badge_services	codecov.io, github.com, readthedocs.org, shields.io
has_pull_request_template	ні

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

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

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

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

28У зоні ризику

Як обчислюється оцінка

9/54	Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
2/22.5	Розподіл комітів — головний контриб’ютор — автор 91% комітів
6.8/13.5	Широта контриб’юторів — 5 контриб’юторів
10/10	OpenSSF Scorecard: Contributors — project has 6 contributing companies or organizations

Використані вхідні дані

bus_factor	1
contributors_sampled	5
top_contributor_share	0,912

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

73Добрий

Як обчислюється оцінка

32.1/42	Вирішення issue — закрито 76% issue
26.8/30	Прийняття PR — злито 469/525 вирішених PR
0/13	Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
4.5/15	OpenSSF Scorecard: Code-Review — Found 1/3 approved changesets -- score normalized to 3

Використані вхідні дані

merged_prs	469
open_issues	13
closed_issues	42
prs_merged_7d	0
prs_decided_7d	0
prs_merged_30d	2
prs_decided_30d	2
issue_closed_ratio	0,764
closed_unmerged_prs	56
first_time_authors_30d	0
first_time_prs_merged_30d	0
first_time_prs_decided_30d	0

Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.

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

55Помірний

Як обчислюється оцінка

10/30	Підтримка власника — особистий (користувацький) обліковий запис
0/20	Верифікований домен — не застосовно до користувацьких облікових записів
13.1/25	Охоплення власника — 66 підписників у DanielNoord
20.8/25	Послужний список — 15 публічних репозиторіїв, вік облікового запису ~11 р.

Використані вхідні дані

followers	66
owner_type	User
is_verified	—
owner_login	DanielNoord
public_repos	15
account_age_days	4 031

Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

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

100Винятковий

Як обчислюється оцінка

25/25	Опубліковано й доступно — 1 пакет(ів) у pypi
35/35	Свіжість публікацій — остання публікація 45 дн. тому
20/20	Історія версій — 17 опублікованих версій
20/20	Не застарілий — активний, не deprecated і не yanked

Використані вхідні дані

packages	pydocstringformatter
ecosystems	pypi
any_deprecated	ні
min_days_since_publish	45

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

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

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

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

94Винятковий

Як обчислюється оцінка

24/24	Процеси CI — 5 процес(ів) CI
24/24	Наявні тести
16/16	Конфігурація лінтера — .flake8
9.6/9.6	Pre-commit-хуки
0/6.4	.editorconfig
20/20	OpenSSF Scorecard: CI-Tests — 29 out of 29 merged PRs checked by a CI test -- score normalized to 10

Використані вхідні дані

has_ci	так
has_tests	так
has_editorconfig	ні
has_linter_config	так
has_precommit_config	так

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

75Добрий

Як обчислюється оцінка

30/30	README
25/25	Каталог документації
0/15	Сайт документації / домашня сторінка
10/10	Опис репозиторію
10/10	Теми — 3 тем
0/10	Wiki

Використані вхідні дані

topics	python, formatter, docstrings
has_wiki	ні
homepage	—
docs_site	—
has_readme	так
has_docs_dir	так
has_description	так

Безпека

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

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

Стан безпеки

61Помірний

Як обчислюється оцінка

7.5/7.5	Binary-Artifacts — no binaries found in the repo
0/7.5	Branch-Protection — немає даних
2.5/2.5	CI-Tests — 29 out of 29 merged PRs checked by a CI test -- score normalized to 10
0/2.5	CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
2.2/7.5	Code-Review — Found 1/3 approved changesets -- score normalized to 3
2.5/2.5	Contributors — project has 6 contributing companies or organizations
10/10	Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5	Dependency-Update-Tool — update tool detected
0/5	Fuzzing — project is not fuzzed
2.5/2.5	Ліцензія — license file detected
7.5/7.5	Maintained — 21 commit(s) and 3 issue activity found in the last 90 days -- score normalized to 10
5/5	Packaging — packaging workflow detected
0/5	Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5	SAST — SAST tool is not run on all commits -- score normalized to 0
0/5	Security-Policy — security policy file not detected
0/7.5	Signed-Releases — немає даних
0/7.5	Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5	Vulnerabilities — 0 existing vulnerabilities detected

Використані вхідні дані

source	openssf_scorecard
checks_evaluated	16
scorecard_version	v5.5.0
checks_inconclusive	2
scorecard_aggregate	6,1

Виключено з оцінювання (немає даних або не застосовно): Branch-Protection, Signed-Releases. Залишкові ваги перенормовано.

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

100Винятковий

Як обчислюється оцінка

35/35	Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
0/25	Непрямі залежності без відомих сповіщень — транзитивний набір не відокремлюється від залежностей розробки й тестування в цьому обсязі
0/40	Немає задавнених сповіщень — жодне сповіщення не має дати публікації

Використані вхідні дані

source	osv
advisories	0
affected_packages	0
assessed_packages	4
unassessed_packages	6
affected_by_severity	none
direct_affected_packages	0

Виключено з оцінювання (немає даних або не застосовно): Непрямі залежності без відомих сповіщень, Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено 4 резолвлених залежностей із OSV. 6 не вдалося оцінити — немає резолвленої версії, непідтримувана екосистема або поза межами звітованого переліку пакетів. Цей репозиторій не публікує пакета, який резолвить індекс, тож натомість оцінено граф залежностей репозиторію. Цей граф змішує закріплені версії для розробки й тестування зі справді постачаними залежностями, тож оцінюються лише задекларовані runtime-залежності; транзитивні знахідки подаються як контекст і в оцінку не входять. Досяжність не аналізується.

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

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

39Слабкий · 4% загального індексу

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

1Критичний

Як обчислюється оцінка

0/45	Інструкції для агентів — немає CLAUDE.md / AGENTS.md / правил редактора
0/15	Машиночитана документація (llms.txt)
0/40	Читабельна історія комітів — немає даних

Використані вхідні дані

has_llms_txt	ні
llms_txt_url	—
legible_history_share	—
agent_instruction_files	—
agent_instruction_max_bytes	—

Виключено з оцінювання (немає даних або не застосовно): Читабельна історія комітів. Залишкові ваги перенормовано.

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

61Помірний

Як обчислюється оцінка

18/18	Розгортання однією командою — docs/Makefile
22/22	Автоматизовані тести
11/11	Конфігурація лінтера / форматера — .flake8
0/11	Статична перевірка типів
0/10	Відтворюване середовище
2/10	Підтверджена практика роботи з агентами — 1 з останніх 100 комітів створено агентом або з його зазначенням
8/8	Автоматизоване супроводження — 53 з останніх 100 комітів — автоматичні оновлення залежностей
0/10	OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0

Використані вхідні дані

has_nix	ні
has_tests	так
lockfiles	—
has_dockerfile	ні
typed_language	ні
bootstrap_files	docs/Makefile
has_devcontainer	ні
has_linter_config	так
typecheck_configs	—
agent_commit_share	0,01
toolchain_manifests	—
dependency_bot_commit_share	0,53

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

55Помірний

Як обчислюється оцінка

0/45	Типізований код — Python без конфігурації перевірки типів
55/55	Керовані розміри файлів — 0/142 файлів вихідного коду понад 60 КБ

Використані вхідні дані

primary_language	Python
largest_source_bytes	11 196
source_files_sampled	142
oversized_source_files	0

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

90зірок GitHub

5контриб'юторів

66комітів за останні 12 місяців

1днів від останнього пушу

18релізів

1бас-фактор

13відкритих issue

PyPIпакетних екосистем

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

Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token

Докладніше

Історія зірок і форків 0 ★ / 10 ⇿

0Зірки

10Форки

17Релізи

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

Мажорні 0Мінорні 7Патчі 9

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

OpenSSF Scorecard 6.1 / 10

6.1сукупно

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

10	Binary-Artifacts	no binaries found in the repo
н/д	Branch-Protection	internal 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
10	CI-Tests	29 out of 29 merged PRs checked by a CI test -- score normalized to 10
0	CII-Best-Practices	no effort to earn an OpenSSF best practices badge detected
3	Code-Review	Found 1/3 approved changesets -- score normalized to 3
10	Contributors	project has 6 contributing companies or organizations
10	Dangerous-Workflow	no dangerous workflow patterns detected
10	Dependency-Update-Tool	update tool detected
0	Fuzzing	project is not fuzzed
10	License	license file detected
10	Maintained	21 commit(s) and 3 issue activity found in the last 90 days -- score normalized to 10
10	Packaging	packaging workflow detected
0	Pinned-Dependencies	dependency not pinned by hash detected -- score normalized to 0
0	SAST	SAST tool is not run on all commits -- score normalized to 0
0	Security-Policy	security policy file not detected
н/д	Signed-Releases	no releases found
0	Token-Permissions	detected GitHub workflow tokens with excessive permissions
10	Vulnerabilities	0 existing vulnerabilities detected

Усі залежності 10

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

Реєстр	Пакет	Версія	Зв'язок
PyPI	coverage	`7.15.2`	непряма
PyPI	furo	`2025.12.19`	непряма
PyPI	gitpython	`—`	непряма
PyPI	myst-parser	`—`	непряма
PyPI	pytest	`9.1.1`	непряма
PyPI	pytest-cov	`7.1.0`	непряма
PyPI	setuptools	`—`	непряма
PyPI	sphinx	`—`	непряма
PyPI	types-docutils	`—`	непряма
PyPI	wheel	`—`	непряма

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

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

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

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

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

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

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

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

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

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

31.6/60	Зірки — 90 зірок
8/25	Форки — 10 форків
0/15	Спостерігачі — 2 спостерігачів

forks	10
stars	90
watchers	2
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

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

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

Власність

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

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

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

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

Докладніше

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

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