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
- API
  
  Reference documentation for the pkg.go.dev API
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

extend

package

Go to main page

Versions in this module

v1

v1.0.2

Jun 23, 2026

v1.0.1

Jun 23, 2026

Changes in this version

+ var ErrRateLimited = errors.New("extend: hook rate limit exceeded")

+ var ErrTooManyRegistrations = errors.New("extend: too many dynamic registrations for app")

type Registry

+ func (r *Registry) CountForApp(appID string) int

+ func (r *Registry) SetRateLimit(ratePerSec float64, burst int)

v1.0.1-beta.1

May 29, 2026

v1.0.0-rc1

May 22, 2026

v0

v0.2.0

May 28, 2026

Changes in this version

+ var ErrPermissionDenied = errors.New("extend: permission denied")

+ func AddEncoding(args HookArgs, codings ...string)

+ func AddRequired(args HookArgs, appIDs ...string)

+ func IsValid(s string) bool

+ func MissingRequired(meta *WireMeta, installed []string) []string

+ func SetDetails(args HookArgs, details map[string]any)

+ func SetMeta(args HookArgs, m *WireMeta)

+ type Core func(ctx context.Context, args HookArgs) (HookArgs, error)

+ type DaemonHandler struct

+ func NewDaemonHandler(reg *Registry, perms Permission) *DaemonHandler

+ func (h *DaemonHandler) List(primitive HookPoint) []Extension

+ func (h *DaemonHandler) Register(appID string, ext Extension) error

+ func (h *DaemonHandler) Unregister(appID string, primitive HookPoint, method string) error

+ type Dispatcher func(ctx context.Context, appID, method string, args HookArgs) (HookArgs, error)

+ type Extension struct

+ AddsFlags []FlagSpec

+ AppID string

+ Method string

+ Order int

+ Primitive HookPoint

+ Version string

+ type FlagSpec struct

+ Help string

+ Name string

+ Type string

+ type HookArgs map[string]any

+ func Wrap(ctx context.Context, r *Registry, cmd string, args HookArgs, core Core) (HookArgs, error)

+ type HookPoint string

+ const PostNetCall

+ const PostRecvMessage

+ const PostSendMessage

+ const PreNetCall

+ const PreSendMessage

+ type HookStamp struct

+ AppID string

+ At time.Time

+ Details map[string]any

+ Primitive string

+ Version string

+ type Permission interface

+ CanRegister func(appID string, primitive HookPoint) bool

+ var AllowAll Permission = PermissionFunc(func(string, HookPoint) bool { ... })

+ var DenyAll Permission = PermissionFunc(func(string, HookPoint) bool { ... })

+ type PermissionFunc func(appID string, primitive HookPoint) bool

+ func (f PermissionFunc) CanRegister(appID string, primitive HookPoint) bool

+ type Phase string

+ const PhasePost

+ const PhasePre

+ type Registry struct

+ func NewRegistry(dispatch Dispatcher) *Registry

+ func (r *Registry) AllRegistered() []Extension

+ func (r *Registry) FlagsFor(p HookPoint) []FlagSpec

+ func (r *Registry) HooksFor(p HookPoint) []Extension

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

+ func (r *Registry) Run(ctx context.Context, p HookPoint, args HookArgs) (HookArgs, error)

+ func (r *Registry) Unregister(appID string)

+ func (r *Registry) UnregisterOne(appID string, primitive HookPoint, method string)

+ type WireMeta struct

+ Encoding []string

+ Required []string

+ TouchedBy []HookStamp

+ func GetMeta(args HookArgs) *WireMeta

v0.1.0

May 22, 2026