Rust wrapper around libucl

A lightweight wrapper library in Rust around libucl, a library used for parsing of UCL (Universal Configuration Language) files.

Requirements

CMake and a C/C++ compiler like gcc or clang.

Note: Currently, support for remote includes is disabled. Plan is to add it as a feature flag, as it additionally requires libcurl / libfetch.

Platform support

Linux / Mac OS

libucl is buildable on Windows, but it is currently not tested.

Basics

You can read all about UCL (Universal Configuration Language) here

Usage

```rust use libucl::Parser;

let parser = Parser::new(); let result = parser.parse(r#"tag = "svc"; upstream { h2c = true; host = "http://localhost"; port = 9090; connect_timeout = 1s; }"#).unwrap();

println!("{}", result.fetchpath("upstream.h2c").andthen(|v| v.as_bool()));

```

Validation

You can write validation schemas in UCL format as well, as long as it follows the JSON Schema rules for defining a schema with the exception of remote references. UCL currently is not absolutely strict about validation schemas themselves, therefore UCL users should supply valid schemas (as it is defined in json-schema draft v4) to ensure that the input objects are validated properly. ```rust use libucl::Parser;

let parser = Parser::new(); let item = parser.parse(r#" { "key": "some string" }"# ).unwrap();

let parser = Parser::new(); let schema = parser.parse(r#" { "type": "object", "properties":{ "key": { "type":"string" } } }"# ).unwrap(); let res = item.validatewithschema(&schema); asserteq!(res.isok(), true);

```

Dump Object

It's possible to dump objects into JSON, JSON compact, YAML and Config format

```rust let parser = Parser::new(); let result = parser.parse(r#"section { flag = true; number = 10k; subsection { hosts = { host = "localhost"; port = 9000 } hosts = { host = "remotehost" port = 9090 } } }"#).unwrap();

let regex = Regex::new("\"flag\":true").unwrap(); let val = result.dumpinto(Emitter::JSONCompact); asserteq!(regex.ismatch(val.asstr()), true); ```

UCL tool

With the UCL tool you can convert input files into a specified format. The input and output file for the tool default to stdin and stdout so you can use them in a pipe. You can also specify a schema file and perform validation. ```dtd USAGE: ucltool [OPTIONS] [help]

FLAGS: -h, --help Prints help information -V, --version Prints version information

OPTIONS: -f, --format Specify the output format [default: ucl] [possible values: ucl, json, json_compact, yaml, msgpack] -i, --in Specify input filename path (defaults to standard input) -o, --out Specify output filename path(defaults to standard output) -s, --schema Specify schema file path to perform validation

ARGS: print this message and exit

```

Licence

Check out LICENSE file.