## Summary:
There were a few bugs here, one of which Craig came across when pulling
the custom-unmarshaler change into webapp:
1. If you have an optional field with a custom unmarshaler, and the
server omits the field from the response entirely (i.e. does not
write `"myField": null`), we would still call your unmarshaler with
an input of `[]byte(nil)`. This is just wrong; it's our job to do
the nil-check. (This is the one Craig found; in practice gqlgen
servers do not do this and I think the spec says not to although it's
a bit fuzzy on the matter of serialization. But in practice we have
mocks that do it -- for required fields even! -- and it seems better
to handle it than pass you data on which you'll probably err or even
panic.)
2. If you have an optional field with a custom unmarshaler, and the
server returns an explicit null (i.e. `"myField": null`), we would
call your unmarshaler with `[]byte("null")`. In principle the intent
was you're supposed to implement that, as [`json.Unmarshaler`
advises][1]. But (a) I forgot to document that, and (b) in practice
`json.Unmarshal` [does *not* call you in that case][2], i.e. its
advice is unnecessary. So I think it's better for us to just match
it, and not call you. (And in that case I see no reason to bother
documenting the advice.)
3. If you have an optional, `pointer: true` field with a custom
marshaler, the reverse of (2) applies: if the pointer is nil, we
shouldn't really call you. (Indeed if you were a real
`json.Marshaler` with a value-method rather than a pointer-method,
trying to call you might panic!) Note we don't need to explicitly
write "null"; we just leave the `json.RawMessage` as nil, and
`json.Marshal` [handles that][3].
4. We handle interface types effectively the same as custom
unmarshalers, just we generate the unmarshaler. So if you have an
optional field with interface type, (1) would also apply there; our
generated unmarshaler returns an error in this case.
5. While (2) doesn't apply to such optional interface fields (because we
do the customary `if string(b) == "null"` check -- this I at least
thought to test), if you set `pointer: true` on the field, we would
still call the unmarshaler on the value, and it would no-op, but only
*after* we initialized the pointer. Put more simply, we'd return a
non-nil pointer to nil interface, rather than a nil pointer; this is
wrong since the whole point of `pointer: true` is you only get a
non-nil pointer if your value is nil! Of course, in practice there's
little reason to use `pointer: true` on interface fields, and indeed
this stuff gets so confusing my test was even wrong.
In this commit I fix all the bugs, by adding appropriate nil-checks to
wrap the unmarshaler-calls. The templates are, as always, a bit
confusing, but the generated code makes it clear what changed.
Note we'll want to land this before cutting a release with custom
marshaler/unmarshaler support, because the first three bugs are
potentially quite noticeable. (The latter two are in `v0.1.0`, but
presumably quite rare.)
[1]: https://pkg.go.dev/encoding/json#Unmarshaler
[2]: https://play.golang.org/p/Pw6zNN8trGO
[3]: https://play.golang.org/p/crTfnT7ePte
Issue: https://phabricator.khanacademy.org/D74453#inline-558571
## Test plan:
make tesc
Author: benjaminjkraft
Reviewers: csilvers, StevenACoffman, benjaminjkraft, aberkan, dnerdy, jvoll, mahtabsabet, MiguelCastillo
Required Reviewers:
Approved By: csilvers, StevenACoffman
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/116
378 lines
14 KiB
Go
378 lines
14 KiB
Go
package test
|
|
|
|
// Code generated by github.com/Khan/genqlient, DO NOT EDIT.
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
|
|
"github.com/Khan/genqlient/graphql"
|
|
"github.com/Khan/genqlient/internal/testutil"
|
|
)
|
|
|
|
// InterfaceListOfListOfListsFieldListOfListsOfListsOfContent includes the requested fields of the GraphQL interface Content.
|
|
//
|
|
// InterfaceListOfListOfListsFieldListOfListsOfListsOfContent is implemented by the following types:
|
|
// InterfaceListOfListOfListsFieldListOfListsOfListsOfContentArticle
|
|
// InterfaceListOfListOfListsFieldListOfListsOfListsOfContentVideo
|
|
// InterfaceListOfListOfListsFieldListOfListsOfListsOfContentTopic
|
|
// The GraphQL type's documentation follows.
|
|
//
|
|
// Content is implemented by various types like Article, Video, and Topic.
|
|
type InterfaceListOfListOfListsFieldListOfListsOfListsOfContent interface {
|
|
implementsGraphQLInterfaceInterfaceListOfListOfListsFieldListOfListsOfListsOfContent()
|
|
// GetTypename returns the receiver's concrete GraphQL type-name (see interface doc for possible values).
|
|
GetTypename() string
|
|
// GetId returns the interface-field "id" from its implementation.
|
|
// The GraphQL interface field's documentation follows.
|
|
//
|
|
// ID is the identifier of the content.
|
|
GetId() testutil.ID
|
|
// GetName returns the interface-field "name" from its implementation.
|
|
GetName() string
|
|
}
|
|
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentArticle) implementsGraphQLInterfaceInterfaceListOfListOfListsFieldListOfListsOfListsOfContent() {
|
|
}
|
|
|
|
// GetTypename is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentArticle) GetTypename() string {
|
|
return v.Typename
|
|
}
|
|
|
|
// GetId is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentArticle) GetId() testutil.ID {
|
|
return v.Id
|
|
}
|
|
|
|
// GetName is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentArticle) GetName() string {
|
|
return v.Name
|
|
}
|
|
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentVideo) implementsGraphQLInterfaceInterfaceListOfListOfListsFieldListOfListsOfListsOfContent() {
|
|
}
|
|
|
|
// GetTypename is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentVideo) GetTypename() string {
|
|
return v.Typename
|
|
}
|
|
|
|
// GetId is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentVideo) GetId() testutil.ID {
|
|
return v.Id
|
|
}
|
|
|
|
// GetName is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentVideo) GetName() string {
|
|
return v.Name
|
|
}
|
|
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentTopic) implementsGraphQLInterfaceInterfaceListOfListOfListsFieldListOfListsOfListsOfContent() {
|
|
}
|
|
|
|
// GetTypename is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentTopic) GetTypename() string {
|
|
return v.Typename
|
|
}
|
|
|
|
// GetId is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentTopic) GetId() testutil.ID {
|
|
return v.Id
|
|
}
|
|
|
|
// GetName is a part of, and documented with, the interface InterfaceListOfListOfListsFieldListOfListsOfListsOfContent.
|
|
func (v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContentTopic) GetName() string {
|
|
return v.Name
|
|
}
|
|
|
|
func __unmarshalInterfaceListOfListOfListsFieldListOfListsOfListsOfContent(b []byte, v *InterfaceListOfListOfListsFieldListOfListsOfListsOfContent) error {
|
|
if string(b) == "null" {
|
|
return nil
|
|
}
|
|
|
|
var tn struct {
|
|
TypeName string `json:"__typename"`
|
|
}
|
|
err := json.Unmarshal(b, &tn)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
switch tn.TypeName {
|
|
case "Article":
|
|
*v = new(InterfaceListOfListOfListsFieldListOfListsOfListsOfContentArticle)
|
|
return json.Unmarshal(b, *v)
|
|
case "Video":
|
|
*v = new(InterfaceListOfListOfListsFieldListOfListsOfListsOfContentVideo)
|
|
return json.Unmarshal(b, *v)
|
|
case "Topic":
|
|
*v = new(InterfaceListOfListOfListsFieldListOfListsOfListsOfContentTopic)
|
|
return json.Unmarshal(b, *v)
|
|
case "":
|
|
return fmt.Errorf(
|
|
"Response was missing Content.__typename")
|
|
default:
|
|
return fmt.Errorf(
|
|
`Unexpected concrete type for InterfaceListOfListOfListsFieldListOfListsOfListsOfContent: "%v"`, tn.TypeName)
|
|
}
|
|
}
|
|
|
|
// InterfaceListOfListOfListsFieldListOfListsOfListsOfContentArticle includes the requested fields of the GraphQL type Article.
|
|
type InterfaceListOfListOfListsFieldListOfListsOfListsOfContentArticle struct {
|
|
Typename string `json:"__typename"`
|
|
// ID is the identifier of the content.
|
|
Id testutil.ID `json:"id"`
|
|
Name string `json:"name"`
|
|
}
|
|
|
|
// InterfaceListOfListOfListsFieldListOfListsOfListsOfContentTopic includes the requested fields of the GraphQL type Topic.
|
|
type InterfaceListOfListOfListsFieldListOfListsOfListsOfContentTopic struct {
|
|
Typename string `json:"__typename"`
|
|
// ID is the identifier of the content.
|
|
Id testutil.ID `json:"id"`
|
|
Name string `json:"name"`
|
|
}
|
|
|
|
// InterfaceListOfListOfListsFieldListOfListsOfListsOfContentVideo includes the requested fields of the GraphQL type Video.
|
|
type InterfaceListOfListOfListsFieldListOfListsOfListsOfContentVideo struct {
|
|
Typename string `json:"__typename"`
|
|
// ID is the identifier of the content.
|
|
Id testutil.ID `json:"id"`
|
|
Name string `json:"name"`
|
|
}
|
|
|
|
// InterfaceListOfListOfListsFieldResponse is returned by InterfaceListOfListOfListsField on success.
|
|
type InterfaceListOfListOfListsFieldResponse struct {
|
|
ListOfListsOfListsOfContent [][][]InterfaceListOfListOfListsFieldListOfListsOfListsOfContent `json:"-"`
|
|
WithPointer [][][]*InterfaceListOfListOfListsFieldWithPointerContent `json:"-"`
|
|
}
|
|
|
|
func (v *InterfaceListOfListOfListsFieldResponse) UnmarshalJSON(b []byte) error {
|
|
|
|
if string(b) == "null" {
|
|
return nil
|
|
}
|
|
|
|
var firstPass struct {
|
|
*InterfaceListOfListOfListsFieldResponse
|
|
ListOfListsOfListsOfContent [][][]json.RawMessage `json:"listOfListsOfListsOfContent"`
|
|
WithPointer [][][]json.RawMessage `json:"withPointer"`
|
|
graphql.NoUnmarshalJSON
|
|
}
|
|
firstPass.InterfaceListOfListOfListsFieldResponse = v
|
|
|
|
err := json.Unmarshal(b, &firstPass)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
{
|
|
dst := &v.ListOfListsOfListsOfContent
|
|
src := firstPass.ListOfListsOfListsOfContent
|
|
*dst = make(
|
|
[][][]InterfaceListOfListOfListsFieldListOfListsOfListsOfContent,
|
|
len(src))
|
|
for i, src := range src {
|
|
dst := &(*dst)[i]
|
|
*dst = make(
|
|
[][]InterfaceListOfListOfListsFieldListOfListsOfListsOfContent,
|
|
len(src))
|
|
for i, src := range src {
|
|
dst := &(*dst)[i]
|
|
*dst = make(
|
|
[]InterfaceListOfListOfListsFieldListOfListsOfListsOfContent,
|
|
len(src))
|
|
for i, src := range src {
|
|
dst := &(*dst)[i]
|
|
if len(src) != 0 && string(src) != "null" {
|
|
err = __unmarshalInterfaceListOfListOfListsFieldListOfListsOfListsOfContent(
|
|
src, dst)
|
|
if err != nil {
|
|
return fmt.Errorf(
|
|
"Unable to unmarshal InterfaceListOfListOfListsFieldResponse.ListOfListsOfListsOfContent: %w", err)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
{
|
|
dst := &v.WithPointer
|
|
src := firstPass.WithPointer
|
|
*dst = make(
|
|
[][][]*InterfaceListOfListOfListsFieldWithPointerContent,
|
|
len(src))
|
|
for i, src := range src {
|
|
dst := &(*dst)[i]
|
|
*dst = make(
|
|
[][]*InterfaceListOfListOfListsFieldWithPointerContent,
|
|
len(src))
|
|
for i, src := range src {
|
|
dst := &(*dst)[i]
|
|
*dst = make(
|
|
[]*InterfaceListOfListOfListsFieldWithPointerContent,
|
|
len(src))
|
|
for i, src := range src {
|
|
dst := &(*dst)[i]
|
|
if len(src) != 0 && string(src) != "null" {
|
|
*dst = new(InterfaceListOfListOfListsFieldWithPointerContent)
|
|
err = __unmarshalInterfaceListOfListOfListsFieldWithPointerContent(
|
|
src, *dst)
|
|
if err != nil {
|
|
return fmt.Errorf(
|
|
"Unable to unmarshal InterfaceListOfListOfListsFieldResponse.WithPointer: %w", err)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// InterfaceListOfListOfListsFieldWithPointerArticle includes the requested fields of the GraphQL type Article.
|
|
type InterfaceListOfListOfListsFieldWithPointerArticle struct {
|
|
Typename string `json:"__typename"`
|
|
// ID is the identifier of the content.
|
|
Id *testutil.ID `json:"id"`
|
|
Name *string `json:"name"`
|
|
}
|
|
|
|
// InterfaceListOfListOfListsFieldWithPointerContent includes the requested fields of the GraphQL interface Content.
|
|
//
|
|
// InterfaceListOfListOfListsFieldWithPointerContent is implemented by the following types:
|
|
// InterfaceListOfListOfListsFieldWithPointerArticle
|
|
// InterfaceListOfListOfListsFieldWithPointerVideo
|
|
// InterfaceListOfListOfListsFieldWithPointerTopic
|
|
// The GraphQL type's documentation follows.
|
|
//
|
|
// Content is implemented by various types like Article, Video, and Topic.
|
|
type InterfaceListOfListOfListsFieldWithPointerContent interface {
|
|
implementsGraphQLInterfaceInterfaceListOfListOfListsFieldWithPointerContent()
|
|
// GetTypename returns the receiver's concrete GraphQL type-name (see interface doc for possible values).
|
|
GetTypename() string
|
|
// GetId returns the interface-field "id" from its implementation.
|
|
// The GraphQL interface field's documentation follows.
|
|
//
|
|
// ID is the identifier of the content.
|
|
GetId() *testutil.ID
|
|
// GetName returns the interface-field "name" from its implementation.
|
|
GetName() *string
|
|
}
|
|
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerArticle) implementsGraphQLInterfaceInterfaceListOfListOfListsFieldWithPointerContent() {
|
|
}
|
|
|
|
// GetTypename is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerArticle) GetTypename() string { return v.Typename }
|
|
|
|
// GetId is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerArticle) GetId() *testutil.ID { return v.Id }
|
|
|
|
// GetName is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerArticle) GetName() *string { return v.Name }
|
|
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerVideo) implementsGraphQLInterfaceInterfaceListOfListOfListsFieldWithPointerContent() {
|
|
}
|
|
|
|
// GetTypename is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerVideo) GetTypename() string { return v.Typename }
|
|
|
|
// GetId is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerVideo) GetId() *testutil.ID { return v.Id }
|
|
|
|
// GetName is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerVideo) GetName() *string { return v.Name }
|
|
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerTopic) implementsGraphQLInterfaceInterfaceListOfListOfListsFieldWithPointerContent() {
|
|
}
|
|
|
|
// GetTypename is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerTopic) GetTypename() string { return v.Typename }
|
|
|
|
// GetId is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerTopic) GetId() *testutil.ID { return v.Id }
|
|
|
|
// GetName is a part of, and documented with, the interface InterfaceListOfListOfListsFieldWithPointerContent.
|
|
func (v *InterfaceListOfListOfListsFieldWithPointerTopic) GetName() *string { return v.Name }
|
|
|
|
func __unmarshalInterfaceListOfListOfListsFieldWithPointerContent(b []byte, v *InterfaceListOfListOfListsFieldWithPointerContent) error {
|
|
if string(b) == "null" {
|
|
return nil
|
|
}
|
|
|
|
var tn struct {
|
|
TypeName string `json:"__typename"`
|
|
}
|
|
err := json.Unmarshal(b, &tn)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
switch tn.TypeName {
|
|
case "Article":
|
|
*v = new(InterfaceListOfListOfListsFieldWithPointerArticle)
|
|
return json.Unmarshal(b, *v)
|
|
case "Video":
|
|
*v = new(InterfaceListOfListOfListsFieldWithPointerVideo)
|
|
return json.Unmarshal(b, *v)
|
|
case "Topic":
|
|
*v = new(InterfaceListOfListOfListsFieldWithPointerTopic)
|
|
return json.Unmarshal(b, *v)
|
|
case "":
|
|
return fmt.Errorf(
|
|
"Response was missing Content.__typename")
|
|
default:
|
|
return fmt.Errorf(
|
|
`Unexpected concrete type for InterfaceListOfListOfListsFieldWithPointerContent: "%v"`, tn.TypeName)
|
|
}
|
|
}
|
|
|
|
// InterfaceListOfListOfListsFieldWithPointerTopic includes the requested fields of the GraphQL type Topic.
|
|
type InterfaceListOfListOfListsFieldWithPointerTopic struct {
|
|
Typename string `json:"__typename"`
|
|
// ID is the identifier of the content.
|
|
Id *testutil.ID `json:"id"`
|
|
Name *string `json:"name"`
|
|
}
|
|
|
|
// InterfaceListOfListOfListsFieldWithPointerVideo includes the requested fields of the GraphQL type Video.
|
|
type InterfaceListOfListOfListsFieldWithPointerVideo struct {
|
|
Typename string `json:"__typename"`
|
|
// ID is the identifier of the content.
|
|
Id *testutil.ID `json:"id"`
|
|
Name *string `json:"name"`
|
|
}
|
|
|
|
func InterfaceListOfListOfListsField(
|
|
client graphql.Client,
|
|
) (*InterfaceListOfListOfListsFieldResponse, error) {
|
|
var err error
|
|
|
|
var retval InterfaceListOfListOfListsFieldResponse
|
|
err = client.MakeRequest(
|
|
nil,
|
|
"InterfaceListOfListOfListsField",
|
|
`
|
|
query InterfaceListOfListOfListsField {
|
|
listOfListsOfListsOfContent {
|
|
__typename
|
|
id
|
|
name
|
|
}
|
|
withPointer: listOfListsOfListsOfContent {
|
|
__typename
|
|
id
|
|
name
|
|
}
|
|
}
|
|
`,
|
|
&retval,
|
|
nil,
|
|
)
|
|
return &retval, err
|
|
}
|
|
|