Kaizo Documentation

Kaizo is a declarative configuration parser that dynamically loads, resolves, and executes Python objects, functions, and plugins from YAML configuration files.

Key features:

• Cross-file imports - import and reuse configuration from other YAML files

• Lazy execution - defer execution until the entry is accessed

• Result caching - cache execution results per argument set

• Plugin dispatch - load, configure, and reuse plugins dynamically

• Variable references - reference other entries using .{key} syntax

• Local Python modules - load Python code from local files

Note

Every YAML entry is converted into an internal Entry object, providing a unified interface for resolution and execution.

Contents

• Installation
  • Install via pip
  • Install from Source
  • Requirements
• Quick Start
  • Minimal Example
  • Summary
• Configuration Files
  • Basic Entry Structure
  • Entry Properties
  • Top-Level Configuration Keys
  • Resolution Summary
• Parser Architecture
  • Main Class
  • Initialization
  • Parser Stages
  • Entry Resolution
  • Execution Model
  • Summary
• Plugins
  • Plugin System
  • Plugin Configuration
  • Plugin Loading Behavior
  • Plugin Invocation
  • Calling Plugin Methods
  • Plugin Rules
  • Execution Summary
• Utilities
  • Entry System
  • FnWithKwargs
  • ModuleLoader
  • Storage