Additional features for the Rust standard library.
This crate contains enhancements to the Rust standard library structures, useful for
broad audience, but not yet implemented (or stabilized) in std
.
Crate is designed to be lightweight (no external dependencies!) and provide essential
functionality which possible can get to the std
some day.
-
Convenient builder methods for
Duration
:use std::time::Duration; use stdext::prelude::*; let duration = Duration::from_minutes(1).add_secs(5).add_micros(100); assert_eq!(duration, Duration::new(65, 100_000));
-
Panicking version for
RwLock::read
,RwLock::write
andMutex::lock
(for fellows who don't really handle the lock poisoning):use std::sync::{Arc, RwLock}; use stdext::prelude::*; let lock = Arc::new(RwLock::new(1)); { let mut n = lock.force_write(); // Instead of `.write().unwrap()`. *n = 2; } let n = lock.force_read(); assert_eq!(*n, 2);
-
Result::combine
andOption::combine
to zip pairs of objects:use stdext::prelude::*; let x = Some(1); let y = Some("hi"); let z = None::<u8>; assert_eq!(x.combine(y), Some((1, "hi"))); assert_eq!(x.combine(z), None); let x = Ok(1); let y = Ok("hi"); let z: Result<i32, &str> = Err("error"); let z2: Result<i32, &str> = Err("other_error"); assert_eq!(x.combine(y), Ok((1, "hi"))); assert_eq!(x.combine(z), Err("error")); assert_eq!(z.combine(z2), Err("error"));
-
New handy macros (mostly for development purposes):
use stdext::{compile_warning, function_name}; fn sample_function() { println!("This function is called {}", function_name!()); compile_warning!("This function must do something else..."); }
...and other features. For a full list, check out the crate documentation.
Standard library is great, and it becomes even better through time. However, a time gap between proposing a new feature and getting it stabilized is way too big.
This crate, however, can be updated quickly and the feature will be usable on the stable Rust soon after implementation.
If you want to contribute to this project, please read the contributing guide.
stdext
library is licensed under the MIT License. See LICENSE for details.