From acda78729ac29f0fa685620cf63185c6d75d4d39 Mon Sep 17 00:00:00 2001
From: Conor Nosal <c.nosal@gmail.com>
Date: Thu, 26 Sep 2019 00:07:44 -0400
Subject: [PATCH] Add inspect command

---
 README.md                   |  22 ++++++
 cmd/commands/inspect.go     | 154 ++++++++++++++++++++++++++++++++++++
 cmd/manifer/manifer.go      |   1 +
 cmd/manifer/manifer_test.go | 144 ++++++++++++++++++++++++++++++++-
 lib/maniferlib.go           |  56 +++++++++++++
 pkg/file/file.go            |  22 ++++++
 pkg/library/loader.go       |  58 ++++++++++++++
 pkg/plan/executor.go        |  11 ++-
 pkg/plan/executor_test.go   |   6 +-
 pkg/plan/plan.go            |  65 +++++++++++++++
 10 files changed, 533 insertions(+), 6 deletions(-)
 create mode 100644 cmd/commands/inspect.go
 create mode 100644 pkg/plan/plan.go

diff --git a/README.md b/README.md
index 48fb662..2f48e70 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,28 @@ combine the library and template to compose the final document.
   -library value
         Path to library file
 ```
+## inspect
+```
+./manifer inspect (--library <library path>...) [--tree|--plan] (-s <scenario name>...):
+  inspect scenarios as a dependency tree or execution plan.
+  -j    Print output in json format
+  -json
+        Print output in json format
+  -l value
+        Path to library file
+  -library value
+        Path to library file
+  -p    Print execution plan
+  -plan
+        Print execution plan
+  -s value
+        Scenario name in library
+  -scenario value
+        Scenario name in library
+  -t    Print dependency tree (default)
+  -tree
+        Print dependency tree (default)
+```
 ## compose
 ```
 ./manifer compose --template <template path> (--library <library path>...) (--scenario <scenario>...) [--print] [--diff] [-- passthrough flags ...]:
diff --git a/cmd/commands/inspect.go b/cmd/commands/inspect.go
new file mode 100644
index 0000000..cd2a759
--- /dev/null
+++ b/cmd/commands/inspect.go
@@ -0,0 +1,154 @@
+package commands
+
+import (
+	"context"
+	"encoding/json"
+	"flag"
+	"fmt"
+	"io"
+	"log"
+	"strings"
+
+	"github.com/google/subcommands"
+
+	"github.com/cjnosal/manifer/lib"
+	"github.com/cjnosal/manifer/pkg/library"
+	"github.com/cjnosal/manifer/pkg/plan"
+)
+
+type inspectCmd struct {
+	libraryPaths arrayFlags
+	scenarios    arrayFlags
+	printJson    bool
+	printPlan    bool
+	printTree    bool
+
+	logger  *log.Logger
+	writer  io.Writer
+	manifer lib.Manifer
+}
+
+func NewInspectCommand(l io.Writer, w io.Writer, m lib.Manifer) subcommands.Command {
+	return &inspectCmd{
+		logger:  log.New(l, "", 0),
+		writer:  w,
+		manifer: m,
+	}
+}
+
+func (*inspectCmd) Name() string { return "inspect" }
+func (*inspectCmd) Synopsis() string {
+	return "inspect scenarios as a dependency tree or execution plan."
+}
+func (*inspectCmd) Usage() string {
+	return `inspect (--library <library path>...) [--tree|--plan] (-s <scenario name>...):
+  inspect scenarios as a dependency tree or execution plan.
+`
+}
+
+func (p *inspectCmd) SetFlags(f *flag.FlagSet) {
+	f.Var(&p.libraryPaths, "library", "Path to library file")
+	f.Var(&p.libraryPaths, "l", "Path to library file")
+	f.BoolVar(&p.printJson, "json", false, "Print output in json format")
+	f.BoolVar(&p.printJson, "j", false, "Print output in json format")
+	f.BoolVar(&p.printPlan, "plan", false, "Print execution plan")
+	f.BoolVar(&p.printPlan, "p", false, "Print execution plan")
+	f.BoolVar(&p.printTree, "tree", false, "Print dependency tree (default)")
+	f.BoolVar(&p.printTree, "t", false, "Print dependency tree (default)")
+	f.Var(&p.scenarios, "scenario", "Scenario name in library")
+	f.Var(&p.scenarios, "s", "Scenario name in library")
+}
+
+func (p *inspectCmd) Execute(_ context.Context, f *flag.FlagSet, _ ...interface{}) subcommands.ExitStatus {
+
+	if len(p.libraryPaths) == 0 {
+		p.logger.Printf("Library not specified")
+		p.logger.Printf(p.Usage())
+		return subcommands.ExitFailure
+	}
+
+	if len(p.scenarios) == 0 {
+		p.logger.Printf("A scenario must be specified")
+		p.logger.Printf(p.Usage())
+		return subcommands.ExitFailure
+	}
+
+	nodes := []*library.ScenarioNode{}
+	for _, name := range p.scenarios {
+		node, err := p.manifer.GetScenarioTree(p.libraryPaths, name)
+		if err != nil {
+			p.logger.Printf("%v\n  while inspecting scenario %s", err, name)
+			return subcommands.ExitFailure
+		}
+		nodes = append(nodes, node)
+	}
+
+	var outBytes []byte
+	if p.printPlan {
+		executionPlan := &plan.Plan{}
+		for _, node := range nodes {
+			executionPlan = plan.Append(executionPlan, plan.FromScenarioTree(node))
+		}
+		if p.printJson {
+			outBytes = p.formatJson(executionPlan)
+		} else {
+			outBytes = p.formatPlainPlan(executionPlan)
+		}
+	} else {
+		if p.printJson {
+			outBytes = p.formatJson(nodes)
+		} else {
+			builder := strings.Builder{}
+			for _, node := range nodes {
+				p.formatPlainTree(node, &builder, "")
+			}
+			outBytes = []byte(builder.String())
+		}
+	}
+
+	_, err := p.writer.Write(outBytes)
+	if err != nil {
+		p.logger.Printf("%v\n  while writing inspect output", err)
+		return subcommands.ExitFailure
+	}
+
+	return subcommands.ExitSuccess
+}
+
+func (p *inspectCmd) formatJson(i interface{}) []byte {
+	bytes, _ := json.Marshal(i)
+	return bytes
+}
+
+func (p *inspectCmd) formatPlainTree(node *library.ScenarioNode, builder *strings.Builder, indent string) {
+	builder.WriteString(fmt.Sprintf("%sname:        %s (from %s)\n", indent, node.Name, node.LibraryPath))
+	builder.WriteString(fmt.Sprintf("%sdescription: %s\n", indent, node.Description))
+	builder.WriteString(fmt.Sprintf("%sglobal:  %v (applied to all scenarios)\n", indent, node.GlobalArgs))
+	builder.WriteString(fmt.Sprintf("%srefargs: %v (applied to snippets and subscenarios)\n", indent, node.RefArgs))
+	builder.WriteString(fmt.Sprintf("%sargs:    %v (applied to snippets and subscenarios)\n", indent, node.Args))
+
+	builder.WriteString(fmt.Sprintf("%ssnippets:\n", indent))
+	for _, snippet := range node.Snippets {
+		builder.WriteString(fmt.Sprintf("%s  %s\n", indent, snippet.Path))
+		builder.WriteString(fmt.Sprintf("%s  args: %v\n", indent, snippet.Args))
+		builder.WriteString("\n")
+	}
+	builder.WriteString(fmt.Sprintf("%sdependencies:\n", indent))
+	for _, dep := range node.Dependencies {
+		p.formatPlainTree(dep, builder, indent+"  ")
+		builder.WriteString("\n")
+	}
+}
+
+func (p *inspectCmd) formatPlainPlan(executionPlan *plan.Plan) []byte {
+	builder := strings.Builder{}
+	builder.WriteString(fmt.Sprintf("global: %v\n", executionPlan.Global.Args))
+	for _, step := range executionPlan.Steps {
+		builder.WriteString(fmt.Sprintf("- %s\n", step.Snippet))
+		builder.WriteString(fmt.Sprintf("  args:\n"))
+		for _, argSet := range step.Args {
+			builder.WriteString(fmt.Sprintf("    %s: %v\n", argSet.Tag, argSet.Args))
+		}
+	}
+	return []byte(builder.String())
+}
diff --git a/cmd/manifer/manifer.go b/cmd/manifer/manifer.go
index 549622c..7f65f43 100644
--- a/cmd/manifer/manifer.go
+++ b/cmd/manifer/manifer.go
@@ -25,6 +25,7 @@ func main() {
 	subcommands.Register(commands.NewComposeCommand(logger, writer, maniferLib), "")
 	subcommands.Register(commands.NewListCommand(logger, writer, maniferLib), "")
 	subcommands.Register(commands.NewSearchCommand(logger, writer, maniferLib), "")
+	subcommands.Register(commands.NewInspectCommand(logger, writer, maniferLib), "")
 
 	// run
 	flag.Parse()
diff --git a/cmd/manifer/manifer_test.go b/cmd/manifer/manifer_test.go
index 104e8c1..1ffac87 100644
--- a/cmd/manifer/manifer_test.go
+++ b/cmd/manifer/manifer_test.go
@@ -1,6 +1,7 @@
 package main
 
 import (
+	"fmt"
 	"github.com/cjnosal/manifer/test"
 	"os/exec"
 	"testing"
@@ -49,9 +50,9 @@ set: by_first
 	if outWriter.String() != expectedOut {
 		t.Errorf("Expected Out:\n'''%v'''\nActual:\n'''%v'''\n", expectedOut, outWriter.String())
 	}
-
-	// includes ascii color codes - use test.ByteWriter to print actual output to update
-	expectedStdErr := []byte{10, 83, 110, 105, 112, 112, 101, 116, 32, 47, 109, 110, 116, 47, 100, 47, 119, 111, 114, 107, 115, 112, 97, 99, 101, 47, 109, 97, 110, 105, 102, 101, 114, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 95, 111, 112, 115, 102, 105, 108, 101, 46, 121, 109, 108, 59, 32, 65, 114, 103, 32, 91, 45, 118, 32, 112, 97, 116, 104, 50, 61, 47, 98, 97, 115, 101, 50, 63, 32, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 98, 97, 115, 101, 51, 63, 32, 45, 118, 32, 112, 97, 116, 104, 49, 61, 47, 98, 97, 115, 101, 49, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 49, 61, 102, 114, 111, 109, 95, 98, 97, 115, 105, 99, 32, 45, 118, 32, 118, 97, 108, 117, 101, 50, 61, 98, 97, 115, 105, 99, 95, 102, 114, 111, 109, 95, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 32, 45, 118, 32, 112, 97, 116, 104, 49, 61, 47, 102, 105, 120, 101, 100, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 49, 61, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 93, 59, 32, 71, 108, 111, 98, 97, 108, 32, 91, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 102, 105, 110, 97, 108, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 51, 61, 116, 111, 117, 99, 104, 32, 45, 108, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 118, 97, 114, 115, 46, 121, 109, 108, 93, 10, 68, 105, 102, 102, 58, 10, 27, 91, 51, 50, 109, 98, 97, 115, 101, 50, 58, 32, 98, 97, 115, 105, 99, 95, 102, 114, 111, 109, 95, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 10, 102, 105, 110, 97, 108, 58, 32, 116, 111, 117, 99, 104, 10, 102, 105, 120, 101, 100, 58, 32, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 10, 27, 91, 48, 109, 102, 111, 111, 58, 32, 98, 97, 114, 10, 10, 83, 110, 105, 112, 112, 101, 116, 32, 47, 109, 110, 116, 47, 100, 47, 119, 111, 114, 107, 115, 112, 97, 99, 101, 47, 109, 97, 110, 105, 102, 101, 114, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 95, 111, 112, 115, 102, 105, 108, 101, 46, 121, 109, 108, 59, 32, 65, 114, 103, 32, 91, 45, 118, 32, 112, 97, 116, 104, 50, 61, 47, 115, 101, 116, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 50, 61, 98, 121, 95, 102, 105, 114, 115, 116, 32, 45, 118, 32, 112, 97, 116, 104, 49, 61, 47, 102, 105, 120, 101, 100, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 49, 61, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 93, 59, 32, 71, 108, 111, 98, 97, 108, 32, 91, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 102, 105, 110, 97, 108, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 51, 61, 116, 111, 117, 99, 104, 32, 45, 108, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 118, 97, 114, 115, 46, 121, 109, 108, 93, 10, 68, 105, 102, 102, 58, 10, 98, 97, 115, 101, 50, 58, 32, 98, 97, 115, 105, 99, 95, 102, 114, 111, 109, 95, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 10, 102, 105, 110, 97, 108, 58, 32, 116, 111, 117, 99, 104, 10, 102, 105, 120, 101, 100, 58, 32, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 10, 102, 111, 111, 58, 32, 98, 97, 114, 10, 27, 91, 51, 50, 109, 115, 101, 116, 58, 32, 98, 121, 95, 102, 105, 114, 115, 116, 10, 27, 91, 48, 109, 10, 83, 110, 105, 112, 112, 101, 116, 32, 47, 109, 110, 116, 47, 100, 47, 119, 111, 114, 107, 115, 112, 97, 99, 101, 47, 109, 97, 110, 105, 102, 101, 114, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 95, 111, 112, 115, 102, 105, 108, 101, 46, 121, 109, 108, 59, 32, 65, 114, 103, 32, 91, 45, 118, 32, 112, 97, 116, 104, 50, 61, 47, 114, 101, 117, 115, 101, 100, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 50, 61, 98, 121, 95, 115, 101, 99, 111, 110, 100, 32, 45, 118, 32, 112, 97, 116, 104, 49, 61, 47, 102, 105, 120, 101, 100, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 49, 61, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 93, 59, 32, 71, 108, 111, 98, 97, 108, 32, 91, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 102, 105, 110, 97, 108, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 51, 61, 116, 111, 117, 99, 104, 32, 45, 108, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 118, 97, 114, 115, 46, 121, 109, 108, 93, 10, 68, 105, 102, 102, 58, 10, 98, 97, 115, 101, 50, 58, 32, 98, 97, 115, 105, 99, 95, 102, 114, 111, 109, 95, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 10, 102, 105, 110, 97, 108, 58, 32, 116, 111, 117, 99, 104, 10, 102, 105, 120, 101, 100, 58, 32, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 10, 102, 111, 111, 58, 32, 98, 97, 114, 10, 27, 91, 51, 50, 109, 114, 101, 117, 115, 101, 100, 58, 32, 98, 121, 95, 115, 101, 99, 111, 110, 100, 10, 27, 91, 48, 109, 115, 101, 116, 58, 32, 98, 121, 95, 102, 105, 114, 115, 116, 10, 10, 83, 110, 105, 112, 112, 101, 116, 32, 59, 32, 65, 114, 103, 32, 91, 93, 59, 32, 71, 108, 111, 98, 97, 108, 32, 91, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 102, 105, 110, 97, 108, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 51, 61, 116, 111, 117, 99, 104, 32, 45, 108, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 118, 97, 114, 115, 46, 121, 109, 108, 93, 10, 68, 105, 102, 102, 58, 10}
+	// includes ascii color codes
+	// use test.ByteWriter and strings.ReplaceAll(fmt.Sprintf("%v", errWriter.Bytes()), " ", ",") to print actual output to update
+	expectedStdErr := []byte{10, 83, 110, 105, 112, 112, 101, 116, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 95, 111, 112, 115, 102, 105, 108, 101, 46, 121, 109, 108, 59, 32, 65, 114, 103, 32, 91, 45, 118, 32, 112, 97, 116, 104, 50, 61, 47, 98, 97, 115, 101, 50, 63, 32, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 98, 97, 115, 101, 51, 63, 32, 45, 118, 32, 112, 97, 116, 104, 49, 61, 47, 98, 97, 115, 101, 49, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 49, 61, 102, 114, 111, 109, 95, 98, 97, 115, 105, 99, 32, 45, 118, 32, 118, 97, 108, 117, 101, 50, 61, 98, 97, 115, 105, 99, 95, 102, 114, 111, 109, 95, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 32, 45, 118, 32, 112, 97, 116, 104, 49, 61, 47, 102, 105, 120, 101, 100, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 49, 61, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 93, 59, 32, 71, 108, 111, 98, 97, 108, 32, 91, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 102, 105, 110, 97, 108, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 51, 61, 116, 111, 117, 99, 104, 32, 45, 108, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 118, 97, 114, 115, 46, 121, 109, 108, 93, 10, 68, 105, 102, 102, 58, 10, 27, 91, 51, 50, 109, 98, 97, 115, 101, 50, 58, 32, 98, 97, 115, 105, 99, 95, 102, 114, 111, 109, 95, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 10, 102, 105, 110, 97, 108, 58, 32, 116, 111, 117, 99, 104, 10, 102, 105, 120, 101, 100, 58, 32, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 10, 27, 91, 48, 109, 102, 111, 111, 58, 32, 98, 97, 114, 10, 10, 83, 110, 105, 112, 112, 101, 116, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 95, 111, 112, 115, 102, 105, 108, 101, 46, 121, 109, 108, 59, 32, 65, 114, 103, 32, 91, 45, 118, 32, 112, 97, 116, 104, 50, 61, 47, 115, 101, 116, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 50, 61, 98, 121, 95, 102, 105, 114, 115, 116, 32, 45, 118, 32, 112, 97, 116, 104, 49, 61, 47, 102, 105, 120, 101, 100, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 49, 61, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 93, 59, 32, 71, 108, 111, 98, 97, 108, 32, 91, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 102, 105, 110, 97, 108, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 51, 61, 116, 111, 117, 99, 104, 32, 45, 108, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 118, 97, 114, 115, 46, 121, 109, 108, 93, 10, 68, 105, 102, 102, 58, 10, 98, 97, 115, 101, 50, 58, 32, 98, 97, 115, 105, 99, 95, 102, 114, 111, 109, 95, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 10, 102, 105, 110, 97, 108, 58, 32, 116, 111, 117, 99, 104, 10, 102, 105, 120, 101, 100, 58, 32, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 10, 102, 111, 111, 58, 32, 98, 97, 114, 10, 27, 91, 51, 50, 109, 115, 101, 116, 58, 32, 98, 121, 95, 102, 105, 114, 115, 116, 10, 27, 91, 48, 109, 10, 83, 110, 105, 112, 112, 101, 116, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 95, 111, 112, 115, 102, 105, 108, 101, 46, 121, 109, 108, 59, 32, 65, 114, 103, 32, 91, 45, 118, 32, 112, 97, 116, 104, 50, 61, 47, 114, 101, 117, 115, 101, 100, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 50, 61, 98, 121, 95, 115, 101, 99, 111, 110, 100, 32, 45, 118, 32, 112, 97, 116, 104, 49, 61, 47, 102, 105, 120, 101, 100, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 49, 61, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 93, 59, 32, 71, 108, 111, 98, 97, 108, 32, 91, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 102, 105, 110, 97, 108, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 51, 61, 116, 111, 117, 99, 104, 32, 45, 108, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 118, 97, 114, 115, 46, 121, 109, 108, 93, 10, 68, 105, 102, 102, 58, 10, 98, 97, 115, 101, 50, 58, 32, 98, 97, 115, 105, 99, 95, 102, 114, 111, 109, 95, 112, 108, 97, 99, 101, 104, 111, 108, 100, 101, 114, 10, 102, 105, 110, 97, 108, 58, 32, 116, 111, 117, 99, 104, 10, 102, 105, 120, 101, 100, 58, 32, 102, 114, 111, 109, 95, 115, 99, 101, 110, 97, 114, 105, 111, 10, 102, 111, 111, 58, 32, 98, 97, 114, 10, 27, 91, 51, 50, 109, 114, 101, 117, 115, 101, 100, 58, 32, 98, 121, 95, 115, 101, 99, 111, 110, 100, 10, 27, 91, 48, 109, 115, 101, 116, 58, 32, 98, 121, 95, 102, 105, 114, 115, 116, 10, 10, 83, 110, 105, 112, 112, 101, 116, 32, 59, 32, 65, 114, 103, 32, 91, 93, 59, 32, 71, 108, 111, 98, 97, 108, 32, 91, 45, 118, 32, 112, 97, 116, 104, 51, 61, 47, 102, 105, 110, 97, 108, 63, 32, 45, 118, 32, 118, 97, 108, 117, 101, 51, 61, 116, 111, 117, 99, 104, 32, 45, 108, 32, 46, 46, 47, 46, 46, 47, 116, 101, 115, 116, 47, 100, 97, 116, 97, 47, 118, 97, 114, 115, 46, 121, 109, 108, 93, 10, 68, 105, 102, 102, 58, 10}
 
 	if errWriter.String() != string(expectedStdErr) {
 		t.Errorf("Expected Stderr:\n'''%v'''\nActual:\n'''%v'''\n", string(expectedStdErr), errWriter.String())
@@ -177,3 +178,140 @@ func TestSearchJson(t *testing.T) {
 		t.Errorf("Expected:\n'''%v'''\nActual:\n'''%v'''\n", expected, writer.String())
 	}
 }
+
+func TestInspect(t *testing.T) {
+	t.Run("Plain Tree", func(t *testing.T) {
+		cmd := exec.Command(
+			"go",
+			"run",
+			"manifer.go",
+			"inspect",
+			"-l",
+			"../../test/data/ref_library.yml",
+			"--tree",
+			"-s",
+			"meta",
+		)
+		writer := &test.StringWriter{}
+		cmd.Stdout = writer
+
+		err := cmd.Run()
+		if err != nil {
+			t.Errorf("Unexpected error: %v", err)
+		}
+
+		expected := `name:        meta (from ../../test/data/ref_library.yml)
+description: 
+global:  [] (applied to all scenarios)
+refargs: [] (applied to snippets and subscenarios)
+args:    [] (applied to snippets and subscenarios)
+snippets:
+dependencies:
+  name:        base (from ../../test/data/base_library.yml)
+  description: 
+  global:  [] (applied to all scenarios)
+  refargs: [] (applied to snippets and subscenarios)
+  args:    [] (applied to snippets and subscenarios)
+  snippets:
+    ../../test/data/placeholder_opsfile.yml
+    args: [-v path1=/base1? -v value1=a -v path2=/base2? -v value2=b -v path3=/base3? -v value3=c]
+
+  dependencies:
+
+  name:        placeholder (from ../../test/data/library.yml)
+  description: replaces placeholder values
+  global:  [] (applied to all scenarios)
+  refargs: [] (applied to snippets and subscenarios)
+  args:    [-v path1=/fixed? -v value1=from_scenario] (applied to snippets and subscenarios)
+  snippets:
+    ../../test/data/placeholder_opsfile.yml
+    args: [-v path2=/set? -v value2=by_first]
+
+    ../../test/data/placeholder_opsfile.yml
+    args: [-v path2=/reused? -v value2=by_second]
+
+  dependencies:
+    name:        basic (from ../../test/data/library.yml)
+    description: a starting point
+    global:  [] (applied to all scenarios)
+    refargs: [-v value2=basic_from_placeholder] (applied to snippets and subscenarios)
+    args:    [-v path1=/base1? -v value1=from_basic] (applied to snippets and subscenarios)
+    snippets:
+      ../../test/data/placeholder_opsfile.yml
+      args: [-v path2=/base2? -v path3=/base3?]
+
+    dependencies:
+
+
+`
+		diffBytes(writer.String(), expected)
+		if writer.String() != expected {
+			t.Errorf("Expected:\n'''%v'''\nActual:\n'''%v'''\n", expected, writer.String())
+		}
+	})
+
+	t.Run("Plain Plan", func(t *testing.T) {
+		cmd := exec.Command(
+			"go",
+			"run",
+			"manifer.go",
+			"inspect",
+			"-l",
+			"../../test/data/ref_library.yml",
+			"--plan",
+			"-s",
+			"meta",
+		)
+		writer := &test.StringWriter{}
+		cmd.Stdout = writer
+
+		err := cmd.Run()
+		if err != nil {
+			t.Errorf("Unexpected error: %v", err)
+		}
+
+		expected := `global: []
+- ../../test/data/placeholder_opsfile.yml
+  args:
+    snippet: [-v path1=/base1? -v value1=a -v path2=/base2? -v value2=b -v path3=/base3? -v value3=c]
+    base: []
+    meta: []
+- ../../test/data/placeholder_opsfile.yml
+  args:
+    snippet: [-v path2=/base2? -v path3=/base3?]
+    basic: [-v path1=/base1? -v value1=from_basic -v value2=basic_from_placeholder]
+    placeholder: [-v path1=/fixed? -v value1=from_scenario]
+    meta: []
+- ../../test/data/placeholder_opsfile.yml
+  args:
+    snippet: [-v path2=/set? -v value2=by_first]
+    placeholder: [-v path1=/fixed? -v value1=from_scenario]
+    meta: []
+- ../../test/data/placeholder_opsfile.yml
+  args:
+    snippet: [-v path2=/reused? -v value2=by_second]
+    placeholder: [-v path1=/fixed? -v value1=from_scenario]
+    meta: []
+`
+
+		if writer.String() != expected {
+			t.Errorf("Expected:\n'''%v'''\nActual:\n'''%v'''\n", expected, writer.String())
+		}
+	})
+
+}
+
+func diffBytes(str1 string, str2 string) {
+	b1 := []byte(str1)
+	b2 := []byte(str2)
+	if len(b1) != len(b2) {
+		fmt.Printf("Different lengths: %d %d\n", len(b1), len(b2))
+	}
+	for i, b := range b1 {
+		if i < len(b2) {
+			if b != b2[i] {
+				fmt.Printf("byte %d differs: %d, %d\n", i, b, b2[i])
+			}
+		}
+	}
+}
diff --git a/lib/maniferlib.go b/lib/maniferlib.go
index b4a28ad..9f70b43 100644
--- a/lib/maniferlib.go
+++ b/lib/maniferlib.go
@@ -19,6 +19,8 @@ func NewManifer(logger io.Writer) Manifer {
 	return &libImpl{
 		composer: newComposer(logger),
 		lister:   newLister(),
+		loader:   newLoader(),
+		file:     &file.FileIO{},
 	}
 }
 
@@ -32,11 +34,15 @@ type Manifer interface {
 		showDiff bool) ([]byte, error)
 
 	ListScenarios(libraryPaths []string, all bool) ([]scenario.ScenarioEntry, error)
+
+	GetScenarioTree(libraryPaths []string, name string) (*library.ScenarioNode, error)
 }
 
 type libImpl struct {
 	composer composer.Composer
 	lister   scenario.ScenarioLister
+	loader   *library.Loader
+	file     *file.FileIO
 }
 
 func (l *libImpl) Compose(
@@ -53,6 +59,55 @@ func (l *libImpl) ListScenarios(libraryPaths []string, all bool) ([]scenario.Sce
 	return l.lister.ListScenarios(libraryPaths, all)
 }
 
+func (l *libImpl) GetScenarioTree(libraryPaths []string, name string) (*library.ScenarioNode, error) {
+	loaded, err := l.loader.Load(libraryPaths)
+	if err != nil {
+		return nil, err
+	}
+	node, err := loaded.GetScenarioTree(name)
+	if err != nil {
+		return nil, err
+	}
+	err = l.makePathsRelative(node)
+	if err != nil {
+		return nil, err
+	}
+	return node, nil
+}
+
+func (l *libImpl) makePathsRelative(node *library.ScenarioNode) error {
+	for i, snippet := range node.Snippets {
+		rel, err := l.file.ResolveRelativeFromWD(snippet.Path)
+		if err != nil {
+			return err
+		}
+		node.Snippets[i].Path = rel
+	}
+	for _, dep := range node.Dependencies {
+		err := l.makePathsRelative(dep)
+		if err != nil {
+			return err
+		}
+	}
+	rel, err := l.file.ResolveRelativeFromWD(node.LibraryPath)
+	if err != nil {
+		return err
+	}
+	node.LibraryPath = rel
+	return nil
+}
+
+func newLoader() *library.Loader {
+	file := &file.FileIO{}
+	yaml := &yaml.Yaml{}
+
+	loader := &library.Loader{
+		File: file,
+		Yaml: yaml,
+	}
+	return loader
+}
+
 func newLister() scenario.ScenarioLister {
 	file := &file.FileIO{}
 	yaml := &yaml.Yaml{}
@@ -89,6 +144,7 @@ func newComposer(logger io.Writer) composer.Composer {
 		Interpolator: opsFileInterpolator,
 		Diff:         diff,
 		Output:       logger,
+		File:         file,
 	}
 	return &composer.ComposerImpl{
 		Resolver: resolver,
diff --git a/pkg/file/file.go b/pkg/file/file.go
index dd51387..f39b929 100644
--- a/pkg/file/file.go
+++ b/pkg/file/file.go
@@ -13,6 +13,8 @@ type FileAccess interface {
 	TempDir(dir string, prefix string) (string, error)
 	RemoveAll(dir string) error
 	ResolveRelativeTo(targetFile string, sourceFile string) (string, error)
+	ResolveRelativeFrom(targetFile string, sourceFile string) (string, error)
+	ResolveRelativeFromWD(targetFile string) (string, error)
 	GetWorkingDirectory() (string, error)
 }
 
@@ -66,6 +68,26 @@ func (f *FileIO) ResolveRelativeTo(targetFile string, sourceFile string) (string
 	}
 }
 
+func (f *FileIO) ResolveRelativeFrom(targetFile string, sourceFile string) (string, error) {
+	dir := sourceFile
+	dirInfo, err := os.Stat(dir)
+	if err != nil {
+		return "", err
+	}
+	if !dirInfo.IsDir() {
+		dir = filepath.Dir(sourceFile)
+	}
+	return filepath.Rel(dir, targetFile)
+}
+
+func (f *FileIO) ResolveRelativeFromWD(targetFile string) (string, error) {
+	dir, err := f.GetWorkingDirectory()
+	if err != nil {
+		return "", err
+	}
+	return filepath.Rel(dir, targetFile)
+}
+
 func (f *FileIO) GetWorkingDirectory() (string, error) {
 	return os.Getwd()
 }
diff --git a/pkg/library/loader.go b/pkg/library/loader.go
index 827592b..fdb4c80 100644
--- a/pkg/library/loader.go
+++ b/pkg/library/loader.go
@@ -21,6 +21,55 @@ type LoadedLibrary struct {
 	Libraries    map[string]*Library
 }
 
+type ScenarioNode struct {
+	Name         string
+	Description  string
+	LibraryPath  string
+	Type         string
+	GlobalArgs   []string
+	RefArgs      []string
+	Args         []string
+	Snippets     []Snippet
+	Dependencies []*ScenarioNode
+}
+
+func (l *LoadedLibrary) GetScenarioTree(name string) (*ScenarioNode, error) {
+	return l.getScenarioNode(name, []string{}, nil)
+}
+
+func (l *LoadedLibrary) getScenarioNode(name string, refArgs []string, parentLib *Library) (*ScenarioNode, error) {
+	var scenario *Scenario
+	var lib *Library
+	if parentLib != nil {
+		scenario, lib = l.GetScenarioFromLib(parentLib, name)
+	} else {
+		scenario, lib = l.GetScenario(name)
+	}
+	if scenario == nil {
+		return nil, fmt.Errorf("Unable to find scenario %s", name)
+	}
+	deps := []*ScenarioNode{}
+	for _, ref := range scenario.Scenarios {
+		node, err := l.getScenarioNode(ref.Name, ref.Args, lib)
+		if err != nil {
+			return nil, fmt.Errorf("%w\n  while finding scenario %s", err, name)
+		}
+		deps = append(deps, node)
+	}
+	scenarioNode := &ScenarioNode{
+		Name:         scenario.Name,
+		Description:  scenario.Description,
+		LibraryPath:  l.GetPath(lib),
+		Type:         string(lib.Type),
+		GlobalArgs:   scenario.GlobalArgs,
+		RefArgs:      refArgs,
+		Args:         scenario.Args,
+		Snippets:     scenario.Snippets,
+		Dependencies: deps,
+	}
+	return scenarioNode, nil
+}
+
 func (l *LoadedLibrary) GetScenario(name string) (*Scenario, *Library) {
 	for _, lib := range l.TopLibraries {
 		scenario, foundIn := l.GetScenarioFromLib(lib, name)
@@ -59,6 +108,15 @@ func (l *LoadedLibrary) GetAliasedLibrary(lib *Library, alias string) *Library {
 	return nil
 }
 
+func (l *LoadedLibrary) GetPath(lib *Library) string {
+	for path, loaded := range l.Libraries {
+		if lib == loaded {
+			return path
+		}
+	}
+	return ""
+}
+
 func (l *Loader) Load(paths []string) (*LoadedLibrary, error) {
 	loaded := &LoadedLibrary{
 		TopLibraries: []*Library{},
diff --git a/pkg/plan/executor.go b/pkg/plan/executor.go
index c04794f..dde9027 100644
--- a/pkg/plan/executor.go
+++ b/pkg/plan/executor.go
@@ -16,6 +16,7 @@ type InterpolationExecutor struct {
 	Interpolator interpolator.Interpolator
 	Diff         diff.Diff
 	Output       io.Writer
+	File         file.FileAccess
 }
 
 func (i *InterpolationExecutor) Execute(showPlan bool, showDiff bool, template *file.TaggedBytes, snippet *file.TaggedBytes, snippetArgs []string, templateArgs []string) ([]byte, error) {
@@ -24,7 +25,15 @@ func (i *InterpolationExecutor) Execute(showPlan bool, showDiff bool, template *
 		snippetPath = snippet.Tag
 	}
 	if showPlan {
-		out := fmt.Sprintf("\nSnippet %s; Arg %v; Global %v\n", snippetPath, snippetArgs, templateArgs)
+		var relpath string
+		var err error
+		if snippet != nil {
+			relpath, err = i.File.ResolveRelativeFromWD(snippetPath)
+			if err != nil {
+				return nil, fmt.Errorf("%w\n  while resolving relative snippet path %s", err, snippetPath)
+			}
+		}
+		out := fmt.Sprintf("\nSnippet %s; Arg %v; Global %v\n", relpath, snippetArgs, templateArgs)
 		i.Output.Write([]byte(out))
 	}
 	bytes, err := i.Interpolator.Interpolate(template, snippet, snippetArgs, templateArgs)
diff --git a/pkg/plan/executor_test.go b/pkg/plan/executor_test.go
index f2c615c..5e492da 100644
--- a/pkg/plan/executor_test.go
+++ b/pkg/plan/executor_test.go
@@ -18,6 +18,7 @@ func TestStringDiff(t *testing.T) {
 		ctrl := gomock.NewController(t)
 		mockDiff := diff.NewMockDiff(ctrl)
 		mockInterpolator := interpolator.NewMockInterpolator(ctrl)
+		mockFile := file.NewMockFileAccess(ctrl)
 		writer := &test.StringWriter{}
 		defer ctrl.Finish()
 
@@ -25,12 +26,13 @@ func TestStringDiff(t *testing.T) {
 			Diff:         mockDiff,
 			Interpolator: mockInterpolator,
 			Output:       writer,
+			File:         mockFile,
 		}
 
 		in := &file.TaggedBytes{Tag: "in", Bytes: []byte("foo: bar")}
 		snippet := &file.TaggedBytes{Tag: "snippet", Bytes: []byte("bizz: bazz")}
 		mockInterpolator.EXPECT().Interpolate(in, snippet, []string{"snippet args"}, []string{"global args"}).Times(1).Return([]byte("bytes"), nil)
-
+		mockFile.EXPECT().ResolveRelativeFromWD("snippet").Times(1).Return("../snippet", nil)
 		bytes, err := subject.Execute(true, false, in, snippet, []string{"snippet args"}, []string{"global args"})
 
 		if err != nil {
@@ -39,7 +41,7 @@ func TestStringDiff(t *testing.T) {
 			t.Errorf("Expected:\n'''%v'''\nActual:\n'''%v'''\n", "bytes", string(bytes))
 		}
 
-		expectedStep := "\nSnippet snippet; Arg [snippet args]; Global [global args]\n"
+		expectedStep := "\nSnippet ../snippet; Arg [snippet args]; Global [global args]\n"
 		if writer.String() != expectedStep {
 			t.Errorf("Expected:\n'''%v'''\nActual:\n'''%v'''\n", expectedStep, writer.String())
 		}
diff --git a/pkg/plan/plan.go b/pkg/plan/plan.go
new file mode 100644
index 0000000..f110d49
--- /dev/null
+++ b/pkg/plan/plan.go
@@ -0,0 +1,65 @@
+package plan
+
+import (
+	"github.com/cjnosal/manifer/pkg/library"
+)
+
+type Plan struct {
+	Global ArgSet
+	Steps  []*Step
+}
+
+func Append(a *Plan, b *Plan) *Plan {
+	return &Plan{
+		Global: ArgSet{
+			Tag:  "global",
+			Args: append(a.Global.Args, b.Global.Args...),
+		},
+		Steps: append(a.Steps, b.Steps...),
+	}
+}
+
+type Step struct {
+	Snippet string
+	Args    []ArgSet
+}
+
+type ArgSet struct {
+	Tag  string
+	Args []string
+}
+
+func FromScenarioTree(node *library.ScenarioNode) *Plan {
+	plan := &Plan{
+		Global: ArgSet{
+			Tag:  "global",
+			Args: []string{},
+		},
+		Steps: []*Step{},
+	}
+	fromNode(node, plan, []ArgSet{})
+	return plan
+}
+
+func fromNode(node *library.ScenarioNode, plan *Plan, inherited []ArgSet) {
+	scenarioArgs := ArgSet{
+		Tag:  node.Name,
+		Args: append(node.Args, node.RefArgs...),
+	}
+	newArgSet := append([]ArgSet{scenarioArgs}, inherited...)
+	for _, dep := range node.Dependencies {
+		fromNode(dep, plan, newArgSet)
+	}
+	plan.Global.Args = append(plan.Global.Args, node.GlobalArgs...)
+	for _, snippet := range node.Snippets {
+		snippetArgs := ArgSet{
+			Tag:  "snippet",
+			Args: snippet.Args,
+		}
+		plan.Steps = append(plan.Steps, &Step{
+			Snippet: snippet.Path,
+			Args:    append([]ArgSet{snippetArgs}, newArgSet...),
+		})
+	}
+
+}