update

Author: Sunrisepeak

README.md

@@ -1,16 +1,12 @@
 # cmdline
 
-> 基于 C++23 的命令行解析库，API 见名知意，单 import
-
-[English](README.md) - 简体中文
-
-[文档](docs/api.md) - [API 参考](docs/api.md#类型一览) - [示例](examples/)
+> 一个简单的命令行解析库/框架 - `import mcpplibs.cmdline;`
 
 使用 C++23 模块的类型安全命令行解析库。流式链式接口，零样板代码。支持位置参数、短/长选项、子命令、全局标志，以及基于 `std::expected` 的错误处理。
 
 ## ✨ 特性
 
-- **C++23 模块** — `import cmdline`
+- **C++23 模块** — `import mcpplibs.cmdline`
 
 - **流式接口** — 链式构建方法，所见即所得的 API
 
@@ -20,13 +16,13 @@
 
 - **类型安全结果** — `std::expected<ParsedArgs, std::string>`
 
-- **多种解析模式** — 支持 `argc/argv`、`cmdline::Args`（即 `vector<string>`）或原始 `string_view`
+- **多种解析模式** — 支持 `argc/argv`、`cmdline::Argv`（即 `vector<string>`）或原始 `string_view`
 
 ## 快速开始
 
 ```cpp
 import std;
-import cmdline;
+import mcpplibs.cmdline;
 
 using namespace mcpplibs;
 
@@ -43,15 +39,7 @@ int main(int argc, char* argv[]) {
             std::println("输入文件: {}", p.positional(0));
         });
 
-    auto result = app.parse(argc, argv);
-    if (!result) {
-        if (result.error() == "help requested" || result.error() == "version requested")
-            return 0;
-        std::println("Error: {}", result.error());
-        return 1;
-    }
-    app.run(*result);
-    return 0;
+    return app.run(argc, argv);
 }
 ```
 
@@ -75,15 +63,14 @@ auto app = cmdline::App("demo")
         .arg("target").required()
         .action([](const cmdline::ParsedArgs& a) { std::println("remove: {}", a.positional(0)); });
 
-auto result = app.parse(argc, argv);
-if (result) app.run(*result);
+app.run(argc, argv);
 ```
 
 ### 多种解析模式
 
 ```cpp
 auto r1 = app.parse(argc, argv);
-auto r2 = app.parse_from(cmdline::Args{"myapp", "add", "x", "1.0"});
+auto r2 = app.parse_from(cmdline::Argv{"myapp", "add", "x", "1.0"});
 auto r3 = app.parse_from("myapp remove x --yes");
 ```
 

docs/api.md

@@ -58,7 +58,7 @@
 
 ```cpp
 import std;
-import cmdline;
+import mcpplibs.cmdline;
 
 int main(int argc, char* argv[]) {
     using namespace cmdline;

examples/basic.cpp

@@ -1,5 +1,5 @@
 import std;
-import cmdline;
+import mcpplibs.cmdline;
 
 using namespace mcpplibs;
 
@@ -16,13 +16,5 @@ int main(int argc, char* argv[]) {
             std::println("Input: {}", p.positional(0));
         });
 
-    auto result = app.parse(argc, argv);
-    if (!result) {
-        if (result.error() == "help requested" || result.error() == "version requested")
-            return 0;
-        std::println("Error: {}", result.error());
-        return 1;
-    }
-    app.run(*result);
-    return 0;
+    return app.run(argc, argv);
 }

examples/parse_from_string.cpp

@@ -1,5 +1,5 @@
 import std;
-import cmdline;
+import mcpplibs.cmdline;
 
 using namespace mcpplibs;
 
@@ -16,8 +16,9 @@ int main() {
 
     auto result = app.parse_from("tool add --verbose");
     if (!result) {
-        std::println("Parse error: {}", result.error());
-        return 1;
+        if (result.error().is_error())
+            std::println("Parse error: {}", result.error().message);
+        return result.error().is_error() ? 1 : 0;
     }
     app.run(*result);
     return 0;

examples/with_dispatch.cpp

@@ -1,5 +1,5 @@
 import std;
-import cmdline;
+import mcpplibs.cmdline;
 
 using namespace mcpplibs;
 
@@ -20,14 +20,5 @@ int main(int argc, char* argv[]) {
             .arg("target").required()
             .action([](const cmdline::ParsedArgs& args) { std::println("remove: {}", args.positional(0)); });
 
-    auto result = app.parse(argc, argv);
-    if (!result) {
-        if (result.error() == "help requested" || result.error() == "version requested")
-            return 0;
-        std::println("Error: {}", result.error());
-        return 1;
-    }
-
-    app.run(*result);
-    return 0;
+    return app.run(argc, argv);
 }