Installation

All of the tools are included as part of the cmake-format python distribution package.

Install with pip

The easiest way to install cmake-format is from pypi.org using pip. For example:

pip install cmake_format

If you’re on a linux-type system (such as ubuntu) the above command might not work if it would install into a system-wide location. If that’s what you really want you might need to use sudo, e.g.:

sudo pip install cmake_format

In general though I wouldn’t really recommend doing that though since things can get pretty messy between your system python distributions and your pip managed directories. Alternatively you can install it for your user with:

pip install --user cmake_format

which I would probably recommend for most users.

Note

If you wish to use a configuration file in YAML format you’ll want to install with the optional YAML feature, e.g.:

pip install cmake_format[YAML]

Install from source

You can also install from source with pip. You can download a release package from github or pypi and then install it directly with pip. For example:

pip install v0.6.9.tar.gz

Note that the release packages on github are automatically generated from git tags which are the same commit used to generate the corresponding version package on pypi.org. So whether you install a particular version from github or pypi shouldn’t matter.

Pip can also install directly from github. For example:

pip install git+https://github.com/cheshirekow/cmake_format.git

If you wish to test a pre-release or dev package from a branch called foobar you can install it with:

pip install "git+https://github.com/cheshirekow/cmake_format.git@foobar"

IDE Integrations

For the formatter specifically:

Note that for both plugins cmake-format itself must be installed separately.

Pre-commit

If you are a user of the pre-commit project you can easily add the formatter, cmake-format, to your hooks with the following addition to your .pre-commit-hooks.yaml file.

repos:
  - repo: https://github.com/cheshirekow/cmake-format-precommit
    rev: v0.6.9
    hooks:
    - id: cmake-format