Rough pencil in of how app should work

Author: kenshaw

cmd.go

@@ -18,6 +18,22 @@ import (
 	"github.com/xo/ox/text"
 )
 
+// ParseCommand parses a command's doc comment with reflect, building
+func ParseCommand(v any) ([]Option, error) {
+	var opts []Option
+	// build sub commands
+	if c, ok := v.(interface{ Sub() []any }); ok {
+		for _, s := range c.Sub() {
+			o, err := ParseCommand(s)
+			if err != nil {
+				return nil, err
+			}
+			opts = append(opts, Sub(o...))
+		}
+	}
+	return opts, nil
+}
+
 // Command is a command.
 type Command struct {
 	// Parent is the command's parent.

ox.go

@@ -301,13 +301,11 @@ func Run(opts ...Option) {
 
 // RunAppContext
 func RunAppContext[T *E, E any](ctx context.Context, v T, opts ...Option) {
-	/*
-	   o, err := NewApp(v)
-	   if err != nil && c.Handler(err) {
-	           return
-	   }
-	   RunContext(ctx, prepend(opts, o...)...)
-	*/
+	c, o, err := NewApp(v)
+	if err != nil && c.Handler(err) {
+		return
+	}
+	RunContext(ctx, prepend(opts, o...)...)
 }
 
 // RunApp
@@ -517,6 +515,20 @@ func (ctx *Context) Expand(v any) (any, error) {
 	return v, nil
 }
 
+// NewApp creates a execution context and a app command tree by parsing the doc
+// comment of v.
+func NewApp[T *E, E any](v T) (*Context, []Option, error) {
+	c, err := NewContext()
+	if err != nil {
+		return nil, nil, err
+	}
+	opts, err := ParseCommand(v)
+	if err != nil {
+		return c, nil, err
+	}
+	return c, opts, nil
+}
+
 // contextKey is the context key type.
 type contextKey int