tikh_email_parser 0.1.0

Simple parser of email addresses.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# tikh_email_parser


Розширений парсер електронних адрес з підтримкою коментарів та спеціальних символів за допомогою pest. Цей парсер розбирає складні електронні адреси та витягує локальну частину і домен.

## Опис


Парсер використовує pest для розбору електронних адрес на основі розширеної граматики. Він підтримує формати електронних адрес з коментарями, спеціальними символами та може перевіряти і витягувати компоненти з електронних адрес.

## Технічний опис процесу парсингу


Парсер аналізує рядок електронної адреси, розбиваючи його на локальну частину та домен за допомогою символу `@`. Локальна частина та домен можуть містити спеціальні символи та коментарі. Парсер використовує розширену граматику, яка підтримує:

- **Коментарі**: Текст, обмежений дужками `(` та `)`, який може з'являтися в різних місцях адреси.
- **Кавички**: Локальна частина може бути взята в подвійні лапки `" "`, щоб дозволити спеціальні символи.
- **Спеціальні символи**: Такі як `! # $ % & ' * + - / = ? ^ _ { | } ~`.

Процес парсингу виконується наступним чином:

1. **Видалення коментарів**: Коментарі ігноруються або обробляються окремо.
2. **Розбір локальної частини**: Може бути простим текстом або взятою в лапки.
3. **Розбір домену**: Складається з піддоменів, розділених крапками.
4. **Валідація**: Перевірка відповідності адреси розширеній граматиці.
5. **Витягування компонентів**: Повернення структури з локальною частиною та доменом.

## Використання


Щоб використовувати парсер, запустіть CLI-додаток і надайте файл, що містить електронні адреси для розбору.

cargo run -- parse emails.txt

Щоб відобразити інформацію про автора:

cargo run -- credits

## Граматика

Парсер використовує наступну граматику:

makefile
Copy code
email          = { cfws? ~ local_part ~ "@" ~ domain ~ cfws? }
local_part     = { dot_atom | quoted_string }
domain         = { dot_atom }
dot_atom       = { dot_atom_text ~ ("." ~ dot_atom_text)* }
dot_atom_text  = { [a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+ }
quoted_string  = { "\"" ~ qcontent* ~ "\"" }
qcontent       = { qtext | quoted_pair }
qtext          = { !["\\] ~ ANY }
quoted_pair    = { "\\" ~ ANY }
cfws           = { (comment | FWS)+ }
comment        = { "(" ~ (ctext | quoted_pair | comment)* ~ ")" }
ctext          = { ![()\\] ~ ANY }
FWS            = { (WSP* ~ CRLF)? ~ WSP+ }
WSP            = _{ " " | "\t" }
CRLF           = _{ "\r\n" | "\n" }