Add a single-context-parens option (#288) #304
Conversation
|
👋 @sgillespie Reviewer: Please verify the following things have been done, if applicable.
|
|
OK, I just realized I didn't add the documentation above. Working on that now. |
changelog.d/single-context-parens.md
Outdated
| @@ -0,0 +1,3 @@ | |||
| * Add a `single-constraint-parens` for controlling parenthesis around constraints in type | |||
| signatures. See [issue 288](https://github.com/fourmolu/fourmolu/pull/304) | |||
| * https://github.com/fourmolu/fourmolu/pull/304 | |||
There was a problem hiding this comment.
Nit: This is already linked in the first bullet, no need to add a second
README.md
Outdated
| | `unicode` | `always`, `detect`, **`never`** | Output Unicode syntax. With `detect` we output Unicode syntax exactly when the extension is seen to be enabled. When using `always`, make sure to have the `UnicodeSyntax` extension enabled, or Fourmolu will throw errors. | ||
| | `respectful` | **`true`**, `false` | Be less aggressive in reformatting input, e.g. keep empty lines in import list | ||
| | `fixities` | list of strings (**`[]`**) | See the "Language extensions, dependencies, and fixities" section below | ||
| | `single-constraint-parens`|**`always`**, `never`, `auto` | How to style optional parentheses around single constraints (`auto` |
There was a problem hiding this comment.
There's an unclosed parenthesis here. Also, can you add spaces around this pipe 🙃
| | `single-constraint-parens`|**`always`**, `never`, `auto` | How to style optional parentheses around single constraints (`auto` | |
| | `single-constraint-parens` | **`always`**, `never`, `auto` | How to style optional parentheses around single constraints (`auto` |
There was a problem hiding this comment.
Thanks for the feedback!
I've updated the changelog.d/ file and updated the formatting in the README. I did not add an explanation of all the options as I felt they were fairly straightforward, but please let me know if you disagree.
I'm not sure how you guys like to structure commits, so let me know if you want me to squash them into one.
README.md
Outdated
| | `unicode` | `always`, `detect`, **`never`** | Output Unicode syntax. With `detect` we output Unicode syntax exactly when the extension is seen to be enabled. When using `always`, make sure to have the `UnicodeSyntax` extension enabled, or Fourmolu will throw errors. | ||
| | `respectful` | **`true`**, `false` | Be less aggressive in reformatting input, e.g. keep empty lines in import list | ||
| | `fixities` | list of strings (**`[]`**) | See the "Language extensions, dependencies, and fixities" section below | ||
| | `single-constraint-parens` | **`always`**, `never`, `auto` | How to style optional parentheses around single constraints |
There was a problem hiding this comment.
Nit: I think this would sound much better as "Whether to style optional parentheses ..."? "How" is a bit ambiguous
There was a problem hiding this comment.
Agreed, updated, and squashed
This option controls parenthesis around constraints in type signatures when there is only one:
becomes
This addresses #288. Note that always is the default, even though the issue suggests auto (ignore) be the default. I did this because Ormolu always adds parenthesis, and it would break some other tests.