Crate ez

A collection of easy-to-use, beginner-friendly utilities for Rust.

⚠️ WARNING: THIS CRATE MAY BE INCOMPLETE AND UNSTABLE UNTIL v0.1.0!

Modules

file

File IO.

random

Generate random numbers (and bools) using the rand crate.

stdio

IO using stdin, stdout, and stderr. Used for terminal IO, etc.

string

Implementation of ezio traits for strings. Useful for mocking and other test usage of ezio in tests.

Macros

throw

Returns from the enclosing function with an error value or error message.

Structs

Error

A dynamic error reporting type.

Functions

stderr

Get a handle to stderr.

stdin

Get a handle to stdin.

stdout

Get a handle to stdout.

Attribute Macros

main

Decorates a main entry point function to configure some standard capabilities such as logging and error reporting, and adds some other conveniences.

throws

Decorates a function so that it implicitly wraps the result in Result::Ok, unless a Result::Err is propagated with the ? operator or returned with the throw! macro.

try_throws

A variation of the #[throws] attribute that creates two copies of the decorated function. One will use the function name and signature as-written, panicking if an error is encountered, while the other will add a try_ prefix to the function name and return a Result instead.