intellij.md

   1 # Running Rustfmt from IntelliJ or CLion
   2
   3 ## Installation
   4
   5 - Install [CLion](https://www.jetbrains.com/clion/), [IntelliJ Ultimate or CE](https://www.jetbrains.com/idea/) through the direct download link or using the [JetBrains Toolbox](https://www.jetbrains.com/toolbox/).
   6   CLion and IntelliJ Ultimate [provide a built-in debugger interface](https://github.com/intellij-rust/intellij-rust#compatible-ides) but they are not free like IntelliJ CE.
   7
   8 - Install the [Rust Plugin](https://intellij-rust.github.io/) by navigating to File → Settings → Plugins and searching the plugin in the Marketplace
   9   ![plugins](https://user-images.githubusercontent.com/6505554/83944518-6f1e5c00-a81d-11ea-9c35-e16948811ba8.png)
  10
  11 - Press "Install" on the Rust plugin
  12   ![install rust](https://user-images.githubusercontent.com/6505554/83944533-82c9c280-a81d-11ea-86b3-ee2e31bc7d12.png)
  13
  14 - Restart CLion/IntelliJ
  15
  16 ## Configuration
  17
  18 ### Run Rustfmt on save
  19
  20 - Open Rustfmt settings (File → Settings → Languages & Frameworks → Rust → Rustfmt) and enable "Run rustfmt on Save"
  21   ![run_rustfmt_on_save](https://user-images.githubusercontent.com/6505554/83944610-3468f380-a81e-11ea-9c34-0cbd18dd4969.png)
  22
  23 - IntellJ uses autosave, so now your files will always be formatted according to rustfmt. Alternatively you can use Ctrl+S to reformat file manually
  24
  25 ### Bind shortcut to "Reformat File with Rustfmt" action
  26
  27 - Open the settings window (File → Settings) and search for "reformat"
  28   ![keymap](https://user-images.githubusercontent.com/1133787/47240922-2ae10c80-d3ea-11e8-9d8f-c798d9749240.png)
  29 - Right-click on "Reformat File with Rustfmt" and assign a keyboard shortcut
  30
  31   ![shortcut_window](https://user-images.githubusercontent.com/1133787/47240981-5b28ab00-d3ea-11e8-882e-8b864164db74.png)
  32 - Press "OK"
  33   ![shortcut_after](https://user-images.githubusercontent.com/1133787/47241000-6976c700-d3ea-11e8-9342-50ebc2f9f97b.png)
  34
  35 - Done. You can now use rustfmt in an opened *.rs file with your previously specified shortcut