docs: more parser examples

with different types of input and ouput.

Author: josecelano

examples/parser_file_in_file_out.rs

@@ -0,0 +1,68 @@
+//! Run with:
+//!
+//! ```not_rust
+//! cargo run --example parser_file_in_file_out -- -i ./tests/fixtures/sample.bencode -o output.json
+//! ```
+//!
+//! It should create the `output.json`  with this content: `["spam"]`.
+use std::{
+    fs::File,
+    io::{Read, Write},
+};
+
+use clap::{Arg, Command};
+use torrust_bencode2json::parsers::BencodeParser;
+
+fn main() {
+    let matches = Command::new("parser_file_in_file_out")
+        .version("0.1.0")
+        .author("Torrust Organization")
+        .about("Converts Bencode to JSON")
+        .arg(
+            Arg::new("input")
+                .short('i')
+                .long("input")
+                .help("Input file"),
+        )
+        .arg(
+            Arg::new("output")
+                .short('o')
+                .long("output")
+                .help("Output file"),
+        )
+        .get_matches();
+
+    // Handle input stream (file or stdin)
+    let input: Box<dyn Read> = if let Some(input_path) = matches.get_one::<String>("input") {
+        match File::open(input_path) {
+            Ok(file) => Box::new(file),
+            Err(e) => {
+                eprintln!("Error: {e}");
+                std::process::exit(1);
+            }
+        }
+    } else {
+        eprintln!("Error: missing input file path. Provide a file path with -i or --input");
+        std::process::exit(1);
+    };
+
+    // Handle output stream (file or stdout)
+    let mut output: Box<dyn Write> = if let Some(output_path) = matches.get_one::<String>("output")
+    {
+        match File::create(output_path) {
+            Ok(file) => Box::new(file),
+            Err(e) => {
+                eprintln!("Error: {e}");
+                std::process::exit(1);
+            }
+        }
+    } else {
+        eprintln!("Error: missing output file path. Provide a file path with -o or --output");
+        std::process::exit(1);
+    };
+
+    if let Err(e) = BencodeParser::new(input).write_bytes(&mut output) {
+        eprintln!("Error: {e}");
+        std::process::exit(1);
+    }
+}

examples/parser_string_in_string_out.rs

@@ -0,0 +1,20 @@
+//! Run with:
+//!
+//! ```not_rust
+//! cargo run --example parser_string_in_string_out
+//! ```
+//!
+//! It prints "spam".
+use torrust_bencode2json::parsers::BencodeParser;
+
+fn main() {
+    let input = "4:spam".to_string();
+    let mut output = String::new();
+
+    if let Err(e) = BencodeParser::new(input.as_bytes()).write_str(&mut output) {
+        eprintln!("Error: {e}");
+        std::process::exit(1);
+    }
+
+    println!("{output}");
+}

examples/parser_string_in_vec_out.rs

@@ -0,0 +1,20 @@
+//! Run with:
+//!
+//! ```not_rust
+//! cargo run --example parser_string_in_vec_out
+//! ```
+//!
+//! It prints "spam".
+use torrust_bencode2json::parsers::BencodeParser;
+
+fn main() {
+    let input = "4:spam".to_string();
+    let mut output = Vec::new();
+
+    if let Err(e) = BencodeParser::new(input.as_bytes()).write_bytes(&mut output) {
+        eprintln!("Error: {e}");
+        std::process::exit(1);
+    }
+
+    println!("{}", String::from_utf8_lossy(&output));
+}

examples/parser_vec_in_string_out.rs

@@ -0,0 +1,20 @@
+//! Run with:
+//!
+//! ```not_rust
+//! cargo run --example parser_vec_in_string_out
+//! ```
+//!
+//! It prints "spam".
+use torrust_bencode2json::parsers::BencodeParser;
+
+fn main() {
+    let input = b"4:spam".to_vec();
+    let mut output = String::new();
+
+    if let Err(e) = BencodeParser::new(&input[..]).write_str(&mut output) {
+        eprintln!("Error: {e}");
+        std::process::exit(1);
+    }
+
+    println!("{output}");
+}

examples/parser_vec_in_vec_out.rs

@@ -0,0 +1,20 @@
+//! Run with:
+//!
+//! ```not_rust
+//! cargo run --example parser_vec_in_vec_out
+//! ```
+//!
+//! It prints "spam".
+use torrust_bencode2json::parsers::BencodeParser;
+
+fn main() {
+    let input = b"4:spam".to_vec();
+    let mut output = Vec::new();
+
+    if let Err(e) = BencodeParser::new(&input[..]).write_bytes(&mut output) {
+        eprintln!("Error: {e}");
+        std::process::exit(1);
+    }
+
+    println!("{}", String::from_utf8_lossy(&output));
+}