feat(picker): add parselib module and README

4 files changed, 41 insertions, 0 deletions

diff --git a/.run/version-files.toml b/.run/version-files.toml
index ca104d2..405652b 100644
--- a/.run/version-files.toml
+++ b/.run/version-files.toml
@@ -17,3 +17,7 @@ pattern = "version = \"{VER}\""
 [[file]]
 file = "./docs/res/guide.txt"
 pattern = "mingling = \"{VER}\""
+
+[[file]]
+file = "./mingling_picker/README.md"
+pattern = "version = \"{VER}\""
diff --git a/mingling_picker/README.md b/mingling_picker/README.md
index e69de29..efd72ad 100644
--- a/mingling_picker/README.md
+++ b/mingling_picker/README.md
@@ -0,0 +1,35 @@
+# Mingling Picker
+
+A command-line argument parser for [Mingling](https://github.com/mingling-rs/mingling), enabled by the `mingling/picker` feature.
+
+```toml
+[dependencies.mingling]
+version = "0.3.0"
+features = [
+    "picker"
+]
+```
+
+## Chained Argument Parser
+
+Provides a clean chained-call API for declaring arguments to parse:
+
+```rust
+let args: Vec<&str> = vec!["--name", "Bob", "--age", "24"];
+let result = args
+    .pick(&flag![name: String])
+    .or(|| "Alice".to_string())
+    .pick(&flag![age: i32])
+    .or(|| 24)
+    .post(|num| num.clamp(0, 120))
+    .parse();
+let (name, age): (String, i32) = a.unwrap();
+```
+
+## Parsing Function Library
+
+Provides a pure function library `parselib` for analyzing the structure of command-line arguments.
+
+```rust
+use mingling::picker::parselib::*;
+```
diff --git a/mingling_picker/src/lib.rs b/mingling_picker/src/lib.rs
index a2f3995..4056283 100644
--- a/mingling_picker/src/lib.rs
+++ b/mingling_picker/src/lib.rs
@@ -10,6 +10,8 @@ pub use flag::*;
 mod result;
 pub use result::*;
 
+pub mod parselib;
+
 pub mod prelude {
     pub use crate::IntoPicker;
 }
diff --git a/mingling_picker/src/parselib.rs b/mingling_picker/src/parselib.rs
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/mingling_picker/src/parselib.rs