Resinker

A YAML-based configuration system for mocking event streams. Resinker allows you to generate realistic event data based on entity relationships, dependencies, and scenarios.

Features

• Define your event schemas in YAML
• Model complex entity relationships and state changes
• Generate realistic event data using the Faker library
• Define complex scenarios and event sequences
• Output to various destinations: Kafka, files, stdout

Installation

pip install resinker

Or if you're using uv:

uv pip install resinker

Quick Start

1. Create a YAML configuration file:

version: "1.0"
simulation_settings:
  duration: "10m"
  initial_entity_counts:
    User: 10
  time_progression:
    start_time: "now"
    time_multiplier: 1.0
  random_seed: 42
# Define your schemas, entities, and events here
# ...
outputs:
  - type: "stdout"
    enabled: true
    format: "json_pretty"

2. Run Resinker:

resinker run -c your_config.yaml

Documentation

For detailed documentation and examples, see the System Overview.