⚙ Very simple config parsing lib for rust!
I made this because I just needed a simple config parser for one of my projects and wanted to learn how to make a rust crate. Hopefully you will find it useful as well. :P
Just add the following to your Cargo.toml
:
toml
[dependencies]
simple_config_parser = "0.1.5"
This config parser is made for use with a simplified version of an ini file. There are no sections and currently no Escape character support. ```ini ; This is a comment
hello = World rust = Is great test = "TEST" ```
There are already a few config parsers out there for rust so why use this one?
There are a few reasons: - It's super simple to use - Its faster then some other popular config parsers (by only a few hundred Nano seconds but still) - It's code is easy to understand (For me at least) - It would make me happy (:P)
Create a new config. ```rust // Import Lib use simpleconfigparser::config::Config;
// Create a new config with no file let mut cfg = Config::new(None);
// Create a new config with a file let mut cfg2 = Config::new(Some("config.cfg")); ```
Read a config file and parse it. ```rust // Import Lib use simpleconfigparser::config::Config;
// Create a new config with a file let mut cfg = Config::new(Some("config.cfg"));
// Read / parse config file cfg.read().ok().expect("Error reading the config file"); ```
Load config from a string. ```rust // Import Lib use simpleconfigparser::config::Config;
// Create a new config with no file let mut cfg = Config::new(None);
// Parse config from string cfg.parse("hello = World\nrust = Is great\ntest = \"TEST\"").ok().expect("Error parsing the config file"); ```
Get a value from a config. ```rust // Import Lib use simpleconfigparser::config::Config;
// Create a new config with no file let mut cfg = Config::new(None); cfg.parse("hello = World\nrust = Is great").ok().unwrap();
// Create a new config with a file let mut cfg2 = Config::new(Some("config.cfg"));
// Get a value from the config (As a string) println!("Hello, {}", cfg.get("hello").unwrap()); ```
Get value from a config as a bool, int and float. ```rust // Import Lib use simpleconfigparser::config::Config;
// Create a new config with no file let mut cfg = Config::new(None); cfg.parse("hello = True\nrust = 15\npi = 3.1415926535").ok().unwrap();
// Get a value from the config as bool asserteq!(cfg.getbool("hello").unwrap(), true);
// Get a value from the config as int asserteq!(cfg.getint("rust").unwrap(), 15);
// Get a value from the config as float asserteq!(cfg.getfloat("pi").unwrap(), 3.1415926535); ```