https://github.com/dpc/convi
Convi - convenient (but safe) conversion (From-like) traits for Rust
https://github.com/dpc/convi
Last synced: 8 months ago
JSON representation
Convi - convenient (but safe) conversion (From-like) traits for Rust
- Host: GitHub
- URL: https://github.com/dpc/convi
- Owner: dpc
- License: mpl-2.0
- Created: 2022-07-31T02:59:00.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-12-28T04:21:06.000Z (over 1 year ago)
- Last Synced: 2025-09-22T08:58:31.508Z (8 months ago)
- Language: Rust
- Homepage:
- Size: 38.1 KB
- Stars: 5
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Convi - convenient (but safe) conversion (`From`-like) traits for Rust
Tired of the pain of casting `usize` and other types in Rust safely? This crate is here to help.
By enabling cargo features on this crate like this:
```norust
convi = { version = "*", features = [ "min_target_pointer_width_32" ] }
```
you can mark your code as not compatible with architectures with
pointer size less than 32 bits. This will enable additional infallible `usize`
conversions like:
```rust,ignore
use convi::CastFrom;
fn main() {
let some_u32 = 3u32;
println!("{}", usize::cast_from(some_u32));
}
```
and display appropriate error message if anyone
tries to build your code for unsupported architecture.
In addition, for times where you know that your value
will always be smaller than the given type, instead of
`u32::try_from(some_usize).expect("must not fail")`,
you can:
```rust
use convi::ExpectFrom;
fn main() {
let some_u32 = 3u32;
println!("{}", usize::expect_from(some_u32));
}
```
Zero dependencies, small code, [review it yourself](https://github.com/dpc/convi/blob/master/src/lib.rs).