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

adamtheturtle / sphinx-substitution-extensions

Extensions for Sphinx which allow substitutions

PythonMIT★ 41 зірка⑂ 7 форківз лист. 2018 р.Переглянути на GitHub ↗
ТипБібліотекаяк це визначено
#sphinx-extension

adamtheturtle/sphinx-substitution-extensions має індекс здоров’я 86 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Vitality (97/100), найнижчий — AI Readiness (60/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

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

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

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

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

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

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

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

Власність

Adam DangoorОсобистий обліковий запис
78 підписників90 публічних репозиторіївз трав. 2011 р.

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

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

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
PyPIsphinx-substitution-extensions2026.8.13.1291 9573429 днів томуdocumentationrstsphinx

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

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

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

97Винятковий · 21% загального індексу

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

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

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

92Відмінний
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 37 релізів
36/36Свіжість релізів — останній реліз 29 дн. тому
19.8/27Ритм релізів — реліз кожні ~48,1 дн.
0/10OpenSSF Scorecard: Signed-Releases — немає даних
Використані вхідні дані
releases_count37
latest_release_tag2026.08.13.1
releases_from_tagsні
days_since_latest_release29
mean_days_between_releases48,1
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

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

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

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

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

32У зоні ризику
Як обчислюється оцінка
26/60Зірки — 41 зірок
6.5/25Форки — 7 форків
0/15Спостерігачі — 1 спостерігачів
Використані вхідні дані
forks7
stars41
watchers1
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

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

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

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

91Відмінний
Як обчислюється оцінка
72.9/80Щомісячні завантаження — 291 957 завантажень/місяць у pypi
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packagessphinx-substitution-extensions
dependents—
ecosystemspypi
total_downloads—
monthly_downloads291 957
unverified_packages_excluded—
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

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

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

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

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

30У зоні ризику
Як обчислюється оцінка
9/54Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
2/22.5Розподіл комітів — головний контриб’ютор — автор 91% комітів
9.5/13.5Широта контриб’юторів — 7 контриб’юторів
10/10OpenSSF Scorecard: Contributors — project has 6 contributing companies or organizations
Використані вхідні дані
bus_factor1
contributors_sampled7
top_contributor_share0,91

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

81Відмінний
Як обчислюється оцінка
42/42Вирішення issue — закрито 100% issue
28.2/30Прийняття PR — злито 1 572/1 675 вирішених PR
0/13Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15OpenSSF Scorecard: Code-Review — Found 0/13 approved changesets -- score normalized to 0
Використані вхідні дані
merged_prs1 572
open_issues0
closed_issues51
prs_merged_7d16
prs_decided_7d16
prs_merged_30d19
prs_decided_30d19
issue_closed_ratio1
closed_unmerged_prs103
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.

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

61Помірний
Як обчислюється оцінка
10/30Підтримка власника — особистий (користувацький) обліковий запис
0/20Верифікований домен — не застосовно до користувацьких облікових записів
13.6/25Охоплення власника — 78 підписників у adamtheturtle
25/25Послужний список — 90 публічних репозиторіїв, вік облікового запису ~15 р.
Використані вхідні дані
followers78
owner_typeUser
is_verified—
owner_loginadamtheturtle
public_repos90
account_age_days5 594
Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

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

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

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

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

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

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

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

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

60Помірний
Як обчислюється оцінка
30/30README
0/25Каталог документації
0/15Сайт документації / домашня сторінка
10/10Опис репозиторію
10/10Теми — 1 тем
10/10Wiki
Використані вхідні дані
topicssphinx-extension
has_wikiтак
homepage—
docs_site—
has_readmeтак
has_docs_dirні
has_descriptionтак

Безпека

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

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

Стан безпеки

55Помірний
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
0.8/7.5Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5CI-Tests — 17 out of 17 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/13 approved changesets -- score normalized to 0
2.5/2.5Contributors — project has 6 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 — 30 commit(s) and 24 issue activity found in the last 90 days -- score normalized to 10
5/5Packaging — packaging workflow detected
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 — немає даних
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5Vulnerabilities — 0 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated17
scorecard_versionv5.5.0
checks_inconclusive1
scorecard_aggregate5,5
Виключено з оцінювання (немає даних або не застосовно): Signed-Releases. Залишкові ваги перенормовано.

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

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

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

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

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

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

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

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

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

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

82Відмінний
Як обчислюється оцінка
27/45Типізований код — Python з конфігурацією перевірки типів (src/sphinx_substitution_extensions/py.typed)
55/55Керовані розміри файлів — 0/8 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes28 917
source_files_sampled8
oversized_source_files0

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

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

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

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

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

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

Докладніше

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

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

1234567712020-032023-052026-06
Мажорні 0Мінорні 0Патчі 14

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

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

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

10Binary-Artifactsno binaries found in the repo
1Branch-Protectionbranch protection is not maximal on development and all release branches
10CI-Tests17 out of 17 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/13 approved changesets -- score normalized to 0
10Contributorsproject has 6 contributing companies or organizations
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 24 issue activity found in the last 90 days -- score normalized to 10
10Packagingpackaging workflow 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
н/дSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
10Vulnerabilities0 existing vulnerabilities detected
Прямі залежності 5
РеєстрПакетОбмеження версіїМаніфест
PyPIbeartype>=0.22.9pyproject.toml
PyPIdocutils>=0.19pyproject.toml
PyPImyst-parser>=4.0.0pyproject.toml
PyPIsphinx>=8.1.0pyproject.toml
PyPItyping-extensions>=4.4.0pyproject.toml
Усі залежності 41

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

РеєстрПакетВерсіяЗв'язок
PyPIbeartype—пряма
PyPIdocutils—пряма
PyPImyst-parser—пряма
PyPIsphinx—пряма
PyPItyping-extensions—пряма
PyPIactionlint-py1.7.12.24непряма
PyPIcheck-manifest0.51непряма
PyPIcheck-wheel-contents0.6.3непряма
PyPIdeptry0.25.1непряма
PyPIdoc82.0.0непряма
PyPIdoc8-custom-ignores2026.7.29.1непряма
PyPIdoccmd2026.9.7непряма
PyPIinterrogate1.7.0непряма
PyPImypy2.3.1непряма
PyPImypy-strict-kwargs2026.8.25.1непряма
PyPIno-defaults2026.9.1непряма
PyPIprek0.5.2непряма
PyPIpydocstringformatter1.0.0непряма
PyPIpylint4.0.8непряма
PyPIpyproject-fmt2.29.3непряма
PyPIpyrefly1.2.0непряма
PyPIpyright1.1.411непряма
PyPIpyroma5.0.1непряма
PyPIpytest9.1.1непряма
PyPIpytest-beartype-tests2026.8.16непряма
PyPIpytest-cov7.1.0непряма
PyPIruff0.16.6непряма
PyPIsetuptools-scm—непряма
PyPIshellcheck-py0.11.0.1непряма
PyPIshfmt-py4.2.0непряма
PyPIsnapper-fmt0.11.1непряма
PyPIsphinx-lint1.0.2непряма
PyPIsphinx-toolbox4.3.0непряма
PyPIstrict-kwargs2026.8.28.post2непряма
PyPItowncrier26.9.0непряма
PyPIty0.0.79непряма
PyPItypes-docutils0.23.0.20260827непряма
PyPIvale3.20.0.0непряма
PyPIvulture2.16непряма
PyPIyamlfix1.19.1непряма
PyPIzizmor1.30.0непряма
Сповіщення про залежності 0

Встановлення pypi:sphinx-substitution-extensions@2026.8.13.1 тягне 28 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.

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

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

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

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

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

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

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

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

94useblocks/sphinx-needsAdds needs/requirements to sphinxВинятковий94sphinx-gallery/sphinx-gallerySphinx extension for automatic generation of an example galleryВинятковий88mgaitan/sphinxcontrib-mermaidMermaid diagrams in yours sphinx powered docsВідмінний86sphinx-contrib/httpdomainDocumenting RESTful HTTP APIsВідмінний84executablebooks/sphinx-tabsTabbed views for SphinxВідмінний80sbrunner/sphinx-promptSphinx directive to add unselectable promptВідмінний

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

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

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