Shared protobuf definitions and Python bindings for Frequenz APIs
frequenz-floss/frequenz-api-common має індекс здоров’я 84 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Vitality (86/100), найнижчий — Community & Adoption (38/100). Останнє оновлення було 4 дні тому. Більшість нещодавньої роботи виконують 2 учасники.
Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).
Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.
Зважений загальний бал 71 калібровано до 84 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).
За цим репозиторієм стоїть організація — спільна, підзвітна опіка, здатна пережити будь-якого окремого мейнтейнера.
| Реєстр | Пакет | Версія | Завантажень / міс | Версії | Остання публікація | Теги |
|---|---|---|---|---|---|---|
| PyPI | frequenz-api-common | 0.8.11 | - | 28 | 4 дні тому | frequenzpythonapigrpcprotobufrpccommon |
Чи живий проєкт — чи пишеться код і чи виходять релізи?
| 36/36 | Свіжість push — останній push 4 дн. тому |
| 19.4/36 | Ритм комітів — 28/52 тижнів із комітами |
| 18/18 | Обсяг комітів — 180 комітів за останній рік |
| 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 | 180 |
| human_commit_share | — |
| days_since_last_push | 4 |
| active_weeks_last_year | 28 |
| 27/27 | Випускає релізи — опубліковано 28 релізів |
| 36/36 | Свіжість релізів — останній реліз 4 дн. тому |
| 27/27 | Ритм релізів — реліз кожні ~40,9 дн. |
| 0/10 | OpenSSF Scorecard: Signed-Releases — Project has not signed or included provenance with any releases. |
| releases_count | 28 |
| latest_release_tag | v0.8.11 |
| releases_from_tags | ні |
| days_since_latest_release | 4 |
| mean_days_between_releases | 40,9 |
Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?
| 0/60 | Зірки — 1 зірок |
| 9.6/25 | Форки — 15 форків |
| 0/15 | Спостерігачі — 2 спостерігачів |
| forks | 15 |
| stars | 1 |
| watchers | 2 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
| 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 | — |
| has_contributing | так |
| has_issue_template | ні |
| has_code_of_conduct | ні |
| readme_badge_services | — |
| has_pull_request_template | ні |
Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?
| 25.2/54 | Бас-фактор — на 2 контриб’ютор(ів) припадає половина всіх комітів |
| 14.8/22.5 | Розподіл комітів — головний контриб’ютор — автор 34% комітів |
| 13.5/13.5 | Широта контриб’юторів — 17 контриб’юторів |
| 10/10 | OpenSSF Scorecard: Contributors — project has 7 contributing companies or organizations |
| bus_factor | 2 |
| contributors_sampled | 17 |
| top_contributor_share | 0,342 |
| 32.6/42 | Вирішення issue — закрито 78% issue |
| 23.8/30 | Прийняття PR — злито 324/408 вирішених PR |
| 0/13 | Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка |
| 10.5/15 | OpenSSF Scorecard: Code-Review — Found 3/4 approved changesets -- score normalized to 7 |
| merged_prs | 324 |
| open_issues | 20 |
| closed_issues | 69 |
| prs_merged_7d | — |
| prs_decided_7d | — |
| prs_merged_30d | — |
| prs_decided_30d | — |
| issue_closed_ratio | 0,775 |
| closed_unmerged_prs | 84 |
| first_time_authors_30d | — |
| first_time_prs_merged_30d | — |
| first_time_prs_decided_30d | — |
| 30/30 | Підтримка власника — у власності організації |
| 0/20 | Верифікований домен — статус підтвердженого домену для цієї організації не зчитано |
| 9.9/25 | Охоплення власника — 23 підписників у frequenz-floss |
| 20.9/25 | Послужний список — 65 публічних репозиторіїв, вік облікового запису ~3 р. |
| followers | 23 |
| owner_type | Organization |
| is_verified | — |
| owner_login | frequenz-floss |
| public_repos | 65 |
| account_age_days | 1 442 |
| 25/25 | Опубліковано й доступно — 1 пакет(ів) у pypi |
| 35/35 | Свіжість публікацій — остання публікація 4 дн. тому |
| 20/20 | Історія версій — 28 опублікованих версій |
| 20/20 | Не застарілий — активний, не deprecated і не yanked |
| packages | frequenz-api-common |
| ecosystems | pypi |
| any_deprecated | ні |
| min_days_since_publish | 4 |
Чи наявні базові інженерні практики та документація?
| 24/24 | Процеси CI — 10 процес(ів) CI |
| 24/24 | Наявні тести |
| 0/16 | Конфігурація лінтера |
| 0/9.6 | Pre-commit-хуки |
| 6.4/6.4 | .editorconfig |
| 20/20 | OpenSSF Scorecard: CI-Tests — 10 out of 10 merged PRs checked by a CI test -- score normalized to 10 |
| has_ci | так |
| has_tests | так |
| has_editorconfig | так |
| has_linter_config | ні |
| has_precommit_config | ні |
| 30/30 | README |
| 25/25 | Каталог документації |
| 15/15 | Сайт документації / домашня сторінка — https://frequenz-floss.github.io/frequenz-api-common/ |
| 10/10 | Опис репозиторію |
| 10/10 | Теми — 7 тем |
| 10/10 | Wiki |
| topics | api, common, frequenz, grpc, protobuf, python, rpc |
| has_wiki | так |
| homepage | https://frequenz-floss.github.io/frequenz-api-common/ |
| docs_site | https://frequenz-floss.github.io/frequenz-api-common/ |
| has_readme | так |
| has_docs_dir | так |
| has_description | так |
Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 3.8/7.5 | Branch-Protection — branch protection is not maximal on development and all release branches |
| 2.5/2.5 | CI-Tests — 10 out of 10 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 |
| 5.2/7.5 | Code-Review — Found 3/4 approved changesets -- score normalized to 7 |
| 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 |
| 5/5 | Pinned-Dependencies — all dependencies are pinned |
| 2/5 | SAST — SAST tool is not run on all commits -- score normalized to 4 |
| 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 |
| 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,5 |
Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.
| 0/45 | Інструкції для агентів — немає CLAUDE.md / AGENTS.md / правил редактора |
| 0/15 | Машиночитана документація (llms.txt) |
| 0/40 | Читабельна історія комітів — немає даних |
| has_llms_txt | ні |
| llms_txt_url | — |
| legible_history_share | — |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
| 18/18 | Розгортання однією командою — noxfile.py |
| 22/22 | Автоматизовані тести |
| 0/11 | Конфігурація лінтера / форматера |
| 11/11 | Статична перевірка типів — py/frequenz/api/common/py.typed |
| 0/10 | Відтворюване середовище |
| 0/10 | Підтверджена практика роботи з агентами — немає даних |
| 5/8 | Автоматизоване супроводження — автоматизацію залежностей налаштовано, але у вибірці комітів її не видно |
| 10/10 | OpenSSF Scorecard: Pinned-Dependencies — all dependencies are pinned |
| has_nix | ні |
| has_tests | так |
| lockfiles | — |
| has_dockerfile | ні |
| typed_language | ні |
| bootstrap_files | noxfile.py |
| has_devcontainer | ні |
| has_linter_config | ні |
| typecheck_configs | py/frequenz/api/common/py.typed |
| agent_commit_share | — |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
| 27/45 | Типізований код — Python з конфігурацією перевірки типів (py/frequenz/api/common/py.typed) |
| 55/55 | Керовані розміри файлів — 0/42 файлів вихідного коду понад 60 КБ |
| primary_language | Python |
| largest_source_bytes | 6 852 |
| source_files_sampled | 42 |
| oversized_source_files | 0 |
| 40/40 | Схема API (OpenAPI/GraphQL/proto) — proto/frequenz/api/common/components.proto, proto/frequenz/api/common/location.proto, proto/frequenz/api/common/metrics.proto, proto/frequenz/api/common/metrics/electrical.proto, proto/frequenz/api/common/v1/grid/delivery_area.proto, proto/frequenz/api/common/v1/grid/delivery_duration.proto, proto/frequenz/api/common/v1/location.proto, proto/frequenz/api/common/v1/market/energy.proto, proto/frequenz/api/common/v1/market/power.proto, proto/frequenz/api/common/v1/market/price.proto, proto/frequenz/api/common/v1/metrics/bounds.proto, proto/frequenz/api/common/v1/metrics/metric_sample.proto, proto/frequenz/api/common/v1/microgrid/components/battery.proto, proto/frequenz/api/common/v1/microgrid/components/components.proto, proto/frequenz/api/common/v1/microgrid/components/ev_charger.proto, proto/frequenz/api/common/v1/microgrid/components/fuse.proto, proto/frequenz/api/common/v1/microgrid/components/grid.proto, proto/frequenz/api/common/v1/microgrid/components/inverter.proto, proto/frequenz/api/common/v1/microgrid/components/transformer.proto, proto/frequenz/api/common/v1/microgrid/lifetime.proto, proto/frequenz/api/common/v1/microgrid/microgrid.proto, proto/frequenz/api/common/v1/microgrid/sensors/sensors.proto, proto/frequenz/api/common/v1/pagination/pagination_info.proto, proto/frequenz/api/common/v1/pagination/pagination_params.proto, proto/frequenz/api/common/v1/types/decimal.proto, proto/frequenz/api/common/v1alpha7/grid/delivery_area.proto, proto/frequenz/api/common/v1alpha7/grid/delivery_duration.proto, proto/frequenz/api/common/v1alpha7/market/energy.proto, proto/frequenz/api/common/v1alpha7/market/power.proto, proto/frequenz/api/common/v1alpha7/market/price.proto, proto/frequenz/api/common/v1alpha7/metrics/bounds.proto, proto/frequenz/api/common/v1alpha7/metrics/metrics.proto, proto/frequenz/api/common/v1alpha7/microgrid/communication_components/communication_components.proto, proto/frequenz/api/common/v1alpha7/microgrid/electrical_components/electrical_components.proto, proto/frequenz/api/common/v1alpha7/microgrid/lifetime.proto, proto/frequenz/api/common/v1alpha7/microgrid/microgrid.proto, proto/frequenz/api/common/v1alpha7/microgrid/sensors/sensors.proto, proto/frequenz/api/common/v1alpha7/pagination/pagination_info.proto, proto/frequenz/api/common/v1alpha7/pagination/pagination_params.proto, proto/frequenz/api/common/v1alpha7/streaming/event.proto, proto/frequenz/api/common/v1alpha7/type/decimal.proto, proto/frequenz/api/common/v1alpha7/type/interval.proto, proto/frequenz/api/common/v1alpha7/type/location.proto, proto/frequenz/api/common/v1alpha8/grid/balancing_group.proto, proto/frequenz/api/common/v1alpha8/grid/delivery_area.proto, proto/frequenz/api/common/v1alpha8/grid/delivery_duration.proto, proto/frequenz/api/common/v1alpha8/grid/flexibility_service.proto, proto/frequenz/api/common/v1alpha8/grid/market_location.proto, proto/frequenz/api/common/v1alpha8/grid/provision_duration.proto, proto/frequenz/api/common/v1alpha8/gridpool/gridpool.proto, proto/frequenz/api/common/v1alpha8/identity/resource_uri.proto, proto/frequenz/api/common/v1alpha8/market/energy.proto, proto/frequenz/api/common/v1alpha8/market/market_area.proto, proto/frequenz/api/common/v1alpha8/market/power.proto, proto/frequenz/api/common/v1alpha8/market/price.proto, proto/frequenz/api/common/v1alpha8/metrics/bounds.proto, proto/frequenz/api/common/v1alpha8/metrics/metrics.proto, proto/frequenz/api/common/v1alpha8/microgrid/communication_components/communication_components.proto, proto/frequenz/api/common/v1alpha8/microgrid/electrical_components/electrical_components.proto, proto/frequenz/api/common/v1alpha8/microgrid/lifetime.proto, proto/frequenz/api/common/v1alpha8/microgrid/microgrid.proto, proto/frequenz/api/common/v1alpha8/microgrid/sensors/sensors.proto, proto/frequenz/api/common/v1alpha8/pagination/pagination_info.proto, proto/frequenz/api/common/v1alpha8/pagination/pagination_params.proto, proto/frequenz/api/common/v1alpha8/streaming/event.proto, proto/frequenz/api/common/v1alpha8/types/decimal.proto, proto/frequenz/api/common/v1alpha8/types/interval.proto, proto/frequenz/api/common/v1alpha8/types/location.proto |
| 0/20 | Сервер MCP — не застосовно до цього типу програмного забезпечення |
| 0/40 | Придатні до запуску приклади |
| example_dirs | — |
| has_mcp_signal | ні |
| api_schema_files | proto/frequenz/api/common/components.proto, proto/frequenz/api/common/location.proto, proto/frequenz/api/common/metrics.proto, proto/frequenz/api/common/metrics/electrical.proto, proto/frequenz/api/common/v1/grid/delivery_area.proto, proto/frequenz/api/common/v1/grid/delivery_duration.proto, proto/frequenz/api/common/v1/location.proto, proto/frequenz/api/common/v1/market/energy.proto, proto/frequenz/api/common/v1/market/power.proto, proto/frequenz/api/common/v1/market/price.proto, proto/frequenz/api/common/v1/metrics/bounds.proto, proto/frequenz/api/common/v1/metrics/metric_sample.proto, proto/frequenz/api/common/v1/microgrid/components/battery.proto, proto/frequenz/api/common/v1/microgrid/components/components.proto, proto/frequenz/api/common/v1/microgrid/components/ev_charger.proto, proto/frequenz/api/common/v1/microgrid/components/fuse.proto, proto/frequenz/api/common/v1/microgrid/components/grid.proto, proto/frequenz/api/common/v1/microgrid/components/inverter.proto, proto/frequenz/api/common/v1/microgrid/components/transformer.proto, proto/frequenz/api/common/v1/microgrid/lifetime.proto, proto/frequenz/api/common/v1/microgrid/microgrid.proto, proto/frequenz/api/common/v1/microgrid/sensors/sensors.proto, proto/frequenz/api/common/v1/pagination/pagination_info.proto, proto/frequenz/api/common/v1/pagination/pagination_params.proto, proto/frequenz/api/common/v1/types/decimal.proto, proto/frequenz/api/common/v1alpha7/grid/delivery_area.proto, proto/frequenz/api/common/v1alpha7/grid/delivery_duration.proto, proto/frequenz/api/common/v1alpha7/market/energy.proto, proto/frequenz/api/common/v1alpha7/market/power.proto, proto/frequenz/api/common/v1alpha7/market/price.proto, proto/frequenz/api/common/v1alpha7/metrics/bounds.proto, proto/frequenz/api/common/v1alpha7/metrics/metrics.proto, proto/frequenz/api/common/v1alpha7/microgrid/communication_components/communication_components.proto, proto/frequenz/api/common/v1alpha7/microgrid/electrical_components/electrical_components.proto, proto/frequenz/api/common/v1alpha7/microgrid/lifetime.proto, proto/frequenz/api/common/v1alpha7/microgrid/microgrid.proto, proto/frequenz/api/common/v1alpha7/microgrid/sensors/sensors.proto, proto/frequenz/api/common/v1alpha7/pagination/pagination_info.proto, proto/frequenz/api/common/v1alpha7/pagination/pagination_params.proto, proto/frequenz/api/common/v1alpha7/streaming/event.proto, proto/frequenz/api/common/v1alpha7/type/decimal.proto, proto/frequenz/api/common/v1alpha7/type/interval.proto, proto/frequenz/api/common/v1alpha7/type/location.proto, proto/frequenz/api/common/v1alpha8/grid/balancing_group.proto, proto/frequenz/api/common/v1alpha8/grid/delivery_area.proto, proto/frequenz/api/common/v1alpha8/grid/delivery_duration.proto, proto/frequenz/api/common/v1alpha8/grid/flexibility_service.proto, proto/frequenz/api/common/v1alpha8/grid/market_location.proto, proto/frequenz/api/common/v1alpha8/grid/provision_duration.proto, proto/frequenz/api/common/v1alpha8/gridpool/gridpool.proto, proto/frequenz/api/common/v1alpha8/identity/resource_uri.proto, proto/frequenz/api/common/v1alpha8/market/energy.proto, proto/frequenz/api/common/v1alpha8/market/market_area.proto, proto/frequenz/api/common/v1alpha8/market/power.proto, proto/frequenz/api/common/v1alpha8/market/price.proto, proto/frequenz/api/common/v1alpha8/metrics/bounds.proto, proto/frequenz/api/common/v1alpha8/metrics/metrics.proto, proto/frequenz/api/common/v1alpha8/microgrid/communication_components/communication_components.proto, proto/frequenz/api/common/v1alpha8/microgrid/electrical_components/electrical_components.proto, proto/frequenz/api/common/v1alpha8/microgrid/lifetime.proto, proto/frequenz/api/common/v1alpha8/microgrid/microgrid.proto, proto/frequenz/api/common/v1alpha8/microgrid/sensors/sensors.proto, proto/frequenz/api/common/v1alpha8/pagination/pagination_info.proto, proto/frequenz/api/common/v1alpha8/pagination/pagination_params.proto, proto/frequenz/api/common/v1alpha8/streaming/event.proto, proto/frequenz/api/common/v1alpha8/types/decimal.proto, proto/frequenz/api/common/v1alpha8/types/interval.proto, proto/frequenz/api/common/v1alpha8/types/location.proto |
| interfaces_expected_of | — |
Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).
| 10 | Binary-Artifacts | no binaries found in the repo |
| 5 | Branch-Protection | branch protection is not maximal on development and all release branches |
| 10 | CI-Tests | 10 out of 10 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 |
| 7 | Code-Review | Found 3/4 approved changesets -- score normalized to 7 |
| 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 |
| 10 | Pinned-Dependencies | all dependencies are pinned |
| 4 | SAST | SAST tool is not run on all commits -- score normalized to 4 |
| 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 |
| 10 | Vulnerabilities | 0 existing vulnerabilities detected |
| Реєстр | Пакет | Обмеження версії | Маніфест |
|---|---|---|---|
| PyPI | protobuf | >= 6.33.6, < 8 | pyproject.toml |
| PyPI | grpcio | >= 1.81.1, < 2 | pyproject.toml |
Повний розв'язаний набір залежностей із графа залежностей GitHub: 2 прямих і 22 непрямих (транзитивних) пакетів. Транзитивне замикання є повним, коли в репозиторії закомічено lockfile.
| Реєстр | Пакет | Версія | Зв'язок |
|---|---|---|---|
| PyPI | grpcio | 1.81.1 | пряма |
| PyPI | protobuf | 6.33.6 | пряма |
| PyPI | black | 26.5.1 | непряма |
| PyPI | flake8 | 7.3.0 | непряма |
| PyPI | flake8-datetimez | 20.10.0 | непряма |
| PyPI | flake8-docstrings | 1.7.0 | непряма |
| PyPI | flake8-pyproject | 1.2.4 | непряма |
| PyPI | frequenz-repo-config | 0.18.0 | непряма |
| PyPI | grpc-stubs | 1.53.0.6 | непряма |
| PyPI | grpcio-tools | 1.81.1 | непряма |
| PyPI | isort | 8.0.1 | непряма |
| PyPI | mike | 1.1.2 | непряма |
| PyPI | mkdocs-gen-files | 0.6.1 | непряма |
| PyPI | mkdocs-literate-nav | 0.6.3 | непряма |
| PyPI | mkdocs-material | 9.7.6 | непряма |
| PyPI | mkdocstrings | 1.0.4 | непряма |
| PyPI | mypy | 2.1.0 | непряма |
| PyPI | nox | 2026.4.10 | непряма |
| PyPI | pydoclint | 0.9.0 | непряма |
| PyPI | pydocstyle | 6.3.0 | непряма |
| PyPI | pylint | 4.0.6 | непряма |
| PyPI | pytest | 9.1.1 | непряма |
| PyPI | setuptools | 82.0.1 | непряма |
| PyPI | setuptools-scm | 10.2.0 | непряма |
Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.
Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.
Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.12.0 — повна методологія · вікі метрик.
Як окремий результат виглядає на тлі всього реєстру: сукупна статистика — PyPI.