Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

codegen

package

Go to main page

Versions in this module

v0

v0.3.0

Jun 8, 2026

Changes in this version

+ const ManifestName

+ const ProtocolVersion

+ func CleanEnabled(cfg CodegenConfig) bool

+ func EnsureNoSymlinkLeaf(path string) error

+ func EnsureNoSymlinkPath(path string) error

+ func HasCodegenSection(path string) (bool, error)

+ func LoadSource(projectDir string, source SourceConfig) (any, error)

+ func SafeOutputRoot(root string) (string, error)

+ func SafeRelativePath(path string) (string, error)

+ func WriteFiles(files *FileSet, opts WriteOptions) error

+ type CodegenConfig struct

+ Clean *bool

+ Extensions []ExtensionConfig

+ Generators []GeneratorConfig

+ Output string

+ type Config struct

+ Codegen CodegenConfig

+ Version int

+ func DecodeConfig(node *coreyaml.Node) (Config, error)

+ func LoadConfig(path string) (Config, error)

+ type Context struct

+ Config Config

+ Diagnostics []Diagnostic

+ Files *FileSet

+ Inputs map[string]any

+ Metadata map[string]any

+ ProjectDir string

+ type Diagnostic struct

+ Message string

+ Severity string

+ type Discovery struct

+ Config Config

+ Found bool

+ Path string

+ ProjectDir string

+ func DiscoverConfig(projectDir string) (Discovery, error)

+ type Extension interface

+ Name func() string

+ RunPhase func(ctx context.Context, phase string, genCtx *Context, gen GeneratorConfig, ...) (ExtensionResponse, error)

+ func NewCommandExtension(name string, command []string, stderrWriter io.Writer) Extension

+ type ExtensionConfig struct

+ Command []string

+ Config map[string]any

+ Name string

+ type ExtensionRequest struct

+ Extension ExtensionConfig

+ Files []GeneratedFile

+ Generator GeneratorConfig

+ Metadata map[string]any

+ Phase string

+ ProjectDir string

+ ProtocolVersion int

+ Source any

+ type ExtensionResponse struct

+ Deletes []string

+ Diagnostics []Diagnostic

+ Files []GeneratedFile

+ ProtocolVersion int

+ type FileSet struct

+ func NewFileSet() *FileSet

+ func (fs *FileSet) Add(file GeneratedFile) error

+ func (fs *FileSet) All() []GeneratedFile

+ func (fs *FileSet) Delete(path string) error

+ func (fs *FileSet) DeleteOwned(path, owner string) error

+ type GeneratedFile struct

+ Content string

+ Owner string

+ Path string

+ type Generator interface

+ Generate func(ctx context.Context, genCtx *Context, cfg GeneratorConfig) ([]GeneratedFile, error)

+ Name func() string

+ type GeneratorConfig struct

+ Config map[string]any

+ Extension string

+ ID string

+ Name string

+ Output string

+ Source SourceConfig

+ type JSONDocument struct

+ Data any

+ Path string

+ type Registry struct

+ func NewRegistry() *Registry

+ func (r *Registry) RegisterCommandExtensions(cfg CodegenConfig, stderrWriter io.Writer) error

+ func (r *Registry) RegisterExtension(ext Extension) error

+ func (r *Registry) RegisterGenerator(gen Generator) error

+ func (r *Registry) Run(ctx context.Context, projectDir string, cfg Config) (*Context, error)

+ type SourceConfig struct

+ Config map[string]any

+ Path string

+ Type string

+ type WriteOptions struct

+ Clean bool

+ OutputRoot string

+ SkipManifest bool

v0.2.2

Jun 1, 2026

v0.2.1

Jun 1, 2026

v0.2.0

Jun 1, 2026