Clang Format
A C++ code formatter based on Clang Format, for beautiful code with minimal effort in Sublime Text 3
Details
Installs
- Total 51K
- Win 19K
- Mac 13K
- Linux 20K
Jun 9 | Jun 8 | Jun 7 | Jun 6 | Jun 5 | Jun 4 | Jun 3 | Jun 2 | Jun 1 | May 31 | May 30 | May 29 | May 28 | May 27 | May 26 | May 25 | May 24 | May 23 | May 22 | May 21 | May 20 | May 19 | May 18 | May 17 | May 16 | May 15 | May 14 | May 13 | May 12 | May 11 | May 10 | May 9 | May 8 | May 7 | May 6 | May 5 | May 4 | May 3 | May 2 | May 1 | Apr 30 | Apr 29 | Apr 28 | Apr 27 | Apr 26 | Apr 25 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 4 | 6 | 5 | 2 | 4 | 5 | 6 | 3 | 7 | 4 | 7 | 6 | 4 | 3 | 3 | 8 | 4 | 5 | 5 | 0 | 1 | 6 | 10 | 3 | 5 | 7 | 2 | 4 | 3 | 3 | 10 | 6 | 4 | 5 | 8 | 3 | 3 | 2 | 3 | 4 | 8 | 1 | 7 | 3 | 4 | 5 |
Mac | 0 | 4 | 2 | 1 | 2 | 0 | 2 | 2 | 2 | 3 | 0 | 2 | 1 | 0 | 2 | 1 | 3 | 1 | 3 | 1 | 0 | 2 | 1 | 3 | 5 | 5 | 2 | 2 | 2 | 3 | 5 | 1 | 4 | 2 | 3 | 4 | 2 | 3 | 2 | 1 | 0 | 0 | 3 | 2 | 5 | 2 |
Linux | 1 | 0 | 3 | 4 | 1 | 3 | 3 | 8 | 13 | 2 | 6 | 5 | 1 | 2 | 2 | 5 | 1 | 0 | 6 | 4 | 8 | 4 | 4 | 5 | 4 | 7 | 6 | 3 | 3 | 6 | 5 | 7 | 3 | 3 | 0 | 4 | 2 | 5 | 3 | 7 | 5 | 2 | 5 | 3 | 3 | 7 |
Readme
- Source
- raw.githubusercontent.com
Clang Format
What it does
Clang-format is a tool for formatting C++, built on LLVM. This is a package that allows you to run it easily from within Sublime Text.
About
In this package, we provide an alternative wrapper around clang-format for use within Sublime Text 3. Whilst LLVM does provide a very simple plugin to work with Sublime Text here, it doesn't really exploit any of the Sublime Text package functionality. We add new features such as customising the style from a settings file, selecting styles using the Command Palette, and easier installation.
Installing
- Install
clang-format
in one of the following ways:- Install using your package manager, e.g.
sudo apt-get install clang-format
orsudo apt-get install clang-format-5.0
. - Download the entire LLVM toolchain
and extract the
clang-format
binary. Just extract the.tar.xz
file and copybin/clang-format
into your PATH (e.g./usr/local/bin
).
- Install using your package manager, e.g.
- Install this package through Package Control in the usual way.
- Set the path to the clang-format binaries. You can do this from within Sublime
Text by choosing
Clang Format - Set Path
from the command palette. Hint: the path should look something like this[path/to/clang]/clang/bin/clang-format
. If clang-format is in your system path, you shouldn't need to do anything.
Use
- Default shortcut is
super+option+a
on OSX andoption+cmd+a
otherwise. This will apply clang-format to the selection. - From the command palette, you can select the formatting type by using
Clang Format: Select Style
. You will find the small number of defaults, and also a new 'Custom' entry. Selecting this entry allows you to customise the style through a settings file. You can access it from the main menu, underPackage Settings
. In this file you can add custom rules, such asAllmen
style braces, and different indents. For examples see http://clang.llvm.org/docs/ClangFormatStyleOptions.html. - Settings for the 'Custom' format and others are available through the Sublime Text preferences.
- It is possible to run the formatter on every save to a file, change settings
to
"format_on_save": true
. - To change settings on a per-package basis, add them under
ClangFormat
key, example project.sublime-settings:
{
"folders": [],
"settings": {
"ClangFormat": {
"format_on_save": true
}
}
}
If You Liked This
… And want to contribute, PR's gladly accepted!
Maybe you'll like my other plugin, iOpener. It lets you open files by path, with completion, history, and other goodies.
Otherwise, why not pop on over and star this repo on GitHub?
Credits
Thanks to the LLVM project for doing the hard work, including writing clang format, and also the original Sublime Text plugin on which this package is based.
Also thanks to y0ssar1an, Bendtherules and other contributors for their improvements!
Finally
Why not go and watch the video that got me interested in clang-format in the first place?