docsonnet/main.go
sh0rez 66a158a8f2
feat: ignore
Implements ignoring certain keys right in Jsonnet, by adding:

  {
    '#foo': "ignore",
    foo: {}
  }

This is especially useful for objects that include `self` references,
which might otherwise recurse infinitely
2020-05-12 22:48:02 +02:00

70 lines
1.6 KiB
Go

package main
import (
"encoding/json"
"fmt"
"log"
"github.com/go-clix/cli"
"github.com/sh0rez/docsonnet/pkg/docsonnet"
"github.com/sh0rez/docsonnet/pkg/render"
)
func main() {
log.SetFlags(0)
root := &cli.Command{
Use: "docsonnet <file>",
Short: "Utility to parse and transform Jsonnet code that uses the docsonnet extension",
Args: cli.ArgsExact(1),
}
dir := root.Flags().StringP("output", "o", "docs", "directory to write the .md files to")
outputJSON := root.Flags().Bool("json", false, "print loaded docsonnet as JSON")
outputRaw := root.Flags().Bool("raw", false, "don't transform, dump raw eval result")
urlPrefix := root.Flags().String("urlPrefix", "/", "url-prefix for frontmatter")
root.Run = func(cmd *cli.Command, args []string) error {
file := args[0]
log.Println("Extracting from Jsonnet")
data, err := docsonnet.Extract(file)
if err != nil {
log.Fatalln("Extracting:", err)
}
if *outputRaw {
fmt.Println(string(data))
return nil
}
log.Println("Transforming to docsonnet model")
pkg, err := docsonnet.Transform(data)
if err != nil {
log.Fatalln("Transforming:", err)
}
if *outputJSON {
data, err := json.MarshalIndent(pkg, "", " ")
if err != nil {
return err
}
fmt.Println(string(data))
return nil
}
log.Println("Rendering markdown")
n, err := render.To(*pkg, *dir, render.Opts{
URLPrefix: *urlPrefix,
})
if err != nil {
log.Fatalln("Rendering:", err)
}
log.Printf("Success! Rendered %v packages from '%s' to '%s'", n, file, *dir)
return nil
}
if err := root.Execute(); err != nil {
log.Fatalln(err)
}
}