Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-09-10 21:38 UTC

tfranzel / drf-spectacular

Sane and flexible OpenAPI 3 schema generation for Django REST framework.

PythonBSD-3-Clause★ 2 861 зірка⑂ 335 форківз бер. 2020 р.Переглянути на GitHub ↗

ТипБібліотекаМережевий сервісяк це визначено

#rest-framework #openapi3 #django #swagger #openapi-specification #documentation-generator #rest-api #drf #openapi-generator

tfranzel/drf-spectacular має індекс здоров’я 84 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Engineering Quality (88/100), найнижчий — Security (58/100). Останнє оновлення було 8 днів тому. Більшість нещодавньої роботи виконує один учасник.

загалом / 100

Відмінний

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

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

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

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

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

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

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

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

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

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

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

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

Власність

T. FranzelОсобистий обліковий запис

103 підписники18 публічних репозиторіївз лип. 2015 р.

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

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

Реєстр	Пакет	Версія	Завантажень / міс	Версії	Остання публікація	Теги
PyPI	drf-spectacular	0.30.0	-	67	66 днів тому	django rest openapi schema api swagger

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

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

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

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

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

68Добрий

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

28.8/36	Свіжість push — останній push 8 дн. тому
11.8/36	Ритм комітів — 17/52 тижнів із комітами
17.6/18	Обсяг комітів — 91 комітів за останній рік
10/10	OpenSSF Scorecard: Maintained — 22 commit(s) and 8 issue activity found in the last 90 days -- score normalized to 10

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

commits_last_year	91
human_commit_share	0,98
days_since_last_push	8
active_weeks_last_year	17

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

84Відмінний

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

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

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

releases_count	12
latest_release_tag	0.30.0
releases_from_tags	ні
days_since_latest_release	66
mean_days_between_releases	130,9

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

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

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

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

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

70Добрий

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

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

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

has_readme	так
has_license	так
readme_badges	0
has_contributing	так
has_issue_template	ні
has_code_of_conduct	ні
readme_badge_services	—
has_pull_request_template	ні

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

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

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

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

37Слабкий

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

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

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

bus_factor	1
contributors_sampled	99
top_contributor_share	0,814

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

70Добрий

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

35.1/42	Вирішення issue — закрито 84% issue
22.4/30	Прийняття PR — злито 308/413 вирішених PR
0/13	Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
3/15	OpenSSF Scorecard: Code-Review — Found 5/23 approved changesets -- score normalized to 2

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

merged_prs	308
open_issues	177
closed_issues	902
prs_merged_7d	0
prs_decided_7d	0
prs_merged_30d	0
prs_decided_30d	0
issue_closed_ratio	0,836
closed_unmerged_prs	105
first_time_authors_30d	0
first_time_prs_merged_30d	0
first_time_prs_decided_30d	0

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

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

57Помірний

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

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

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

followers	103
owner_type	User
is_verified	—
owner_login	tfranzel
public_repos	18
account_age_days	4 064

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

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

100Винятковий

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

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

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

packages	drf-spectacular
ecosystems	pypi
any_deprecated	ні
min_days_since_publish	66

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

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

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

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

80Відмінний

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

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

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

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

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

100Винятковий

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

30/30	README
25/25	Каталог документації
15/15	Сайт документації / домашня сторінка — https://drf-spectacular.readthedocs.io
10/10	Опис репозиторію
10/10	Теми — 9 тем
10/10	Wiki

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

topics	rest-framework, openapi3, django, swagger, openapi-specification, documentation-generator, rest-api, drf, openapi-generator
has_wiki	так
homepage	https://drf-spectacular.readthedocs.io
docs_site	https://drf-spectacular.readthedocs.io
has_readme	так
has_docs_dir	так
has_description	так

Безпека

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

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

Стан безпеки

48Слабкий

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

7.5/7.5	Binary-Artifacts — no binaries found in the repo
0/7.5	Branch-Protection — немає даних
2/2.5	CI-Tests — 8 out of 10 merged PRs checked by a CI test -- score normalized to 8
0/2.5	CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
1.5/7.5	Code-Review — Found 5/23 approved changesets -- score normalized to 2
2.5/2.5	Contributors — project has 33 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 — 22 commit(s) and 8 issue activity found in the last 90 days -- score normalized to 10
0/5	Packaging — немає даних
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
0/7.5	Vulnerabilities — 52 existing vulnerabilities detected

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

source	openssf_scorecard
checks_evaluated	15
scorecard_version	v5.5.0
checks_inconclusive	3
scorecard_aggregate	4,8

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

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

100Винятковий

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

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

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

source	osv
advisories	0
affected_packages	0
assessed_packages	12
unassessed_packages	0
affected_by_severity	none
direct_affected_packages	0

Виключено з оцінювання (немає даних або не застосовно): Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено з runtime-замиканням залежностей pypi:drf-spectacular@0.30.0 — тим, що тягне за собою встановлення опублікованого пакета, — 12 пакетів. Досяжність не аналізується.

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

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

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

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

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

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

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

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

has_llms_txt	ні
llms_txt_url	—
legible_history_share	0,602
agent_instruction_files	—
agent_instruction_max_bytes	—

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

72Добрий

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

18/18	Розгортання однією командою — docs/Makefile
22/22	Автоматизовані тести
11/11	Конфігурація лінтера / форматера — tox.ini
11/11	Статична перевірка типів — drf_spectacular/py.typed
0/10	Відтворюване середовище
2/10	Підтверджена практика роботи з агентами — 1 з останніх 100 комітів створено агентом або з його зазначенням
8/8	Автоматизоване супроводження — 2 з останніх 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	drf_spectacular/py.typed
agent_commit_share	0,01
toolchain_manifests	—
dependency_bot_commit_share	0,02

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

81Відмінний

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

27/45	Типізований код — Python з конфігурацією перевірки типів (drf_spectacular/py.typed)
53.9/55	Керовані розміри файлів — 2/100 файлів вихідного коду понад 60 КБ

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

primary_language	Python
largest_source_bytes	136 307
source_files_sampled	100
oversized_source_files	2

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

2 861зірок GitHub

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

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

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

12релізів

1бас-фактор

177відкритих issue

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

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

Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
pypi download statistics for 'drf-spectacular' unavailable this scan (stats endpoint failed after retries); adoption may be under-evidenced

Докладніше

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

0Зірки

335Форки

12Релізи

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

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

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

OpenSSF Scorecard 4.8 / 10

4.8сукупно

Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-09-10 21:38 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
8	CI-Tests	8 out of 10 merged PRs checked by a CI test -- score normalized to 8
0	CII-Best-Practices	no effort to earn an OpenSSF best practices badge detected
2	Code-Review	Found 5/23 approved changesets -- score normalized to 2
10	Contributors	project has 33 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	22 commit(s) and 8 issue activity found in the last 90 days -- score normalized to 10
н/д	Packaging	packaging workflow not 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
0	Vulnerabilities	52 existing vulnerabilities detected

Прямі залежності 7

Реєстр	Пакет	Обмеження версії	Маніфест
PyPI	Django	`>=2.2`	pyproject.toml
PyPI	djangorestframework	`>=3.10.3`	pyproject.toml
PyPI	uritemplate	`>=2.0.0`	pyproject.toml
PyPI	PyYAML	`>=5.1`	pyproject.toml
PyPI	jsonschema	`>=2.6.0`	pyproject.toml
PyPI	inflection	`>=0.3.1`	pyproject.toml
PyPI	typing-extensions	`—`	pyproject.toml

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

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

Реєстр	Пакет	Версія	Зв'язок
PyPI	django	`—`	пряма
PyPI	django	`5.2.15`	пряма
PyPI	djangorestframework	`—`	пряма
PyPI	djangorestframework	`3.17.1`	пряма
PyPI	inflection	`—`	пряма
PyPI	jsonschema	`—`	пряма
PyPI	pyyaml	`—`	пряма
PyPI	typing-extensions	`—`	пряма
PyPI	uritemplate	`—`	пряма
PyPI	build	`—`	непряма
PyPI	dj-rest-auth	`—`	непряма
PyPI	django-allauth	`—`	непряма
PyPI	django-filter	`—`	непряма
PyPI	django-oauth-toolkit	`—`	непряма
PyPI	django-polymorphic	`—`	непряма
PyPI	django-rest-knox	`—`	непряма
PyPI	django-rest-polymorphic	`—`	непряма
PyPI	django-stubs	`5.2.7`	непряма
PyPI	djangorestframework-camel-case	`—`	непряма
PyPI	djangorestframework-dataclasses	`—`	непряма
PyPI	djangorestframework-gis	`—`	непряма
PyPI	djangorestframework-recursive	`—`	непряма
PyPI	djangorestframework-simplejwt	`—`	непряма
PyPI	djangorestframework-stubs	`3.16.5`	непряма
PyPI	drf-jwt	`—`	непряма
PyPI	drf-nested-routers	`—`	непряма
PyPI	drf-spectacular-sidecar	`—`	непряма
PyPI	flake8	`—`	непряма
PyPI	furo	`—`	непряма
PyPI	isort	`7.0.0`	непряма
PyPI	mypy	`1.18.2`	непряма
PyPI	psycopg2-binary	`—`	непряма
PyPI	pydantic	`—`	непряма
PyPI	pytest	`—`	непряма
PyPI	pytest-cov	`—`	непряма
PyPI	pytest-django	`—`	непряма
PyPI	setuptools	`—`	непряма
PyPI	sphinx	`—`	непряма
PyPI	twine	`—`	непряма

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

Встановлення pypi:drf-spectacular@0.30.0 тягне 12 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.

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

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

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

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

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

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

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

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

56.1/60	Зірки — 2 861 зірок
21/25	Форки — 335 форків
5/15	Спостерігачі — 9 спостерігачів

forks	335
stars	2 861
watchers	9
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

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

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

Власність

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

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

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

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

Докладніше

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

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