7 releases

0.3.0 Aug 20, 2023
0.2.1 Jan 22, 2023
0.1.3 Nov 20, 2021
0.1.2 Dec 22, 2020
0.1.1 Jun 21, 2020

#1555 in Parser implementations

Download history 22/week @ 2024-03-13 15/week @ 2024-03-20 18/week @ 2024-03-27 41/week @ 2024-04-03 40/week @ 2024-04-10 21/week @ 2024-04-17 38/week @ 2024-04-24 41/week @ 2024-05-01 35/week @ 2024-05-08 39/week @ 2024-05-15 45/week @ 2024-05-22 36/week @ 2024-05-29 36/week @ 2024-06-05 18/week @ 2024-06-12 38/week @ 2024-06-19 19/week @ 2024-06-26

120 downloads per month
Used in procmon-oprs

MIT license

14KB
280 lines

Light INI parser

Rust

This library implements an event-driven parser for the INI file format.

It doesn't load data in a container. It's an alternative to rust-ini that avoids building an intermediate hash map if it's not necessary.

[dependencies]
light_ini = "0.3"

See the documentation and examples for details.

Format

  • There is no limitation in the names of the properties.

  • Comments are only allowed in their own line. The default character to start a comment is ;. Use IniParser::with_start_comment to use a different character such as #.

  • There is no escape or quoting characters

License

Licensed under MIT license.


lib.rs:

Light Ini file parser.

light-ini implements an event-driven parser for the INI file format. The handler must implement IniHandler.

use light_ini::{IniHandler, IniParser, IniHandlerError};

struct Handler {}

impl IniHandler for Handler {
    type Error = IniHandlerError;

    fn section(&mut self, name: &str) -> Result<(), Self::Error> {
        println!("section {}", name);
        Ok(())
    }

    fn option(&mut self, key: &str, value: &str) -> Result<(), Self::Error> {
        println!("option {} is {}", key, value);
        Ok(())
    }

    fn comment(&mut self, comment: &str) -> Result<(), Self::Error> {
        println!("comment: {}", comment);
        Ok(())
    }
}

let mut handler = Handler{};
let mut parser = IniParser::new(&mut handler);
parser.parse_file("example.ini");

No runtime deps