otter-conf

otter-conf turns flat key = value files into Zig structs. Your struct shape drives a comptime-generated parser. Files load through mmap. App schemas live in otter-config-types; apps load them with otter-conf.

Quick start

const otter_conf = @import("otter_conf");

const Config = struct {
    port: u16 = 8080,
    debug: bool = false,
};

var config = try otter_conf.load(Config, allocator, "/path/to/config.conf", .{});
defer otter_conf.freeConfig(Config, allocator, &config);

Example file:

# Application configuration
port = 443
debug = false

Documentation map

Format and types

Syntax, supported field types, strings, enums, arrays.

Loading API

load, loadFromSlice, directories, serialization, save.

Hot reload

hasChanged, Watcher, and poll-loop integration.

Advanced features

Nested structs, custom types, Dynamic, and import.

Conventions

Every struct field needs a default value.
Unknown keys are skipped (forward compatible).
Nested structs flatten to prefix_field keys (clock_enabled, clock_text_color).
Call freeConfig when the struct owns heap strings or slices.

Dependencies

otter-utils (inotify wrapper for Watcher).

Types and operations

Format and types

⌘I

Getting Started

Libraries

Quick start

Documentation map

Format and types

Loading API

Hot reload

Advanced features

Conventions

Dependencies

​Quick start

​Documentation map

Format and types

Loading API

Hot reload

Advanced features

​Conventions

​Dependencies

Quick start

Documentation map

Conventions

Dependencies