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

Alberto-Codes / docvet

Comprehensive docstring quality vetting for Python projects

PythonMIT★ 9 зірок⑂ 1 форкз лют. 2026 р.Переглянути на GitHub ↗
ТипІнструмент командного рядкаБібліотекаяк це визначено
#code-quality#docstring-checker#docstrings#documentation#github-actions#linter#mkdocs#pre-commit-hook#python#python3#static-analysis#docvet#ai-agent#ai-coding#ai-tools#developer-tools#llm-tools#mkdocstrings#docstring-linter#google-style-docstrings

Alberto-Codes/docvet має індекс здоров’я 83 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Engineering Quality (92/100), найнижчий — Community & Adoption (50/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

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

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

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

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

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

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

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

Власність

Alberto-CodesОсобистий обліковий запис
19 підписників113 публічних репозиторіївз лист. 2021 р.

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

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

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
PyPIdocvet2.0.314 540340 днів томуai-agentai-codingcode-reviewdarglintdocstringdocstring-checkerdocstring-linterdocumentationgithub-actionsgoogle-stylelinterllm-toolsmkdocsmkdocstringspre-commitpydocstylepython-linterqualitystatic-analysis

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

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

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

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

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

72Добрий
Як обчислюється оцінка
36/36Свіжість push — останній push 0 дн. тому
7.6/36Ритм комітів — 11/52 тижнів із комітами
18/18Обсяг комітів — 328 комітів за останній рік
10/10OpenSSF Scorecard: Maintained — 30 commit(s) and 30 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year328
human_commit_share0,93
days_since_last_push0
active_weeks_last_year11

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

100Винятковий
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 34 релізів
36/36Свіжість релізів — останній реліз 0 дн. тому
27/27Ритм релізів — реліз кожні ~23,6 дн.
0/10OpenSSF Scorecard: Signed-Releases — немає даних
Використані вхідні дані
releases_count34
latest_release_tagv2.0.3
releases_from_tagsні
days_since_latest_release0
mean_days_between_releases23,6
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

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

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

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

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

15Критичний
Як обчислюється оцінка
14.6/60Зірки — 9 зірок
0/25Форки — 1 форків
0/15Спостерігачі — 1 спостерігачів
Використані вхідні дані
forks1
stars9
watchers1
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

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

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

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

69Добрий
Як обчислюється оцінка
55.5/80Щомісячні завантаження — 14 540 завантажень/місяць у pypi
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packagesdocvet
dependents—
ecosystemspypi
total_downloads—
monthly_downloads14 540
unverified_packages_excluded—
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

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

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

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

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

10Критичний
Як обчислюється оцінка
9/54Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
0/22.5Розподіл комітів — головний контриб’ютор — автор 100% комітів
1.4/13.5Широта контриб’юторів — 1 контриб’юторів
0/10OpenSSF Scorecard: Contributors — project has 0 contributing companies or organizations -- score normalized to 0
Використані вхідні дані
bus_factor1
contributors_sampled1
top_contributor_share1

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

70Добрий
Як обчислюється оцінка
34.1/42Вирішення issue — закрито 81% issue
26.7/30Прийняття PR — злито 267/300 вирішених PR
0/13Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15OpenSSF Scorecard: Code-Review — Found 0/30 approved changesets -- score normalized to 0
Використані вхідні дані
merged_prs267
open_issues37
closed_issues159
prs_merged_7d22
prs_decided_7d26
prs_merged_30d22
prs_decided_30d26
issue_closed_ratio0,811
closed_unmerged_prs33
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.

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

53Помірний
Як обчислюється оцінка
10/30Підтримка власника — особистий (користувацький) обліковий запис
0/20Верифікований домен — не застосовно до користувацьких облікових записів
9.4/25Охоплення власника — 19 підписників у Alberto-Codes
22.9/25Послужний список — 113 публічних репозиторіїв, вік облікового запису ~4 р.
Використані вхідні дані
followers19
owner_typeUser
is_verified—
owner_loginAlberto-Codes
public_repos113
account_age_days1 805
Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

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

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

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

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

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

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

94Винятковий
Як обчислюється оцінка
24/24Процеси CI — 7 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера — pyproject.toml ([tool.ruff])
9.6/9.6Pre-commit-хуки
0/6.4.editorconfig
20/20OpenSSF Scorecard: CI-Tests — 30 out of 30 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://alberto-codes.github.io/docvet/
10/10Опис репозиторію
10/10Теми — 20 тем
0/10Wiki
Використані вхідні дані
topicscode-quality, docstring-checker, docstrings, documentation, github-actions, linter, mkdocs, pre-commit-hook, python, python3, static-analysis, docvet, ai-agent, ai-coding, ai-tools, developer-tools, llm-tools, mkdocstrings, docstring-linter, google-style-docstrings
has_wikiні
homepagehttps://alberto-codes.github.io/docvet/
docs_sitehttps://alberto-codes.github.io/docvet/
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

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

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

Стан безпеки

62Помірний
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
2.2/7.5Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5CI-Tests — 30 out of 30 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
0/7.5Code-Review — Found 0/30 approved changesets -- score normalized to 0
0/2.5Contributors — project has 0 contributing companies or organizations -- score normalized to 0
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 — 30 commit(s) and 30 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
5/5SAST — SAST tool is run on all commits
5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — немає даних
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5Vulnerabilities — 0 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate6,2
Виключено з оцінювання (немає даних або не застосовно): Packaging, Signed-Releases. Залишкові ваги перенормовано.

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

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

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

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

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

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

100Винятковий
Як обчислюється оцінка
45/45Інструкції для агентів — .github/instructions/mermaid.instructions.md, .github/instructions/sonarqube_mcp.instructions.md, AGENTS.md, CLAUDE.md
15/15Машиночитана документація (llms.txt) — llms.txt опубліковано на сайті проєкту (https://jsh9.github.io/pydoclint/llms.txt)
40/40Читабельна історія комітів — намір зазначено у 93 з 93 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtтак
llms_txt_urlhttps://jsh9.github.io/pydoclint/llms.txt
legible_history_share1
agent_instruction_files.github/instructions/mermaid.instructions.md, .github/instructions/sonarqube_mcp.instructions.md, AGENTS.md, CLAUDE.md
agent_instruction_max_bytes7 953

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

68Добрий
Як обчислюється оцінка
0/18Розгортання однією командою
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера — pyproject.toml ([tool.ruff])
11/11Статична перевірка типів — src/docvet/py.typed
10/10Відтворюване середовище — lockfile
6/10Підтверджена практика роботи з агентами — 3 з останніх 100 комітів створено агентом або з його зазначенням
8/8Автоматизоване супроводження — 7 з останніх 100 комітів — автоматичні оновлення залежностей
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Використані вхідні дані
has_nixні
has_testsтак
lockfilesuv.lock
has_dockerfileні
typed_languageні
bootstrap_files—
has_devcontainerні
has_linter_configтак
typecheck_configssrc/docvet/py.typed
agent_commit_share0,03
toolchain_manifests—
dependency_bot_commit_share0,07

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

80Відмінний
Як обчислюється оцінка
27/45Типізований код — Python з конфігурацією перевірки типів (src/docvet/py.typed)
53.2/55Керовані розміри файлів — 3/94 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes132 910
source_files_sampled94
oversized_source_files3

Машиночитні інтерфейси

33У зоні ризику
Як обчислюється оцінка
0/40Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення
20/20Сервер MCP
0/40Придатні до запуску приклади
Використані вхідні дані
example_dirs—
has_mcp_signalтак
api_schema_files—
interfaces_expected_of—
Виключено з оцінювання (немає даних або не застосовно): Схема API (OpenAPI/GraphQL/proto). Залишкові ваги перенормовано.

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

9зірок GitHub
1контриб'юторів
328комітів за останні 12 місяців
0днів від останнього пушу
34релізів
1бас-фактор
37відкритих issue
PyPIпакетних екосистем

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

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • deps.dev does not index pypi:docvet@2.0.3; advisories assessed against the repository dependency graph instead

Докладніше

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

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

10Binary-Artifactsno binaries found in the repo
3Branch-Protectionbranch protection is not maximal on development and all release branches
10CI-Tests30 out of 30 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0Code-ReviewFound 0/30 approved changesets -- score normalized to 0
0Contributorsproject has 0 contributing companies or organizations -- score normalized to 0
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 30 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
10SASTSAST tool is run on all commits
10Security-Policysecurity policy file detected
н/дSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
10Vulnerabilities0 existing vulnerabilities detected
Прямі залежності 1
РеєстрПакетОбмеження версіїМаніфест
PyPItyper>=0.9pyproject.toml
Усі залежності 94

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

РеєстрПакетВерсіяЗв'язок
PyPItyper0.27.2пряма
PyPIannotated-doc0.0.5непряма
PyPIannotated-types0.8.0непряма
PyPIanyio4.15.0непряма
PyPIattrs26.1.0непряма
PyPIbabel2.18.0непряма
PyPIbackrefs8.0непряма
PyPIcattrs26.1.0непряма
PyPIcertifi2026.10.19непряма
PyPIcffi2.1.1непряма
PyPIcharset-normalizer3.5.1непряма
PyPIclick8.5.0непряма
PyPIcolorama0.4.6непряма
PyPIcomrak0.0.16непряма
PyPIcoverage7.16.0непряма
PyPIcryptography50.0.1непряма
PyPIdocutils0.23непряма
PyPIdocvet2.0.3непряма
PyPIghp-import2.1.0непряма
PyPIgriffelib2.2.0непряма
PyPIgrimp3.16непряма
PyPIh110.16.0непряма
PyPIhjson3.1.0непряма
PyPIhttpcore1.0.9непряма
PyPIhttpx0.28.1непряма
PyPIhttpx-sse0.4.3непряма
PyPIidna3.19непряма
PyPIimport-linter2.14непряма
PyPIiniconfig2.3.0непряма
PyPIjinja23.1.6непряма
PyPIjsonschema4.26.0непряма
PyPIjsonschema-specifications2025.9.1непряма
PyPIlsprotocol2025.0.0непряма
PyPImarkdown3.10.3непряма
PyPImarkdown-it-py4.2.0непряма
PyPImarkupsafe3.0.3непряма
PyPImcp1.30.0непряма
PyPImdurl0.1.2непряма
PyPImergedeep1.3.4непряма
PyPImkdocs1.6.1непряма
PyPImkdocs-autorefs1.4.4непряма
PyPImkdocs-gen-files0.6.1непряма
PyPImkdocs-get-deps0.2.2непряма
PyPImkdocs-literate-nav0.6.3непряма
PyPImkdocs-macros-plugin1.5.0непряма
PyPImkdocs-material9.7.7непряма
PyPImkdocs-material-extensions1.3.1непряма
PyPImkdocs-section-index0.3.12непряма
PyPImkdocstrings1.0.6непряма
PyPImkdocstrings-python2.0.8непряма
PyPInh30.3.7непряма
PyPIpackaging26.3непряма
PyPIpaginate0.5.7непряма
PyPIpathspec1.1.1непряма
PyPIplatformdirs4.11.7непряма
PyPIpluggy1.6.0непряма
PyPIproperdocs1.6.7непряма
PyPIpycparser3.0непряма
PyPIpydantic2.13.5непряма
PyPIpydantic-core2.46.5непряма
PyPIpydantic-settings2.15.0непряма
PyPIpygls2.1.1непряма
PyPIpygments2.21.0непряма
PyPIpyjwt2.15.1непряма
PyPIpymdown-extensions11.0.2непряма
PyPIpytest9.1.1непряма
PyPIpytest-cov7.1.0непряма
PyPIpytest-mock3.15.1непряма
PyPIpytest-randomly5.0.0непряма
PyPIpython-dateutil2.9.0.post0непряма
PyPIpython-dotenv1.2.3непряма
PyPIpython-multipart0.0.32непряма
PyPIpywin32312непряма
PyPIpyyaml6.0.3непряма
PyPIpyyaml-env-tag1.1непряма
PyPIreadme-renderer46.0непряма
PyPIreferencing0.37.0непряма
PyPIrequests2.34.2непряма
PyPIrich15.0.0непряма
PyPIrpds-py2026.6.3непряма
PyPIruff0.16.5непряма
PyPIshellingham1.5.4непряма
PyPIsix1.17.0непряма
PyPIsse-starlette3.4.8непряма
PyPIstarlette1.6.0непряма
PyPIsuper-collections0.6.2непряма
PyPItermcolor3.3.0непряма
PyPIty0.0.78непряма
PyPItyping-extensions4.16.0непряма
PyPItyping-inspection0.4.4непряма
PyPIurllib32.8.0непряма
PyPIuvicorn0.52.4непряма
PyPIwatchdog6.0.0непряма
PyPIyamllint1.38.0непряма
Сповіщення про залежності 0

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

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

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

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

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

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

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

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

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

99astral-sh/ruffAn extremely fast Python linter and code formatter, written in Rust.Винятковий98pylint-dev/pylintIt's not just a linter that annoys you!Винятковий100psf/blackThe uncompromising Python code formatterВинятковий100streamlit/streamlitStreamlit — A faster way to build and share data apps.Винятковий99python/mypyOptional static typing for PythonВинятковий99pydantic/logfireAI observability platform for production LLM and agent systems.Винятковий

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

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

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