Crate confget

Parse configuration files.

The confget library parses configuration files (currently INI-style files only) and allows a program to use the values defined in them. It provides various options for selecting the variable names and values to return and the configuration file sections to fetch them from.

The confget library may also be used as a command-line tool with the same interface as the C implementation.

Quick-and-easy parsing of INI-style files

The read_ini_file function will parse an INI-style file and return a hashmap of the values found in its various sections, as well as the name of the first section found in the file (or the one specified in the configuration if the Config::section_override option is enabled).

// Default configuration except for the filename.
let config = Config {
    filename: Some(confdir.join("config.ini").to_str().unwrap().to_string()),
    ..Config::default()
};
let (data, first_section) = confget::read_ini_file(&config)?;

For the crate’s change history, see the CHANGES file in the source distribution.

Re-exports

pub use defs::BackendKind;

pub use defs::ConfgetError;

pub use defs::Config;

pub use defs::FileData;

pub use defs::SectionData;

Modules

backend

Abstract definitions for data parsing backends.

defs

Common definitions used by the various confget modules.

format

Format the variable names and values as specified by the configuration.

Functions

features

Build an array of features supported by the confget library based on the enabled crate features.

get_backend

Construct an object of the specified backend type.

read_ini_file

Read an INI-style file with the specified configuration.