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

alexander-akhmetov / python-telegram

Python client for the Telegram's tdlib

PythonMIT★ 718 зірок⑂ 134 форкиз квіт. 2018 р.Переглянути на GitHub ↗

#python #telegram #tdlib #tdlib-python #telegram-bot #telegram-api #telegram-bots #telegram-bot-api #telegram-cli #python-telegram

alexander-akhmetov/python-telegram має індекс здоров’я 88 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Engineering Quality (90/100), найнижчий — Sustainability & Governance (63/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

загалом / 100

Відмінний

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

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

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

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

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

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

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

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

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

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

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

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

Власність

Alexander AkhmetovОсобистий обліковий запис

101 підписник93 публічні репозиторіїз черв. 2012 р.@grafana

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

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

Реєстр	Пакет	Версія	Завантажень / міс	Версії	Остання публікація	Теги
PyPI	python-telegram	2.0.0	6 226	21	0 днів тому	api client td tdjson tdlib telegram

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

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

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

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

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

79Добрий

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

36/36	Свіжість push — останній push 0 дн. тому
15.2/36	Ритм комітів — 22/52 тижнів із комітами
17.4/18	Обсяг комітів — 85 комітів за останній рік
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	85
human_commit_share	0,61
days_since_last_push	0
active_weeks_last_year	22

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

76Добрий

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

27/27	Випускає релізи — опубліковано 8 релізів
36/36	Свіжість релізів — останній реліз 0 дн. тому
12.6/27	Ритм релізів — реліз кожні ~300,8 дн.
0/10	OpenSSF Scorecard: Signed-Releases — Project has not signed or included provenance with any releases.

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

releases_count	8
latest_release_tag	2.0.0
releases_from_tags	ні
days_since_latest_release	0
mean_days_between_releases	300,8

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

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

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

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

70Добрий

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

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

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

has_readme	так
has_license	так
readme_badges	3
has_contributing	так
has_issue_template	ні
has_code_of_conduct	ні
readme_badge_services	github.com, shields.io
has_pull_request_template	ні

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

63Помірний

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

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

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

packages	python-telegram
dependents	—
ecosystems	pypi
total_downloads	—
monthly_downloads	6 226
unverified_packages_excluded	—

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

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

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

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

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

35Слабкий

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

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

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

bus_factor	1
contributors_sampled	15
top_contributor_share	0,906

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

69Добрий

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

40.8/42	Вирішення issue — закрито 97% issue
18.8/30	Прийняття PR — злито 313/500 вирішених PR
0/13	Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15	OpenSSF Scorecard: Code-Review — Found 0/8 approved changesets -- score normalized to 0

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

merged_prs	313
open_issues	5
closed_issues	173
prs_merged_7d	0
prs_decided_7d	0
prs_merged_30d	8
prs_decided_30d	8
issue_closed_ratio	0,972
closed_unmerged_prs	187
first_time_authors_30d	0
first_time_prs_merged_30d	0
first_time_prs_decided_30d	0

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

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

62Помірний

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

10/30	Підтримка власника — особистий (користувацький) обліковий запис
0/20	Верифікований домен — не застосовно до користувацьких облікових записів
14.4/25	Охоплення власника — 101 підписників у alexander-akhmetov
25/25	Послужний список — 93 публічних репозиторіїв, вік облікового запису ~14 р.

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

followers	101
owner_type	User
is_verified	—
owner_login	alexander-akhmetov
public_repos	93
account_age_days	5 176

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

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

100Винятковий

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

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

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

packages	python-telegram
ecosystems	pypi
any_deprecated	ні
min_days_since_publish	0

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

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

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

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

90Відмінний

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

24/24	Процеси CI — 3 процес(ів) CI
24/24	Наявні тести
16/16	Конфігурація лінтера — pyproject.toml ([tool.ruff]), tox.ini
0/9.6	Pre-commit-хуки
6.4/6.4	.editorconfig
20/20	OpenSSF Scorecard: CI-Tests — 16 out of 16 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://python-telegram.readthedocs.io/latest/
10/10	Опис репозиторію
10/10	Теми — 10 тем
0/10	Wiki

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

topics	python, telegram, tdlib, tdlib-python, telegram-bot, telegram-api, telegram-bots, telegram-bot-api, telegram-cli, python-telegram
has_wiki	ні
homepage	—
docs_site	https://python-telegram.readthedocs.io/latest/
has_readme	так
has_docs_dir	так
has_description	так

Безпека

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

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

Стан безпеки

64Помірний

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

7.5/7.5	Binary-Artifacts — no binaries found in the repo
3/7.5	Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5	CI-Tests — 16 out of 16 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 — Found 0/8 approved changesets -- score normalized to 0
2.5/2.5	Contributors — project has 7 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
1/5	Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 2
3.5/5	SAST — SAST tool detected but not run on all commits
0/5	Security-Policy — security policy file not detected
0/7.5	Signed-Releases — Project has not signed or included provenance with any releases.
6.8/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	18
scorecard_version	v5.5.0
checks_inconclusive	0
scorecard_aggregate	6,4

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

100Винятковий

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

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

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

source	osv
advisories	0
affected_packages	0
assessed_packages	7
unassessed_packages	5
affected_by_severity	none
direct_affected_packages	0

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

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

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

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

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

85Відмінний

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

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

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

has_llms_txt	ні
llms_txt_url	—
legible_history_share	0,82
agent_instruction_files	AGENTS.md, CLAUDE.md
agent_instruction_max_bytes	3 278

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

82Відмінний

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

18/18	Розгортання однією командою — Makefile, docs/Makefile
22/22	Автоматизовані тести
11/11	Конфігурація лінтера / форматера — pyproject.toml ([tool.ruff]), tox.ini
11/11	Статична перевірка типів — telegram/py.typed
10/10	Відтворюване середовище — Dockerfile
0/10	Підтверджена практика роботи з агентами — серед останніх 100 комітів немає створених агентом
8/8	Автоматизоване супроводження — 39 з останніх 100 комітів — автоматичні оновлення залежностей
2/10	OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 2

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

has_nix	ні
has_tests	так
lockfiles	—
has_dockerfile	так
typed_language	ні
bootstrap_files	Makefile, docs/Makefile
has_devcontainer	ні
has_linter_config	так
typecheck_configs	telegram/py.typed
agent_commit_share	0
toolchain_manifests	—
dependency_bot_commit_share	0,39

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

82Відмінний

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

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

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

primary_language	Python
largest_source_bytes	36 986
source_files_sampled	26
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. Залишкові ваги перенормовано.

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

718зірок GitHub

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

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

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

8релізів

1бас-фактор

5відкритих issue

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

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

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

Докладніше

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

0Зірки

134Форки

6Релізи

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

Мажорні 0Мінорні 6Патчі 0

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

OpenSSF Scorecard 6.4 / 10

6.4сукупно

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

10	Binary-Artifacts	no binaries found in the repo
4	Branch-Protection	branch protection is not maximal on development and all release branches
10	CI-Tests	16 out of 16 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
0	Code-Review	Found 0/8 approved changesets -- score normalized to 0
10	Contributors	project has 7 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
2	Pinned-Dependencies	dependency not pinned by hash detected -- score normalized to 2
7	SAST	SAST tool detected but not run on all commits
0	Security-Policy	security policy file not detected
0	Signed-Releases	Project has not signed or included provenance with any releases.
9	Token-Permissions	detected GitHub workflow tokens with excessive permissions
10	Vulnerabilities	0 existing vulnerabilities detected

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

Реєстр	Пакет	Обмеження версії	Маніфест
PyPI	telegram-text	`==0.2.0`	pyproject.toml

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

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

Реєстр	Пакет	Версія	Зв'язок
PyPI	telegram-text	`0.2.0`	пряма
PyPI	autodoc	`—`	непряма
PyPI	hatchling	`—`	непряма
PyPI	hatchling	`1.32.0`	непряма
PyPI	ipdb	`0.13.13`	непряма
PyPI	mypy	`2.3.1`	непряма
PyPI	pytest	`9.1.1`	непряма
PyPI	ruff	`0.16.3`	непряма
PyPI	sphinx	`—`	непряма
PyPI	sphinx-autobuild	`—`	непряма
PyPI	sphinx-immaterial	`—`	непряма
PyPI	types-pkg-resources	`0.1.3`	непряма

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

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

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

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

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

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

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

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

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

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

46.3/60	Зірки — 718 зірок
17.7/25	Форки — 134 форків
6.2/15	Спостерігачі — 14 спостерігачів

forks	134
stars	718
watchers	14
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

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

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

Власність

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

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

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

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

Докладніше

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

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