Crate haproxy_config
source ·Expand description
HAProxy config
Parse HAProxy configs and easily query it
See also:
A parser for HAProxy config files. HAProxy’s configs have many options to many to build a completely typed API. Such an API would also be quite fragile to changes in the config. This crate therefore presents a loosely typed config.
It parses to sections
consisting of lines
from which a Config
struct can be made. The struct follows the sections of a HAProxy config. Most options within the sections are presented in a HashMap
as key value strings. The important settings have a fully typed API.
Example
List all the ports HAProxy will bind to from the config file.
use haproxy_config::parse_sections;
use haproxy_config::Config;
let file = include_str!("../tests/medium_haproxy.cfg");
let sections = parse_sections(file).unwrap();
let config = Config::try_from(§ions).unwrap();
let frontend_ports = config.frontends.values().map(|f| f.bind.addr.port);
let listen_ports = config.listen.values().map(|f| f.bind.addr.port);
let ports: Vec<_> = frontend_ports.chain(listen_ports).collect();
println!("ports bound to by haproxy: {ports:?}")
Features
- Zero copy parsing to a config section based representation which preserves the order of the config lines and any comments.
- A stricter owned representation that is easy to query.
- Clear error reporting on parsing errors featuring a debug formatter that shows the problem with the config being parsed.
- Panic free implementation, this crate will not crash your code.
Unsupported
Because the API is not fully typed the crate allows some invalid configs to parse. Specifically any invalid configuration inside a section will be interpreted as a configuration value. Sections end at the next section or the end of the file therefore any invalid configuration after the first section is undetected.
The crate will break on valid configs that feature conditional blocks.
Contributions
This crate is far from complete but covers all my own use cases. I do however welcome any contributions.
Thanks
Re-exports
pub use config::Config;
Modules
- Stricter owned representation of an entire config that is easy to query.
- Zero copy and Owned representations of the lines in a config section.
- Zero copy and Owned representations of config sections.
Functions
- Parse a string representing a haproxy config to list of
sections
. Preservers comments and the order of the sections and their options. Unknown sections will result in multipleUnknownLine
entries.