Публічний реєстр
Звіт про здоров'я програмного забезпеченнясхема 0.31.0 · метрики 2.10.0 · 2026-08-12 23:34 UTC

dry-python / returns

Make your functions return something meaningful, typed, and safe!

PythonBSD-2-Clause★ 4 345 зірок⑂ 154 форкиз січ. 2019 р.Переглянути на GitHub ↗
ТипПлагінБібліотекаяк це визначено
#python#python3#functional-programming#fp#type-safety#mypy#railway-oriented-programming#dry-python#mypy-plugins#mypy-stubs#hacktoberfest

dry-python/returns має індекс здоров’я 96 зі 100, що відповідає смузі «Винятковий». Найвищий показник — Engineering Quality (100/100), найнижчий — AI Readiness (53/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

96
загалом / 100
Винятковий

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

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

96
Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям
Відмінний80-92Сильний за всіма напрямами; незначні прогалини
Добрий65-79Здоровий; прогалини обмежені та керовані
Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку
Слабкий35-49Суттєві недоліки в кількох сферах
У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності
Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)
ЖиттєздатністьСпільнота тавпровадженняСталість таврядуванняІнженернаякістьБезпекаГотовність доШІ

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

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

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

Власність

dry-pythonОрганізація
367 підписників10 публічних репозиторіївз квіт. 2018 р.

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

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

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
PyPIreturns0.29.0-3010 днів томуfunctional-programmingfpmonadsmonadmonad-transformerscompositiontype-safetymypyrailway-oriented-programming

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

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

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

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

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

99Винятковий
Як обчислюється оцінка
36/36Свіжість push — останній push 0 дн. тому
35.3/36Ритм комітів — 51/52 тижнів із комітами
18/18Обсяг комітів — 193 комітів за останній рік
10/10OpenSSF Scorecard: Maintained — 30 commit(s) and 6 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year193
human_commit_share0,08
days_since_last_push0
active_weeks_last_year51

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

84Відмінний
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 32 релізів
36/36Свіжість релізів — останній реліз 10 дн. тому
12.6/27Ритм релізів — реліз кожні ~126,2 дн.
0/10OpenSSF Scorecard: Signed-Releases — немає даних
Використані вхідні дані
releases_count32
latest_release_tag0.29.0
releases_from_tagsні
days_since_latest_release10
mean_days_between_releases126,2
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

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

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

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

Популярність і впровадження

86Відмінний
Як обчислюється оцінка
59/60Зірки — 4 345 зірок
18.2/25Форки — 154 форків
8.9/15Спостерігачі — 41 спостерігачів
Використані вхідні дані
forks154
stars4 345
watchers41
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

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

92Відмінний
Як обчислюється оцінка
22.5/22.5README
22.5/22.5Ліцензія — визнана ліцензія (BSD-2-Clause)
18/18Настанови CONTRIBUTING
13.5/13.5Кодекс поведінки
0/7.2Шаблон issue
6.3/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges8
has_contributingтак
has_issue_templateні
has_code_of_conductтак
readme_badge_servicescodecov.io, github.com, readthedocs.org, shields.io
has_pull_request_templateтак

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

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

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

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

36Слабкий
Як обчислюється оцінка
9/54Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
3.9/22.5Розподіл комітів — головний контриб’ютор — автор 83% комітів
13.5/13.5Широта контриб’юторів — 61 контриб’юторів
10/10OpenSSF Scorecard: Contributors — project has 37 contributing companies or organizations
Використані вхідні дані
bus_factor1
contributors_sampled61
top_contributor_share0,826

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

82Відмінний
Як обчислюється оцінка
35.6/42Вирішення issue — закрито 85% issue
24.9/30Прийняття PR — злито 1 684/2 028 вирішених PR
13/13Newcomer PR acceptance — злито 3/3 PR від новачків за 30 дн.
9/15OpenSSF Scorecard: Code-Review — Found 3/5 approved changesets -- score normalized to 6
Використані вхідні дані
merged_prs1 684
open_issues67
closed_issues372
prs_merged_7d0
prs_decided_7d0
prs_merged_30d4
prs_decided_30d4
issue_closed_ratio0,847
closed_unmerged_prs344
first_time_authors_30d3
first_time_prs_merged_30d3
first_time_prs_decided_30d3

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

85Відмінний
Як обчислюється оцінка
30/30Підтримка власника — у власності організації
0/20Верифікований домен — статус підтвердженого домену для цієї організації не зчитано
18.4/25Охоплення власника — 367 підписників у dry-python
19.6/25Послужний список — 10 публічних репозиторіїв, вік облікового запису ~8 р.
Використані вхідні дані
followers367
owner_typeOrganization
is_verified—
owner_logindry-python
public_repos10
account_age_days3 054
Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

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

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно — 1 пакет(ів) у pypi
35/35Свіжість публікацій — остання публікація 10 дн. тому
20/20Історія версій — 30 опублікованих версій
20/20Не застарілий — активний, не deprecated і не yanked
Використані вхідні дані
packagesreturns
ecosystemspypi
any_deprecatedні
min_days_since_publish10

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

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

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

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

100Винятковий
Як обчислюється оцінка
24/24Процеси CI — 2 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера
9.6/9.6Pre-commit-хуки
6.4/6.4.editorconfig
20/20OpenSSF Scorecard: CI-Tests — 29 out of 29 merged PRs checked by a CI test -- score normalized to 10
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigтак
has_linter_configтак
has_precommit_configтак

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

100Винятковий
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінка — https://returns.rtfd.io
10/10Опис репозиторію
10/10Теми — 11 тем
10/10Wiki
Використані вхідні дані
topicspython, python3, functional-programming, fp, type-safety, mypy, railway-oriented-programming, dry-python, mypy-plugins, mypy-stubs, hacktoberfest
has_wikiтак
homepagehttps://returns.rtfd.io
docs_sitehttps://returns.rtfd.io
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

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

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

Стан безпеки

64Помірний
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — branch protection not enabled on development/release branches
2.5/2.5CI-Tests — 29 out of 29 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
4.5/7.5Code-Review — Found 3/5 approved changesets -- score normalized to 6
2.5/2.5Contributors — project has 37 contributing companies or organizations
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5Ліцензія — license file detected
7.5/7.5Maintained — 30 commit(s) and 6 issue activity found in the last 90 days -- score normalized to 10
0/5Packaging — немає даних
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — немає даних
7.5/7.5Token-Permissions — GitHub workflow tokens follow principle of least privilege
7.5/7.5Vulnerabilities — 0 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate6,4
Виключено з оцінювання (немає даних або не застосовно): Packaging, Signed-Releases. Залишкові ваги перенормовано.

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

100Винятковий
Як обчислюється оцінка
35/35Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
25/25Непрямі залежності без відомих сповіщень — жодна непряма залежність не має відомих сповіщень
0/40Немає задавнених сповіщень — жодне сповіщення не має дати публікації
Використані вхідні дані
sourceosv
advisories0
affected_packages0
assessed_packages1
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
Виключено з оцінювання (немає даних або не застосовно): Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено з runtime-замиканням залежностей pypi:returns@0.29.0 — тим, що тягне за собою встановлення опублікованого пакета, — 1 пакетів. Досяжність не аналізується.

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

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

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

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

1Критичний
Як обчислюється оцінка
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—
Виключено з оцінювання (немає даних або не застосовно): Читабельна історія комітів. Залишкові ваги перенормовано.

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

82Відмінний
Як обчислюється оцінка
18/18Розгортання однією командою — docs/Makefile
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера
11/11Статична перевірка типів — returns/py.typed
10/10Відтворюване середовище — lockfile
2/10Підтверджена практика роботи з агентами — 1 з останніх 100 комітів створено агентом або з його зазначенням
8/8Автоматизоване супроводження — 78 з останніх 100 комітів — автоматичні оновлення залежностей
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Використані вхідні дані
has_nixні
has_testsтак
lockfilespoetry.lock
has_dockerfileні
typed_languageні
bootstrap_filesdocs/Makefile
has_devcontainerні
has_linter_configтак
typecheck_configsreturns/py.typed
agent_commit_share0,01
toolchain_manifests—
dependency_bot_commit_share0,78

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

82Відмінний
Як обчислюється оцінка
27/45Типізований код — Python з конфігурацією перевірки типів (returns/py.typed)
55/55Керовані розміри файлів — 0/201 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes48 479
source_files_sampled201
oversized_source_files0

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

4 345зірок GitHub
61контриб'юторів
193комітів за останні 12 місяців
0днів від останнього пушу
32релізів
1бас-фактор
67відкритих issue
PyPIпакетних екосистем

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

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

Докладніше

Історія зірок і форків 0 ★ / 154 ⇿
0Зірки
154Форки
26Релізи

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

0408012016015492019-032022-112026-08
Мажорні 0Мінорні 25Патчі 1

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

OpenSSF Scorecard 6.4 / 10
6.4сукупно

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

10Binary-Artifactsno binaries found in the repo
0Branch-Protectionbranch protection not enabled on development/release branches
10CI-Tests29 out of 29 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
6Code-ReviewFound 3/5 approved changesets -- score normalized to 6
10Contributorsproject has 37 contributing companies or organizations
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 6 issue activity found in the last 90 days -- score normalized to 10
н/дPackagingpackaging workflow not detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
н/дSigned-Releasesno releases found
10Token-PermissionsGitHub workflow tokens follow principle of least privilege
10Vulnerabilities0 existing vulnerabilities detected
Прямі залежності 4
РеєстрПакетОбмеження версіїМаніфест
PyPItyping-extensions>=4.0,<5.0pyproject.toml
PyPIpytest>=8,<10pyproject.toml
PyPIhypothesis^6.151pyproject.toml
PyPImypy>=1.19,<2.4pyproject.toml
Усі залежності 79

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

РеєстрПакетВерсіяЗв'язок
PyPIhypothesis6.165.1пряма
PyPImypy2.3.0пряма
PyPIpytest9.1.1пряма
PyPItyping-extensions4.16.0пряма
PyPIaccessible-pygments0.0.5непряма
PyPIalabaster1.0.0непряма
PyPIanyio4.14.2непряма
PyPIast-serialize0.6.0непряма
PyPIattrs26.1.0непряма
PyPIbabel2.18.0непряма
PyPIbeautifulsoup44.15.0непряма
PyPIcertifi2026.7.22непряма
PyPIcffi2.1.0непряма
PyPIcharset-normalizer3.4.9непряма
PyPIcolorama0.4.6непряма
PyPIcovdefaults2.3.0непряма
PyPIcoverage7.15.2непряма
PyPIdecorator5.3.1непряма
PyPIdocutils0.22.4непряма
PyPIflake87.3.0непряма
PyPIfuro2025.12.19непряма
PyPIh110.16.0непряма
PyPIhttpcore1.0.9непряма
PyPIhttpx0.28.1непряма
PyPIidna3.18непряма
PyPIimagesize1.5.0непряма
PyPIiniconfig2.3.0непряма
PyPIjinja23.1.6непряма
PyPIjsonschema4.26.0непряма
PyPIjsonschema-specifications2025.9.1непряма
PyPIlibrt0.13.0непряма
PyPImarkdown-it-py4.2.0непряма
PyPImarkupsafe3.0.3непряма
PyPImccabe0.7.0непряма
PyPImdit-py-plugins0.6.1непряма
PyPImdurl0.1.2непряма
PyPImypy-extensions1.1.0непряма
PyPImyst-parser5.1.0непряма
PyPIoutcome1.3.0.post0непряма
PyPIpackaging26.2непряма
PyPIpathspec1.1.1непряма
PyPIpluggy1.6.0непряма
PyPIpycodestyle2.14.0непряма
PyPIpycparser3.0непряма
PyPIpyflakes3.4.0непряма
PyPIpygments2.20.0непряма
PyPIpytest-codspeed5.0.3непряма
PyPIpytest-cov7.1.0непряма
PyPIpytest-mypy-plugins4.0.3непряма
PyPIpytest-randomly4.1.0непряма
PyPIpytest-shard0.1.2непряма
PyPIpytest-subtests0.15.0непряма
PyPIpyyaml6.0.3непряма
PyPIreferencing0.37.0непряма
PyPIregex2026.7.19непряма
PyPIrequests2.34.2непряма
PyPIrich15.0.0непряма
PyPIroman-numerals4.1.0непряма
PyPIrpds-py2026.6.3непряма
PyPIruff0.16.1непряма
PyPIslotscheck0.20.1непряма
PyPIsniffio1.3.1непряма
PyPIsnowballstemmer3.1.1непряма
PyPIsortedcontainers2.4.0непряма
PyPIsoupsieve2.9.1непряма
PyPIsphinx9.0.4непряма
PyPIsphinx-autodoc-typehints3.6.1непряма
PyPIsphinx-basic-ng1.0.0b2непряма
PyPIsphinxcontrib-applehelp2.0.0непряма
PyPIsphinxcontrib-devhelp2.0.0непряма
PyPIsphinxcontrib-htmlhelp2.1.0непряма
PyPIsphinxcontrib-jsmath1.0.1непряма
PyPIsphinxcontrib-mermaid2.1.0непряма
PyPIsphinxcontrib-qthelp2.0.0непряма
PyPIsphinxcontrib-serializinghtml2.0.0непряма
PyPItomlkit0.15.1непряма
PyPItrio0.33.0непряма
PyPIurllib32.7.0непряма
PyPIwemake-python-styleguide1.7.1непряма
Сповіщення про залежності 0

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

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

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

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

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

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

Повідомлення збережеться під час входу.

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

Перевірені репозиторії, що мають спільні каталожні теги або екосистеми з dry-python/returns. Читати поруч →

98bloomberg/memrayMemray is a memory profiler for PythonВинятковий98strawberry-graphql/strawberryA GraphQL library for Python that leverages type annotations 🍓Винятковий100psf/blackThe uncompromising Python code formatterВинятковий99prowler-cloud/prowlerProwler is the world’s most widely used open-source cloud security platform that automates security and compliance across any cloud environment.Винятковий99astral-sh/ruffAn extremely fast Python linter and code formatter, written in Rust.Винятковий99pyvista/pyvista3D visualization and mesh analysis for science and engineeringВинятковий

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

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

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