Metadata-Version: 2.5
Name: cmk-werk-zeug
Version: 0.4.4
Summary: cmk-werk-zeug
Author-email: Benedikt Seidl <benedikt.seidl@checkmk.com>, Frans Fürst <frans.fuerst@checkmk.com>
License-File: LICENSE
Requires-Python: <4,>=3.12
Requires-Dist: aiohttp>=3.13.3
Requires-Dist: argcomplete>=3.5
Requires-Dist: cmk-dev-site>=1.19.3
Requires-Dist: jira>=3.10.5
Requires-Dist: psycopg2-binary>=2.9.11
Requires-Dist: pydantic>=2
Requires-Dist: python-jenkins>=1.8.3
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: secretstorage>=3.5.0
Requires-Dist: sqlalchemy>=2.0.45
Requires-Dist: textual>=7.3.0
Requires-Dist: trickkiste>=0.3.7
Requires-Dist: vcrpy>=8.1.1
Description-Content-Type: text/markdown

# CWZ - CMK-Werk-Zeug

Tools for Checkmk development. Some solid, some rough, some experimental.

## Tools

**[cmk-components](doc/cmk-components.md)** - who owns what in `check_mk`, straight from Gerrit's
code-owners plugin. TUI by default. `list`, `info`, `owners PATH`, `me` and friends for scripts.

**[update-gerrit-changes](doc/update-gerrit-changes.md)** - a table of your local commits against
their Gerrit changes: in sync, behind, diverged, not pushed. Read-only.

**[cmk-infect](doc/cmk-infect.md)** - hardlink your changed Python files into an installed OMD
version. Zero-second deploy. Python only, rough edges.

**[cmk-up](doc/cmk-up.md)** (alias `cmk-setup`) - build a Checkmk setup from a YAML
playbook: versions, sites, hosts with faked services, users, rules, BI. Undoes itself unless told
otherwise. `--enroll` writes a playbook from an existing machine or a crash report.
`cmk-up 01-minimal` runs a shipped example.

**[cmk-check-plugins](doc/cmk-check-plugins.md)** - run check plugins against recorded SNMP walks
and agent outputs. Proof of concept. Needs a `check_mk` Python environment.

**[ci-build-metrics](doc/ci-build-metrics.md)** - fetch finished Jenkins builds, match failures
against known issues, export to PostgreSQL. Sheriff tooling, built for one user.

**[worklog-from-fs](doc/worklog-from-fs.md)** (alias `forgot-to-track-time-again`) - guess your
daily activity from file modification times.

`devboard` is installed too: an experimental Gerrit/Jira dashboard TUI. Undocumented.

Gerrit and Jenkins credentials work the same for all tools: [doc/credentials.md](doc/credentials.md).

## Install

Use without installation:
```bash
uvx --from cmk-werk-zeug cmk-up <CMD>
```

Easy `pipx` based installation:

```bash
pipx install cmk-werk-zeug
```

Development setup:

```bash
git clone ssh://review.lan.tribe29.com:29418/cmk-werk-zeug
cd cmk-werk-zeug && uv sync
uv run <CMD>
uv tool install --editable .
ci/run-change-validation.sh   # what CI runs: lock check, pre-commit, unit tests
```

`ci-build-metrics export` needs a local PostgreSQL (`sudo apt install postgresql`). Setup in
[doc/ci-build-metrics.md](doc/ci-build-metrics.md).

