No known security advisories.
The current version has no OSV.dev malware reports and no critical or high-severity vulnerabilities.
returns has 1.1M monthly downloads and 4K GitHub stars. Version 0.28.0 supports Python <4.0,>=3.11, first published in 2019.
It is actively maintained under a permissive license, last released in Jun 2026.
It is built on top of typing-extensions. It is used by 137 tracked packages, including inspect-tool-support, boring-semantic-layer and parsita.
GitHub topics include functional-programming, fp and type-safety.
Package Insights
Score breakdown - each component scores 0-100, weighted by percentage
Maintenance
100
Popularity
72
Adoption
70
Community
60
Provenance
0
How the maintenance status was determined
Last commit
3 days ago
Monthly downloads
1,138,907
•
Active
Activity within 30 days
Stable
Activity within 31-180 days
Minimal
Activity within 181-365 days, or no activity data
At Risk
No activity for > 365 days, but > 10,000 monthly downloads
Archived
Repository flagged as archived on GitHub
How the popularity category was determined
Monthly downloads
1,138,907
Stars
4,321
Stars per 1k downloads
3.79
Industry Standard
> 10,000,000 monthly downloads
Hidden Gem
< 0.5 stars per 1k downloads and > 100,000 monthly downloads
Community Favorite
> 5 stars per 1k downloads
•
Rising Star
Balanced ratio of stars to downloads
Unknown
Fewer than 1,000 monthly downloads, or no star data
How download momentum is calculated
Week daily avg
37,925
Month daily avg
37,964
Momentum
-0.1%
((week_daily_avg - month_daily_avg) / month_daily_avg) * 100Python version support tiers
requires_python
<4.0,>=3.11
Cutting Edge
Minimum supported version is 3.12 or newer
•
Modern
Minimum supported version is 3.9, 3.10, or 3.11
Legacy
Supports 3.8 or older (or Python 2)
Unknown
No requires_python specified or unparseable
License categories
License
BSD-3-Clause
•
Permissive
MIT, Apache, BSD, ISC, Unlicense, CC0, etc.
Copyleft
GPL, LGPL, AGPL, MPL, EPL, etc.
Proprietary
Commercial, all rights reserved, custom EULAs
Unknown
No license specified, or none of the above match
How the release cadence was determined
Last release
32 days ago
Total releases
29
Releases/year
3.9
Rapid
Last release within 365 days and > 12 releases/year
•
Regular
Last release within 365 days
Slow
Last release 366-730 days ago
Stalled
Last release > 730 days ago, or no releases
Unknown
No usable release date available
How contributor risk was determined
Contributors
63
Monthly downloads
1,138,907
High Load
≤ 2 contributors and ≥ 50,000 monthly downloads
Moderate Load
< 10 contributors and ≥ 500,000 monthly downloads
Low Load
< 25 contributors and ≥ 5,000,000 monthly downloads, or sole maintainer with ≥ 10,000 monthly downloads
•
Balanced
Enough contributors for the package's popularity
Unknown
No contributor data available
Engagement
54
Issue Burden
15.7
per 1k stars
Discussions
0.0
per 1k stars
Fork Ratio
43.2%
contrib / forks
Stale Release
No
PR Velocity
Quiet
Weekly Downloads
GitHub Stars
Not all downloads include detailed metadata. Breakdowns reflect the subset that does.
Downloads by OS
Linux
13.1K
Windows
46
macOS
29
Python Versions
3.11
45.7%
5.4K
3.12
19.5%
2.3K
3.14
15.6%
1.8K
3.13
10.7%
1.3K
3.10
8.5%
998
Top Countries
1.
US
8.2K
US
2.
DE
1.8K
DE
3.
KR
1.6K
KR
4.
IE
599
IE
5.
NO
212
NO
6.
SG
149
SG
7.
CN
118
CN
8.
UA
79
UA
9.
RU
56
RU
10.
AU
50
AU
Dependencies
1
- typing-extensions <5.0,>=4.0
3 optional dependencies
- hypothesis[check-laws]
- mypy[compatible-mypy]
- pytest[check-laws]
Used By
137
- inspect-tool-support
- boring-semantic-layer
- parsita
- yutto
- serialite
- thds-attrs-utils
- nsidc-metgenc
- ambientika-py
- open-gopro
- isla-solver
- walrasquant
- fyuneru
- invar-tools
- dinohub-seedwork-be
- pixi-kernel
- abuse-whois
- fx-bin
- derive-client
- stapi-fastapi
- pinjected
- tanimachi
- larva
- nwp-consumer
- azuma
- my-cli-utilities
- algobase
- masthay-helpers
- bitvavo-api-upgraded
- dqlib
- volttron-core
- orinoco
- walrasquant-lib
- pyvectorial-au
- islandofmisfittoys
- pyrovelocity
- qa-pytest-webdriver
- minigun-soren-n
- pinject-design
- qa-pytest-commons
- featuremesh
- gamesparser
- bittrade-cryptodotcom-websocket
- async-task-pipeline
- closive
- volcano-base
- qa-testing-utils
- qa-pytest-rest
- luna-bench
- netunicorn-base
- lattice-memory
GitHub Topics
Tags from the package's GitHub repository describing what it does.
Package Information
License
BSD-3-Clause
First Release
January 30, 2019
Last Release
1 month ago
Last Commit
4 days ago
Latest Version
0.28.0
Total Releases
29
Contributors
63
Open PRs
15
Archived
No
Author
sobolevn
Python Versions
3
3.11
3.12
3.13
3.14
Wheels
py3
Keywords
Tracking Since
January 6, 2026
Data Updated
July 5, 2026
Data Freshness
Fresh