Ergonomic exception handling for Python.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for carderne from gravatar.com carderne

Unverified details

These details have not been verified by PyPI
Meta
  • Author: Chris Arderne
  • Tags errors , exceptions
  • Requires: Python >=3.14
Classifiers
Report project as malware

Project description

trye

Ergonomic exception handling for Python.

Inspired by the ECMAScript Try Operator proposal. Instead of try/except blocks, wrap any callable in trye() and get back a typed Result — either Ok(val) or Err(err).

Requires Python 3.14+ (uses generic syntax and type aliases).

Install

uv add trye

Usage

from trye import trye, atrye, is_ok, is_err, Ok, Err

Wrapping a function call

Pass the function and its arguments directly:

result = trye(json.loads, '{"foo": "bar"}')

Or use a lambda for more complex expressions:

result = trye(lambda: db.query("SELECT * FROM users"))

For async functions, use atrye:

result = await atrye(fetch_user, user_id)

Checking and narrowing

is_ok() and is_err() check the result and narrow the type for your type checker:

result = trye(json.loads, '{"foo": "bar"}')
if is_ok(result):
    print(result.val)    # dict
else:
    print(result.err)    # Exception

result = trye(some_function, arg1, arg2)
if is_err(result):
    log_error(result.err)
    return
# result is narrowed to Ok here
use_value(result.val)

unwrap

If you just want the value or to re-raise the exception:

value = trye(json.loads, data).unwrap()

unwrap() returns the value from Ok, or raises the exception from Err.

match/case

result = trye(int, user_input)
match result:
    case Ok(val=v):
        print(f"parsed: {v}")
    case Err(err=e):
        print(f"failed: {e}")

Sentinel fields

Both Ok and Err have sentinel fields so you can always safely check either side:

result = trye(some_function, arg)
if result.err is not None:
    handle_error(result.err)
if result.val is not None:
    use_value(result.val)

Creating results manually

You can create Ok and Err objects directly:

from trye import Ok, Err

success = Ok(42)
failure = Err(ValueError("something went wrong"))

This is useful for bridging non-trye code, writing tests, or returning results from your own functions:

def parse_config(path: str) -> Result[Config]:
    if not path.endswith(".toml"):
        return Err(ValueError(f"unsupported format: {path}"))
    return Ok(load_toml(path))

API

Name Description
trye(f, *args, **kwargs) Call f with args, return Ok(result) or Err(exception)
atrye(f, *args, **kwargs) Async version — await f, return Ok(result) or Err(exception)
is_ok(result) TypeIs narrowing to Ok[T]
is_err(result) TypeIs narrowing to Err
Ok[T] Success wrapper. .val: T, .err: None, .unwrap() -> T
Err Error wrapper. .err: Exception, .val: None, .unwrap() -> Never
Result[T] Type alias for Ok[T] | Err

Arguments are fully typed via ParamSpec, so type checkers will catch incorrect arguments to the wrapped function.

Development

Install uv, then:

uv sync

This project uses poethepoet for tasks:

uv run poe fmt       # format
uv run poe lint      # lint
uv run poe check     # type check (basedpyright + ty)
uv run poe test      # test

uv run poe all       # all of the above

License

MIT

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for carderne from gravatar.com carderne

Unverified details

These details have not been verified by PyPI
Meta
  • Author: Chris Arderne
  • Tags errors , exceptions
  • Requires: Python >=3.14
Classifiers

Release history Release notifications | RSS feed

This version

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trye-0.1.5.tar.gz (19.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

trye-0.1.5-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

File details

Details for the file trye-0.1.5.tar.gz.

File metadata

  • Download URL: trye-0.1.5.tar.gz
  • Upload date:
  • Size: 19.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for trye-0.1.5.tar.gz
Algorithm Hash digest
SHA256 a22e67904c85b214b0ba39d050fe56445d061a02288db05d1062ea9a063854f6
MD5 d6474dbc81bb0ec2f6fbc211e437d0bf
BLAKE2b-256 03961665302c21cc7d2b92ccc183fd467ef562f44c03f8ad28be22705a82c1de

See more details on using hashes here.

Provenance

The following attestation bundles were made for trye-0.1.5.tar.gz:

Publisher: release.yml on carderne/trye

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file trye-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: trye-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 4.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for trye-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 4c86b1eda45477f2f5c01d1af2c595dbff287df686c6adade80754f81dd068bc
MD5 05a0240658b6aebdbfb734c4c317dda2
BLAKE2b-256 57c52a62c3f9748d1a3cf0ab22a6a555822571a23e2ad2ddfdb95b5d64fc9b75

See more details on using hashes here.

Provenance

The following attestation bundles were made for trye-0.1.5-py3-none-any.whl:

Publisher: release.yml on carderne/trye

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page