.. black documentation master file, created by sphinx-quickstart on Fri Mar 23 10:53:30 2018. The uncompromising code formatter ================================= By using *Black*, you agree to cease control over minutiae of hand-formatting. In return, *Black* gives you speed, determinism, and freedom from `pycodestyle` nagging about formatting. You will save time and mental energy for more important matters. *Black* makes code review faster by producing the smallest diffs possible. Blackened code looks the same regardless of the project you're reading. Formatting becomes transparent after a while and you can focus on the content instead. .. note:: `Black is an early pre-release `_. Testimonials ------------ **Dusty Phillips**, `writer `_: *Black is opinionated so you don't have to be.* **Hynek Schlawack**, creator of `attrs `_, core developer of Twisted and CPython: *An auto-formatter that doesn't suck is all I want for Xmas!* **Carl Meyer**, `Django `_ core developer: *At least the name is good.* **Kenneth Reitz**, creator of `requests `_ and `pipenv `_: *This vastly improves the formatting of our code. Thanks a ton!* Contents -------- .. toctree:: :maxdepth: 2 installation_and_usage the_black_code_style editor_integration contributing change_log authors Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search`