State

A Rust library for safe and effortless global and thread-local state management.

```rust extern crate state;

static GLOBAL: state::Storage = state::Storage::new();

GLOBAL.set(42); assert_eq!(*GLOBAL.get(), 42); ```

This library can be used to easily implement:

• Global Singletons
• Global or Local Cached Values
• Thread-Local Thunks
• Dynamic Thread-Local Data
• Typed Containers

See the documentation for more.

Usage

Include state in your Cargo.toml [dependencies]:

toml [dependencies] state = "0.4"

Thread-local state management is not enabled by default. You can enable it via the tls feature:

toml [dependencies] state = { version = "0.4", features = ["tls"] }

All constructors may be made const by enabling the const_fn feature:

toml [dependencies] state = { version = "0.4", features = ["const_fn"] }

This will require Rust nightly due to the instability of the const_fn feature. Ensure that it is enabled by adding the following to your top-level crate attributes:

```rust

![feature(const_fn)]

```

Testing

This library is extensively tested. Tests can be found in tests/main.rs. You can run the tests on Rust nightly with cargo test --all-features.

License

State is licensed under either of the following, at your option:

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)