aliri_braid

Crates.ioaliri_braid
lib.rsaliri_braid
version0.4.0
sourcesrc
created_at2021-05-11 16:13:05.516043
updated_at2023-05-26 21:10:55.353838
descriptionImprove and strengthen your strings by making them strongly-typed with less boilerplate
homepage
repositoryhttps://github.com/neoeinstein/aliri_braid
max_upload_size
id396123
size99,960
Marcus Griep (neoeinstein)

documentation

README

aliri_braid

Build Status

Improve and strengthen your strings

Strongly-typed APIs reduce errors and confusion over passing around un-typed strings. Braid helps in that endeavor by making it painless to create wrappers around your string values, ensuring that you use them in the right way every time.

Examples of the documentation and implementations provided for braids are available below and in the aliri_braid_examples crate documentation.

Usage

A braid is created by attaching #[braid] to a struct definition. The macro will take care of automatically updating the representation of the struct to wrap a string and generate the borrowed form of the strong type.

use aliri_braid::braid;

#[braid]
pub struct DatabaseName;

Braids of custom string types are also supported, so long as they implement a set of expected traits. If not specified, the type named String in the current namespace will be used.

use aliri_braid::braid;
use compact_str::CompactString as String;

#[braid]
pub struct UserId;

Once created, braids can be passed around as strongly-typed, immutable strings.

fn take_strong_string(n: DatabaseName) {}
fn borrow_strong_string(n: &DatabaseNameRef) {}

let owned = DatabaseName::new(String::from("mongo"));
borrow_strong_string(&owned);
take_strong_string(owned);

A braid can also be untyped for use in stringly-typed interfaces.

fn take_raw_string(s: String) {}
fn borrow_raw_str(s: &str) {}

let owned = DatabaseName::new(String::from("mongo"));
borrow_raw_str(owned.as_str());
take_raw_string(owned.take());

For more information, see the documentation on docs.rs.

Commit count: 101

cargo fmt