dagger-codegen

Original：🇺🇸 English
Translated

Edit dagger.gen.go output, Go templates (object.go.tmpl, defs.go.tmpl), invoke() dispatch, SDK interfaces (CodeGenerator, ClientGenerator), `dagger develop`, `dagger client install`. Keywords: codegen, SDK, bindings, templates, internal/dagger, dag.*, ModuleMainSrc

1installs
Sourcedagger/dagger
Added on

NPX Install

npx skill4agent add dagger/dagger dagger-codegen

Tags

Translated version includes tags in frontmatter
dagger-codegensdk-developmentgo-templatescode-generationdagger-commands

SKILL.md Content

View Translation Comparison →

Dagger Codegen

When to Load This Skill

  • Editing 
    dagger.gen.go
    or 
    internal/dagger/dagger.gen.go
    output
  • Modifying Go templates in 
    cmd/codegen/generator/go/templates/
  • Changing SDK interfaces in 
    core/sdk.go
  • Working on 
    dagger develop
    , 
    dagger call
    , or 
    dagger client install
  • Debugging why generated code looks wrong

Critical Concepts

"Codegen" means 4 different things in Dagger:
#NameTriggerKey Files
1In-Module Bindings
dagger develop
cmd/codegen/generator/go/templates/
2Runtime DispatchModule startup
cmd/codegen/generator/go/templates/modules.go:140
3SDK Libraries
go generate
sdk/go/generate.go
4Generated Clients
dagger client install
_dagger.gen.go/client.go.tmpl
Know which one you're dealing with before editing.

Key Entry Points

To change...Edit
Generated method signatures
cmd/codegen/generator/go/templates/src/_types/object.go.tmpl
Generated type definitions
cmd/codegen/generator/go/templates/src/_types/*.go.tmpl
Module 
invoke()
dispatch
cmd/codegen/generator/go/templates/modules.go:140
Standalone client 
Connect()
cmd/codegen/generator/go/templates/src/_dagger.gen.go/client.go.tmpl
Template functions
cmd/codegen/generator/go/templates/functions.go:54
SDK interfaces
core/sdk.go:20
(ClientGenerator), 
:93
(CodeGenerator)
Built-in SDK list
core/sdk/consts.go
Python output
sdk/python/codegen/src/codegen/generator.py

Reference Files

Load based on specific need:
NeedLoad
Understanding the 4 codegen typescodegen-types.md
SDK architecture, interfaces, Go special casesdk-architecture.md
Go template conditionals, two-pass generationgo-templates.md
dagger client install
internals		generated-clients.md