## Summary: When genqlient generates output types, it generates whatever code is necessary to unmarshal them. Conversely, when it generates input types, it generates whatever code is necessary to marshal. This is all that's needed for genqlient itself: it never needs to marshal output types or unmarshal input types. But maybe you do! (For example, to put the responses in a cache, which is the use case that @csilvers hit at Khan, although there are others one can imagine.) While we can't support every serialization format you might want (at least not without adding plugins or some such), it's not unreasonable to expect that since genqlient can read JSON, it can write it too. Sadly, in the past this was not true for types requiring custom unmarshaling logic, for several reasons. In this commit I implement logic to always write both marshalers and unmarshalers whenever they're needed to be able to correctly round-trip the types, even though genqlient doesn't do so. I wasn't starting from scratch, since of course we already write both marshalers and unmarshalers in some cases. But this ended up requiring surprisingly large changes on the marshaling side, mostly to correctly support embedding (which we use for named fragments). Specifically, as the comments in `types.go` discuss, the most difficult issue is spreads with duplicate fields, which translate to Go embedded fields which end up hidden from the json-marshaler. Ultimately, I had to do things quite differently from unmarshaling, and essentially flatten the type when we write marshaler. But in the end it's not so ugly -- indeed arguably it's cleaner! Mainly it's just different. One thing to note is that we do marshal `__typename` based on what we know about the types; users need not fill it in (and if they do we'll ignore it). This seemed to me to be a better UX, and didn't add much complexity. In general, I begin to wonder whether using `encoding/json` at all is really right for genqlient: we're doing a lot of work to appease it, despite knowing what our types look like. I think it would still be a significant increase in lines of code to roll our own, but that code would perhaps be simpler, and would surely be faster (although if we just want the speed gains we could use another JSON-generator library, see also #47). Anyway, something to think about in the future. ## Test plan: make tesc Author: benjaminjkraft Reviewers: csilvers, StevenACoffman, benjaminjkraft, dnerdy, aberkan, jvoll, mahtabsabet, MiguelCastillo Required Reviewers: Approved By: StevenACoffman, 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/120
297 lines
6.9 KiB
Go
297 lines
6.9 KiB
Go
package test
|
|
|
|
// Code generated by github.com/Khan/genqlient, DO NOT EDIT.
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
"time"
|
|
|
|
"github.com/Khan/genqlient/graphql"
|
|
"github.com/Khan/genqlient/internal/testutil"
|
|
)
|
|
|
|
// UserQueryInput is the argument to Query.users.
|
|
//
|
|
// Ideally this would support anything and everything!
|
|
// Or maybe ideally it wouldn't.
|
|
// Really I'm just talking to make this documentation longer.
|
|
type MyInput struct {
|
|
Email *string `json:"email"`
|
|
Name *string `json:"name"`
|
|
// id looks the user up by ID. It's a great way to look up users.
|
|
Id *testutil.ID `json:"id"`
|
|
Role *Role `json:"role"`
|
|
Names []*string `json:"names"`
|
|
HasPokemon *testutil.Pokemon `json:"hasPokemon"`
|
|
Birthdate *time.Time `json:"-"`
|
|
}
|
|
|
|
func (v *MyInput) UnmarshalJSON(b []byte) error {
|
|
|
|
if string(b) == "null" {
|
|
return nil
|
|
}
|
|
|
|
var firstPass struct {
|
|
*MyInput
|
|
Birthdate json.RawMessage `json:"birthdate"`
|
|
graphql.NoUnmarshalJSON
|
|
}
|
|
firstPass.MyInput = v
|
|
|
|
err := json.Unmarshal(b, &firstPass)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
{
|
|
dst := &v.Birthdate
|
|
src := firstPass.Birthdate
|
|
if len(src) != 0 && string(src) != "null" {
|
|
*dst = new(time.Time)
|
|
err = testutil.UnmarshalDate(
|
|
src, *dst)
|
|
if err != nil {
|
|
return fmt.Errorf(
|
|
"Unable to unmarshal MyInput.Birthdate: %w", err)
|
|
}
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
type __premarshalMyInput struct {
|
|
Email *string `json:"email"`
|
|
|
|
Name *string `json:"name"`
|
|
|
|
Id *testutil.ID `json:"id"`
|
|
|
|
Role *Role `json:"role"`
|
|
|
|
Names []*string `json:"names"`
|
|
|
|
HasPokemon *testutil.Pokemon `json:"hasPokemon"`
|
|
|
|
Birthdate json.RawMessage `json:"birthdate"`
|
|
}
|
|
|
|
func (v *MyInput) MarshalJSON() ([]byte, error) {
|
|
premarshaled, err := v.__premarshalJSON()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return json.Marshal(premarshaled)
|
|
}
|
|
|
|
func (v *MyInput) __premarshalJSON() (*__premarshalMyInput, error) {
|
|
var retval __premarshalMyInput
|
|
|
|
retval.Email = v.Email
|
|
retval.Name = v.Name
|
|
retval.Id = v.Id
|
|
retval.Role = v.Role
|
|
retval.Names = v.Names
|
|
retval.HasPokemon = v.HasPokemon
|
|
{
|
|
|
|
dst := &retval.Birthdate
|
|
src := v.Birthdate
|
|
if src != nil {
|
|
var err error
|
|
*dst, err = testutil.MarshalDate(
|
|
src)
|
|
if err != nil {
|
|
return nil, fmt.Errorf(
|
|
"Unable to marshal MyInput.Birthdate: %w", err)
|
|
}
|
|
}
|
|
}
|
|
return &retval, nil
|
|
}
|
|
|
|
// MyMultipleDirectivesResponse is returned by MultipleDirectives on success.
|
|
type MyMultipleDirectivesResponse struct {
|
|
// user looks up a user by some stuff.
|
|
//
|
|
// See UserQueryInput for what stuff is supported.
|
|
// If query is null, returns the current user.
|
|
User *MyMultipleDirectivesResponseUser `json:"user"`
|
|
Users []*MyMultipleDirectivesResponseUsersUser `json:"users"`
|
|
}
|
|
|
|
// MyMultipleDirectivesResponseUser includes the requested fields of the GraphQL type User.
|
|
// The GraphQL type's documentation follows.
|
|
//
|
|
// A User is a user!
|
|
type MyMultipleDirectivesResponseUser struct {
|
|
// id is the user's ID.
|
|
//
|
|
// It is stable, unique, and opaque, like all good IDs.
|
|
Id *testutil.ID `json:"id"`
|
|
}
|
|
|
|
// MyMultipleDirectivesResponseUsersUser includes the requested fields of the GraphQL type User.
|
|
// The GraphQL type's documentation follows.
|
|
//
|
|
// A User is a user!
|
|
type MyMultipleDirectivesResponseUsersUser struct {
|
|
// id is the user's ID.
|
|
//
|
|
// It is stable, unique, and opaque, like all good IDs.
|
|
Id *testutil.ID `json:"id"`
|
|
}
|
|
|
|
// Role is a type a user may have.
|
|
type Role string
|
|
|
|
const (
|
|
// What is a student?
|
|
//
|
|
// A student is primarily a person enrolled in a school or other educational institution and who is under learning with goals of acquiring knowledge, developing professions and achieving employment at desired field. In the broader sense, a student is anyone who applies themselves to the intensive intellectual engagement with some matter necessary to master it as part of some practical affair in which such mastery is basic or decisive.
|
|
//
|
|
// (from [Wikipedia](https://en.wikipedia.org/wiki/Student))
|
|
RoleStudent Role = "STUDENT"
|
|
// Teacher is a teacher, who teaches the students.
|
|
RoleTeacher Role = "TEACHER"
|
|
)
|
|
|
|
// UserQueryInput is the argument to Query.users.
|
|
//
|
|
// Ideally this would support anything and everything!
|
|
// Or maybe ideally it wouldn't.
|
|
// Really I'm just talking to make this documentation longer.
|
|
type UserQueryInput struct {
|
|
Email *string `json:"email"`
|
|
Name *string `json:"name"`
|
|
// id looks the user up by ID. It's a great way to look up users.
|
|
Id *testutil.ID `json:"id"`
|
|
Role *Role `json:"role"`
|
|
Names []*string `json:"names"`
|
|
HasPokemon *testutil.Pokemon `json:"hasPokemon"`
|
|
Birthdate *time.Time `json:"-"`
|
|
}
|
|
|
|
func (v *UserQueryInput) UnmarshalJSON(b []byte) error {
|
|
|
|
if string(b) == "null" {
|
|
return nil
|
|
}
|
|
|
|
var firstPass struct {
|
|
*UserQueryInput
|
|
Birthdate json.RawMessage `json:"birthdate"`
|
|
graphql.NoUnmarshalJSON
|
|
}
|
|
firstPass.UserQueryInput = v
|
|
|
|
err := json.Unmarshal(b, &firstPass)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
{
|
|
dst := &v.Birthdate
|
|
src := firstPass.Birthdate
|
|
if len(src) != 0 && string(src) != "null" {
|
|
*dst = new(time.Time)
|
|
err = testutil.UnmarshalDate(
|
|
src, *dst)
|
|
if err != nil {
|
|
return fmt.Errorf(
|
|
"Unable to unmarshal UserQueryInput.Birthdate: %w", err)
|
|
}
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
type __premarshalUserQueryInput struct {
|
|
Email *string `json:"email"`
|
|
|
|
Name *string `json:"name"`
|
|
|
|
Id *testutil.ID `json:"id"`
|
|
|
|
Role *Role `json:"role"`
|
|
|
|
Names []*string `json:"names"`
|
|
|
|
HasPokemon *testutil.Pokemon `json:"hasPokemon"`
|
|
|
|
Birthdate json.RawMessage `json:"birthdate"`
|
|
}
|
|
|
|
func (v *UserQueryInput) MarshalJSON() ([]byte, error) {
|
|
premarshaled, err := v.__premarshalJSON()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return json.Marshal(premarshaled)
|
|
}
|
|
|
|
func (v *UserQueryInput) __premarshalJSON() (*__premarshalUserQueryInput, error) {
|
|
var retval __premarshalUserQueryInput
|
|
|
|
retval.Email = v.Email
|
|
retval.Name = v.Name
|
|
retval.Id = v.Id
|
|
retval.Role = v.Role
|
|
retval.Names = v.Names
|
|
retval.HasPokemon = v.HasPokemon
|
|
{
|
|
|
|
dst := &retval.Birthdate
|
|
src := v.Birthdate
|
|
if src != nil {
|
|
var err error
|
|
*dst, err = testutil.MarshalDate(
|
|
src)
|
|
if err != nil {
|
|
return nil, fmt.Errorf(
|
|
"Unable to marshal UserQueryInput.Birthdate: %w", err)
|
|
}
|
|
}
|
|
}
|
|
return &retval, nil
|
|
}
|
|
|
|
// __MultipleDirectivesInput is used internally by genqlient
|
|
type __MultipleDirectivesInput struct {
|
|
Query MyInput `json:"query,omitempty"`
|
|
Queries []*UserQueryInput `json:"queries,omitempty"`
|
|
}
|
|
|
|
func MultipleDirectives(
|
|
client graphql.Client,
|
|
query MyInput,
|
|
queries []*UserQueryInput,
|
|
) (*MyMultipleDirectivesResponse, error) {
|
|
__input := __MultipleDirectivesInput{
|
|
Query: query,
|
|
Queries: queries,
|
|
}
|
|
var err error
|
|
|
|
var retval MyMultipleDirectivesResponse
|
|
err = client.MakeRequest(
|
|
nil,
|
|
"MultipleDirectives",
|
|
`
|
|
query MultipleDirectives ($query: UserQueryInput, $queries: [UserQueryInput]) {
|
|
user(query: $query) {
|
|
id
|
|
}
|
|
users(query: $queries) {
|
|
id
|
|
}
|
|
}
|
|
`,
|
|
&retval,
|
|
&__input,
|
|
)
|
|
return &retval, err
|
|
}
|
|
|