#fallible #traits #try #try-from #result #tryfrom

no-std try-traits

Alternatives to std lib traits that can fail

2 releases

0.1.1 Aug 18, 2020
0.1.0 Aug 18, 2020

#2487 in Rust patterns

Download history 271/week @ 2023-11-20 271/week @ 2023-11-27 299/week @ 2023-12-04 397/week @ 2023-12-11 440/week @ 2023-12-18 19/week @ 2023-12-25 269/week @ 2024-01-01 353/week @ 2024-01-08 272/week @ 2024-01-15 488/week @ 2024-01-22 641/week @ 2024-01-29 460/week @ 2024-02-05 345/week @ 2024-02-12 156/week @ 2024-02-19 182/week @ 2024-02-26 429/week @ 2024-03-04

1,155 downloads per month

MIT/Apache

25KB
527 lines

Try Traits

Alternatives to std lib traits that can fail.

TODO: an actual readme. lol.


lib.rs:

Fallible versions of the std lib's traits.

For most cases, these traits are probably not what you need, and simply with careful use of generics you can use the builtin variants. And, when you can't, it's preferred to write "try" functions directly, such as File's try_clone method.

Instead, these are meant to be used in APIs that require the ability to abstract over operations that could be fallible.

Why Some Traits Weren't Included

There's a few reasons a core trait might not have been included:

  • They already completely support a form of failibility, and as such it wouldn't make sense to add a try version of them. (examples: FromStr).
  • Traits that it doesn't make much sense for them to be failible, such as core::marker traits like Copy and Send.
  • They simply hadn't been released yet when this was written. If this is the case, file an issue (or submit a pull request!)

No runtime deps

Features