Crate haproxy_config

source ·
Expand description

HAProxy config

Parse HAProxy configs and easily query it

Crates.io Crates.io Docs.rs License

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(&sections).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

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 multiple UnknownLine entries.