Document pre-commit mirror

.pre-commit-hooks.yaml

@@ -1,3 +1,5 @@
+# Note that we recommend using https://github.com/psf/black-pre-commit-mirror instead
+# This will work about 2x as fast as using the hooks in this repository
 - id: black
   name: black
   description: "Black: The uncompromising Python code formatter"

CHANGES.md

@@ -43,6 +43,9 @@
 ### Integrations
 
 <!-- For example, Docker, GitHub Actions, pre-commit, editors -->
+- Black now has an [official pre-commit mirror](https://github.com/psf/black-pre-commit-mirror).
+  Swapping `https://github.com/psf/black` to `https://github.com/psf/black-pre-commit-mirror`
+  in your `.pre-commit-config.yaml` will make Black about 2x faster.
 
 ### Documentation
 

docs/integrations/source_version_control.md

@@ -6,7 +6,8 @@ Use [pre-commit](https://pre-commit.com/). Once you
 
 ```yaml
 repos:
-  - repo: https://github.com/psf/black
+  # Using this mirror lets us use mypyc-compiled black, which is about 2x faster
+  - repo: https://github.com/psf/black-pre-commit-mirror
     rev: 23.7.0
     hooks:
       - id: black
@@ -17,10 +18,12 @@ repos:
         language_version: python3.11
 ```
 
-Feel free to switch out the `rev` value to something else, like another
-[tag/version][black-tags] or even a specific commit. Although we discourage the use of
-branches or other mutable refs since the hook [won't auto update as you may
-expect][pre-commit-mutable-rev].
+Feel free to switch out the `rev` value to a different version of Black.
+
+Note if you'd like to use a specific commit in `rev`, you'll need to swap
+the repo specified from the mirror to https://github.com/psf/black.
+We discourage the use of branches or other mutable refs since the hook
+[won't auto update as you may expect][pre-commit-mutable-rev].
 
 ## Jupyter Notebooks
 
@@ -30,7 +33,8 @@ include Jupyter Notebooks. To use this hook, simply replace the hook's `id: blac
 
 ```yaml
 repos:
-  - repo: https://github.com/psf/black
+  # Using this mirror lets us use mypyc-compiled black, which is about 2x faster
+  - repo: https://github.com/psf/black-pre-commit-mirror
     rev: 23.7.0
     hooks:
       - id: black-jupyter
@@ -45,6 +49,5 @@ repos:
 The `black-jupyter` hook became available in version 21.8b0.
 ```
 
-[black-tags]: https://github.com/psf/black/tags
 [pre-commit-mutable-rev]:
   https://pre-commit.com/#using-the-latest-version-for-a-repository