mirror of
https://github.com/j3ssie/osmedeus.git
synced 2026-08-24 16:42:28 +02:00
j3ssie
7de3e7b2b2
- Add lock-free ResultCollector for parallel execution with atomic operations, eliminating mutex contention for pre-allocated slices - Implement circuit breaker pattern (internal/retry/circuit_breaker) with configurable thresholds and half-open recovery state for fault tolerance - Introduce json-iterator replacement (internal/json) for 2-6x faster JSON operations while maintaining stdlib compatibility - Add lazy template rendering (RenderLazy) with variable reference caching for 50-80% faster rendering on large contexts - Implement memory-efficient buffer pooling (bufpool) with 10MB pre-allocated reusable buffers for reduced GC pressure - Add LoadFlowWithModules for parallel module pre-loading using errgroup, improving startup time for complex flows - Add VarRefCache with LRU eviction for variable extraction caching - Add streaming output support for foreach loops to process large datasets without memory accumulation - Fix json import compatibility in llm_executor and db_functions - Update test fixtures with correct YAML field names (call→function, run→command)
73 lines
2.9 KiB
Go
73 lines
2.9 KiB
Go
package template
|
|
|
|
// TemplateEngine defines the interface for template rendering engines.
|
|
// This allows for different implementations (standard, sharded) to be used
|
|
// interchangeably throughout the codebase.
|
|
type TemplateEngine interface {
|
|
// Render renders a template string with the given context.
|
|
// Returns the rendered string or an error if rendering fails.
|
|
Render(template string, ctx map[string]any) (string, error)
|
|
|
|
// RenderMap renders all template values in a map.
|
|
// Returns a new map with rendered values.
|
|
RenderMap(m map[string]string, ctx map[string]any) (map[string]string, error)
|
|
|
|
// RenderSlice renders all template values in a slice.
|
|
// Returns a new slice with rendered values.
|
|
RenderSlice(s []string, ctx map[string]any) ([]string, error)
|
|
|
|
// RenderSecondary renders templates using [[ ]] delimiters.
|
|
// Used for variables that only exist at runtime (e.g., foreach loop variables).
|
|
RenderSecondary(template string, ctx map[string]any) (string, error)
|
|
|
|
// HasSecondaryVariable checks if template contains [[ ]] delimiters.
|
|
HasSecondaryVariable(template string) bool
|
|
|
|
// ExecuteGenerator executes a generator function expression.
|
|
ExecuteGenerator(expr string) (string, error)
|
|
|
|
// RegisterGenerator registers a custom generator function.
|
|
RegisterGenerator(name string, fn GeneratorFunc)
|
|
|
|
// ExtractVariablesSet extracts all variable names referenced in a template string.
|
|
// Returns a set of variable names (map for O(1) lookup).
|
|
ExtractVariablesSet(template string) map[string]struct{}
|
|
|
|
// RenderLazy renders a template with lazy context loading.
|
|
// Only variables actually referenced in the template are looked up from the full context.
|
|
RenderLazy(template string, fullCtx map[string]any) (string, error)
|
|
}
|
|
|
|
// BatchRenderer extends TemplateEngine with batch rendering capability
|
|
// for improved performance under high concurrency.
|
|
type BatchRenderer interface {
|
|
TemplateEngine
|
|
|
|
// RenderBatch renders multiple templates in a single operation.
|
|
// This reduces lock contention by grouping templates and acquiring
|
|
// locks fewer times.
|
|
RenderBatch(requests []RenderRequest, ctx map[string]any) (map[string]string, error)
|
|
}
|
|
|
|
// RenderRequest represents a single template to render in a batch operation.
|
|
type RenderRequest struct {
|
|
// Key is the identifier for this template (e.g., field name)
|
|
Key string
|
|
|
|
// Template is the template string to render
|
|
Template string
|
|
}
|
|
|
|
// Precompiler provides access to pre-compiled templates for workflows.
|
|
type Precompiler interface {
|
|
// PrecompileWorkflow scans a workflow and pre-compiles all template strings.
|
|
PrecompileWorkflow(workflowName string, templates map[string]string) error
|
|
|
|
// GetPrecompiled retrieves a pre-compiled template if available.
|
|
// Returns nil if not found.
|
|
GetPrecompiled(workflowName, key string) any
|
|
|
|
// ClearPrecompiled removes pre-compiled templates for a workflow.
|
|
ClearPrecompiled(workflowName string)
|
|
}
|