Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-08-27 14:17 UTC

maxmind / GeoIP2-python

Python code for GeoIP2 webservice client and database reader

PythonApache-2.0★ 1 217 зірок⑂ 142 форкиз квіт. 2013 р.Переглянути на GitHub ↗

maxmind/GeoIP2-python має індекс здоров’я 96 зі 100, що відповідає смузі «Винятковий». Найвищий показник — Vitality (94/100), найнижчий — Community & Adoption (73/100). Останнє оновлення було 1 день тому. Більшість нещодавньої роботи виконує один учасник.

загалом / 100

Винятковий

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

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

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

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

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

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

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

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

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

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

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

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

Власність

MaxMindОрганізація · підтверджений домен

335 підписників100 публічних репозиторіївз лист. 2011 р.

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

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

Реєстр	Пакет	Версія	Завантажень / міс	Версії	Остання публікація
PyPI	geoip2	5.3.0	17 934 757	45	41 день тому

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

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

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

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

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

100Винятковий

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

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

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

commits_last_year	481
human_commit_share	0,59
days_since_last_push	1
active_weeks_last_year	52

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

84Відмінний

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

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

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

releases_count	46
latest_release_tag	v5.3.0
releases_from_tags	ні
days_since_latest_release	41
mean_days_between_releases	189

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

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

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

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

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

50Помірний

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

22.5/22.5	README
22.5/22.5	Ліцензія — визнана ліцензія (Apache-2.0)
0/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	ні

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

100Винятковий

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

80/80	Щомісячні завантаження — 17 934 757 завантажень/місяць у pypi
0/20	Залежні пакети в реєстрі — ця екосистема цього не повідомляє

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

packages	geoip2
dependents	—
ecosystems	pypi
total_downloads	—
monthly_downloads	17 934 757
unverified_packages_excluded	—

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

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

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

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

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

42Слабкий

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

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

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

bus_factor	1
contributors_sampled	31
top_contributor_share	0,574

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

97Винятковий

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

40.7/42	Вирішення issue — закрито 97% issue
28.9/30	Прийняття PR — злито 405/421 вирішених PR
0/13	Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15	OpenSSF Scorecard: Code-Review — немає даних

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

merged_prs	405
open_issues	2
closed_issues	60
prs_merged_7d	0
prs_decided_7d	0
prs_merged_30d	1
prs_decided_30d	1
issue_closed_ratio	0,968
closed_unmerged_prs	16
first_time_authors_30d	0
first_time_prs_merged_30d	0
first_time_prs_decided_30d	0

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

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

93Винятковий

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

30/30	Підтримка власника — у власності організації
20/20	Верифікований домен
18.2/25	Охоплення власника — 335 підписників у maxmind
25/25	Послужний список — 100 публічних репозиторіїв, вік облікового запису ~14 р.

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

followers	335
owner_type	Organization
is_verified	так
owner_login	maxmind
public_repos	100
account_age_days	5 405

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

100Винятковий

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

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

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

packages	geoip2
ecosystems	pypi
any_deprecated	ні
min_days_since_publish	41

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

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

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

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

84Відмінний

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

24/24	Процеси CI — 6 процес(ів) CI
24/24	Наявні тести
16/16	Конфігурація лінтера — pyproject.toml ([tool.ruff])
0/9.6	Pre-commit-хуки
0/6.4	.editorconfig
20/20	OpenSSF Scorecard: CI-Tests — 18 out of 18 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/30	README
25/25	Каталог документації
15/15	Сайт документації / домашня сторінка — https://geoip2.readthedocs.org/en/latest/
10/10	Опис репозиторію
10/10	Теми — 4 тем
0/10	Wiki

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

topics	geoip, mmdb, geoip2, maxmind
has_wiki	ні
homepage	https://geoip2.readthedocs.org/en/latest/
docs_site	https://geoip2.readthedocs.org/en/latest/
has_readme	так
has_docs_dir	так
has_description	так

Безпека

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

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

Стан безпеки

83Відмінний

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

7.5/7.5	Binary-Artifacts — no binaries found in the repo
4.5/7.5	Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5	CI-Tests — 18 out of 18 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
0/7.5	Code-Review — немає даних
2.5/2.5	Contributors — project has 30 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 — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
5/5	Packaging — packaging workflow detected
5/5	Pinned-Dependencies — all dependencies are pinned
5/5	SAST — SAST tool is run on all commits
0/5	Security-Policy — security policy file not detected
0/7.5	Signed-Releases — немає даних
7.5/7.5	Token-Permissions — GitHub workflow tokens follow principle of least privilege
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	8,3

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

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

100Винятковий

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

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

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

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

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

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

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

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

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

85Відмінний

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

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

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

has_llms_txt	ні
llms_txt_url	—
legible_history_share	0,932
agent_instruction_files	CLAUDE.md
agent_instruction_max_bytes	12 518

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

100Винятковий

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

18/18	Розгортання однією командою — docs/Makefile, mise.toml
22/22	Автоматизовані тести
11/11	Конфігурація лінтера / форматера — pyproject.toml ([tool.ruff])
11/11	Статична перевірка типів — src/geoip2/py.typed
10/10	Відтворюване середовище — lockfile
10/10	Підтверджена практика роботи з агентами — 7 з останніх 100 комітів створено агентом або з його зазначенням
8/8	Автоматизоване супроводження — 41 з останніх 100 комітів — автоматичні оновлення залежностей
10/10	OpenSSF Scorecard: Pinned-Dependencies — all dependencies are pinned

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

has_nix	ні
has_tests	так
lockfiles	uv.lock
has_dockerfile	ні
typed_language	ні
bootstrap_files	docs/Makefile, mise.toml
has_devcontainer	ні
has_linter_config	так
typecheck_configs	src/geoip2/py.typed
agent_commit_share	0,07
toolchain_manifests	—
dependency_bot_commit_share	0,41

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

82Відмінний

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

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

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

primary_language	Python
largest_source_bytes	29 453
source_files_sampled	14
oversized_source_files	0

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

100Винятковий

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

0/40	Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення
0/20	Сервер MCP — не застосовно до цього типу програмного забезпечення
40/40	Придатні до запуску приклади — examples

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

example_dirs	examples
has_mcp_signal	ні
api_schema_files	—
interfaces_expected_of	—

Виключено з оцінювання (немає даних або не застосовно): Схема API (OpenAPI/GraphQL/proto), Сервер MCP. Залишкові ваги перенормовано.

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

1 217зірок GitHub

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

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

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

46релізів

1бас-фактор

2відкритих issue

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

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

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

Докладніше

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

0Зірки

142Форки

39Релізи

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

Мажорні 4Мінорні 23Патчі 12

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

OpenSSF Scorecard 8.3 / 10

8.3сукупно

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

10	Binary-Artifacts	no binaries found in the repo
6	Branch-Protection	branch protection is not maximal on development and all release branches
10	CI-Tests	18 out of 18 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
н/д	Code-Review	Found no human activity in the last 18 changesets
10	Contributors	project has 30 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	30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
10	Packaging	packaging workflow detected
10	Pinned-Dependencies	all dependencies are pinned
10	SAST	SAST tool is run on all commits
0	Security-Policy	security policy file not detected
н/д	Signed-Releases	no releases found
10	Token-Permissions	GitHub workflow tokens follow principle of least privilege
10	Vulnerabilities	0 existing vulnerabilities detected

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

Реєстр	Пакет	Обмеження версії	Маніфест
PyPI	aiohttp	`>=3.14.1,<4.0.0`	pyproject.toml
PyPI	maxminddb	`>=3.0.0,<4.0.0`	pyproject.toml
PyPI	requests	`>=2.24.0,<3.0.0`	pyproject.toml

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

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

Реєстр	Пакет	Версія	Зв'язок
PyPI	aiohttp	`3.14.3`	пряма
PyPI	maxminddb	`3.1.1`	пряма
PyPI	requests	`2.34.2`	пряма
PyPI	aiohappyeyeballs	`2.6.1`	непряма
PyPI	aiosignal	`1.4.0`	непряма
PyPI	ast-serialize	`0.6.0`	непряма
PyPI	async-timeout	`5.0.1`	непряма
PyPI	attrs	`25.3.0`	непряма
PyPI	cachetools	`7.0.5`	непряма
PyPI	certifi	`2025.6.15`	непряма
PyPI	charset-normalizer	`3.4.2`	непряма
PyPI	colorama	`0.4.6`	непряма
PyPI	distlib	`0.4.0`	непряма
PyPI	exceptiongroup	`1.3.0`	непряма
PyPI	filelock	`3.25.0`	непряма
PyPI	frozenlist	`1.7.0`	непряма
PyPI	geoip2	`5.3.0`	непряма
PyPI	idna	`3.15`	непряма
PyPI	iniconfig	`2.1.0`	непряма
PyPI	librt	`0.13.0`	непряма
PyPI	markupsafe	`3.0.2`	непряма
PyPI	multidict	`6.5.0`	непряма
PyPI	mypy	`2.3.1`	непряма
PyPI	mypy-extensions	`1.1.0`	непряма
PyPI	packaging	`26.0`	непряма
PyPI	pathspec	`1.0.4`	непряма
PyPI	platformdirs	`4.9.4`	непряма
PyPI	pluggy	`1.6.0`	непряма
PyPI	propcache	`0.3.2`	непряма
PyPI	pygments	`2.20.0`	непряма
PyPI	pyproject-api	`1.10.0`	непряма
PyPI	pytest	`9.1.1`	непряма
PyPI	pytest-httpserver	`1.1.5`	непряма
PyPI	python-discovery	`1.2.2`	непряма
PyPI	ruff	`0.15.22`	непряма
PyPI	tomli	`2.4.0`	непряма
PyPI	tomli-w	`1.2.0`	непряма
PyPI	tox	`4.53.0`	непряма
PyPI	tox-uv	`1.36.0`	непряма
PyPI	tox-uv-bare	`1.36.0`	непряма
PyPI	typing-extensions	`4.15.0`	непряма
PyPI	urllib3	`2.7.0`	непряма
PyPI	uv	`0.11.15`	непряма
PyPI	virtualenv	`21.1.0`	непряма
PyPI	werkzeug	`3.1.6`	непряма
PyPI	yarl	`1.20.1`	непряма

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

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

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

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

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

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

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

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

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

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

50/60	Зірки — 1 217 зірок
17.9/25	Форки — 142 форків
9.2/15	Спостерігачі — 47 спостерігачів

forks	142
stars	1 217
watchers	47
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

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

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

Власність

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

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

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

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

Докладніше

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

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