cal7tor/README.md
2022-08-23 17:53:57 +02:00

44 lines
1.2 KiB
Markdown

# cal8tor • ***cal***endar P***8*** extrac***tor***
Extractor of the calendar of the IT degree of university Paris 8.
[![dependency status](https://deps.rs/repo/gitea/git.kennel.ml/Anri/cal8tor/status.svg)](https://deps.rs/repo/gitea/git.kennel.ml/Anri/cal8tor)
## Build and run
You will need Rust installed to compile the program.
<details><summary>You also need <code>OpenSSL</code> installed.</summary>
- Ubuntu: `sudo apt install libssl-dev`
- Fedora: `dnf install openssl-devel`
</details>
1. Clone the repo and get in
```bash
$ git clone https://git.kennel.ml/Anri/cal8tor.git && cd cal8tor
```
2. Build the app and get in the output folder
```bash
$ cargo build --release && cd target/release/
```
3. Run the app, here the help page will be displayed
```
$ ./cal8tor --help
```
## See the calendar in your terminal
For the L2-X, run:
```bash
$ ./cal8tor l2-X
```
> The rendering can sometimes be unreadable and/or hard to read.
## Export the calendar in .ics format
For the L1-A, run:
```bash
$ ./cal8tor L1A --export calendar.ics
```
> The file include the timezone for `Europe/Paris` and is in
compliance with [this validator tool](https://icalendar.org/validator.html).
---
Please open a PR if you want to improve the project!