Ben KraftandGitHub
dc38360d9d
## Summary: Steve pointed out (#73) that having genqlient with no arguments silently use a default config file was a bit confusing, and changed it to use `genqlient.yaml` by default (#74). Mark pointed out (#76) that this makes it a bit less convenient when you're starting from scratch; you have to go create a config file. In this commit I add a new init flag that creates you a config file before using it. Originally the suggestion was to use subcommands, e.g. we'd have `genqlient init` and `genqlient generate` and so on. But I couldn't think of anything else we might want subcommands for in the future, and it felt a little silly to make you type `generate` each time. So instead, I made it a flag, which has the nice property that you can do `genqlient --init` and it will generate and then use a config file. (I mean, maybe it will immediately crash because you don't have a schema, but hopefully that's still a useful clue as to what to do next!) The implmentation was fairly trivial. Since we now have a nice way to generate a default config, I removed the default values for most of the options; I've always felt they were probably more confusing than helpful. (And indeed, all the users I know of (Khan/webapp, and the much smaller project Steve was working on, are setting those options explicitly.) This required a slight change to the syntax to say "don't use context", which is probably also net clearer. I decided this is also a good time to pull in a proper CLI parser (#31); see ADR-504 for more on that choice. This also adds some nice help messages! Fixes #76, #31. Issue: https://github.com/Khan/genqlient/issues/76 ## Test plan: ``` go run . go run . --init go run . --init example/genqlient.yaml # refuses to clobber go run . --init example/newgenqlient.yaml ``` Author: benjaminjkraft Reviewers: dnerdy, aberkan, MiguelCastillo, StevenACoffman Required Reviewers: Approved By: dnerdy Checks: ✅ Test (1.17), ✅ Test (1.16), ✅ Test (1.15), ✅ Test (1.14), ✅ Lint, ✅ Test (1.17), ✅ Test (1.16), ✅ Test (1.15), ✅ Test (1.14), ✅ Lint Pull Request URL: https://github.com/Khan/genqlient/pull/81
67 lines
1.7 KiB
Cheetah
67 lines
1.7 KiB
Cheetah
package {{.Config.Package}}
|
|
|
|
// Code generated by github.com/Khan/genqlient, DO NOT EDIT.
|
|
|
|
{{.Imports}}
|
|
|
|
{{/* TODO: type-assert that your ctx type implements context.Context */}}
|
|
|
|
{{.Types}}
|
|
|
|
{{range .Operations}}
|
|
{{.Doc}}
|
|
func {{.Name}}(
|
|
{{if ne $.Config.ContextType "-" -}}
|
|
ctx {{ref $.Config.ContextType}},
|
|
{{end}}
|
|
{{- if not $.Config.ClientGetter -}}
|
|
client {{ref "github.com/Khan/genqlient/graphql.Client"}},
|
|
{{end}}
|
|
{{- range .Args -}}
|
|
{{.GoName}} {{.GoType}},
|
|
{{end -}}
|
|
) (*{{.ResponseName}}, error) {
|
|
{{- if .Args -}}
|
|
variables := map[string]interface{}{
|
|
{{range .Args -}}
|
|
{{if not .Options.GetOmitempty -}}
|
|
"{{.GraphQLName}}": {{.GoName}},
|
|
{{end -}}
|
|
{{end}}
|
|
}
|
|
{{range .Args -}}
|
|
{{if .Options.GetOmitempty -}}
|
|
{{if .IsSlice -}}
|
|
if len({{.GoName}}) > 0 {
|
|
{{else -}}
|
|
{{/* zero_{{.GoType}} would be a better name, but {{.GoType}} would require
|
|
munging since it might be, say, `time.Time`. */}}
|
|
var zero_{{.GoName}} {{.GoType}}
|
|
if {{.GoName}} != zero_{{.GoName}} {
|
|
{{end -}}
|
|
variables["{{.GraphQLName}}"] = {{.GoName}}
|
|
}
|
|
{{end}}
|
|
{{end}}
|
|
{{end -}}
|
|
|
|
var err error
|
|
{{if $.Config.ClientGetter -}}
|
|
client, err := {{ref $.Config.ClientGetter}}({{if ne $.Config.ContextType "-"}}ctx{{else}}{{end}})
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
{{end}}
|
|
|
|
var retval {{.ResponseName}}
|
|
err = client.MakeRequest(
|
|
{{if ne $.Config.ContextType "-"}}ctx{{else}}nil{{end}},
|
|
"{{.Name}}",
|
|
`{{.Body}}`,
|
|
&retval,
|
|
{{if .Args}}variables{{else}}nil{{end}},
|
|
)
|
|
return &retval, err
|
|
}
|
|
{{end}}
|