timberborn-http 0.0.2

Timberborn http api wrapper

Timberborn HTTP API Wrapper

A Python library for interacting with the Timberborn HTTP automation API. Supports both direct API control and webhook-based event handling.

Features

• Control levers and adapters in your Timberborn game
• Poll or watch for state changes
• Webhook support for real-time events
• Multiple interaction styles: OOP, decorators, and direct function calls

Installation

pip install timberborn-http

Quickstart

1. Direct API Control

from timberborn_http import TimberbornAPI

api = TimberbornAPI("http://localhost:8080")

# Get all levers
levers = api.get_levers()
for lever in levers:
    print(lever.name, lever.state)

# Control a lever
api.switch_on("Main Water Pump")
api.set_color("Main Water Pump", "ff0000")

2. Webhook Events

from timberborn_http import TimberbornWebhookServer

server = TimberbornWebhookServer()

@server.on("Main Water Pump")
def handle_on(name):
    print(f"{name} turned ON!")

server.start()

Documentation & Examples

• API Usage: Direct control and polling
• Webhook Usage: Real-time event handling

Getting Help

• GitHub Issues
• Discord

Commands

• python -m venv .venv
• pip install -r requirements.txt
• pip install -e .
• python -m build
• python3 -m twine upload --repository testpypi dist/*
• python3 -m pip install --index-url https://test.pypi.org/simple/ --no-deps timberborn_http