# Film Parser

## Project Name
**film_parser**: A Rust application to parse film information from formatted strings into structured data.

## Link to crates.io
https://crates.io/crates/film_parser

## Link to docs.rs
https://docs.rs/film_parser/latest/film_parser/

## Overview
This project implements a Rust application that parses a string containing film information into a structured format defined by the `Film` struct. The goal is to facilitate the extraction and manipulation of film data, making it easier to work with various film-related tasks.

## Technical Description
The parsing process involves taking a string formatted in a specific way (for example,
```text
"Title: I Used To Be Funny; Year: 2023; Director: Ally Pankiw; Writer: Ally Pankiw; Genre: [Comedy, Drama]; Stars: [Rachel Sennott, Olga Petsa, Jason Jones]; Description: Sam, a stand-up comedian struggling with PTSD, weighs whether or not to join the search for a missing teenage girl she used to nanny."
```

### Parsing Steps
1. **Input File**: The input is a file containing strings with film details, where each string is separated by semicolons.
2. **Reading File**: The file is read line by line, where each line represents a separate film's information.
3. **Splitting**: Each line is split into key-value pairs using the semicolon as a delimiter.
4. **Trimming**: Each key-value pair is trimmed to remove extra spaces.
5. **Mapping to Struct**: The resulting pairs are mapped to the fields of the Film struct.

### Film Struct
The `Film` struct will be defined as follows:
```rust
struct Film {
    title: String,
    year: u32,
    director: String,
    writer: String,
    genre: Vec<String>,
    stars: Vec<String>,
    description: String,
}
```

## Usage
Once parsed, the resulting Film struct can be used for various purposes, including displaying film details, storing them in a database, or further processing them in an application.

## Film Grammar
The grammar for parsing the film data is structured as follows:
```text
file = { film* }

film = { Title ~ ";" ~ (" ")* ~ Year ~ ";" ~ (" ")* ~ Director ~ ";" ~ (" ")* ~ Writer ~ ";" ~ (" ")* ~ Genre ~ ";" ~ (" ")* ~ Stars ~ ";" ~ (" ")* ~ Description ~ (";")* }

Title = { "Title: " ~ title_value }
title_value = { (!";" ~ ANY)* }

Year = { "Year: " ~ year_value }
year_value = { ASCII_DIGIT+ }

Director = { "Director: " ~ director_value }
director_value = { (!";" ~ ANY)* }

Writer = { "Writer: " ~ writer_value }
writer_value = { (!";" ~ ANY)* }

Genre = { "Genre: " ~ "[" ~ genre_list ~ "]" }
genre_list = { genre_item ~ ("," ~ (" ")* ~ genre_item)* }
genre_item = { (!("," | "]") ~ ANY)* }

Stars = { "Stars: " ~ "[" ~ stars_list ~ "]" }
stars_list = { star_item ~ ("," ~ (" ")* ~ star_item)* }
star_item = { (!("," | "]") ~ ANY)* }

Description = { "Description: " ~ description_value }
description_value = { (!";" ~ ANY)* }
```

```text
                                                            +------------------+
                                                            |    Film Entry    |
                                                            +------------------+
                                                                     |
    +--------------------------------------------------------------------------------------------------------------------------------------+
    |      Title      |      Year      |      Director      |      Writer      |      Genre      |      Stars      |      Description      |
    +--------------------------------------------------------------------------------------------------------------------------------------+
            |                 |                  |                   |                  |                 |                    |
    +------------+     +------------+     +-------------+      +-----------+      +-----------+   +---------------+     +---------------+
    | Title: ... |     | Year: ...  |     |Director: ...|      |Writer: ...|      |Genre:[...]|   | Stars: [...]  |     |Description:...|
    +------------+     +------------+     +-------------+      +-----------+      +-----------+   +---------------+     +---------------+
```