Language support

Topiary ships with formatting support for a number of languages. The formatting styles for these languages come in two levels of maturity:

• Supported languages are actively maintained by the Topiary team.

• Experimental languages do not cover a significant proportion of the target grammar, may contain formatting bugs and could even be deprecated. You should not use these to format production code.

We also ship formatting styles for languages from a number of contributors. The Topiary team does not actively maintain these and -- while not necessarily -- where indicated, they should also be considered experimental.

Supported

These formatting styles cover their target language and fulfil Topiary's stated design goals. They are exposed, in Topiary, through the --language command line flag, or language detection (based on file extension).

• Bash
• JSON
• Nickel
• OCaml (both implementations and interfaces)
• OCamllex
• TOML
• Tree Sitter Queries

Contributed

These languages' formatting styles have been generously provided by external contributors. They are built in, by default -- unless marked as experimental -- so are exposed in the same way as supported languages.

• CSS, by Eric Lavigne
• OpenSCAD, by Mikhail Katychev
• SDML, by Simon Johnston

Experimental

These languages' formatting styles -- from either the Topiary team or external contributors -- are subject to change and/or not yet considered production-ready. They are not built by default and are gated behind a feature flag (either experimental, for all of them, or by their individual name). Once included, they can be accessed in Topiary in the usual way.

• Rust