config

package
v0.0.0-...-86a398c Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 13, 2023 License: MIT Imports: 17 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	MapType       = types.NewMap(types.Typ[types.String], types.NewInterfaceType(nil, nil).Complete())
	InterfaceType = types.NewInterfaceType(nil, nil)
)
View Source
var ErrTypeNotFound = errors.New("unable to find type")

Functions

func CompleteConfig

func CompleteConfig(config *Config) error

CompleteConfig fills in the schema and other values to a config loaded from YAML.

func IsNilable

func IsNilable(t types.Type) bool

Types

type Binder

type Binder struct {
	References []*TypeReference
	SawInvalid bool
	// contains filtered or unexported fields
}

Binder connects graphql types to golang types using static analysis

func (*Binder) CopyModifiersFromAst

func (b *Binder) CopyModifiersFromAst(t *ast.Type, base types.Type) types.Type

func (*Binder) DefaultUserObject

func (b *Binder) DefaultUserObject(name string) (types.Type, error)

func (*Binder) FindObject

func (b *Binder) FindObject(pkgName string, typeName string) (types.Object, error)

func (*Binder) FindType

func (b *Binder) FindType(pkgName string, typeName string) (types.Type, error)

func (*Binder) FindTypeFromName

func (b *Binder) FindTypeFromName(name string) (types.Type, error)

func (*Binder) InstantiateType

func (b *Binder) InstantiateType(orig types.Type, targs []types.Type) (types.Type, error)

func (*Binder) ObjectPosition

func (b *Binder) ObjectPosition(typ types.Object) token.Position

func (*Binder) PointerTo

func (b *Binder) PointerTo(ref *TypeReference) *TypeReference

func (*Binder) PushRef

func (b *Binder) PushRef(ret *TypeReference)

func (*Binder) TypePosition

func (b *Binder) TypePosition(typ types.Type) token.Position

func (*Binder) TypeReference

func (b *Binder) TypeReference(schemaType *ast.Type, bindTarget types.Type) (ret *TypeReference, err error)

type Config

type Config struct {
	SchemaFilename                StringList                 `yaml:"schema,omitempty"`
	Exec                          ExecConfig                 `yaml:"exec"`
	Model                         PackageConfig              `yaml:"model,omitempty"`
	Federation                    PackageConfig              `yaml:"federation,omitempty"`
	Resolver                      ResolverConfig             `yaml:"resolver,omitempty"`
	AutoBind                      []string                   `yaml:"autobind"`
	Models                        TypeMap                    `yaml:"models,omitempty"`
	StructTag                     string                     `yaml:"struct_tag,omitempty"`
	Directives                    map[string]DirectiveConfig `yaml:"directives,omitempty"`
	GoBuildTags                   StringList                 `yaml:"go_build_tags,omitempty"`
	GoInitialisms                 GoInitialismsConfig        `yaml:"go_initialisms,omitempty"`
	OmitSliceElementPointers      bool                       `yaml:"omit_slice_element_pointers,omitempty"`
	OmitGetters                   bool                       `yaml:"omit_getters,omitempty"`
	OmitInterfaceChecks           bool                       `yaml:"omit_interface_checks,omitempty"`
	OmitComplexity                bool                       `yaml:"omit_complexity,omitempty"`
	OmitGQLGenFileNotice          bool                       `yaml:"omit_gqlgen_file_notice,omitempty"`
	OmitGQLGenVersionInFileNotice bool                       `yaml:"omit_gqlgen_version_in_file_notice,omitempty"`
	StructFieldsAlwaysPointers    bool                       `yaml:"struct_fields_always_pointers,omitempty"`
	ReturnPointersInUmarshalInput bool                       `yaml:"return_pointers_in_unmarshalinput,omitempty"`
	ResolversAlwaysReturnPointers bool                       `yaml:"resolvers_always_return_pointers,omitempty"`
	NullableInputOmittable        bool                       `yaml:"nullable_input_omittable,omitempty"`
	EnableModelJsonOmitemptyTag   *bool                      `yaml:"enable_model_json_omitempty_tag,omitempty"`
	SkipValidation                bool                       `yaml:"skip_validation,omitempty"`
	SkipModTidy                   bool                       `yaml:"skip_mod_tidy,omitempty"`
	Sources                       []*ast.Source              `yaml:"-"`
	Packages                      *code.Packages             `yaml:"-"`
	Schema                        *ast.Schema                `yaml:"-"`

	// Deprecated: use Federation instead. Will be removed next release
	Federated bool `yaml:"federated,omitempty"`
}

func DefaultConfig

func DefaultConfig() *Config

DefaultConfig creates a copy of the default config

func LoadConfig

func LoadConfig(filename string) (*Config, error)

LoadConfig reads the gqlgen.yml config file

func LoadConfigFromDefaultLocations

func LoadConfigFromDefaultLocations() (*Config, error)

LoadConfigFromDefaultLocations looks for a config file in the current directory, and all parent directories walking up the tree. The closest config file will be returned.

func LoadDefaultConfig

func LoadDefaultConfig() (*Config, error)

LoadDefaultConfig loads the default config so that it is ready to be used

func ReadConfig

func ReadConfig(cfgFile io.Reader) (*Config, error)

func (*Config) Init

func (c *Config) Init() error

func (*Config) IsRoot

func (c *Config) IsRoot(def *ast.Definition) bool

func (*Config) LoadSchema

func (c *Config) LoadSchema() error

func (*Config) NewBinder

func (c *Config) NewBinder() *Binder

func (*Config) ReloadAllPackages

func (c *Config) ReloadAllPackages()

type DirectiveConfig

type DirectiveConfig struct {
	SkipRuntime bool `yaml:"skip_runtime"`
}

type ExecConfig

type ExecConfig struct {
	Package string     `yaml:"package,omitempty"`
	Layout  ExecLayout `yaml:"layout,omitempty"` // Default: single-file

	// Only for single-file layout:
	Filename string `yaml:"filename,omitempty"`

	// Only for follow-schema layout:
	FilenameTemplate string `yaml:"filename_template,omitempty"` // String template with {name} as placeholder for base name.
	DirName          string `yaml:"dir"`
}

func (*ExecConfig) Check

func (r *ExecConfig) Check() error

func (*ExecConfig) Dir

func (r *ExecConfig) Dir() string

func (*ExecConfig) ImportPath

func (r *ExecConfig) ImportPath() string

func (*ExecConfig) IsDefined

func (r *ExecConfig) IsDefined() bool

func (*ExecConfig) Pkg

func (r *ExecConfig) Pkg() *types.Package

type ExecLayout

type ExecLayout string
var (
	// Write all generated code to a single file.
	ExecLayoutSingleFile ExecLayout = "single-file"
	// Write generated code to a directory, generating one Go source file for each GraphQL schema file.
	ExecLayoutFollowSchema ExecLayout = "follow-schema"
)

type GoInitialismsConfig

type GoInitialismsConfig struct {
	// If true, the Initialisms won't get appended to the default ones but replace them
	ReplaceDefaults bool `yaml:"replace_defaults"`
	// Custom initialisms to be added or to replace the default ones
	Initialisms []string `yaml:"initialisms"`
}

GoInitialismsConfig allows to modify the default behavior of naming Go methods, types and properties

type ModelExtraField

type ModelExtraField struct {
	// Type is the Go type of the field.
	//
	// It supports the builtin basic types (like string or int64), named types
	// (qualified by the full package path), pointers to those types (prefixed
	// with `*`), and slices of those types (prefixed with `[]`).
	//
	// For example, the following are valid types:
	//  string
	//  *github.com/author/package.Type
	//  []string
	//  []*github.com/author/package.Type
	//
	// Note that the type will be referenced from the generated/graphql, which
	// means the package it lives in must not reference the generated/graphql
	// package to avoid circular imports.
	// restrictions.
	Type string `yaml:"type"`

	// OverrideTags is an optional override of the Go field tag.
	OverrideTags string `yaml:"overrideTags"`

	// Description is an optional the Go field doc-comment.
	Description string `yaml:"description"`
}

type PackageConfig

type PackageConfig struct {
	Filename      string `yaml:"filename,omitempty"`
	Package       string `yaml:"package,omitempty"`
	Version       int    `yaml:"version,omitempty"`
	ModelTemplate string `yaml:"model_template,omitempty"`
}

func (*PackageConfig) Check

func (c *PackageConfig) Check() error

func (*PackageConfig) Dir

func (c *PackageConfig) Dir() string

func (*PackageConfig) ImportPath

func (c *PackageConfig) ImportPath() string

func (*PackageConfig) IsDefined

func (c *PackageConfig) IsDefined() bool

func (*PackageConfig) Pkg

func (c *PackageConfig) Pkg() *types.Package

type ResolverConfig

type ResolverConfig struct {
	Filename            string         `yaml:"filename,omitempty"`
	FilenameTemplate    string         `yaml:"filename_template,omitempty"`
	Package             string         `yaml:"package,omitempty"`
	Type                string         `yaml:"type,omitempty"`
	Layout              ResolverLayout `yaml:"layout,omitempty"`
	DirName             string         `yaml:"dir"`
	OmitTemplateComment bool           `yaml:"omit_template_comment,omitempty"`
	ResolverTemplate    string         `yaml:"resolver_template,omitempty"`
}

func (*ResolverConfig) Check

func (r *ResolverConfig) Check() error

func (*ResolverConfig) Dir

func (r *ResolverConfig) Dir() string

func (*ResolverConfig) ImportPath

func (r *ResolverConfig) ImportPath() string

func (*ResolverConfig) IsDefined

func (r *ResolverConfig) IsDefined() bool

func (*ResolverConfig) Pkg

func (r *ResolverConfig) Pkg() *types.Package

type ResolverLayout

type ResolverLayout string
var (
	LayoutSingleFile   ResolverLayout = "single-file"
	LayoutFollowSchema ResolverLayout = "follow-schema"
)

type StringList

type StringList []string

func (StringList) Has

func (a StringList) Has(file string) bool

func (*StringList) UnmarshalYAML

func (a *StringList) UnmarshalYAML(unmarshal func(interface{}) error) error

type TypeMap

type TypeMap map[string]TypeMapEntry

func (TypeMap) Add

func (tm TypeMap) Add(name string, goType string)

func (TypeMap) Check

func (tm TypeMap) Check() error

func (TypeMap) Exists

func (tm TypeMap) Exists(typeName string) bool

func (TypeMap) ForceGenerate

func (tm TypeMap) ForceGenerate(name string, forceGenerate bool)

func (TypeMap) ReferencedPackages

func (tm TypeMap) ReferencedPackages() []string

func (TypeMap) UserDefined

func (tm TypeMap) UserDefined(typeName string) bool

type TypeMapEntry

type TypeMapEntry struct {
	Model         StringList              `yaml:"model,omitempty"`
	ForceGenerate bool                    `yaml:"forceGenerate,omitempty"`
	Fields        map[string]TypeMapField `yaml:"fields,omitempty"`

	// Key is the Go name of the field.
	ExtraFields map[string]ModelExtraField `yaml:"extraFields,omitempty"`
}

type TypeMapField

type TypeMapField struct {
	Resolver        bool   `yaml:"resolver"`
	FieldName       string `yaml:"fieldName"`
	GeneratedMethod string `yaml:"-"`
}

type TypeReference

type TypeReference struct {
	Definition              *ast.Definition
	GQL                     *ast.Type
	GO                      types.Type  // Type of the field being bound. Could be a pointer or a value type of Target.
	Target                  types.Type  // The actual type that we know how to bind to. May require pointer juggling when traversing to fields.
	CastType                types.Type  // Before calling marshalling functions cast from/to this base type
	Marshaler               *types.Func // When using external marshalling functions this will point to the Marshal function
	Unmarshaler             *types.Func // When using external marshalling functions this will point to the Unmarshal function
	IsMarshaler             bool        // Does the type implement graphql.Marshaler and graphql.Unmarshaler
	IsOmittable             bool        // Is the type wrapped with Omittable
	IsContext               bool        // Is the Marshaler/Unmarshaller the context version; applies to either the method or interface variety.
	PointersInUmarshalInput bool        // Inverse values and pointers in return.
	IsRoot                  bool        // Is the type a root level definition such as Query, Mutation or Subscription
}

TypeReference is used by args and field types. The Definition can refer to both input and output types.

func (*TypeReference) Elem

func (ref *TypeReference) Elem() *TypeReference

func (*TypeReference) IsMap

func (ref *TypeReference) IsMap() bool

func (*TypeReference) IsNamed

func (ref *TypeReference) IsNamed() bool

func (*TypeReference) IsNilable

func (ref *TypeReference) IsNilable() bool

func (*TypeReference) IsPtr

func (ref *TypeReference) IsPtr() bool

func (*TypeReference) IsPtrToIntf

func (ref *TypeReference) IsPtrToIntf() bool

func (*TypeReference) IsPtrToPtr

func (ref *TypeReference) IsPtrToPtr() bool

fix for https://github.com/golang/go/issues/31103 may make it possible to remove this (may still be useful)

func (*TypeReference) IsPtrToSlice

func (ref *TypeReference) IsPtrToSlice() bool

func (*TypeReference) IsScalar

func (ref *TypeReference) IsScalar() bool

func (*TypeReference) IsSlice

func (ref *TypeReference) IsSlice() bool

func (*TypeReference) IsStruct

func (ref *TypeReference) IsStruct() bool

func (*TypeReference) IsTargetNilable

func (ref *TypeReference) IsTargetNilable() bool

func (*TypeReference) MarshalFunc

func (ref *TypeReference) MarshalFunc() string

func (*TypeReference) UniquenessKey

func (ref *TypeReference) UniquenessKey() string

func (*TypeReference) UnmarshalFunc

func (ref *TypeReference) UnmarshalFunc() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL