ua_contact_book

Crates: https://crates.io/crates/ua_contact_book Docs: https://docs.rs/ua_contact_book/latest/ua_contact_book/ (rules description in Enum Rule)

Parser written with Rust and pest create to convert contact data to json format

Parsing data

File for parsing

Currently, the program parses data from the file used in generate_contact(). That is, test.txt

The file for parsing should have the following structure:

full_name; city; birth_date; phone_numbers; email
...
full_name; city; birth_date; phone_numbers; email

Grammar rules

name

This rule used to parse full_name properly: as soon, as this project oriented for ukrainian audience full_name contains Cyrillic letters, gaps and dot("Роберт Дауні мол.")

name = {(CYRILLIC|"."|" "|"'")+}

Роберт Дауні мол.
Іван Іванеко

city

This rule designed to parse contact's city: in this program city have name part(Cyrillic letters and gaps) and zip-code part(5-digit number) divided with coma and gaps

city = {((CYRILLIC|"."|"'")+~" "*)*~","~ " "*~ASCII_DIGIT{5}}

Київ, 00001
Бровари, 07400

birth_date

This rule was writen to parse birthdate with next structure:

birth_date = {ASCII_DIGIT{2} ~ (("." ~  ASCII_DIGIT{2} ~ ".")|("/" ~  ASCII_DIGIT{2} ~ "/")) ~ (ASCII_DIGIT{4})}

dd.mm.yyyy
dd/mm/yyyy

number

Rule for parsing single ukrainian phone number. Each ukrainian number starts with 0 or +380, then non-zero digit and 8 digits after.

number = {("+38")? ~ "0"~ ASCII_NONZERO_DIGIT ~ ASCII_DIGIT{8}}

0xxxxxxxxx
+380xxxxxxxxx

numbers

As long as person can own more than 1 phone number, phone numbers can be written with coma separation and gaps

numbers = {number ~ (" "* ~","~ " "* ~ number)*}

0xxxxxxxxx, +380xxxxxxxxx,+380xxxxxxxxx ,  +380xxxxxxxxx

email

Rule for parsing email. According to standard, max email length - 254 symbols, where part before "@" up to 64 symbols, that can be ASCII_DIGIT, ASCII_ALPHA or dot. After "@" length can be from 5 symbols up to 189, that can be ASCII_DIGIT, ASCII_ALPHA or dot.

email = {(ASCII_ALPHA|"."|ASCII_DIGIT){1, 64} ~ "@" ~ (ASCII_ALPHA|"."|ASCII_DIGIT){5, 189}}

user.123@examp.le

contact

Rule that contain previous rules and combines it into one.

contact = {name ~ " "* ~";"~ " "* ~city~ " "* ~";"~ " "* ~birth_date ~ " "* ~";"~ " "* ~numbers ~ " "* ~";"~ " "* ~ email}

name; city; date; numbers; email
Олексій Ігорович; Львів, 79000; 12/04/1985; +380961234567, 0951234567; oleksii@example.com

file

Rule that parse multiple contacts in file separated with NEWLINE

file = { SOI ~ (contact ~ NEWLINE*)* ~ EOI }

contact
contact
...
contact

Processing parsed data

After parsing data converts into JSON format. Here is part of current test result test.txt

[
        {
                "full_name": "Мар'яна ЄҐЇ",
                "city": "Бровари, 07400",
                "birth_date": "06/06/2006",
                "contacts": {
                        "phone_numbers": ["+380904652439", "0904652439"],
                        "email": "user@exam.pl"
                }
        },
        {
                "full_name": "Олексій Ігорович",
                "city": "Львів, 79000",
                "birth_date": "12/04/1985",
                "contacts": {
                        "phone_numbers": ["+380961234567", "0951234567"],
                        "email": "oleksii@example.com"
                }
        },
        {
                "full_name": "Катерина Михайлівна",
                "city": "Ужгород, 88000",
                "birth_date": "05/05/1991",
                "contacts": {
                        "phone_numbers": ["+380939876543"],
                        "email": "kateryna@example.com"
                }
        }
]