Metadata-Version: 2.5
Name: opencomb
Version: 0.19.2
Summary: OpenComb – Everything developers need: combine, merge, pak, init, check, recipes & more
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,dotenv,jinja2,opencomb,prompts,recipes,templates,testing
Classifier: Development Status :: 4 - Beta
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.16.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'
Provides-Extra: format
Requires-Dist: black>=24.0.0; extra == 'format'
Requires-Dist: ruff>=0.5.0; extra == 'format'
Provides-Extra: watch
Requires-Dist: watchdog>=4.0.0; extra == 'watch'
Description-Content-Type: text/markdown

# OpenComb

**Developer Swiss Army Knife** — **100% plain Python source** (no base64, no obfuscation, no hidden loaders).

Combine, build, drill, PRT language, **56+ templates**, **PyRunner**, stacks, wizard, OCC SSH, **Problem Scanner**, **Zombie toolkit**, **custom commands**, and a full **Python API**.

[![PyPI](https://img.shields.io/pypi/v/opencomb.svg)](https://pypi.org/project/opencomb/)
[![CI](https://github.com/SlabyLol/OpenComb/actions/workflows/ci.yml/badge.svg)](https://github.com/SlabyLol/OpenComb/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

<p align="center">
  <img src="https://raw.githubusercontent.com/SlabyLol/OpenComb/main/docs/logo.svg" alt="OpenComb Logo" width="160"/>
</p>

```bash
pip install opencomb
```

## Transparency

Every module under `src/opencomb/` is normal, readable Python.  
There are **no** compressed payload files, **no** `exec(compile(...))` loaders, **no** base64 blobs in the package.

## Highlights (v0.19.2)

| Area | CLI | Python API |
|------|-----|------------|
| **Zombie toolkit** | `zombie run-check` · `shoot` · `list` · `parents` | `run_zombie_check()` · `shoot_folder()` |
| **Problem Scanner** | `problemscanner` (GUI) · `--cli` | `run_scan()` · `launch_gui()` |
| **Custom commands** | `add` · `add --list` · `add --del` | user command registry |
| **Codec** (optional) | `codec encode` · `decode` | `encode()` · `decode()` |
| **Templates** | `templates` · `new` | `list_templates()` · `apply_template()` |
| **Code / Config** | `combine` · `merge` · `env` | `combine()` · `merge_configs()` |
| **Packages** | `pak add` … | `PackageManager` |
| **SSH** | `occ` | `SSHTarget` · `occ_connect()` |

---

## Custom commands

```bash
opencomb add mycommand python hello.py
opencomb mycommand
opencomb add --list
opencomb add --del mycommand
```

## Zombie / Scanner

```bash
opencomb zombie run-check --once
opencomb zombie shoot ~/Downloads --dry-run
opencomb problemscanner --cli
```

## Codec (optional utility)

Optional encode/decode for your own files — **not** used to hide package source:

```bash
opencomb codec encode mycode.py
opencomb codec decode mycode.py.oc
```

## Development

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

## License

MIT © DarkFox Co.
