statsd-parser 0.2.0

Library to parse (Dog)StatsD strings
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

# (Dog)statsD Parser

[![Build Status](https://travis-ci.org/appsignal/statsd_parser.svg?branch=master)](https://travis-ci.org/appsignal/statsd_parser)
[![Crate](http://meritbadge.herokuapp.com/statsd_parser)](https://crates.io/crates/statsd_parser)

Parses (Dog)StatsD strings and returns a normalized struct.

All [standard StatsD](https://github.com/b/statsd_spec) metric types are implemented.
For [DogStatsD](https://docs.datadoghq.com/guides/dogstatsd/) sample rates and tags are implemented.

```rust
use statsd_parser;

#[test]
fn test_statsd_counter_with_sample_rate_and_tags() {
    let mut tags = BTreeMap::new();
    tags.insert("foo".to_string(), "bar".to_string());
    tags.insert("moo".to_string(), "maa".to_string());

    let expected = Metric::Counter(Counter {
        name: "gorets".to_string(),
        value: 1.0,
        sample_rate: Some(0.9),
        tags: Some(tags)
    });

    assert_eq!(parse("gorets:1|c|@0.9|#foo:bar,moo:maa"), Ok(expected));
}
```

## License

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

Contributions are very welcome. Please make sure that you add a test for any use case you want to add.

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