2 releases (1 stable)

1.0.0 Oct 12, 2021
0.1.0 Mar 12, 2019

#125 in Configuration

Download history 1760/week @ 2024-04-22 2269/week @ 2024-04-29 1930/week @ 2024-05-06 2221/week @ 2024-05-13 2001/week @ 2024-05-20 1531/week @ 2024-05-27 1810/week @ 2024-06-03 2081/week @ 2024-06-10 2614/week @ 2024-06-17 3098/week @ 2024-06-24 1972/week @ 2024-07-01 2193/week @ 2024-07-08 2455/week @ 2024-07-15 2795/week @ 2024-07-22 3952/week @ 2024-07-29 3901/week @ 2024-08-05

13,173 downloads per month
Used in 50 crates (8 directly)

MIT license

27KB
296 lines

fluid-let

Build Status Rust Documentation Latest Version

fluid-let implements dynamically scoped variables.

Dynamic or fluid variables are a handy way to define global configuration values. They come from the Lisp family of languages where they are relatively popular for this use case.

Usage

Add this to your Cargo.toml:

[dependencies]
fluid-let = "1"

You can declare global dynamic variables using fluid_let! macro. Suppose you want to have a configurable Debug implementation for your hashes, controlling whether to print out the whole hash or a truncated version:

use fluid_let::fluid_let;

fluid_let!(pub static DEBUG_FULL_HASH: bool);

Enable full print out using the fluid_set! macro. Assignments to dynamic variables are effective for a certain dynamic scope. In this case, while the function is being executed:

use fluid_let::fluid_set;

fn some_important_function() {
    fluid_set!(DEBUG_FULL_HASH, &true);

    // Hashes will be printed out with full precision in this function
    // as well as in all functions that it calls.
}

And here is how you can implement Debug that uses dynamic configuration:

impl fmt::Debug for Hash {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        let full = DEBUG_FULL_HASH.copied().unwrap_or(false);

        write!(f, "Hash(")?;
        if full {
            for byte in &self.value {
                write!(f, "{:02X}", byte)?;
            }
        } else {
            for byte in &self.value[..4] {
                write!(f, "{:02X}", byte)?;
            }
            write!(f, "...")?;
        }
        write!(f, ")")
    }
}

Here we print either the full value of the hash, or a truncated version, based on whether debugging mode has been enabled by the caller or not.

License

The code is licensed under MIT license (see LICENSE).

No runtime deps

Features