A tool suite for converting DLS XMLbuilder IOC projects to epics-containers ibek.
| What | Where |
|---|---|
| Source | https://github.com/epics-containers/builder2ibek |
| PyPI | pip install builder2ibek |
| Documentation | https://epics-containers.github.io/builder2ibek |
| Releases | https://github.com/epics-containers/builder2ibek/releases |
For Claude agentic conversions, use the claude-sandbox guest project as a peer workspace.
Run the full test suite:
uv run pytestTests are parameterized per sample XML, so you can run a single IOC:
uv run pytest -k "BL11I-CS-IOC-09"
uv run pytest "tests/test_file_conversion.py::test_convert[BL11I-CS-IOC-09]"Regenerate expected outputs and schema:
./update-schema
./tests/samples/make_samples.sh
./update-schemaSee golden-file tests for how the baselines are reviewed and committed.
CI can't reach ibek-support-dls on Diamond's GitLab, so the support YAMLs the
samples need are vendored into tests/vendored-support-dls/. After moving the
ibek-support-dls pin, refresh that copy in the same commit:
git -C ibek-support-dls checkout <sha>
git add ibek-support-dls
git commit -m "Bump ibek-support-dls to <sha>"
python3 tests/vendor_support_dls.py --update
git add tests/vendored-support-dls
git commit --amend --no-edit
uv run pytest--update only runs once the new pin is committed, and two guard tests compare
against the committed pin, not a staged one. So the suite stays red until both
steps are done. If the tests show sample differences, regenerate with
./tests/samples/make_samples.sh and review the diff before committing. A bump
of ibek-support alone needs only the commit and the tests.
See testing and CI for the details and the guards.
╭─ Commands ───────────────────────────────────────────────────────────────────╮ │ xml2yaml Convert a builder XML IOC instance definition file into an │ │ ibek YAML file │ │ beamline2yaml Convert every IOC in a beamline's BUILDER to an ibek │ │ services folder │ │ autosave Convert DLS autosave DB template comments into autosave req │ │ files │ │ db-compare Compare two DB files and output the differences │ ╰──────────────────────────────────────────────────────────────────────────────╯
See https://epics-containers.github.io/builder2ibek for full documentation.