mirror of
https://github.com/astral-sh/ruff.git
synced 2025-08-04 02:38:25 +00:00
Fix list markup: blank line required (#10591)
Judging from the other lists in this same file, it looks like a blank line is required to separate the previous paragraph from the first list item. Otherwise the list is considered part of the paragraph: - https://docs.astral.sh/ruff/settings/#lint_flake8-copyright_notice-rgx <img width="400" alt="image" src="663fa5b4
-f787-4fcd-bdd6-0b891d7ad72b"> - https://docs.astral.sh/ruff/settings/#format_quote-style <img width="400" alt="image" src="809735eb
-c546-4348-9311-877441bae84e"> After this change hopefully those will be rendered as proper bullet lists.
This commit is contained in:
parent
fdd25f0d99
commit
80b46889ed
2 changed files with 4 additions and 2 deletions
|
@ -1133,6 +1133,7 @@ pub struct Flake8CopyrightOptions {
|
|||
/// with the [`regex`](https://docs.rs/regex/latest/regex/) crate.
|
||||
/// Defaults to `(?i)Copyright\s+((?:\(C\)|©)\s+)?\d{4}((-|,\s)\d{4})*`, which matches
|
||||
/// the following:
|
||||
///
|
||||
/// - `Copyright 2023`
|
||||
/// - `Copyright (C) 2023`
|
||||
/// - `Copyright 2021-2023`
|
||||
|
@ -2962,6 +2963,7 @@ pub struct FormatOptions {
|
|||
pub indent_style: Option<IndentStyle>,
|
||||
|
||||
/// Configures the preferred quote character for strings. The recommended options are
|
||||
///
|
||||
/// * `double` (default): Use double quotes `"`
|
||||
/// * `single`: Use single quotes `'`
|
||||
///
|
||||
|
|
4
ruff.schema.json
generated
4
ruff.schema.json
generated
|
@ -959,7 +959,7 @@
|
|||
"minimum": 0.0
|
||||
},
|
||||
"notice-rgx": {
|
||||
"description": "The regular expression used to match the copyright notice, compiled with the [`regex`](https://docs.rs/regex/latest/regex/) crate. Defaults to `(?i)Copyright\\s+((?:\\(C\\)|©)\\s+)?\\d{4}((-|,\\s)\\d{4})*`, which matches the following: - `Copyright 2023` - `Copyright (C) 2023` - `Copyright 2021-2023` - `Copyright (C) 2021-2023` - `Copyright (C) 2021, 2023`",
|
||||
"description": "The regular expression used to match the copyright notice, compiled with the [`regex`](https://docs.rs/regex/latest/regex/) crate. Defaults to `(?i)Copyright\\s+((?:\\(C\\)|©)\\s+)?\\d{4}((-|,\\s)\\d{4})*`, which matches the following:\n\n- `Copyright 2023` - `Copyright (C) 2023` - `Copyright 2021-2023` - `Copyright (C) 2021-2023` - `Copyright (C) 2021, 2023`",
|
||||
"type": [
|
||||
"string",
|
||||
"null"
|
||||
|
@ -1376,7 +1376,7 @@
|
|||
]
|
||||
},
|
||||
"quote-style": {
|
||||
"description": "Configures the preferred quote character for strings. The recommended options are * `double` (default): Use double quotes `\"` * `single`: Use single quotes `'`\n\nIn compliance with [PEP 8](https://peps.python.org/pep-0008/) and [PEP 257](https://peps.python.org/pep-0257/), Ruff prefers double quotes for triple quoted strings and docstrings even when using `quote-style = \"single\"`.\n\nRuff deviates from using the configured quotes if doing so prevents the need for escaping quote characters inside the string:\n\n```python a = \"a string without any quotes\" b = \"It's monday morning\" ```\n\nRuff will change the quotes of the string assigned to `a` to single quotes when using `quote-style = \"single\"`. However, ruff uses double quotes for he string assigned to `b` because using single quotes would require escaping the `'`, which leads to the less readable code: `'It\\'s monday morning'`.\n\nIn addition, Ruff supports the quote style `preserve` for projects that already use a mixture of single and double quotes and can't migrate to the `double` or `single` style. The quote style `preserve` leaves the quotes of all strings unchanged.",
|
||||
"description": "Configures the preferred quote character for strings. The recommended options are\n\n* `double` (default): Use double quotes `\"` * `single`: Use single quotes `'`\n\nIn compliance with [PEP 8](https://peps.python.org/pep-0008/) and [PEP 257](https://peps.python.org/pep-0257/), Ruff prefers double quotes for triple quoted strings and docstrings even when using `quote-style = \"single\"`.\n\nRuff deviates from using the configured quotes if doing so prevents the need for escaping quote characters inside the string:\n\n```python a = \"a string without any quotes\" b = \"It's monday morning\" ```\n\nRuff will change the quotes of the string assigned to `a` to single quotes when using `quote-style = \"single\"`. However, ruff uses double quotes for he string assigned to `b` because using single quotes would require escaping the `'`, which leads to the less readable code: `'It\\'s monday morning'`.\n\nIn addition, Ruff supports the quote style `preserve` for projects that already use a mixture of single and double quotes and can't migrate to the `double` or `single` style. The quote style `preserve` leaves the quotes of all strings unchanged.",
|
||||
"anyOf": [
|
||||
{
|
||||
"$ref": "#/definitions/QuoteStyle"
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue