Add an option to generalise parsing to a BTreeMap when using std

examples/btreemap.rs

@@ -0,0 +1,29 @@
+/* btreemap - jaarg example program using BTreeMap
+ * SPDX-FileCopyrightText: (C) 2025 Gay Pizza Specifications
+ * SPDX-License-Identifier: MIT
+ */
+
+use jaarg::{std::ParseMapResult, Opt, Opts};
+use std::process::ExitCode;
+
+fn main() -> ExitCode {
+  const OPTIONS: Opts<&'static str> = Opts::new(&[
+    Opt::flag("help", &["--help"], "Show this help"),
+    Opt::positional("positional", "positional", "Positional argument"),
+    Opt::value("value", &["-v", "--value"], "path", "Value option"),
+    Opt::flag("flag", &["-f", "--flag"], "Flag option"),
+  ]);
+
+  let map = match OPTIONS.parse_map_easy() {
+    // TODO: There should probably be a more efficient way to make jaarg handle help for us
+    ParseMapResult::Map(map) if map.contains_key("help") => {
+      OPTIONS.print_full_help("btreemap");
+      return ExitCode::SUCCESS;
+    }
+    ParseMapResult::Map(map) => map,
+    ParseMapResult::Exit(code) => { return code; }
+  };
+
+  println!("{:?}", map);
+  ExitCode::SUCCESS
+}