Loco Bindings - Python Bindings for Loco-rs

Python bindings for the Loco-rs code generator. This provides a thin wrapper around the Loco generator, allowing you to generate models, controllers, and scaffolds from Python.

Features

• 🚀 Direct Integration - Uses loco-gen directly for 100% compatibility
• 🎯 Simple API - Clean Python interface to Loco's generator
• ⚡ High Performance - Native Rust implementation with Python bindings
• 🔄 Auto-sync - Always up-to-date with loco-gen improvements

Installation

# Development installation
cd loco-bindings
maturin develop

Usage

Generate a Model

import loco_bindings

result = loco_bindings.generate_model(
    project_path="/path/to/loco/project",
    name="user",
    fields={
        "name": "string",
        "email": "string^",  # unique
        "age": "int",
    },
    with_timestamps=True
)

print(result["messages"])

Generate a Scaffold

Generate a complete scaffold with model, controller, and views:

result = loco_bindings.generate_scaffold(
    project_path="/path/to/loco/project",
    name="post",
    fields={
        "title": "string",
        "content": "text",
        "published": "bool",
    },
    kind="api",  # Options: "api", "html", "htmx"
    with_timestamps=True
)

Generate a Controller

result = loco_bindings.generate_controller_view(
    project_path="/path/to/loco/project",
    name="users",
    actions=["index", "show", "create", "update", "delete"],
    kind="api"  # Options: "api", "html", "htmx"
)

Field Types

The fields dictionary uses Loco's field type syntax:

See Loco field types documentation for more.

Error Handling

from loco_bindings import ValidationError, FileOperationError, ProjectError

try:
    result = loco_bindings.generate_model(
        project_path="/invalid/path",
        name="user",
        fields={"name": "string"},
        with_timestamps=True
    )
except FileOperationError as e:
    print(f"File error: {e}")
except ValidationError as e:
    print(f"Validation error: {e}")
except ProjectError as e:
    print(f"Project error: {e}")

Architecture

This package is a thin binding layer (~250 lines) that directly exposes loco-gen's functionality:

Python Application
    ↓
loco_bindings (thin wrapper)
    ↓
loco-gen (Rust core)
    ↓
File system

All generation logic, template processing, and validations are handled by loco-gen itself, ensuring complete compatibility with the Loco CLI.

Development

Build

maturin develop

Build for release

maturin build --release

License

MIT OR Apache-2.0