kubesplit 0.6.0

A CLI to split multidoc yaml formatted kubernetes descriptors to a set of single resource files

kubesplit

Split a multidoc YAML file of Kubernetes descriptors into a set of single-resource files — one file per resource, nicely formatted and grouped by namespace.

If you just want an opinionated YAML formatter, have a look at yamkix.

Documentation

📖 Full documentation: https://looztra.github.io/kubesplit/

It follows the Diátaxis framework:

• Getting started tutorial
• How-to guides (install, split, organize output, control quotes, Kustomize/Helm)
• CLI reference and file naming rules
• How kubesplit works

Quick start

# Install (see the docs for pip / Docker / mise alternatives)
uv tool install kubesplit

# Split a file into an output directory
kubesplit --input all-in-one.yml --output out

# Or read from STDIN (compose with kustomize / helm)
kustomize build overlays/prod | kubesplit -q -i - -o generated/prod

Contributing

See the contributing guide.

Credits

• Kubesplit uses the awesome ruamel.yaml library and the yamkix formatter.