crashbytes-result

A practical Result type for Python — Ok, Err, and pattern matching.

Install

pip install crashbytes-result

Usage

from crashbytes_result import Ok, Err, Result, safe

def divide(a: float, b: float) -> Result[float, str]:
    if b == 0:
        return Err("division by zero")
    return Ok(a / b)

result = divide(10, 3)
match result:
    case Ok(value):
        print(f"Result: {value}")
    case Err(error):
        print(f"Error: {error}")

# Or use .match()
msg = result.match(
    ok=lambda v: f"Got {v:.2f}",
    err=lambda e: f"Failed: {e}",
)

# @safe decorator
@safe
def parse_int(s: str) -> int:
    return int(s)

parse_int("42")   # Ok(42)
parse_int("abc")  # Err(ValueError(...))

API

Method	Ok	Err
`.unwrap()`	Returns value	Raises `UnwrapError`
`.unwrap_or(default)`	Returns value	Returns default
`.unwrap_err()`	Raises `UnwrapError`	Returns error
`.map(fn)`	`Ok(fn(value))`	`self`
`.map_err(fn)`	`self`	`Err(fn(error))`
`.bind(fn)`	`fn(value)`	`self`
`.match(ok, err)`	`ok(value)`	`err(error)`
`.is_ok`	`True`	`False`
`.is_err`	`False`	`True`

License

MIT

Metadata

Release files for crashbytes-result 1.1.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crashbytes-result 1.1.9
File	Size	Uploaded
crashbytes_result-1.1.9.tar.gz	50.5 kB	Oct 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for crashbytes-result 1.1.9
File	Interpreter	ABI	Platform	Reset
crashbytes_result-1.1.9-py3-none-any.whl 4.6 kB Oct 1, 2026	Python 3	none	any	Details

Total release size: 55.1 kB

Release files / crashbytes_result-1.1.9.tar.gz

Download URL	crashbytes_result-1.1.9.tar.gz
Size	50.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`02a28188fb654d56849554477595e00372b38ea242a3d52ac38cd49edec2aab8`
BLAKE2b-256 checksum How to use checksums	`b7159487a38868cd7b2e168c8318ac787ac54e8c85494cdcba2a3cdce070145f`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CrashBytes/crashbytes-result
Publishing commit: github.com/CrashBytes/crashbytes-result/tree/e3ecb365632199ff81ad17c5fe540393dad7e5ae

Workflow

Publishing configuration: github.com/CrashBytes/crashbytes-result/blob/e3ecb365632199ff81ad17c5fe540393dad7e5ae/.github/workflows/publish.yml
Publishing logs: github.com/CrashBytes/crashbytes-result/actions/runs/36870243891/attempts/1

Artifact

Subject: crashbytes_result-1.1.9.tar.gz
SHA-256 checksum: 02a28188fb654d56849554477595e00372b38ea242a3d52ac38cd49edec2aab8 Verifying attestations

Release files / crashbytes_result-1.1.9-py3-none-any.whl

Download URL	crashbytes_result-1.1.9-py3-none-any.whl
Size	4.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`351aa3001fb910c2b8df6049c2d8e400de79da404c994aa37493d00b28bb991d`
BLAKE2b-256 checksum How to use checksums	`acc217ad0a8657419a86173c35ba8a4ac9143c94742228939c3546d9f80bc2ec`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CrashBytes/crashbytes-result
Publishing commit: github.com/CrashBytes/crashbytes-result/tree/e3ecb365632199ff81ad17c5fe540393dad7e5ae

Workflow

Publishing configuration: github.com/CrashBytes/crashbytes-result/blob/e3ecb365632199ff81ad17c5fe540393dad7e5ae/.github/workflows/publish.yml
Publishing logs: github.com/CrashBytes/crashbytes-result/actions/runs/36870243891/attempts/1

Artifact

Subject: crashbytes_result-1.1.9-py3-none-any.whl
SHA-256 checksum: 351aa3001fb910c2b8df6049c2d8e400de79da404c994aa37493d00b28bb991d Verifying attestations