From c105422f916a84effe06d68086100fdb587fd28d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jes=C3=BAs=20P=C3=A9rez?= <jpl@jesusperez.pro>
Date: Mon, 21 Oct 2024 03:21:48 +0100
Subject: [PATCH] chore: add .cargo and assets for rustdoc build

---
 .cargo/config.toml |  2 ++
 assets/doc.css     |  3 +++
 assets/header.html |  0
 assets/howto.md    | 67 ++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 72 insertions(+)
 create mode 100644 .cargo/config.toml
 create mode 100644 assets/doc.css
 create mode 100644 assets/header.html
 create mode 100644 assets/howto.md

diff --git a/.cargo/config.toml b/.cargo/config.toml
new file mode 100644
index 0000000..84f2afa
--- /dev/null
+++ b/.cargo/config.toml
@@ -0,0 +1,2 @@
+[build]
+rustdocflags = ["--html-in-header", "assets/header.html", "--default-theme", "light", "--extend-css","assets/doc.css"]
diff --git a/assets/doc.css b/assets/doc.css
new file mode 100644
index 0000000..8bafcc8
--- /dev/null
+++ b/assets/doc.css
@@ -0,0 +1,3 @@
+.logo-container img {
+  width: 100% !important;
+}
diff --git a/assets/header.html b/assets/header.html
new file mode 100644
index 0000000..e69de29
diff --git a/assets/howto.md b/assets/howto.md
new file mode 100644
index 0000000..2b1c77e
--- /dev/null
+++ b/assets/howto.md
@@ -0,0 +1,67 @@
+
+## How to used
+
+**cargo run --** can be replaced for generated binaries with
+ 
+- target/debug/be-technical-interview-rust (for debug build)
+- target/release/be-technical-interview-rust (for release build)
+
+### For help
+
+```bash
+cargo run -- -h
+```
+
+### For input file **input.txt**
+
+```bash
+cargo run -- -i input.txt
+```
+
+### In quiet mode
+
+```bash
+cargo run -- -i input.txt -q
+```
+
+if **output path** is provided, results will be saved in provided path,<br>
+without **quiet mode** info is printed to terminal
+
+```bash
+cargo run -- -i input.txt -o /tmp/output.txt
+```
+
+### Use config path. **Batch processing in parallel** (one thread for each target) 
+
+```bash
+cargo run -- -c config.toml
+```
+
+### Config file content
+
+```toml
+be_quiet = false
+[[targets]]
+input = "input.txt"
+
+[[targets]]
+input = "input_2.txt"
+```
+
+If **output** path is provided, **out_overwrite** can be used (true or false) to append conten or rewrite.
+
+By default:
+
+- **out_overwrite** is **true**
+- *reg_exp** is set as
+
+```rust
+pub const DEFAULT_REG_EXP: &str = r"(\d+) (\w+) (\d+)";
+```
+
+**reg_exp** can be provided but as a **regex** expresion from **string**, if it can not be converted parser exit.
+
+#### CAUTION
+
+Command line options have precedence over **config path** settings. <br>
+Be careful with the combinations