OpenComb

Developer Swiss Army Knife – combine, build, drill, PRT language, 56+ templates, PyRunner, stacks, wizard, OCC SSH, and a full Python API.

pip install opencomb

Highlights (v0.17.0)

Full API docs: docs/API.md

Python API – quick start

import opencomb

# Version
print(opencomb.__version__)

# Combine Python sources
code = opencomb.combine(["a.py", "b.py"])
code = opencomb.combine(snippets=["x = 1", "print(x)"])

# Merge configs / env
cfg = opencomb.merge_configs(["base.yaml", "local.yaml"])
env = opencomb.merge_env([".env", ".env.local"])

# Combinatorial parameter sets
rows = opencomb.generate_combos(
    {"lr": [0.001, 0.01], "batch": [16, 32]},
    method="pairwise",
)

# Jinja2 + prompts
html = opencomb.render_template("Hi {{ name }}!", data={"name": "Ada"})
prompt = opencomb.build_prompt(
    system="You are a code reviewer.",
    user="Review this PR.",
)

# Scaffold a project
path = opencomb.new_project("my-api", template="fastapi")

# Search / TODOs / stats / doctor
hits = opencomb.search("TODO", ".", regex=False)
items = opencomb.todos(".")
st = opencomb.stats(".")
report = opencomb.doctor(".")
print(report["score"], report["grade"])

Main classes

from opencomb import (
    CodeCombiner, ConfigMerger, EnvMerger,
    CombinatorialGenerator, PromptCombiner, TemplateRenderer,
    RecipeRunner, PackageManager, ProjectHelper, Checker,
    Searcher, TodoExtractor, ProjectStats,
    list_templates, apply_template, apply_stack, add_component,
)

# Example: class usage
text = CodeCombiner().combine_files(["src/a.py", "src/b.py"])
data = ConfigMerger().merge_files(["cfg/base.yaml", "cfg/prod.yaml"])
PackageManager().add(["requests"])
ProjectHelper().init("demo", description="Demo package")

See docs/API.md for every function, method, and return type.

CLI quick start

# List all 56 templates
opencomb templates

# Create a FastAPI project
opencomb new fastapi my-api
cd my-api && pip install -e .

# Interactive wizard (stacks)
opencomb wizard

# Apply a full stack
opencomb stack api-full ./my-full-api

# Add a component
opencomb add dockerfile .
opencomb add makefile .

# Project doctor
opencomb syscheck

# SSH connector
opencomb occ user@example.com

PyRunner

Run Python in the browser (Pyodide). Packages only via packages.json (no GUI).

opencomb new pyrunner my-runner
cd my-runner && python -m http.server 8080

Stacks

Components

dockerfile · makefile · precommit · devcontainer · gitignore · compose · pytest · github-ci · readme

PRT language

opencomb prt                  # REPL
opencomb prt examples/prt/hello.prt

Development

git clone https://github.com/SlabyLol/OpenComb.git
cd OpenComb
pip install -e ".[dev]"
pytest

License

MIT © DarkFox Co.