Skip to content

Commit

Permalink
Merge pull request #9 from inteon/rename
Browse files Browse the repository at this point in the history
Rename helm-docgen to helm-tool
  • Loading branch information
jetstack-bot authored Jan 12, 2024
2 parents 7092aaa + 38277b5 commit 263fd66
Show file tree
Hide file tree
Showing 12 changed files with 32 additions and 30 deletions.
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ Helm Docgen generates documentation for Helm charts by reading the values.yaml f

## Usage

There are two commands that can be used to generate documentation, `helm-docgen render` and `helm-docgen inject`.
There are two commands that can be used to generate documentation, `helm-tool render` and `helm-tool inject`.

- `helm-docgen render` - The render command will simply render the markdown to the stdout
- `helm-docgen inject` - The inject command will inject the generated documentation into an existing markdown file, it will look for the `## Properties` header and inject the documentation between it and the next header. This can be useful for keeping a chart README up to date.
- `helm-tool render` - The render command will simply render the markdown to the stdout
- `helm-tool inject` - The inject command will inject the generated documentation into an existing markdown file, it will look for the `## Properties` header and inject the documentation between it and the next header. This can be useful for keeping a chart README up to date.

## Customising the output

Expand Down
2 changes: 1 addition & 1 deletion go.mod
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
module github.com/cert-manager/helm-docgen
module github.com/cert-manager/helm-tool

go 1.21

Expand Down
4 changes: 2 additions & 2 deletions linter/linter.go
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,8 @@ import (
"slices"
"strings"

"github.com/cert-manager/helm-docgen/linter/parsetemplates"
"github.com/cert-manager/helm-docgen/parser"
"github.com/cert-manager/helm-tool/linter/parsetemplates"
"github.com/cert-manager/helm-tool/parser"
)

func Lint(
Expand Down
2 changes: 1 addition & 1 deletion linter/parsetemplates/templates.go
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ import (
"text/template"
"text/template/parse"

"github.com/cert-manager/helm-docgen/linter/parsetemplates/funcs_serdes"
"github.com/cert-manager/helm-tool/linter/parsetemplates/funcs_serdes"
)

func ListTemplatePaths(templatesPath string) ([]string, error) {
Expand Down
4 changes: 2 additions & 2 deletions linter/parsetemplates/templates_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,8 @@ import (
"testing"
"text/template"

"github.com/cert-manager/helm-docgen/linter/parsetemplates"
"github.com/cert-manager/helm-docgen/linter/parsetemplates/funcs_serdes"
"github.com/cert-manager/helm-tool/linter/parsetemplates"
"github.com/cert-manager/helm-tool/linter/parsetemplates/funcs_serdes"
"github.com/stretchr/testify/require"
)

Expand Down
10 changes: 5 additions & 5 deletions main.go
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,10 @@ import (
"os"
"regexp"

"github.com/cert-manager/helm-docgen/linter"
"github.com/cert-manager/helm-docgen/parser"
"github.com/cert-manager/helm-docgen/render"
"github.com/cert-manager/helm-docgen/schema"
"github.com/cert-manager/helm-tool/linter"
"github.com/cert-manager/helm-tool/parser"
"github.com/cert-manager/helm-tool/render"
"github.com/cert-manager/helm-tool/schema"
"github.com/spf13/cobra"
)

Expand All @@ -39,7 +39,7 @@ var (
)

var Cmd = cobra.Command{
Use: "helm-docgen",
Use: "helm-tool",
}

var Render = cobra.Command{
Expand Down
16 changes: 8 additions & 8 deletions make/00_mod.mk
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,14 @@
# See the License for the specific language governing permissions and
# limitations under the License.

repo_name := github.com/cert-manager/helm-docgen
repo_name := github.com/cert-manager/helm-tool

build_names := helm-docgen
build_names := helm-tool

go_helm-docgen_source_path := main.go
go_helm-docgen_ldflags := -X $(repo_name)/internal/version.AppVersion=$(VERSION) -X $(repo_name)/internal/version.GitCommit=$(GITCOMMIT)
go_helm-tool_source_path := main.go
go_helm-tool_ldflags := -X $(repo_name)/internal/version.AppVersion=$(VERSION) -X $(repo_name)/internal/version.GitCommit=$(GITCOMMIT)

oci_helm-docgen_base_image_flavor := static
oci_helm-docgen_image_name := quay.io/jetstack/helm-docgen
oci_helm-docgen_image_tag := $(VERSION)
oci_helm-docgen_image_name_development := cert-manager.local/helm-docgen
oci_helm-tool_base_image_flavor := static
oci_helm-tool_image_name := quay.io/jetstack/helm-tool
oci_helm-tool_image_tag := $(VERSION)
oci_helm-tool_image_name_development := cert-manager.local/helm-tool
6 changes: 4 additions & 2 deletions make/test-unit.mk
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,11 @@
## @category Testing
test-unit: | $(NEEDS_GO) $(NEEDS_GOTESTSUM) $(ARTIFACTS)
$(GOTESTSUM) \
--junitfile=$(ARTIFACTS)/junit-go-e2e.xml \
-- \
-coverprofile=$(ARTIFACTS)/filtered.cov \
./... \
-- \
-ldflags $(go_manager_ldflags) \
-coverprofile cover.out
-ldflags $(go_manager_ldflags)

$(GO) tool cover -html=$(ARTIFACTS)/filtered.cov -o=$(ARTIFACTS)/filtered.html
2 changes: 1 addition & 1 deletion parser/comment.go
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ limitations under the License.

package parser

import "github.com/cert-manager/helm-docgen/heuristics"
import "github.com/cert-manager/helm-tool/heuristics"

type Comment struct {
heuristics.CommentBlock
Expand Down
4 changes: 2 additions & 2 deletions parser/document.go
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,8 @@ import (
"os"
"strings"

"github.com/cert-manager/helm-docgen/heuristics"
"github.com/cert-manager/helm-docgen/paths"
"github.com/cert-manager/helm-tool/heuristics"
"github.com/cert-manager/helm-tool/paths"
"gopkg.in/yaml.v3"
)

Expand Down
2 changes: 1 addition & 1 deletion render/render.go
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ import (
"strings"
"text/template"

"github.com/cert-manager/helm-docgen/parser"
"github.com/cert-manager/helm-tool/parser"
)

//go:embed markdown-table
Expand Down
4 changes: 2 additions & 2 deletions schema/render.go
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,8 @@ import (
"encoding/json"
"fmt"

"github.com/cert-manager/helm-docgen/parser"
"github.com/cert-manager/helm-docgen/paths"
"github.com/cert-manager/helm-tool/parser"
"github.com/cert-manager/helm-tool/paths"
"gopkg.in/yaml.v3"
"k8s.io/kube-openapi/pkg/validation/spec"
)
Expand Down

0 comments on commit 263fd66

Please sign in to comment.