Ravenports generated: 10 Feb 2024 22:55
[ravenports.git] / bucket_1E / python-black
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-black
4 VERSION=                24.1.1
5 KEYWORDS=               python
6 VARIANTS=               v11 v12
7 SDESC[v11]=             Uncompromising code formatter (3.11)
8 SDESC[v12]=             Uncompromising code formatter (3.12)
9 HOMEPAGE=               https://github.com/psf/black
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPIWHL/95/f3/c3d59ae490c627950efc97a27c3f73776577e2ec32d35737e72aee3d6738
14 DISTFILE[1]=            black-24.1.1-py3-none-any.whl:main
15 DF_INDEX=               1
16 SPKGS[v11]=             single
17 SPKGS[v12]=             single
18
19 OPTIONS_AVAILABLE=      PY311 PY312
20 OPTIONS_STANDARD=       none
21 VOPTS[v11]=             PY311=ON PY312=OFF
22 VOPTS[v12]=             PY311=OFF PY312=ON
23
24 DISTNAME=               black-24.1.1.dist-info
25
26 GENERATED=              yes
27
28 [PY311].RUN_DEPENDS_ON=                 python-click:single:v11
29                                         python-mypy-extensions:single:v11
30                                         python-packaging:single:v11
31                                         python-pathspec:single:v11
32                                         python-platformdirs:single:v11
33 [PY311].USES_ON=                        python:v11,wheel
34
35 [PY312].RUN_DEPENDS_ON=                 python-click:single:v12
36                                         python-mypy-extensions:single:v12
37                                         python-packaging:single:v12
38                                         python-pathspec:single:v12
39                                         python-platformdirs:single:v12
40 [PY312].USES_ON=                        python:v12,wheel
41
42 [FILE:2515:descriptions/desc.single]
43 [Black Logo]
44
45 <h2 align="center">The Uncompromising Code Formatter</h2>
46
47 <p align="center">
48 [image]
49 [image]
50 [image]
51 [image]
52 [image]
53 [image]
54 [image]
55 [image]
56 </p>
57
58 > “Any color you like.”
59
60 _Black_ is the uncompromising Python code formatter. By using it, you agree
61 to cede
62 control over minutiae of hand-formatting. In return, _Black_ gives you
63 speed,
64 determinism, and freedom from `pycodestyle` nagging about formatting. You
65 will save time
66 and mental energy for more important matters.
67
68 Blackened code looks the same regardless of the project you're reading.
69 Formatting
70 becomes transparent after a while and you can focus on the content instead.
71
72 _Black_ makes code review faster by producing the smallest diffs possible.
73
74 Try it out now using the [Black Playground]. Watch the
75 [PyCon 2019 talk] to learn more.
76
77 ---
78
79 **[Read the documentation on ReadTheDocs!]**
80
81 ---
82
83 ## Installation and usage
84
85 ### Installation
86
87 _Black_ can be installed by running `pip install black`. It requires Python
88 3.8+ to run.
89 If you want to format Jupyter Notebooks, install with `pip install
90 "black[jupyter]"`.
91
92 If you can't wait for the latest _hotness_ and want to install from GitHub,
93 use:
94
95 `pip install git+https://github.com/psf/black`
96
97 ### Usage
98
99 To get started right away with sensible defaults:
100
101 ```sh
102 black {source_file_or_directory}
103 ```
104
105 You can run _Black_ as a package if running it as a script doesn't work:
106
107 ```sh
108 python -m black {source_file_or_directory}
109 ```
110
111 Further information can be found in our docs:
112
113 - [Usage and Configuration]
114
115 _Black_ is already [successfully used] by many
116 projects, small and big. _Black_ has a comprehensive test suite, with
117 efficient parallel
118 tests, and our own auto formatting and parallel Continuous Integration
119 runner. Now that
120 we have become stable, you should not expect large formatting changes in
121 the future.
122 Stylistic changes will mostly be responses to bug reports and support for
123 new Python
124 syntax. For more information please refer to
125 [The Black Code Style].
126
127 Also, as a safety measure which slows down processing, _Black_ will check
128 that the
129 reformatted code still produces a valid AST that is effectively equivalent
130 to the
131 original (see the
132 [Pragmatism]
133 section for details). If you're feeling confident, use `--fast`.
134
135 ## The _Black_ code style
136
137 _Black_ is a PEP 8 compliant opinionated formatter. _Black_ reformats
138 entire files in
139 place. Style configuration options are deliberately limited and rarely
140 added. It doesn't
141 take previous formatting into account (see
142 [Pragmatism]
143
144
145 [FILE:108:distinfo]
146 5cdc2e2195212208fbcae579b931407c1fa9997584f0a415421748aeafff1168       195702 black-24.1.1-py3-none-any.whl
147