#treat #function #complexity #respect #bool #scary #deserve

macro confused

treat scary functions with the respect they deserve

3 releases

0.1.2 Sep 10, 2024
0.1.1 Sep 10, 2024
0.1.0 Sep 10, 2024

#529 in Procedural macros

MIT license

5KB
64 lines

Confused

Do you ever find yourself using a function that intimidates you? Are there functions so terrifying, mere comments do not sufficiently warn unwitting callers of its infinite complexity and unknowability?

With the confusion!() and confused!() macros, you can easily mark a scary function as such:

fn main() -> Result<(), ()> {
	if scary_function(666)?????????? {
		println!("oh shit, oh fuck");
	}

	Ok(())
}

fn scary_function(evil_number: u16) -> confusion!(10, bool) {
	confused!(10, evil_number == 666)
}

Syntax

confusion!(n, ok, err = ())

n is the depth of the Result<...> chain

ok is the type of the final Ok value

err is an optional Err type, if you actually want to use this for error handling

confused!(n, expr)

n is the depth of the Ok(...) chain expr is the final result

Dependencies

~230–670KB
~16K SLoC