feat: Expose leftover args so that can processed further if needed. (#46

)

parser.go

@@ -199,3 +199,8 @@ func (y *Parser) Usage() string {
 	}
 	return strings.Join(u, "\n")
 }
+
+// Args returns non-flag arguments left over after parsing.
+func (y *Parser) Args() []string {
+	return y.flagSet.Args()
+}

parser_example_test.go

@@ -54,3 +54,19 @@ func ExampleErrHelp() {
 
 	// Output: --help flag passed
 }
+
+func ExampleParser_Args() {
+	var foo string
+
+	y := yag.New()
+
+	y.String(&foo, "foo", "sets Foo")
+	err := y.Parse([]string{"--foo", "x", "arg1", "arg2", "arg3"})
+	if err != nil {
+		fmt.Printf("error: %s", err)
+	}
+
+	fmt.Printf("foo: %q, args: %v", foo, y.Args())
+
+	// Output: foo: "x", args: [arg1 arg2 arg3]
+}