dry-python/returns
Make your functions return something meaningful, typed, and safe! observed · 2026-08-28
Health v2 · maintenance only
90/100
- Activity 99
- Release rhythm 72
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-02. Adoption (stars, forks) is never an input.
- gap_med: 109
- age_days: 2776
- days_rel: 31
- days_push: 8
- n_releases_24m: 6
Adoption not part of the score
4355 stars · 155 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded
A Python library providing typed functional programming primitives like Result, Maybe, and IO containers with full mypy support and a custom mypy plugin. It enables railway-oriented programming and safe, declarative error handling in Python.
Use cases
- handle errors without exceptions using Result types
- make mypy enforce null-safety with Maybe
- write declarative business logic pipelines in Python
- compose async and sync functions safely
- add functional programming patterns to a Python codebase
When to choose
- you want type-safe error handling instead of exceptions
- your team uses mypy and wants stronger type guarantees
- you prefer functional composition and railway-oriented design
When to avoid
- your codebase is plain Python without static type checking
- the team is unfamiliar with functional programming concepts
- you need minimal dependencies and simple imperative style
Facets
library · maturity active
type-system error-handling serialization programming-languages developer-tools python cross-platform functional-programming monads mypy-plugin railway-oriented-programming result-types higher-kinded-types algorithms
2 sources
- readme: https://github.com/dry-python/returns · fetched 2026-08-28 · 61317e8dfff6
- registry_pypi: https://pypi.org/pypi/returns/json · fetched 2026-08-29 · 376d210d4e4d
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| dry-python/returns | main | 90 |
For agents
markdown · JSON · MCP: product_card(name="dry-python/returns")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem