You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A [Prettier plugin](https://prettier.io/docs/en/plugins.html) for automatically formatting your [Solidity](https://github.com/ethereum/solidity) code.
12
-
13
-
## Nomic Foundation's Slang
14
-
15
-
Nomic Foundation has put a lot of effort in providing a set of compiler APIs that helped us rethink our approach to parsing and rely on their flexibility, detail oriented solution and continuos support of new and old Solidity syntaxes.
16
-
17
-
Since v2.0.0 this package will ship with the Slang parser and this change must be implemented in existing configurations by replacing `parser: 'antlr'` with `parser: 'slang'`.
18
-
19
-
The `antlr4` parser (`antlr`) is still supported for the time being and will trigger a deprecation warning, since Slang gives us a much more powerful tool, is faster, allowed us to fully transition into typescript (minimizing the introduction of mismatching type bugs), and allows prettier to format the code in a much more decoupled way and position comments with a greater precision.
11
+
A [Prettier](https://prettier.io/) plugin for automatically formatting your [Solidity](https://docs.soliditylang.org/en/latest/) code.
20
12
21
13
## Installation and usage
22
14
@@ -28,15 +20,13 @@ Install both `prettier` and `prettier-plugin-solidity`:
@@ -52,13 +42,11 @@ Or you can use it as part of your linting to check that all your code is prettif
52
42
53
43
### Using in the Browser
54
44
55
-
_Added in v1.1.0_
56
-
57
45
To use this package in the browser, you need to load Prettier's standalone bundle before loading the build provided in this package.
58
46
59
47
Prettier's unpkg field points to `https://unpkg.com/prettier/standalone.js`, in a similar way this plugin points to `https://unpkg.com/prettier-plugin-solidity/dist/standalone.js`.
60
48
61
-
Once the scripts are loaded you will have access the globals `prettier` and `prettierPlugins`.
49
+
Once the scripts are loaded you will have access to the globals `prettier` and `prettierPlugins`.
62
50
63
51
We follow Prettier's strategy for populating their plugins in the object `prettierPlugins`, you can load other plugins like `https://unpkg.com/[email protected]/parser-markdown.js` and Prettier will have access to multiple parsers.
64
52
@@ -83,17 +71,15 @@ We follow Prettier's strategy for populating their plugins in the object `pretti
83
71
</script>
84
72
```
85
73
86
-
For more details and please have a look at [Prettier's documentation](https://prettier.io/docs/en/browser.html).
74
+
For more details, have a look at [Prettier's documentation](https://prettier.io/docs/en/browser.html).
87
75
88
76
### Creating a package for the Browser
89
77
90
-
_Added in v1.2.0_
91
-
92
78
If you are creating your own package to be run in a browser, you might want to import the standalone files directly.
@@ -138,7 +124,7 @@ Most options are described in Prettier's [documentation](https://prettier.io/doc
138
124
139
125
### Compiler
140
126
141
-
Many versions of the Solidity compiler have changes that affect how the code should be formatted. This plugin, by default, tries to format the code in the most compatible way that it's possible, but you can use the `compiler` option to nudge it in the right direction.
127
+
Many versions of the Solidity compiler have changes that affect how the code should be formatted. This plugin, by default, tries to format the code in the most compatible way that is possible, but you can use the `compiler` option to nudge it in the right direction.
142
128
143
129
One example of this is import directives. Before `0.7.4`, the compiler didn't accept multi-line import statements, so we always format them in a single line. But if you use the `compiler` option to indicate that you are using a version greater or equal than `0.7.4`, the plugin will use multi-line imports when it makes sense.
144
130
@@ -218,9 +204,18 @@ You might have a multi-version project, where different files are compiled with
You can configure the parser used by Prettier Solidity. Two Solidity parsers are supported:
210
+
211
+
-[Slang](https://nomicfoundation.github.io/slang) (the default), a more powerful and correct parser that results in better formatting for some edge cases, especially when comments are involved.
212
+
-[Solidity Parser for JavaScript](https://github.com/solidity-parser/parser/), an [ANTLR](https://www.antlr.org/)-based parser. This is the version that Prettier Solidity v1 used by default. This parser is still supported in v2, but it's deprecated and will be removed in the next major version. You can use this parser by setting `parser: "antlr"` in your Prettier configuration.
We modified the `do` instruction to also install this plugin. Then you'll have to configure the plugin to always use the
266
-
version installed in the vim plugin's directory. The vim-plug directory depends on value you use in `call plug#begin('~/.vim/<dir>')`:
260
+
We modified the `do` instruction to also install this plugin. Then you'll have to configure the plugin to always use the version installed in the vim plugin's directory. The vim-plug directory depends on the value you use in `call plug#begin('~/.vim/<dir>')`:
267
261
268
262
```vim
269
263
let g:prettier#exec_cmd_path = '~/.vim/plugged/vim-prettier/node_modules/.bin/prettier'
@@ -282,34 +276,29 @@ Now Prettier will be run every time the file is saved.
282
276
283
277
### VSCode
284
278
285
-
VSCode is not familiar with the Solidity language.
286
-
There are 2 extensions that you can install to provide support for Solidity:
279
+
VSCode is not familiar with the Solidity language. There are two extensions that you can install to provide support for Solidity:
> :warning:**These 2 extensions offer similar functionality and will clash with each other**: Please choose which one matches your projects better.
298
-
299
290
These extensions provide basic integration with Prettier; in most cases, no further action is needed.
300
291
301
-
Make sure your editor has format on save set to true.
302
-
When you save VSCode will ask you what formatter would you like to use for the Solidity language, you can choose `JuanBlanco.solidity` or `NomicFoundation.hardhat-solidity`.
292
+
Make sure your editor has format-on-save set to true. When you save, VSCode will ask you what formatter would you like to use for the Solidity language. We recommend choosing `NomicFoundation.hardhat-solidity`.
303
293
304
294
At this point VSCode's `settings.json` should have a configuration similar to this:
305
295
306
-
```JSON
296
+
```JSON5
307
297
{
308
298
"editor.formatOnSave":true,
309
299
"solidity.formatter":"prettier", // This is the default so it might be missing.
@@ -320,15 +309,15 @@ If you want more control over other details, you should proceed to install [`pre
320
309
code --install-extension esbenp.prettier-vscode
321
310
```
322
311
323
-
To interact with 3rd party plugins, `prettier-vscode` will look in the project's npm modules, so you'll need to have `prettier` and `prettier-plugin-solidity` in your `package.json`
312
+
To interact with third-party plugins, `prettier-vscode` will look in the project's npm modules, so you'll need to have `prettier` and `prettier-plugin-solidity` in your `package.json`
This will allow you to specify the version of the plugin in case you want to use the latest version of the plugin or need to freeze the formatting since new versions of this plugin will implement tweaks on the possible formats.
330
319
331
-
You'll have to let VSCode what formatter you prefer.
320
+
You'll have to let VSCode know what formatter you prefer.
332
321
This can be done by opening the command palette and executing:
333
322
334
323
```
@@ -351,7 +340,7 @@ Now VSCode's `settings.json` should have this:
351
340
352
341
Note: By design, Prettier prioritizes a local over a global configuration. If you have a `.prettierrc` file in your project, your VSCode's default settings or rules in `settings.json` are ignored ([prettier/prettier-vscode#1079](https://github.com/prettier/prettier-vscode/issues/1079)).
353
342
354
-
### Pnpm
343
+
### pnpm
355
344
356
345
To make Prettier Solidity work in your project, you have to add a `.prettierrc` file as shown [here](#configuration-file).
357
346
@@ -400,21 +389,6 @@ Notice that the unnecessary parentheses in `modifier2` were removed in the funct
400
389
5. Push to the branch (`git push origin feature/fooBar`)
401
390
6. Create a new Pull Request
402
391
403
-
## Who's using it?
404
-
405
-
These are some of the projects using Prettier Solidity:
0 commit comments