Crate kai

Description

This library contains my personal Rust prelude and utilities.

Design goals

• Remove the hassle of having to add use statements for very common standard library types
• Reduce the amount of code that actually has to be written
• Alleviate common Rust pain points

This library is meant to improve your experience writing Rust no matter what you are writing code for. The patterns it tackles are mostly ones that the average Rust programmer encounters on a daily basis.

Utilities

I have made some very simple utilities to aid in writing Rust code:

Functions

• order Functions for fully ordering PartialOrd types
• close Functions for checking if two floating-point numbers are close enough to be considered equal
• promote_then Temporarily gain access an immutable reference as mutable

Traits

• BoolMap Maps bools to Options in one line

Structs

• Adapter Wraps a reference to a string representation of some type
• Swap Wrapper that allows consuming transformations on borrowed data

Macros

• variant! Maps an enum to an option for use with Iterator::filter_map
• transparent_mod! Declares transparent external child modules

Modules

close	Functions for checking if two floating-point numbers are close enough to be considered equal
fs	Filesystem manipulation operations.
iter	Composable external iteration.
order	Functions for fully ordering PartialOrd types
thread	Native threads.

Macros

transparent_mod	Declares transparent external child modules
variant	Maps an enum to an option for use with Iterator::filter_map

Structs

Adapter	Wraps a reference to a string representation of some type
Arc	A thread-safe reference-counting pointer. 'Arc' stands for 'Atomically Reference Counted'.
File	A reference to an open file on the filesystem.
Formatter	Configuration for formatting.
HashMap	A hash map implemented with linear probing and Robin Hood bucket stealing.
HashSet	A hash set implemented as a HashMap where the value is ().
IntoIter	An iterator that moves out of a vector.
JoinHandle	An owned permission to join on a thread (block on its termination).
Mutex	A mutual exclusion primitive useful for protecting shared data
Path	A slice of a path (akin to str).
PathBuf	An owned, mutable path (akin to String).
Rc	A single-threaded reference-counting pointer. 'Rc' stands for 'Reference Counted'.
Swap	Wrapper that allows consuming transformations on borrowed data

Enums

Ordering

An Ordering is the result of a comparison between two values.

Constants

PI32	Archimedes' constant (π)
PI64	Archimedes' constant (π)

Traits

BoolMap	Maps bools to Options in one line
BufRead	A BufRead is a type of Reader which has an internal buffer, allowing it to perform extra ways of reading.
Debug	? formatting.
Deref	Used for immutable dereferencing operations, like *v.
DerefMut	Used for mutable dereferencing operations, like in *v = 1;.
Display	Format trait for an empty format, {}.
Error	Error is a trait representing the basic expectations for error values, i.e., values of type E in Result<T, E>. Errors must describe themselves through the Display and Debug traits, and may provide cause chain information:
FromStr	Parse a value from a string
Index	Used for indexing operations (container[index]) in immutable contexts.
IndexMut	Used for indexing operations (container[index]) in mutable contexts.
Read	The Read trait allows for reading bytes from a source.
Write	A trait for objects which are byte-oriented sinks.

Functions

promote_then⚠

Temporarily gain access an immutable reference as mutable

Type Definitions

FmtResult	The type returned by formatter methods.
IoResult	A specialized Result type for I/O operations.