1
0
Fork 0
mirror of https://github.com/tldr-pages/tldr.git synced 2025-04-29 23:24:55 +02:00
tldr/pages/common/black.md
Vítor Henrique 5edbf734fb
pages*: improve page descriptions (#12558)
* pages*: improve page descriptions

* ical: improve page description

* cockpit-desktop: remove unneeded word from page description

* nc: improve description wording

---------

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
2024-04-25 19:58:21 -03:00

28 lines
923 B
Markdown

# black
> Format Python code automatically.
> More information: <https://black.readthedocs.io/en/stable/usage_and_configuration/the_basics.html>.
- Auto-format a file or entire directory:
`black {{path/to/file_or_directory}}`
- Format the [c]ode passed in as a string:
`black -c "{{code}}"`
- Show whether a file or a directory would have changes made to them if they were to be formatted:
`black --check {{path/to/file_or_directory}}`
- Show changes that would be made to a file or a directory without performing them (dry-run):
`black --diff {{path/to/file_or_directory}}`
- Auto-format a file or directory, emitting exclusively error messages to `stderr`:
`black --quiet {{path/to/file_or_directory}}`
- Auto-format a file or directory without replacing single quotes with double quotes (adoption helper, avoid using this for new projects):
`black --skip-string-normalization {{path/to/file_or_directory}}`