Can not generate projects that uses go module

[ahmetb]

Can not generate projects that uses go module

[StrongMonkey]

FYI, I fixed this issue by specifying the full package name in the command line.

For example,:
$ refdocs -config ./docs/doc-config.json -api-dir "github.com/rancher/gitjob/pkg/apis/gitjob.cattle.io/v1" -out-file ./api-docs.md --template-dir ./docs

I think this is how k8s.io gengo and go package works, you have to put into a path that is being imported somewhere.

[zhenghuiwang]

I tried to generate docs for Kubeflow Notebook Controller, but failed because it uses go module with replace statement. Tried the above work around, but it doesn't work in this case:

go.mod is

https://github.com/kubeflow/kubeflow/blob/master/components/notebook-controller/go.mod

gen-crd-api-reference-docs master !1 ?1 ❯ ./gen-crd-api-reference-docs -config="example-config.json" -api-dir="github.com/kubeflow/kubeflow/components/notebook-controller/api/v1beta1" -out-file=doc.html
I0113 16:14:07.681060   13420 main.go:127] parsing go packages in directory github.com/kubeflow/kubeflow/components/notebook-controller/api/v1beta1
W0113 16:14:08.137690   13420 parse.go:224] Ignoring directory github.com/kubeflow/kubeflow/components/notebook-controller/api/v1beta1: unable to import "github.com/kubeflow/kubeflow/components/notebook-controller/api/v1beta1": go/build: importGo github.com/kubeflow/kubeflow/components/notebook-controller/api/v1beta1: exit status 1
go: finding github.com/kubeflow/kubeflow/components/notebook-controller latest
go: github.com/kubeflow/kubeflow/components/[email protected] requires
	github.com/kubeflow/kubeflow/components/[email protected]: reading https://proxy.golang.org/github.com/kubeflow/kubeflow/components/common/@v/v0.0.0-00010101000000-000000000000.mod: 410 Gone

panic: runtime error: invalid memory address or nil pointer dereference
[signal SIGSEGV: segmentation violation code=0x1 addr=0x8 pc=0x1422a65]

goroutine 1 [running]:
k8s.io/gengo/parser.(*Builder).AddDirRecursive(0xc0001cc000, 0x7ffeefbff802, 0x47, 0x94, 0xe8)
	/Users/zhenghui/go/pkg/mod/k8s.io/[email protected]/parser/parse.go:229 +0xb5
main.parseAPIPackages(0x7ffeefbff802, 0x47, 0x15427cf, 0x23, 0xc000171f10, 0x1, 0x1)
	/Users/zhenghui/github.com/ahmetb/gen-crd-api-reference-docs/main.go:201 +0x60
main.main()
	/Users/zhenghui/github.com/ahmetb/gen-crd-api-reference-docs/main.go:128 +0x2ca

[munnerz]

To work around this, we construct a 'fake gopath' using go mod vendor in cert-manager: https://github.com/cert-manager/website/blob/172648ac48c09c2004b5ba3049346c84b5462722/scripts/gendocs/generate

It'd be great to skip this step 😄

[StrongMonkey]

Yeah, end up with the same hack...

[ahmetb]

Sorry for the silence here, turns out I wasn't watching the repo. /facepalm

Yes, your $PWD has to be within the go module, and you should use the Go module path as the package name (I think). Nothing we can fix here. That's how gengo works.

[delthas]

Using the full import path also works on my end. This issue can be closed.