opencomb 0.2.0__tar.gz

opencomb-0.2.0/.gitignore

@@ -0,0 +1,52 @@
+# Byte-compiled / cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Testing / coverage
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.tox/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Local
+*.local
+.env

opencomb-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DarkFox Co. / SlabyLol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

opencomb-0.2.0/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.5
+Name: opencomb
+Version: 0.2.0
+Summary: OpenComb – Smart Combiner for Code, Configs, Prompts, Templates, Recipes & Combinatorial Generation
+Project-URL: Homepage, https://github.com/SlabyLol/OpenComb
+Project-URL: Repository, https://github.com/SlabyLol/OpenComb
+Project-URL: Issues, https://github.com/SlabyLol/OpenComb/issues
+Project-URL: Documentation, https://github.com/SlabyLol/OpenComb#readme
+Author-email: "DarkFox Co." <darkfox-to@proton.me>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,code-generation,combinatorial,combiner,config-merge,jinja2,opencomb,prompts,recipes,templates,testing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# OpenComb
+
+**Smart Combiner for Code, Configs, Prompts, Templates, Recipes & Combinatorial Generation**
+
+[![PyPI](https://img.shields.io/pypi/v/opencomb.svg)](https://pypi.org/project/opencomb/)
+[![Python](https://img.shields.io/pypi/pyversions/opencomb.svg)](https://pypi.org/project/opencomb/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/SlabyLol/OpenComb/actions/workflows/ci.yml/badge.svg)](https://github.com/SlabyLol/OpenComb/actions/workflows/ci.yml)
+
+<p align="center">
+  <img src="docs/logo.svg" alt="OpenComb Logo" width="160"/>
+</p>
+
+**OpenComb** is a powerful, practical toolkit for developers that helps you:
+
+- **Combine** multiple Python source files into one clean module (with smart import deduplication)
+- **Merge** YAML, JSON and TOML configs intelligently (deep or shallow)
+- **Generate** combinatorial parameter sets (cartesian, pairwise testing, sampling)
+- **Build** structured LLM prompts from system / instruction / context / few-shot / user parts
+- **Render** Jinja2 templates (single or multi-file)
+- **Run declarative recipes** that orchestrate all of the above in one YAML file
+
+Perfect for rapid prototyping, test matrix generation, config management, AI/prompt engineering and automation pipelines.
+
+## Installation
+
+```bash
+pip install opencomb
+```
+
+Or with uv:
+
+```bash
+uv add opencomb
+```
+
+## Features at a Glance
+
+| Feature              | CLI Command     | Library Class            | Description                                      |
+|----------------------|-----------------|--------------------------|--------------------------------------------------|
+| Code Combining       | `combine`       | `CodeCombiner`           | Merge Python files + import dedupe               |
+| Config Merging       | `merge`         | `ConfigMerger`           | Deep / shallow YAML·JSON·TOML                    |
+| Combinatorial Gen    | `generate`      | `CombinatorialGenerator` | Cartesian · Pairwise · Sample                    |
+| Prompt Building      | `prompt`        | `PromptCombiner`         | Structured LLM prompts                           |
+| Template Rendering   | `template`      | `TemplateRenderer`       | Jinja2 power                                     |
+| Recipe Runner        | `recipe`        | `RecipeRunner`           | Full pipelines in one YAML                       |
+
+## Quick Start – CLI
+
+```bash
+# Combine Python files
+opencomb combine module_a.py module_b.py utils.py -o combined.py
+
+# Merge configs (later files win)
+opencomb merge base.yaml local.yaml secrets.toml -o final.yaml
+
+# Generate combinations
+opencomb generate -p params.yaml --method pairwise --report
+
+# Build an LLM prompt
+opencomb prompt \
+  --system system.txt \
+  --instruction task.txt \
+  --examples fewshot.yaml \
+  --user query.txt \
+  -o final_prompt.txt
+
+# Render Jinja2 templates
+opencomb template template.j2 --data data.yaml -o output.md
+
+# Run a full recipe
+opencomb recipe examples/sample_recipe.yaml
+opencomb recipe examples/sample_recipe.yaml --dry-run --verbose
+```
+
+## Quick Start – Library
+
+```python
+from opencomb import (
+    CodeCombiner,
+    ConfigMerger,
+    CombinatorialGenerator,
+    PromptCombiner,
+    TemplateRenderer,
+    RecipeRunner,
+)
+
+# Code
+combiner = CodeCombiner()
+code = combiner.combine_files(["a.py", "b.py"])
+
+# Config
+merger = ConfigMerger()
+config = merger.merge_files(["base.yaml", "override.yaml"])
+merger.save(config, "result.yaml")
+
+# Combinations
+gen = CombinatorialGenerator(seed=42)
+params = {"lr": [0.001, 0.01], "batch": [16, 32], "opt": ["adam", "sgd"]}
+all_combos = gen.cartesian(params)
+pairwise   = gen.pairwise(params)   # much smaller & efficient
+
+# Prompts
+pc = PromptCombiner()
+prompt = pc.combine(
+    system="You are a senior Python engineer.",
+    instruction="Review the following code.",
+    examples=[{"input": "x=1", "output": "Looks fine."}],
+    user="def foo(): pass",
+)
+
+# Templates
+renderer = TemplateRenderer()
+html = renderer.render_string("<h1>{{ title }}</h1>", title="OpenComb")
+
+# Recipes
+runner = RecipeRunner()
+results = runner.run("my_recipe.yaml")
+```
+
+## Recipe Example
+
+```yaml
+# my_pipeline.yaml
+name: full-pipeline
+
+combine:
+  files: [src/a.py, src/b.py, src/utils.py]
+  output: build/combined.py
+
+merge:
+  files: [config/base.yaml, config/prod.yaml]
+  output: build/config.yaml
+  strategy: deep
+
+generate:
+  method: pairwise
+  params:
+    python: ["3.10", "3.11", "3.12"]
+    os: ["linux", "macos", "windows"]
+  output: build/matrix.jsonl
+  seed: 42
+
+prompt:
+  system: |
+    You are an expert code reviewer.
+  instruction: |
+    Review the combined module and suggest improvements.
+  output: build/review_prompt.txt
+
+template:
+  file: templates/report.md.j2
+  data:
+    project: OpenComb
+    version: "0.2.0"
+  output: build/report.md
+```
+
+```bash
+opencomb recipe my_pipeline.yaml
+```
+
+## Publishing to PyPI
+
+This repository includes ready-to-use GitHub Actions:
+
+- **CI** (`.github/workflows/ci.yml`) – runs tests on Python 3.10–3.13 + builds the package
+- **Publish** (`.github/workflows/publish.yml`) – publishes to PyPI when you create a GitHub Release
+
+### How to release
+
+1. Make sure the version in `pyproject.toml` is correct (currently `0.2.0`)
+2. Create a new GitHub Release (or tag):
+   ```bash
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
+   Then create a Release on GitHub from that tag.
+3. The `publish.yml` workflow will automatically build and upload to PyPI.
+
+### Trusted Publishing (recommended)
+
+1. Go to https://pypi.org/manage/account/publishing/
+2. Add a new pending publisher:
+   - **PyPI Project Name**: `opencomb`
+   - **Owner**: `SlabyLol`
+   - **Repository name**: `OpenComb`
+   - **Workflow name**: `publish.yml`
+   - **Environment name**: `pypi`
+3. Create the project on PyPI if it doesn’t exist yet (first upload will create it).
+
+Alternatively you can use a classic API token:
+- Create a token on PyPI → add it as repository secret `PYPI_TOKEN`
+- Uncomment the token-based step in `publish.yml`
+
+## Development
+
+```bash
+git clone https://github.com/SlabyLol/OpenComb.git
+cd OpenComb
+pip install -e ".[dev]"
+pytest
+ruff check src tests
+```
+
+## License
+
+MIT © DarkFox Co. / SlabyLol
+
+## Links
+
+- **Repository**: https://github.com/SlabyLol/OpenComb
+- **Issues**: https://github.com/SlabyLol/OpenComb/issues
+- **PyPI**: https://pypi.org/project/opencomb/

opencomb-0.2.0/README.md

@@ -0,0 +1,214 @@
+# OpenComb
+
+**Smart Combiner for Code, Configs, Prompts, Templates, Recipes & Combinatorial Generation**
+
+[![PyPI](https://img.shields.io/pypi/v/opencomb.svg)](https://pypi.org/project/opencomb/)
+[![Python](https://img.shields.io/pypi/pyversions/opencomb.svg)](https://pypi.org/project/opencomb/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/SlabyLol/OpenComb/actions/workflows/ci.yml/badge.svg)](https://github.com/SlabyLol/OpenComb/actions/workflows/ci.yml)
+
+<p align="center">
+  <img src="docs/logo.svg" alt="OpenComb Logo" width="160"/>
+</p>
+
+**OpenComb** is a powerful, practical toolkit for developers that helps you:
+
+- **Combine** multiple Python source files into one clean module (with smart import deduplication)
+- **Merge** YAML, JSON and TOML configs intelligently (deep or shallow)
+- **Generate** combinatorial parameter sets (cartesian, pairwise testing, sampling)
+- **Build** structured LLM prompts from system / instruction / context / few-shot / user parts
+- **Render** Jinja2 templates (single or multi-file)
+- **Run declarative recipes** that orchestrate all of the above in one YAML file
+
+Perfect for rapid prototyping, test matrix generation, config management, AI/prompt engineering and automation pipelines.
+
+## Installation
+
+```bash
+pip install opencomb
+```
+
+Or with uv:
+
+```bash
+uv add opencomb
+```
+
+## Features at a Glance
+
+| Feature              | CLI Command     | Library Class            | Description                                      |
+|----------------------|-----------------|--------------------------|--------------------------------------------------|
+| Code Combining       | `combine`       | `CodeCombiner`           | Merge Python files + import dedupe               |
+| Config Merging       | `merge`         | `ConfigMerger`           | Deep / shallow YAML·JSON·TOML                    |
+| Combinatorial Gen    | `generate`      | `CombinatorialGenerator` | Cartesian · Pairwise · Sample                    |
+| Prompt Building      | `prompt`        | `PromptCombiner`         | Structured LLM prompts                           |
+| Template Rendering   | `template`      | `TemplateRenderer`       | Jinja2 power                                     |
+| Recipe Runner        | `recipe`        | `RecipeRunner`           | Full pipelines in one YAML                       |
+
+## Quick Start – CLI
+
+```bash
+# Combine Python files
+opencomb combine module_a.py module_b.py utils.py -o combined.py
+
+# Merge configs (later files win)
+opencomb merge base.yaml local.yaml secrets.toml -o final.yaml
+
+# Generate combinations
+opencomb generate -p params.yaml --method pairwise --report
+
+# Build an LLM prompt
+opencomb prompt \
+  --system system.txt \
+  --instruction task.txt \
+  --examples fewshot.yaml \
+  --user query.txt \
+  -o final_prompt.txt
+
+# Render Jinja2 templates
+opencomb template template.j2 --data data.yaml -o output.md
+
+# Run a full recipe
+opencomb recipe examples/sample_recipe.yaml
+opencomb recipe examples/sample_recipe.yaml --dry-run --verbose
+```
+
+## Quick Start – Library
+
+```python
+from opencomb import (
+    CodeCombiner,
+    ConfigMerger,
+    CombinatorialGenerator,
+    PromptCombiner,
+    TemplateRenderer,
+    RecipeRunner,
+)
+
+# Code
+combiner = CodeCombiner()
+code = combiner.combine_files(["a.py", "b.py"])
+
+# Config
+merger = ConfigMerger()
+config = merger.merge_files(["base.yaml", "override.yaml"])
+merger.save(config, "result.yaml")
+
+# Combinations
+gen = CombinatorialGenerator(seed=42)
+params = {"lr": [0.001, 0.01], "batch": [16, 32], "opt": ["adam", "sgd"]}
+all_combos = gen.cartesian(params)
+pairwise   = gen.pairwise(params)   # much smaller & efficient
+
+# Prompts
+pc = PromptCombiner()
+prompt = pc.combine(
+    system="You are a senior Python engineer.",
+    instruction="Review the following code.",
+    examples=[{"input": "x=1", "output": "Looks fine."}],
+    user="def foo(): pass",
+)
+
+# Templates
+renderer = TemplateRenderer()
+html = renderer.render_string("<h1>{{ title }}</h1>", title="OpenComb")
+
+# Recipes
+runner = RecipeRunner()
+results = runner.run("my_recipe.yaml")
+```
+
+## Recipe Example
+
+```yaml
+# my_pipeline.yaml
+name: full-pipeline
+
+combine:
+  files: [src/a.py, src/b.py, src/utils.py]
+  output: build/combined.py
+
+merge:
+  files: [config/base.yaml, config/prod.yaml]
+  output: build/config.yaml
+  strategy: deep
+
+generate:
+  method: pairwise
+  params:
+    python: ["3.10", "3.11", "3.12"]
+    os: ["linux", "macos", "windows"]
+  output: build/matrix.jsonl
+  seed: 42
+
+prompt:
+  system: |
+    You are an expert code reviewer.
+  instruction: |
+    Review the combined module and suggest improvements.
+  output: build/review_prompt.txt
+
+template:
+  file: templates/report.md.j2
+  data:
+    project: OpenComb
+    version: "0.2.0"
+  output: build/report.md
+```
+
+```bash
+opencomb recipe my_pipeline.yaml
+```
+
+## Publishing to PyPI
+
+This repository includes ready-to-use GitHub Actions:
+
+- **CI** (`.github/workflows/ci.yml`) – runs tests on Python 3.10–3.13 + builds the package
+- **Publish** (`.github/workflows/publish.yml`) – publishes to PyPI when you create a GitHub Release
+
+### How to release
+
+1. Make sure the version in `pyproject.toml` is correct (currently `0.2.0`)
+2. Create a new GitHub Release (or tag):
+   ```bash
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
+   Then create a Release on GitHub from that tag.
+3. The `publish.yml` workflow will automatically build and upload to PyPI.
+
+### Trusted Publishing (recommended)
+
+1. Go to https://pypi.org/manage/account/publishing/
+2. Add a new pending publisher:
+   - **PyPI Project Name**: `opencomb`
+   - **Owner**: `SlabyLol`
+   - **Repository name**: `OpenComb`
+   - **Workflow name**: `publish.yml`
+   - **Environment name**: `pypi`
+3. Create the project on PyPI if it doesn’t exist yet (first upload will create it).
+
+Alternatively you can use a classic API token:
+- Create a token on PyPI → add it as repository secret `PYPI_TOKEN`
+- Uncomment the token-based step in `publish.yml`
+
+## Development
+
+```bash
+git clone https://github.com/SlabyLol/OpenComb.git
+cd OpenComb
+pip install -e ".[dev]"
+pytest
+ruff check src tests
+```
+
+## License
+
+MIT © DarkFox Co. / SlabyLol
+
+## Links
+
+- **Repository**: https://github.com/SlabyLol/OpenComb
+- **Issues**: https://github.com/SlabyLol/OpenComb/issues
+- **PyPI**: https://pypi.org/project/opencomb/

opencomb-0.2.0/examples/sample_recipe.yaml

@@ -0,0 +1,22 @@
+# OpenComb Sample Recipe
+name: demo-pipeline
+
+# Generate a test matrix
+generate:
+  method: pairwise
+  params:
+    python: ["3.10", "3.11", "3.12"]
+    os: ["linux", "macos"]
+    arch: ["x64", "arm64"]
+  output: build/test_matrix.jsonl
+  seed: 42
+
+# Build a prompt
+prompt:
+  system: |
+    You are a helpful Python expert.
+  instruction: |
+    Explain the following code clearly and suggest improvements.
+  user: |
+    How does the pairwise generator work?
+  output: build/prompt.txt

opencomb-0.2.0/pyproject.toml

@@ -0,0 +1,96 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "opencomb"
+version = "0.2.0"
+description = "OpenComb – Smart Combiner for Code, Configs, Prompts, Templates, Recipes & Combinatorial Generation"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "DarkFox Co.", email = "darkfox-to@proton.me" }
+]
+keywords = [
+    "combiner",
+    "code-generation",
+    "config-merge",
+    "combinatorial",
+    "testing",
+    "cli",
+    "prompts",
+    "templates",
+    "recipes",
+    "jinja2",
+    "opencomb"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Utilities",
+    "Environment :: Console",
+]
+dependencies = [
+    "typer>=0.12.0",
+    "rich>=13.0.0",
+    "pyyaml>=6.0",
+    "tomli>=2.0.0; python_version < '3.11'",
+    "tomli-w>=1.0.0",
+    "click>=8.0.0",
+    "jinja2>=3.1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+    "ruff>=0.5.0",
+    "mypy>=1.10.0",
+]
+
+[project.scripts]
+opencomb = "opencomb.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/SlabyLol/OpenComb"
+Repository = "https://github.com/SlabyLol/OpenComb"
+Issues = "https://github.com/SlabyLol/OpenComb/issues"
+Documentation = "https://github.com/SlabyLol/OpenComb#readme"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/opencomb"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/examples",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

opencomb-0.2.0/src/opencomb/__init__.py

@@ -0,0 +1,23 @@
+"""
+OpenComb – Smart Combiner for Code, Configs, Prompts, Templates, Recipes
+and Combinatorial Generation.
+
+A practical toolkit for developers.
+"""
+
+from opencomb.combiner import CodeCombiner, ConfigMerger
+from opencomb.combinatorial import CombinatorialGenerator
+from opencomb.prompt import PromptCombiner
+from opencomb.recipe import RecipeRunner
+from opencomb.template import TemplateRenderer
+
+__version__ = "0.2.0"
+__all__ = [
+    "CodeCombiner",
+    "ConfigMerger",
+    "CombinatorialGenerator",
+    "PromptCombiner",
+    "TemplateRenderer",
+    "RecipeRunner",
+    "__version__",
+]