3 unstable releases
|0.2.0||Oct 25, 2019|
|0.1.1||Oct 22, 2019|
|0.1.0||Sep 25, 2019|
#2603 in Rust patterns
108 downloads per month
Helper macros to implement std traits for custom validated slice types in Rust.
These examples defines custom string types and implement basic std traits for them by this crate.
To define opaque type aliases for data with specific characteristics, you may want to define custom slice types and vector types. For example:
- String with only ASCII characters.
- String which is a valid URI.
- Escaped HTML and unescaped HTML.
- String with case-insensitive comparison by
- Non-empty array.
- Sorted array.
However, primitive types
str have many trait impls, and custom array types might be non-user-friendly without such trait impls.
(For example, if you want ASCII string
&AsciiStr, you may also want
Default for &AsciiStr,
std::convert::TryFrom<&str> for &AsciiStr,
PartialEq<str> for &AsciiStr,
PartialOrd<AsciiStr> for Cow<'_, AsciiStr>,
std::fmt::Display for AsciiStr`, etc.)
validated-slice helps users to automatically implement these traits common for array and string with less boilerplates.
This crate is at an early stage, and experimental. Breaking changes would be introduced for syntax and features.
This crate follows semver, so you can check crate version to know breaking change.
- nostd support
- See docs of the macros for detail.
For desired features without detailed ideas, see TODO.md.
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE.txt or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT.txt or https://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.