]>
git.madduck.net Git - etc/vim.git/blobdiff - docs/the_black_code_style/index.rst
madduck's git repository
Every one of the projects in this repository is available at the canonical
URL git://git.madduck.net/madduck/pub/<projectpath> — see
each project's metadata for the exact URL.
All patches and comments are welcome. Please squash your changes to logical
commits before using git-format-patch and git-send-email to
patches@ git. madduck. net .
If you'd read over the Git project's submission guidelines and adhered to them,
I'd be especially grateful.
SSH access, as well as push access can be individually
arranged .
If you use my repositories frequently, consider adding the following
snippet to ~/.gitconfig and using the third clone URL listed for each
project:
[url "git://git.madduck.net/madduck/"]
insteadOf = madduck:
*Black* is a PEP 8 compliant opinionated formatter with its own style.
While keeping the style unchanged throughout releases has always been a goal,
*Black* is a PEP 8 compliant opinionated formatter with its own style.
While keeping the style unchanged throughout releases has always been a goal,
-the *Black* code style isn't set in stone. It evolves to accomodate for new features
-in the Python language and, ocas sionally, in response to user feedback.
+the *Black* code style isn't set in stone. It evolves to accomm odate for new features
+in the Python language and, occa sionally, in response to user feedback.
Stability Policy
----------------
Stability Policy
----------------
improved formatting enabled by newer Python language syntax as well as due
to improvements in the formatting logic.
improved formatting enabled by newer Python language syntax as well as due
to improvements in the formatting logic.
-- The ``--future`` flag is exempt from this policy. There are no guare ntees
+- The ``--preview`` flag is exempt from this policy. There are no guara ntees
around the stability of the output with that flag passed into *Black*. This
flag is intended for allowing experimentation with the proposed changes to
the *Black* code style.
around the stability of the output with that flag passed into *Black*. This
flag is intended for allowing experimentation with the proposed changes to
the *Black* code style.