4 releases

0.1.3 Aug 31, 2022
0.1.2 Aug 31, 2022
0.1.1 Aug 30, 2022
0.1.0 Aug 30, 2022

#22 in #cli-config

Download history 16/week @ 2024-07-22 28/week @ 2024-07-29 36/week @ 2024-08-05 57/week @ 2024-08-12 14/week @ 2024-08-26 28/week @ 2024-09-02 26/week @ 2024-09-09 40/week @ 2024-09-23 40/week @ 2024-09-30 17/week @ 2024-10-07 41/week @ 2024-10-14 4/week @ 2024-10-21 1/week @ 2024-10-28 22/week @ 2024-11-04

69 downloads per month
Used in drawbridge

Apache-2.0

17KB
349 lines

Description

confargs is a Rust library, which parses a configuration file in arbitrary format into a iterator of command-line arguments. The main use case for this is to add configuration file support for CLI tools and argument parsers, which do not have support for configuration files.

Compatibility

This project primarily aims at compatibility with clap, which is tested automatically in CI. Other libraries should work as well, but that is not tested.

Examples

Examples are provided in examples directory along an example configuration files in supported formats.

clap

From the root of the repository:

$ cargo run -q --example clap    
Args { string: "string", integer: 42, float: 42.2, array: [] }
$ cargo run -q --example clap -- @examples/conf.toml
Args { string: "conf", integer: -42, float: -42.2, array: ["test", "config"] }

lib.rs:

Parse a configuration file in arbitrary format into a iterator of command-line arguments.

The main use case for this crate is to add configuration file support for CLI tools and argument parsers, which do not have support for configuration files (for example, clap)

Dependencies

~335–600KB
~13K SLoC