From 3895f429f1947aac1d2465d89c7bcd3ce38fc70e Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Mon, 27 Jul 2026 21:04:50 +0800
Subject: docs(sidebar): archive resolved issues with _ prefix
Archive three resolved issues by renaming files with an _ prefix and
adding
archival note banners
---
docs/dev/pages/issues/add-picker2.md | 100 -----------------------------------
1 file changed, 100 deletions(-)
delete mode 100644 docs/dev/pages/issues/add-picker2.md
(limited to 'docs/dev/pages/issues/add-picker2.md')
diff --git a/docs/dev/pages/issues/add-picker2.md b/docs/dev/pages/issues/add-picker2.md
deleted file mode 100644
index a2b5a10..0000000
--- a/docs/dev/pages/issues/add-picker2.md
+++ /dev/null
@@ -1,100 +0,0 @@
-The Picker2 Arguments Parser
-
- A smarter, faster alternative to Picker
-
-
-## Intro
-
-Mingling's `parser` feature is a temporary argument parsing solution created in the early stages of the project. While it can handle basic argument parsing tasks, its functionality is incomplete and has many limitations.
-
-This article aims to propose the design and development plan for the new Picker2 (feature name: `picker`).
-
-### Picker2 Expected Syntax
-
-1. **Pos args & flag args no longer depend on parsing order:** In `parser`, all flag args must be parsed before pos args. Picker2 removes this restriction.
-2. **Declare flags with declarative macros:** Use `positional!()`, `flag![-X, --x]` etc. to declare flags — cleaner and more concise.
-3. **One-shot `parse()` replaces step-by-step `unpack()`:** Defers the entire parsing flow to the final step, leaving more room for compile-time optimization.
-
-```rust
-#[chain]
-fn handle_hello(args: EntryHello) {
- let parsed = args
- .pick::(positional!())
- .pick::(flag![--help, -h])
- .parse();
-}
-```
-
-4. **Post-processing & routing control:** Use `after`, `after_route` to control post-processing logic. The route type is explicitly specified by the first `route` method.
-
-```rust
-#[chain]
-fn handle_hello(args: EntryHello) {
- let parsed = args
- .pick::(positional!())
- .after(|v| format!("\"{}\"", v)) // post-processing
- .parse();
-}
-```
-
-```rust
-#[chain]
-fn handle_hello(args: EntryHello) -> Next {
- // requires impl Grouped<_>
- // |
- let parsed = args // vvvvvvvvvvvvvvvvvvv
- .pick_route::(positional!(), ErrorNoNameProvided)
- .after_route(|v| Ok(format!("\"{}\"", v))) // post-process & route
- .parse();
- let routed_parsed = route!(parsed);
- empty_result!()
-}
-```
-
-5. **Keep the `Pickable` Trait**
-6. **Keep `PickableEnum` & provide a derive macro**
-7. **Use `pick_optional`, `pick_vec` instead of implementing trait separately for `Option`, `Vec`**
-8. **Use `pick_flag` instead of `pick::`**
-9. **Provide `YesOrNo`, `TrueOrFalse` etc. that implement the `BoolFlag` trait for explicit bool extraction**
-10. **Provide a `MultiFlag` derive macro, supporting arg modes like `pacman`**
-
-```rust
-#[derive(MultiFlag)]
-pub struct SomeToggles {
- // default [-i]
- pub install: bool,
-
- #[flag('U')]
- pub uninstall: bool,
-
- #[flag('X')]
- pub execute: bool,
-}
-
-// Auto-implements Pickable, supports parsing args like `-iUX`
-```
-
-11. **Support multiple arg formats:** e.g. `--key=value`, `/Key=Value`, controlled by global config `PickerConfig` (or: `Picker::from_with_cfg(prev.inner, PickerConfig::default())`)
-
-12. `.parse()` no longer returns a bare tuple, but instead returns:
-
-```rust
-pub struct PickerResult {
- pub result: Tuple,
- pub remains_argument: Arguments,
-}
-```
-
----
-
-## 🕘 Progress
-
-- [x] In Progress
- - [x] Added `Picker` struct and related call chain
- - [x] Added `parselib` providing parsing logic
- - [x] Added `Pickable` for extensibility
- - [x] Comprehensive testing!
- - [ ] Improve documentation
- - [x] Add examples
- - [ ] Update README
-- [ ] Complete
--
cgit