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

sblibs / pySwitchbot

Library to control Switchbot over Bluetooth

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

#bleak #bluetooth #home-assistant #switchbot

sblibs/pySwitchbot має індекс здоров’я 84 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Vitality (88/100), найнижчий — Community & Adoption (60/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

загалом / 100

Відмінний

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

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

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

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

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

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

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

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

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

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

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

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

Власність

Switchbot LibsОрганізація

2 підписники1 публічний репозиторійз лист. 2024 р.

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

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

Реєстр	Пакет	Версія	Завантажень / міс	Версії	Остання публікація
PyPI	PySwitchbot	2.9.0	60 226	195	0 днів тому

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

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

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

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

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

86Відмінний

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

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

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

commits_last_year	133
human_commit_share	0,62
days_since_last_push	0
active_weeks_last_year	31

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

90Відмінний

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

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

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

releases_count	100
latest_release_tag	2.9.0
releases_from_tags	ні
days_since_latest_release	0
mean_days_between_releases	16

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

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

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

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

50Помірний

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

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

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

has_readme	так
has_license	так
readme_badges	1
has_contributing	ні
has_issue_template	ні
has_code_of_conduct	ні
readme_badge_services	codecov.io
has_pull_request_template	ні

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

80Відмінний

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

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

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

packages	PySwitchbot
dependents	—
ecosystems	pypi
total_downloads	—
monthly_downloads	60 226
unverified_packages_excluded	—

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

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

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

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

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

41Слабкий

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

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

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

bus_factor	1
contributors_sampled	52
top_contributor_share	0,626

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

74Добрий

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

24.8/42	Вирішення issue — закрито 59% issue
28.4/30	Прийняття PR — злито 435/459 вирішених PR
13/13	Newcomer PR acceptance — злито 2/2 PR від новачків за 30 дн.
7.5/15	OpenSSF Scorecard: Code-Review — Found 12/21 approved changesets -- score normalized to 5

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

merged_prs	435
open_issues	36
closed_issues	52
prs_merged_7d	3
prs_decided_7d	3
prs_merged_30d	7
prs_decided_30d	7
issue_closed_ratio	0,591
closed_unmerged_prs	24
first_time_authors_30d	2
first_time_prs_merged_30d	2
first_time_prs_decided_30d	2

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

39Слабкий

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

30/30	Підтримка власника — у власності організації
0/20	Верифікований домен
3.4/25	Охоплення власника — 2 підписників у sblibs
5.8/25	Послужний список — 1 публічних репозиторіїв, вік облікового запису ~1 р.

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

followers	2
owner_type	Organization
is_verified	ні
owner_login	sblibs
public_repos	1
account_age_days	665

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

100Винятковий

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

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

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

packages	PySwitchbot
ecosystems	pypi
any_deprecated	ні
min_days_since_publish	0

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

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

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

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

94Винятковий

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

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

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

topics	bleak, bluetooth, home-assistant, switchbot
has_wiki	так
homepage	—
docs_site	—
has_readme	так
has_docs_dir	ні
has_description	так

Безпека

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

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

Стан безпеки

61Помірний

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

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 — 22 out of 22 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
3.8/7.5	Code-Review — Found 12/21 approved changesets -- score normalized to 5
2.5/2.5	Contributors — project has 23 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 1 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
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 — Project has not signed or included provenance with any releases.
0/7.5	Token-Permissions — detected GitHub workflow tokens with excessive permissions
6.8/7.5	Vulnerabilities — 1 existing vulnerabilities detected

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

source	openssf_scorecard
checks_evaluated	18
scorecard_version	v5.5.0
checks_inconclusive	0
scorecard_aggregate	6

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

78Добрий

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

18.5/35	Прямі залежності без відомих сповіщень — уражено 1: cryptography 49.0.0 (moderate 5.9)
0/25	Непрямі залежності без відомих сповіщень — транзитивний набір не відокремлюється від залежностей розробки й тестування в цьому обсязі
40/40	Немає задавнених сповіщень — жодне сповіщення не є публічним довше за 90 дн.

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

source	osv
advisories	2
affected_packages	1
assessed_packages	43
unassessed_packages	0
affected_by_severity	moderate 1
direct_affected_packages	1

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

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

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

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

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

85Відмінний

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

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

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

has_llms_txt	ні
llms_txt_url	—
legible_history_share	0,839
agent_instruction_files	AGENTS.md, CLAUDE.md
agent_instruction_max_bytes	6 569

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

71Добрий

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

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

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

has_nix	ні
has_tests	так
lockfiles	poetry.lock
has_dockerfile	ні
typed_language	ні
bootstrap_files	—
has_devcontainer	ні
has_linter_config	так
typecheck_configs	—
agent_commit_share	0,13
toolchain_manifests	—
dependency_bot_commit_share	0,19

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

54Помірний

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

0/45	Типізований код — Python без конфігурації перевірки типів
54.5/55	Керовані розміри файлів — 1/111 файлів вихідного коду понад 60 КБ

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

primary_language	Python
largest_source_bytes	167 258
source_files_sampled	111
oversized_source_files	1

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

173зірок GitHub

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

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

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

100релізів

1бас-фактор

36відкритих issue

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

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

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

Докладніше

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

0Зірки

82Форки

97Релізи

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

Мажорні 2Мінорні 54Патчі 41

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

OpenSSF Scorecard 6.0 / 10

6.0сукупно

Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-09-15 12:43 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	22 out of 22 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
5	Code-Review	Found 12/21 approved changesets -- score normalized to 5
10	Contributors	project has 23 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 1 issue activity found in the last 90 days -- score normalized to 10
10	Packaging	packaging workflow detected
10	Pinned-Dependencies	all dependencies are pinned
0	SAST	SAST tool is not run on all commits -- score normalized to 0
0	Security-Policy	security policy file not detected
0	Signed-Releases	Project has not signed or included provenance with any releases.
0	Token-Permissions	detected GitHub workflow tokens with excessive permissions
9	Vulnerabilities	1 existing vulnerabilities detected

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

Реєстр	Пакет	Обмеження версії	Маніфест
PyPI	aiohttp	`>=3.9.5`	pyproject.toml
PyPI	bleak	`>=0.19.0`	pyproject.toml
PyPI	bleak-retry-connector	`>=3.4.0`	pyproject.toml
PyPI	cryptography	`>=39.0.0`	pyproject.toml
PyPI	pyOpenSSL	`>=23.0.0`	pyproject.toml

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

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

Реєстр	Пакет	Версія	Зв'язок
PyPI	aiohttp	`3.14.3`	пряма
PyPI	bleak	`3.0.2`	пряма
PyPI	bleak-retry-connector	`4.7.0`	пряма
PyPI	cryptography	`49.0.0`	пряма
PyPI	pyopenssl	`26.4.0`	пряма
PyPI	aiohappyeyeballs	`2.6.2`	непряма
PyPI	aiooui	`0.1.9`	непряма
PyPI	aiosignal	`1.4.0`	непряма
PyPI	attrs	`26.1.0`	непряма
PyPI	bluetooth-adapters	`2.4.0`	непряма
PyPI	cffi	`2.0.0`	непряма
PyPI	colorama	`0.4.6`	непряма
PyPI	coverage	`7.14.2`	непряма
PyPI	dbus-fast	`5.0.22`	непряма
PyPI	frozenlist	`1.8.0`	непряма
PyPI	idna	`3.18`	непряма
PyPI	iniconfig	`2.3.0`	непряма
PyPI	multidict	`6.7.1`	непряма
PyPI	packaging	`26.2`	непряма
PyPI	pluggy	`1.6.0`	непряма
PyPI	propcache	`0.5.2`	непряма
PyPI	pycparser	`3.0`	непряма
PyPI	pygments	`2.20.0`	непряма
PyPI	pyobjc-core	`12.2.1`	непряма
PyPI	pyobjc-framework-cocoa	`12.2.1`	непряма
PyPI	pyobjc-framework-corebluetooth	`12.2.1`	непряма
PyPI	pyobjc-framework-libdispatch	`12.2.1`	непряма
PyPI	pytest	`9.1.1`	непряма
PyPI	pytest-asyncio	`1.4.0`	непряма
PyPI	pytest-cov	`7.1.0`	непряма
PyPI	typing-extensions	`4.15.0`	непряма
PyPI	uart-devices	`0.1.1`	непряма
PyPI	usb-devices	`0.5.1`	непряма
PyPI	winrt-runtime	`3.2.1`	непряма
PyPI	winrt-windows-devices-bluetooth	`3.2.1`	непряма
PyPI	winrt-windows-devices-bluetooth-advertisement	`3.2.1`	непряма
PyPI	winrt-windows-devices-bluetooth-genericattributeprofile	`3.2.1`	непряма
PyPI	winrt-windows-devices-enumeration	`3.2.1`	непряма
PyPI	winrt-windows-devices-radios	`3.2.1`	непряма
PyPI	winrt-windows-foundation	`3.2.1`	непряма
PyPI	winrt-windows-foundation-collections	`3.2.1`	непряма
PyPI	winrt-windows-storage-streams	`3.2.1`	непряма
PyPI	yarl	`1.24.2`	непряма

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

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

Пакет	Версія	Зв'язок	Критичність	Сповіщень	Виправлено в
cryptography	`49.0.0`	пряма	помірна	2	`50.0.0`

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

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

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

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

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

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

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

36.3/60	Зірки — 173 зірок
15.9/25	Форки — 82 форків
4.7/15	Спостерігачі — 8 спостерігачів

forks	82
stars	173
watchers	8
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

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

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

Власність

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

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

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

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

Докладніше

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

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