pipelex-tools-py 0.1.1

Pipelex Tools as a Python library — MTHDS lint & format, importable as `pipelex_tools`

pipelex-tools-py

Python bindings for Pipelex Tools. This package installs the importable pipelex_tools module for formatting and linting MTHDS content in-process, without shelling out to the plxt CLI.

What is MTHDS? MTHDS is an open standard for defining AI methods as typed, composable, human-readable TOML files. A .mthds file describes what an AI should do: its inputs, outputs, logic, and data types. Pipelex is the runtime that executes them.

Installation

pip install pipelex-tools-py

uv add pipelex-tools-py

Usage

import pipelex_tools

formatted = pipelex_tools.format_mthds("a=1")
print(formatted["formatted"])
# a = 1

linted = pipelex_tools.lint_mthds("""
domain = "example"

[concept]

[pipe]
""")
print(linted["diagnostics"])

API

format_mthds(content: str, *, options: dict | None = None) -> dict

Returns:

{
    "formatted": str,
    "changed": bool,
    "diagnostics": list[dict],
}

lint_mthds(content: str, *, source: str | None = None) -> dict

Returns:

{
    "diagnostics": list[dict],
}

Diagnostics use this shape:

{
    "kind": "syntax" | "semantic" | "schema",
    "severity": "error",
    "message": str,
    "location": str | None,
    "range": {
        "start_offset": int,
        "end_offset": int,
        "start_line": int,
        "start_col": int,
        "end_line": int,
        "end_col": int,
    } | None,
}

Malformed MTHDS content is returned as diagnostics, not raised as an exception. Malformed formatter option values may raise ValueError.

CLI package

This is the Python library package. To install the plxt command-line tool, use the separate pipelex-tools package:

uv tool install pipelex-tools

Links

• GitHub
• Documentation
• Issues

TOML support built on Taplo.

"Pipelex" is a trademark of Evotis S.A.S.