[ty] Remove brackets around option names (#18037)

This commit is contained in:
Micha Reiser 2025-05-12 13:16:03 +02:00 committed by GitHub
parent d3f3d92df3
commit d944a1397e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 13 additions and 13 deletions

View file

@ -134,13 +134,13 @@ impl Set {
fn emit_field(output: &mut String, name: &str, field: &OptionField, parents: &[Set]) { fn emit_field(output: &mut String, name: &str, field: &OptionField, parents: &[Set]) {
let header_level = if parents.is_empty() { "###" } else { "####" }; let header_level = if parents.is_empty() { "###" } else { "####" };
let _ = writeln!(output, "{header_level} [`{name}`]"); let _ = writeln!(output, "{header_level} `{name}`");
output.push('\n'); output.push('\n');
if let Some(deprecated) = &field.deprecated { if let Some(deprecated) = &field.deprecated {
output.push_str("!!! warning \"Deprecated\"\n"); output.push_str("> [!WARN] \"Deprecated\"\n");
output.push_str(" This option has been deprecated"); output.push_str("> This option has been deprecated");
if let Some(since) = deprecated.since { if let Some(since) = deprecated.since {
write!(output, " in {since}").unwrap(); write!(output, " in {since}").unwrap();

View file

@ -1,5 +1,5 @@
# Configuration # Configuration
#### [`respect-ignore-files`] #### `respect-ignore-files`
Whether to automatically exclude files that are ignored by `.ignore`, Whether to automatically exclude files that are ignored by `.ignore`,
`.gitignore`, `.git/info/exclude`, and global `gitignore` files. `.gitignore`, `.git/info/exclude`, and global `gitignore` files.
@ -18,7 +18,7 @@ respect-ignore-files = false
--- ---
#### [`rules`] #### `rules`
Configures the enabled rules and their severity. Configures the enabled rules and their severity.
@ -47,7 +47,7 @@ division-by-zero = "ignore"
## `environment` ## `environment`
#### [`extra-paths`] #### `extra-paths`
List of user-provided paths that should take first priority in the module resolution. List of user-provided paths that should take first priority in the module resolution.
Examples in other type checkers are mypy's `MYPYPATH` environment variable, Examples in other type checkers are mypy's `MYPYPATH` environment variable,
@ -66,7 +66,7 @@ extra-paths = ["~/shared/my-search-path"]
--- ---
#### [`python`] #### `python`
Path to the Python installation from which ty resolves type information and third-party dependencies. Path to the Python installation from which ty resolves type information and third-party dependencies.
@ -88,7 +88,7 @@ python = "./.venv"
--- ---
#### [`python-platform`] #### `python-platform`
Specifies the target platform that will be used to analyze the source code. Specifies the target platform that will be used to analyze the source code.
If specified, ty will understand conditions based on comparisons with `sys.platform`, such If specified, ty will understand conditions based on comparisons with `sys.platform`, such
@ -115,7 +115,7 @@ python-platform = "win32"
--- ---
#### [`python-version`] #### `python-version`
Specifies the version of Python that will be used to analyze the source code. Specifies the version of Python that will be used to analyze the source code.
The version should be specified as a string in the format `M.m` where `M` is the major version The version should be specified as a string in the format `M.m` where `M` is the major version
@ -139,7 +139,7 @@ python-version = "3.12"
--- ---
#### [`typeshed`] #### `typeshed`
Optional path to a "typeshed" directory on disk for us to use for standard-library types. Optional path to a "typeshed" directory on disk for us to use for standard-library types.
If this is not provided, we will fallback to our vendored typeshed stubs for the stdlib, If this is not provided, we will fallback to our vendored typeshed stubs for the stdlib,
@ -160,7 +160,7 @@ typeshed = "/path/to/custom/typeshed"
## `src` ## `src`
#### [`root`] #### `root`
The root(s) of the project, used for finding first-party modules. The root(s) of the project, used for finding first-party modules.
@ -179,7 +179,7 @@ root = ["./app"]
## `terminal` ## `terminal`
#### [`error-on-warning`] #### `error-on-warning`
Use exit code 1 if there are any warning-level diagnostics. Use exit code 1 if there are any warning-level diagnostics.
@ -199,7 +199,7 @@ error-on-warning = true
--- ---
#### [`output-format`] #### `output-format`
The format to use for printing diagnostic messages. The format to use for printing diagnostic messages.