tuna 0.1.0

Tuna-bles for live-tweaking of variables, for games and other applications.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# tuna

Tuna is a tool for managing CVARs during game development, as a set of global
global variables, on which manipulation can be built.

At the core, the goal of tuna is to be *easy* to use, while avoiding unsafe
code.

This is how you use it:

``` rust
extern crate tuna;

const ENABLE_LOGGING: tuna::Boolean = tuna::Boolean::new("logging", "enable", false);

fn main() {
    ENABLE_LOGGING.register();

    for i in 0..10 {
	    eprintln!("xx");
        if (ENABLE_LOGGING.read()) {
            eprintln!("looping once");
        }
		if i == 5 {
		    ENABLE_LOGGING.write(true);
		}
    }
}
```

The register call can be omitted, at some performance cost during the first
read.

There's also a utility macro to create a category more easily:

``` rust
extern crate tuna;

#[tuna::tuna]
mod logging {
	pub(super) const ENABLE: bool = false;
}

fn main() {
    logging::register();

    for i in 0..10 {
        if (logging::ENABLE.read()) {
            eprintln!("looping once");
        }

		if i == 5 {
		    logging::ENABLE.write(true);
		}
    }
}
```

Note that `tuna` is a work in progress! I'm working on it due to a need, but I
want to dogfood it while I build it - not build a whole thing on its own.

## Alternatives:

* [cvar](https://crates.io/crates/cvar) - much more customizable, less batteries-included