alloc_geiger 0.1.0

A Rust allocator which makes sound when active, like a Geiger counter.
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

# alloc_geiger

[![Latest Version]][crates.io] [![docs]][docs.rs]
[Latest Version]: https://img.shields.io/crates/v/alloc_geiger.svg
[crates.io]: https://crates.io/crates/alloc_geiger
[docs]: https://docs.rs/alloc_geiger/badge.svg
[docs.rs]: https://docs.rs/alloc_geiger/

A Rust allocator which makes sound when active, like a Geiger counter.

Currently this just writes an ASCII [`BEL`] to `/dev/tty`.

Inspired by [Malloc Geiger].

[`BEL`]: https://en.wikipedia.org/wiki/Bell_character
[Malloc Geiger]: https://github.com/laserallan/malloc_geiger

## Usage

To use `alloc_geiger` add it as a dependency:

```toml
# Cargo.toml
[dependencies]
alloc_geiger = "0.1.0"
```

To set `alloc_geiger::Geiger` as the global allocator, it must be initialized
with an underlying allocator. The `type System` alias and its `const SYSTEM`
make it easy to use the default system allocator:

```rust
#[global_allocator]
static ALLOC: alloc_geiger::System = alloc_geiger::SYSTEM;
```

Alternatives like [`jemallocator`] may also be used:

```rust
use alloc_geiger::Geiger;
use jemallocator::Jemalloc;

#[global_allocator]
static ALLOC: Geiger<Jemalloc> = Geiger::new(Jemalloc);
```

[`jemallocator`]: https://crates.io/crates/jemallocator

## License

This project is licensed under either of

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

at your option.

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in `alloc_geiger` by you, as defined in the Apache-2.0 license,
shall be dual licensed as above, without any additional terms or conditions.