xmltv 0.9.2

XMLTV for electronic program guide (EPG) parser and generator using serde.
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

# xmltv

XMLTV for electronic program guide (EPG) parser and generator using serde.

## Features

- Flatten some elements like `<new/>` to be a boolean in order to avoid boilerplate
- CLI available to perform some operations

## Usage

### Library

```rust
use std::str::FromStr;

use quick_xml::de::from_str;
use quick_xml::se::to_string_with_root;
use xmltv::*;

fn main() {
    let xml = "<tv>\
<programme channel=\"1\" start=\"2021-10-09 12:00:00 +0200\" stop=\"2021-10-09 13:00:00 +0200\">\
<title>Les feux de l&apos;amour é</title>\
</programme>\
<programme channel=\"2\" start=\"2021-10-09 12:20:00 +0200\" stop=\"2021-10-09 12:35:00 +0200\">\
<title lang=\"fr-FR\">Le journal</title>\
</programme>\
<programme channel=\"3\" start=\"2021-10-09 13:00:00 +0200\" stop=\"2021-10-09 13:40:00 +0200\">\
<title>Le journal</title>\
</programme>\
</tv>";

    // deserialize into the root object (Tv)
    let item: Tv = from_str(xml).unwrap();

    // serialize into string
    let _out = to_string_with_root("tv", &tv).unwrap();
}
```

To serialize **big files**, you can look into `tests/from_files.rs::test_programmes_from_files`.
It reads programmes one by one without loading everything in RAM.

### Command line interface (CLI)

Install it with `cargo install xmltv` or with the binaries.

## Roadmap

- [ ] CLI
  - [ ] filter channels `-c <channel list>` or `--channels <channel list>`
  - [ ] limit to *N* days `-d <number>`. `-d 3` means from today and the nex 3 days
  - [ ] clean: remove some unwanted elements to make it lighter. You can remove description `--no-description`,
  all credits `--no-credits` or partial one (`--no-directors`, `--no-actors`, `--no-guests`, ...), `--no-categories`,
  `--no-keywords`, `--no-countries`, ... You can also remove unwanted time slot(s) (like between 0:00-6:00 and/or
  23:30-23:59) or unwanted day(s) `--days 1,2,3,5,6,7` (here no thursday, first day is monday).
  - [ ] load external filter (`-l <FILE>` or `--load <FILE>`) from a configuration file to avoid a command with too many arguments or just to follow
  favorite programmes.
- [ ] Terminal UI (TUI) `--ui`
  - [ ] check channels to filter
  - [ ] search in the title (and maybe other like keywords, desciption, credits)
  - [ ] show EPG
  - [ ] export selected program to calendar (`.ics`)
  - [ ] configure favorites and filters?

## Ressources

XMLTV DTD is here: https://github.com/XMLTV/xmltv/blob/master/xmltv.dtd