chore: add command docs

Signed-off-by: Charles-Edouard Brétéché <[email protected]>

.github/workflows/codegen.yaml

@@ -18,6 +18,10 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0
+      - uses: actions/setup-go@93397bea11091df50f3d7e59dc26a7711a8bcfbe # v4.1.0
+        with:
+          go-version-file: go.mod
+          cache-dependency-path: go.sum
       - name: Verify codegen
         run: |
           set -e

.github/workflows/lint.yaml

@@ -20,6 +20,7 @@ jobs:
         uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0
       - uses: actions/setup-go@93397bea11091df50f3d7e59dc26a7711a8bcfbe # v4.1.0
         with:
-          go-version: ~1.21.1
+          go-version-file: go.mod
+          cache-dependency-path: go.sum
       - name: golangci-lint
         uses: golangci/golangci-lint-action@3a919529898de77ec3da873e3063ca4b10e7f5cc # v3.7.0

.github/workflows/tests.yaml

@@ -20,6 +20,7 @@ jobs:
         uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0
       - uses: actions/setup-go@93397bea11091df50f3d7e59dc26a7711a8bcfbe # v4.1.0
         with:
-          go-version: ~1.21.1
+          go-version-file: go.mod
+          cache-dependency-path: go.sum
       - name: Run tests
         run: make tests

Makefile

@@ -103,8 +103,17 @@ codegen-api-docs-html: $(REFERENCE_DOCS) ## Generate html API docs
 .PHONY: codegen-api-docs
 codegen-api-docs: codegen-api-docs-md codegen-api-docs-html ## Generate API docs
 
+.PHONY: codegen-cli-docs
+codegen-cli-docs: build ## Generate CLI docs
+	@echo Generate cli docs... >&2
+	@rm -rf docs/user/commands && mkdir -p docs/user/commands
+	@./kyverno-json docs -o docs/user/commands --autogenTag=false
+
+.PHONY: codegen-docs
+codegen-docs: codegen-api-docs-md codegen-cli-docs ## Generate docs
+
 .PHONY: codegen-all
-codegen-all: codegen-crds codegen-deepcopy codegen-register codegen-api-docs-md ## Rebuild all generated code and docs
+codegen-all: codegen-crds codegen-deepcopy codegen-register codegen-docs ## Rebuild all generated code and docs
 
 .PHONY: verify-codegen
 verify-codegen: codegen-all ## Verify all generated code and docs are up to date
@@ -131,7 +140,7 @@ vet: ## Run go vet
 	@go vet ./...
 
 .PHONY: build
-build: fmt vet codegen-all ## Build
+build: fmt vet codegen-crds codegen-deepcopy codegen-register ## Build
 	@echo Building... >&2
 	@go build -ldflags=$(LD_FLAGS) .
 

docs/user/README.md

@@ -3,3 +3,4 @@
 This documentation contains the following user docs:
 
 - [API reference docs](./apis/README.md)
+- [CLI commands docs](./commands/kyverno-json.md)

docs/user/commands/kyverno-json.md

@@ -0,0 +1,26 @@
+## kyverno-json
+
+kyverno-json
+
+### Synopsis
+
+kyverno-json is a CLI tool to apply policies to json resources
+
+```
+kyverno-json [flags]
+```
+
+### Options
+
+```
+  -h, --help                  help for kyverno-json
+      --payload string        Path to payload (json or yaml file)
+      --policy strings        Path to kyverno-json policies
+      --pre-process strings   JmesPath expression used to pre process payload
+```
+
+### SEE ALSO
+
+* [kyverno-json completion](kyverno-json_completion.md)	 - Generate the autocompletion script for the specified shell
+* [kyverno-json docs](kyverno-json_docs.md)	 - Generates reference documentation.
+

docs/user/commands/kyverno-json_completion.md

@@ -0,0 +1,24 @@
+## kyverno-json completion
+
+Generate the autocompletion script for the specified shell
+
+### Synopsis
+
+Generate the autocompletion script for kyverno-json for the specified shell.
+See each sub-command's help for details on how to use the generated script.
+
+
+### Options
+
+```
+  -h, --help   help for completion
+```
+
+### SEE ALSO
+
+* [kyverno-json](kyverno-json.md)	 - kyverno-json
+* [kyverno-json completion bash](kyverno-json_completion_bash.md)	 - Generate the autocompletion script for bash
+* [kyverno-json completion fish](kyverno-json_completion_fish.md)	 - Generate the autocompletion script for fish
+* [kyverno-json completion powershell](kyverno-json_completion_powershell.md)	 - Generate the autocompletion script for powershell
+* [kyverno-json completion zsh](kyverno-json_completion_zsh.md)	 - Generate the autocompletion script for zsh
+

docs/user/commands/kyverno-json_completion_bash.md

@@ -0,0 +1,43 @@
+## kyverno-json completion bash
+
+Generate the autocompletion script for bash
+
+### Synopsis
+
+Generate the autocompletion script for the bash shell.
+
+This script depends on the 'bash-completion' package.
+If it is not installed already, you can install it via your OS's package manager.
+
+To load completions in your current shell session:
+
+	source <(kyverno-json completion bash)
+
+To load completions for every new session, execute once:
+
+#### Linux:
+
+	kyverno-json completion bash > /etc/bash_completion.d/kyverno-json
+
+#### macOS:
+
+	kyverno-json completion bash > $(brew --prefix)/etc/bash_completion.d/kyverno-json
+
+You will need to start a new shell for this setup to take effect.
+
+
+```
+kyverno-json completion bash
+```
+
+### Options
+
+```
+  -h, --help              help for bash
+      --no-descriptions   disable completion descriptions
+```
+
+### SEE ALSO
+
+* [kyverno-json completion](kyverno-json_completion.md)	 - Generate the autocompletion script for the specified shell
+

docs/user/commands/kyverno-json_completion_fish.md

@@ -0,0 +1,34 @@
+## kyverno-json completion fish
+
+Generate the autocompletion script for fish
+
+### Synopsis
+
+Generate the autocompletion script for the fish shell.
+
+To load completions in your current shell session:
+
+	kyverno-json completion fish | source
+
+To load completions for every new session, execute once:
+
+	kyverno-json completion fish > ~/.config/fish/completions/kyverno-json.fish
+
+You will need to start a new shell for this setup to take effect.
+
+
+```
+kyverno-json completion fish [flags]
+```
+
+### Options
+
+```
+  -h, --help              help for fish
+      --no-descriptions   disable completion descriptions
+```
+
+### SEE ALSO
+
+* [kyverno-json completion](kyverno-json_completion.md)	 - Generate the autocompletion script for the specified shell
+

docs/user/commands/kyverno-json_completion_powershell.md

@@ -0,0 +1,31 @@
+## kyverno-json completion powershell
+
+Generate the autocompletion script for powershell
+
+### Synopsis
+
+Generate the autocompletion script for powershell.
+
+To load completions in your current shell session:
+
+	kyverno-json completion powershell | Out-String | Invoke-Expression
+
+To load completions for every new session, add the output of the above command
+to your powershell profile.
+
+
+```
+kyverno-json completion powershell [flags]
+```
+
+### Options
+
+```
+  -h, --help              help for powershell
+      --no-descriptions   disable completion descriptions
+```
+
+### SEE ALSO
+
+* [kyverno-json completion](kyverno-json_completion.md)	 - Generate the autocompletion script for the specified shell
+

docs/user/commands/kyverno-json_completion_zsh.md

@@ -0,0 +1,45 @@
+## kyverno-json completion zsh
+
+Generate the autocompletion script for zsh
+
+### Synopsis
+
+Generate the autocompletion script for the zsh shell.
+
+If shell completion is not already enabled in your environment you will need
+to enable it.  You can execute the following once:
+
+	echo "autoload -U compinit; compinit" >> ~/.zshrc
+
+To load completions in your current shell session:
+
+	source <(kyverno-json completion zsh)
+
+To load completions for every new session, execute once:
+
+#### Linux:
+
+	kyverno-json completion zsh > "${fpath[1]}/_kyverno-json"
+
+#### macOS:
+
+	kyverno-json completion zsh > $(brew --prefix)/share/zsh/site-functions/_kyverno-json
+
+You will need to start a new shell for this setup to take effect.
+
+
+```
+kyverno-json completion zsh [flags]
+```
+
+### Options
+
+```
+  -h, --help              help for zsh
+      --no-descriptions   disable completion descriptions
+```
+
+### SEE ALSO
+
+* [kyverno-json completion](kyverno-json_completion.md)	 - Generate the autocompletion script for the specified shell
+

docs/user/commands/kyverno-json_docs.md

@@ -0,0 +1,29 @@
+## kyverno-json docs
+
+Generates reference documentation.
+
+### Synopsis
+
+Generates reference documentation.
+
+  The docs command generates CLI reference documentation.
+
+  It can be used to generate simple markdown files or markdown to be used for the website.
+
+```
+kyverno-json docs [flags]
+```
+
+### Options
+
+```
+      --autogenTag      Determines if the generated docs should contain a timestamp (default true)
+  -h, --help            help for docs
+  -o, --output string   Output path (default ".")
+      --website         Website version
+```
+
+### SEE ALSO
+
+* [kyverno-json](kyverno-json.md)	 - kyverno-json
+

go.mod

@@ -86,6 +86,7 @@ require (
 	github.com/coreos/go-oidc/v3 v3.6.0 // indirect
 	github.com/coreos/go-semver v0.3.1 // indirect
 	github.com/coreos/go-systemd/v22 v22.5.0 // indirect
+	github.com/cpuguy83/go-md2man/v2 v2.0.2 // indirect
 	github.com/cyberphone/json-canonicalization v0.0.0-20230710064741-aa7fe85c7dbd // indirect
 	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
 	github.com/decred/dcrd/dcrec/secp256k1/v4 v4.2.0 // indirect
@@ -202,6 +203,7 @@ require (
 	github.com/puzpuzpuz/xsync/v2 v2.5.0 // indirect
 	github.com/r3labs/diff v1.1.0 // indirect
 	github.com/rcrowley/go-metrics v0.0.0-20201227073835-cf1acfcdf475 // indirect
+	github.com/russross/blackfriday/v2 v2.1.0 // indirect
 	github.com/sassoftware/relic v7.2.1+incompatible // indirect
 	github.com/secure-systems-lab/go-securesystemslib v0.7.0 // indirect
 	github.com/segmentio/asm v1.2.0 // indirect

go.sum

@@ -354,6 +354,7 @@ github.com/coreos/pkg v0.0.0-20180928190104-399ea9e2e55f/go.mod h1:E3G3o1h8I7cfc
 github.com/cpuguy83/go-md2man v1.0.10/go.mod h1:SmD6nW6nTyfqj6ABTjUi3V3JVMnlJmwcJI5acqYI6dE=
 github.com/cpuguy83/go-md2man/v2 v2.0.0-20190314233015-f79a8a8ca69d/go.mod h1:maD7wRr/U5Z6m/iR4s+kqSMx2CaBsrgA7czyZG/E6dU=
 github.com/cpuguy83/go-md2man/v2 v2.0.0/go.mod h1:maD7wRr/U5Z6m/iR4s+kqSMx2CaBsrgA7czyZG/E6dU=
+github.com/cpuguy83/go-md2man/v2 v2.0.2 h1:p1EgwI/C7NhT0JmVkwCD2ZBK8j4aeHQX2pMHHBfMQ6w=
 github.com/cpuguy83/go-md2man/v2 v2.0.2/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
 github.com/creack/pty v1.1.7/go.mod h1:lj5s0c3V2DBrqTV7llrYr5NG6My20zk30Fl46Y7DoTY=
 github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E=
@@ -1271,6 +1272,7 @@ github.com/rogpeppe/go-internal v1.10.0/go.mod h1:UQnix2H7Ngw/k4C5ijL5+65zddjncj
 github.com/rs/cors v1.7.0/go.mod h1:gFx+x8UowdsKA9AchylcLynDq+nNFfI8FkUZdN/jGCU=
 github.com/russross/blackfriday v1.5.2/go.mod h1:JO/DiYxRf+HjHt06OyowR9PTA263kcR/rfWxYHBV53g=
 github.com/russross/blackfriday/v2 v2.0.1/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
 github.com/ryancurrah/gomodguard v1.2.0/go.mod h1:rNqbC4TOIdUDcVMSIpNNAzTbzXAZa6W5lnUepvuMMgQ=
 github.com/ryanrolds/sqlclosecheck v0.3.0/go.mod h1:1gREqxyTGR3lVtpngyFo3hZAgk0KCtEdgEkHwDbigdA=

pkg/commands/docs/command.go

@@ -0,0 +1,35 @@
+package docs
+
+import (
+	"log"
+
+	"github.com/kyverno/kyverno/cmd/cli/kubectl-kyverno/command"
+	"github.com/spf13/cobra"
+)
+
+func Command(root *cobra.Command) *cobra.Command {
+	var options options
+	cmd := &cobra.Command{
+		Use:          "docs",
+		Short:        command.FormatDescription(true, websiteUrl, false, description...),
+		Long:         command.FormatDescription(false, websiteUrl, false, description...),
+		Args:         cobra.NoArgs,
+		SilenceUsage: true,
+		RunE: func(cmd *cobra.Command, _ []string) error {
+			if err := options.validate(root); err != nil {
+				return err
+			}
+			return options.execute(root)
+		},
+	}
+	cmd.Flags().StringVarP(&options.path, "output", "o", ".", "Output path")
+	cmd.Flags().BoolVar(&options.website, "website", false, "Website version")
+	cmd.Flags().BoolVar(&options.autogenTag, "autogenTag", true, "Determines if the generated docs should contain a timestamp")
+	if err := cmd.MarkFlagDirname("output"); err != nil {
+		log.Println("WARNING", err)
+	}
+	if err := cmd.MarkFlagRequired("output"); err != nil {
+		log.Println("WARNING", err)
+	}
+	return cmd
+}