person_struct_parser 1.1.0

Rust parser for person struct #parser #grammar #person_struct
Documentation

person_struct_parser

Parser for Rust source code

Person_struct_parser(PSP) is a parsing library for parsing a String into a person object.

  • PSP has structure Person(person_struct_parser::person_module::Person) for containing the information about a person(name,age,city,zip) and zip_is_ua(true if zip is UA)
pub struct Person {
        pub name: String,
        pub age: u32,
        pub city: String,
        pub zip: u32,
        pub zip_is_ua: bool,
    }
  • There is a function person_struct_parser::person_module::normalize implemented for Person to reduce object data to normal form:
pub fn normalize(&mut self) -> &mut Self
  • Function person_struct_parser::person_module::parse is implemented for Person, it's main method for parsing String into the Person object with normalization:
pub fn parse(string: &str) -> anyhow::Result<Person>

  • std::fmt::Display is implemented for Person

  • The grammar for parsing is placed in grammar.pest file in src folder. Grammar:

alpha = { 'a'..'z' | 'A'..'Z' }
digit = { '0'..'9' }
non_digit = { !digit ~ . }
non_alpha = { !alpha ~ . }
all_characters_without_digits = { non_digit+ }
all_characters_without_alpha = { non_alpha+ }

name = {(all_characters_without_digits)+ ~ (alpha)+ ~ (all_characters_without_digits)+}
age = {(all_characters_without_alpha)+ ~ (digit)+ ~ (all_characters_without_alpha)+}
city = {(all_characters_without_digits)+ ~ (alpha)+ ~ .+}
zip = {.+ ~ (digit)+ ~ .+}

person = {name ~ age ~ city ~ zip}

Example

  • Normalization. To normalize person object. Next example will print Roman-21-Paris54586:
let mut person = Person{name:String::from("RoMAn"),age:21,city:String::from("PaRiS"),zip:54586};
println!("{}",person.normalize());
  • Parsing. Next example will print Roman-21-Paris54586 because of parsing and normalization after:
println!("{}",parse("-+Ro*Ma/N//2*+-1..PaR*I-s-54+gh5h-+h8ghj6").unwrap());
  • CLI. You can execute cargo run -- -i your_file_name.txt in command prompt to parse the content of your file. If there is a problem it will parse the appropriate default file. Also there are more commands - try cargo run -- --help for more info.

Custom Error

There is a custom error enum type using thiserror crate for parsing. For more look the documentation