tmpl

Documentation

Overview

Package tmpl provides template rendering utilities for shell commands.

Index

• type Config
• type Renderer
  • func New(cfg Config) *Renderer
  • func NewValidation() *Renderer
  • func (r *Renderer) Render(tmpl string, data any) (string, error)
  • func (r *Renderer) ValidateSyntax(tmpl string) error
  • func (r *Renderer) WithAgent(command, window, flags string) *Renderer

Types

type Config

type Config struct {
	ScriptPaths  map[string]string // "hive-tmux" -> "/path/to/bin/hive-tmux"
	AgentCommand string            // default profile command (e.g., "claude")
	AgentWindow  string            // default profile key / tmux window name
	AgentFlags   string            // shell-quoted flags string
}

Config holds all template rendering context.

type Renderer

type Renderer struct {
	// contains filtered or unexported fields
}

Renderer renders Go templates with shell-oriented helper functions.

func New

func New(cfg Config) *Renderer

New creates a Renderer with the given config baked into template functions.

func NewValidation

func NewValidation() *Renderer

NewValidation creates a Renderer with safe defaults for template syntax checking. Template functions return placeholder values — output is discarded, only parse errors matter.

func (*Renderer) Render

func (r *Renderer) Render(tmpl string, data any) (string, error)

Render executes a Go template string with the given data.

func (*Renderer) ValidateSyntax

func (r *Renderer) ValidateSyntax(tmpl string) error

ValidateSyntax parses tmpl without executing it. Use this instead of Render when the template's data shape includes dynamic map fields (e.g. map[string]any) whose keys can't be known at validation time — executing with missingkey=error would reject valid templates referencing keys that only exist at render time.

func (*Renderer) WithAgent

func (r *Renderer) WithAgent(command, window, flags string) *Renderer

WithAgent returns a new Renderer with the agent values overridden. All other config (script paths etc.) is inherited from the receiver.