Add gpptool binary

This tool allows decoding of GPP strings to JSON in the console.

Author: noirotm

Cargo.toml

@@ -1,5 +1,6 @@
 [workspace]
 members = [
+    "gpptool",
     "iab_gpp",
     "iab_gpp_derive"
 ]

gpptool/Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "gpptool"
+version = "0.1.0"
+edition = "2021"
+authors = ["Marc Noirot <[email protected]>"]
+description = "IAB GPP Consent String implementation"
+homepage = "https://github.com/noirotm/iabgpp-rs"
+repository = "https://github.com/noirotm/iabgpp-rs"
+license = "Apache-2.0"
+keywords = ["tcf", "iab", "gpp", "decode"]
+categories = ["parser-implementations"]
+documentation = "https://docs.rs/iab_gpp/"
+
+[dependencies]
+clap = { version = "4.5.28", features = ["derive"] }
+colored_json = "5.0.0"
+iab_gpp = { path = "../iab_gpp", features = ["serde"] }
+serde = { version = "1.0.217", features = ["derive"] }
+serde_json = "1.0.138"
+num-traits = "0.2.19"

gpptool/src/main.rs

@@ -0,0 +1,91 @@
+use clap::{Parser, Subcommand};
+use colored_json::ToColoredJson;
+use iab_gpp::sections::SectionId;
+use iab_gpp::v1::GPPString;
+use num_traits::cast::FromPrimitive;
+use num_traits::ToPrimitive;
+use std::str::FromStr;
+
+#[derive(Parser)]
+#[command(version, about, long_about = None)]
+struct Cli {
+    #[command(subcommand)]
+    cmd: Commands,
+}
+
+#[derive(Subcommand)]
+enum Commands {
+    /// Parse a GPP string and display it in the console
+    Parse {
+        /// GPP string to parse
+        gpp_string: String,
+        /// Section ID to parse
+        #[arg(short, long)]
+        section_id: Option<u32>,
+    },
+    /// List all sections
+    List {
+        /// GPP string to parse
+        gpp_string: String,
+    },
+}
+
+fn main() {
+    let args = Cli::parse();
+
+    let e = match args.cmd {
+        Commands::Parse {
+            gpp_string,
+            section_id: None,
+        } => parse_gpp_string(&gpp_string),
+        Commands::Parse {
+            gpp_string,
+            section_id: Some(id),
+        } => parse_gpp_string_section(&gpp_string, id),
+        Commands::List { gpp_string } => list_sections(&gpp_string),
+    };
+
+    if let Err(e) = e {
+        eprintln!("{}", e);
+        std::process::exit(1);
+    }
+}
+
+fn parse_gpp_string(s: &str) -> Result<(), Box<dyn std::error::Error>> {
+    let gpp_str = GPPString::from_str(s)?;
+
+    let sections = gpp_str
+        .decode_all_sections()
+        .into_iter()
+        .collect::<Result<Vec<_>, _>>()?;
+
+    println!(
+        "{}",
+        serde_json::to_string_pretty(&sections)?.to_colored_json_auto()?
+    );
+
+    Ok(())
+}
+
+fn parse_gpp_string_section(s: &str, id: u32) -> Result<(), Box<dyn std::error::Error>> {
+    let gpp_str = GPPString::from_str(s)?;
+
+    let section = gpp_str.decode_section(SectionId::from_u32(id).ok_or("Invalid ID")?)?;
+
+    println!(
+        "{}",
+        serde_json::to_string_pretty(&section)?.to_colored_json_auto()?
+    );
+
+    Ok(())
+}
+
+fn list_sections(s: &str) -> Result<(), Box<dyn std::error::Error>> {
+    let gpp_str = GPPString::from_str(s)?;
+
+    for s in gpp_str.section_ids() {
+        println!("{}\t{:?}", s.to_u32().unwrap_or_default(), s);
+    }
+
+    Ok(())
+}