diff --git a/generate/config.go b/generate/config.go index 7b98d2ac..3881c976 100644 --- a/generate/config.go +++ b/generate/config.go @@ -102,12 +102,16 @@ func (c *Config) ValidateAndFillDefaults(baseDir string) error { if c.Package == "" { abs, err := filepath.Abs(c.Generated) if err != nil { - return errorf(nil, "unable to guess package-name: %v", err) + return errorf(nil, "unable to guess package-name: %v is not a valid identifier"+ + "\nSet package name in genqlient.yaml"+ + "\nExample: https://github.com/Khan/genqlient/blob/main/example/genqlient.yaml#L6", err) } base := filepath.Base(filepath.Dir(abs)) if !token.IsIdentifier(base) { - return errorf(nil, "unable to guess package-name: %v is not a valid identifier", base) + return errorf(nil, "unable to guess package-name: %v is not a valid identifier"+ + "\nSet package name in genqlient.yaml"+ + "\nExample: https://github.com/Khan/genqlient/blob/main/example/genqlient.yaml#L6", base) } c.Package = base diff --git a/generate/convert.go b/generate/convert.go index 8073ae50..caf3754f 100644 --- a/generate/convert.go +++ b/generate/convert.go @@ -524,7 +524,8 @@ func (g *generator) convertDefinition( // (If you had an entry in bindings, we would have returned it above.) return nil, errorf( - pos, `unknown scalar %v: please add it to "bindings" in genqlient.yaml`, def.Name) + pos, "unknown scalar %v: please add it to \"bindings\" in genqlient.yaml"+ + "\nExample: https://github.com/Khan/genqlient/blob/main/example/genqlient.yaml#L12", def.Name) default: return nil, errorf(pos, "unexpected kind: %v", def.Kind) } diff --git a/generate/testdata/snapshots/TestGenerateErrors-UnknownScalar-go b/generate/testdata/snapshots/TestGenerateErrors-UnknownScalar-go index 3c698d27..ec3378e0 100644 --- a/generate/testdata/snapshots/TestGenerateErrors-UnknownScalar-go +++ b/generate/testdata/snapshots/TestGenerateErrors-UnknownScalar-go @@ -1 +1,2 @@ testdata/errors/UnknownScalar.schema.graphql:3: unknown scalar UnknownScalar: please add it to "bindings" in genqlient.yaml +Example: https://github.com/Khan/genqlient/blob/main/example/genqlient.yaml#L12 diff --git a/generate/testdata/snapshots/TestGenerateErrors-UnknownScalar-graphql b/generate/testdata/snapshots/TestGenerateErrors-UnknownScalar-graphql index 3c698d27..ec3378e0 100644 --- a/generate/testdata/snapshots/TestGenerateErrors-UnknownScalar-graphql +++ b/generate/testdata/snapshots/TestGenerateErrors-UnknownScalar-graphql @@ -1 +1,2 @@ testdata/errors/UnknownScalar.schema.graphql:3: unknown scalar UnknownScalar: please add it to "bindings" in genqlient.yaml +Example: https://github.com/Khan/genqlient/blob/main/example/genqlient.yaml#L12