https://github.com/boris-code/clangformat-xcode
https://github.com/boris-code/clangformat-xcode
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/boris-code/clangformat-xcode
- Owner: Boris-code
- License: mit
- Created: 2015-11-06T07:44:48.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2016-01-05T03:20:46.000Z (about 10 years ago)
- Last Synced: 2025-02-01T06:27:42.693Z (11 months ago)
- Language: Objective-C
- Size: 5.29 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ClangFormat-Xcode
An Xcode plug-in to format your code using Clang's format tools, by [@travisjeffery](https://twitter.com/travisjeffery).
With [clang-format](http://clang.llvm.org/docs/ClangFormat.html) you can use Clang to format your code to styles such as LLVM, Google, Chromium, Mozilla, WebKit, or your own configuration.
## Installation:
Install via [Alcatraz](https://github.com/mneorr/Alcatraz).
OR
Clone this repo, build and run ClangFormat, restart Xcode.
## Removing ClangFormat
To remove ClangFormat, run the following in your terminal:
`rm -r "~/Library/Application Support/Developer/Shared/Xcode/Plug-ins/ClangFormat.xcplugin"`
Or just find the same file and move it to the trash. You'll need to restart Xcode after deleting the plugin.
## Usage:
### Format on save
I.e., you press `command-s` and the file is formatted and wrote to disk.
In the menu, open Edit > Clang Format > Click Format on save (a checkmark appears in this menu item indicicating that the feature is active.)
### Assign keyboard shortcuts
You can assign your own keyboard shortcuts like so:
- Open the System Preferences > Keyboard > Shortcuts > App Shortcuts > Click +
- Set the application to be Xcode
- Set the menu title to an action title, e.g. "Format File in Focus"
- Set your shortcut
In this example, we'll format the active file when `control-i` is pressed.
### Using your own style configuration
By using Clang Format > File in the plug-in menu, Clang will look for the nearest `.clang-format` file from the input file. Most likely, you'll have a .clang-format file at the root of your project.
[Here are the options for .clang-format and how they're configured](http://clang.llvm.org/docs/ClangFormatStyleOptions.html). Here's a [cool interactive website](http://clangformat.com/) to help you make your .clang-format file.
If one of the built-in styles is close to what you want, you can bootstrap your own configuration with:
`./bin/clang-format -style=llvm -dump-config > .clang-format`
For example, this .clang-format is similar to the [Linux Kernel style](https://www.kernel.org/doc/Documentation/CodingStyle):
```
BasedOnStyle: LLVM
IndentWidth: 8
UseTab: Always
BreakBeforeBraces: Linux
AllowShortIfStatementsOnASingleLine: false
IndentCaseLabels: false
```
And this is similar to Visual Studio's style:
```
UseTab: Never
IndentWidth: 4
BreakBeforeBraces: Allman
AllowShortIfStatementsOnASingleLine: false
IndentCaseLabels: false
ColumnLimit: 0
```