Transmute

Common Patterns

# Convert JSON to XML through the public wrapper
printf '{"a":1}\n' | transmute -j2x -set Set -rec Rec

# Pretty-print JSON using the wrapper's python helper path
printf '{"a":1}\n' | transmute -j2p

# Wrapper-level line-length sort helper
printf 'bbb\na\ncc\n' | transmute -sort-by-length

Recommended Workflow

1. Start with transmute -help to choose the right mode.
2. Prefer the wrapper over transmute.Linux when you want portability or wrapper-only helper modes.
3. Feed data through stdin unless the selected mode explicitly documents file-based arguments.
4. If a mode behaves oddly, check whether it is one of the shell-intercepted paths before blaming the compiled backend.

Guardrails

• transmute -help and transmute -version both work here and report version 24.0.
• The wrapper intercepts several modes itself, including -encodeXML, -decodeXML, -plainXML, -x2p, -j2p, -x2j, -word-pairs, -sort-by-length, and multiple newline-conversion helpers.
• Some intercepted modes have extra runtime dependencies: for example -x2p needs xmllint, -j2p needs python3, and several helpers require perl.
• In local testing, printf '{"a":1}\n' | transmute -j2x -set Set -rec Rec produced a wrapped XML document with <Set><Rec><a>1</a></Rec></Set>.
• If the compiled backend is missing, the wrapper prints explicit download instructions for transmute.<platform>.gz rather than failing silently.