Prepare release 26.3.0 (#5032)

Author: JelleZijlstra

CHANGES.md

@@ -1,46 +1,27 @@
 # Change Log
 
-## Unreleased
-
-<!-- PR authors:
-     Please include the PR number in the changelog entry, not the issue number -->
-
-### Highlights
-
-<!-- Include any especially major or disruptive changes here -->
+## 26.3.0
 
 ### Stable style
 
-<!-- Changes that affect Black's stable style -->
-
 - Don't double-decode input, causing non-UTF-8 files to be corrupted (#4964)
 - Fix crash on standalone comment in lambda default arguments (#4993)
+- Preserve parentheses when `# type: ignore` comments would be merged with other
+  comments on the same line, preventing AST equivalence failures (#4888)
 
 ### Preview style
 
-<!-- Changes that affect Black's preview style -->
-
 - Fix bug where `if` guards in `case` blocks were incorrectly split when the pattern had
   a trailing comma (#4884)
 - Fix `string_processing` crashing on unassigned long string literals with trailing
   commas (one-item tuples) (#4929)
 - Simplify implementation of the power operator "hugging" logic (#4918)
 
-### Configuration
-
-<!-- Changes to how Black can be configured -->
-
 ### Packaging
 
-<!-- Changes to how Black is packaged, such as dependency requirements -->
-
 - Fix shutdown errors in PyInstaller builds on macOS by disabling multiprocessing in
   frozen environments (#4930)
 
-### Parser
-
-<!-- Changes to the parser or to version autodetection -->
-
 ### Performance
 
 - Introduce winloop for windows as an alternative to uvloop (#4996)
@@ -52,8 +33,6 @@
 
 ### Output
 
-<!-- Changes to Black's terminal output and error messages -->
-
 - Emit a clear warning when the target Python version is newer than the running Python
   version, since AST safety checks cannot parse newer syntax. Also replace the
   misleading "INTERNAL ERROR" message with an actionable error explaining the version
@@ -66,8 +45,6 @@
 
 ### Integrations
 
-<!-- For example, Docker, GitHub Actions, pre-commit, editors -->
-
 - Remove unused gallery script (#5030)
 - Harden parsing of `black` requirements in the GitHub Action when `use_pyproject` is
   enabled so that only version specifiers are accepted and direct references such as
@@ -78,9 +55,6 @@
 
 ### Documentation
 
-<!-- Major changes to documentation and policies. Small docs changes
-     don't need a changelog entry. -->
-
 - Expand preview style documentation with detailed examples for `wrap_comprehension_in`,
   `simplify_power_operator_hugging`, and `wrap_long_dict_values_in_parens` features
   (#4987)
@@ -160,8 +134,6 @@ directories.
 - Fix crash when multiple `# fmt: skip` comments are used in a multi-part if-clause, on
   string literals, or on dictionary entries with long lines (#4872)
 - Fix possible crash when `fmt: ` directives aren't on the top level (#4856)
-- Preserve parentheses when `# type: ignore` comments would be merged with other
-  comments on the same line, preventing AST equivalence failures (#4888)
 
 ### Preview style
 

docs/guides/using_black_with_jupyter_notebooks.md

@@ -111,7 +111,7 @@ Simply replace the `black` hook with `black-jupyter`.
 ```yaml
 repos:
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 26.1.0
+    rev: 26.3.0
     hooks:
       - id: black-jupyter
         language_version: python3.11

docs/integrations/source_version_control.md

@@ -8,7 +8,7 @@ Use [pre-commit](https://pre-commit.com/). Once you
 repos:
   # Using this mirror lets us use mypyc-compiled black, which is about 2x faster
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 26.1.0
+    rev: 26.3.0
     hooks:
       - id: black
         # It is recommended to specify the latest version of Python
@@ -34,7 +34,7 @@ include Jupyter Notebooks. To use this hook, simply replace the hook's `id: blac
 ```yaml
 repos:
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 26.1.0
+    rev: 26.3.0
     hooks:
       - id: black-jupyter
         language_version: python3.11
@@ -64,7 +64,7 @@ Configure exclusions directly in `.pre-commit-config.yaml`:
 ```yaml
 repos:
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 26.1.0
+    rev: 26.3.0
     hooks:
       - id: black
         exclude: ^migrations/|^generated/

docs/usage_and_configuration/the_basics.md

@@ -280,8 +280,8 @@ configuration file for consistent results across environments.
 
 ```console
 $ black --version
-black, 26.1.0 (compiled: yes)
-$ black --required-version 26.1.0 -c "format = 'this'"
+black, 26.3.0 (compiled: yes)
+$ black --required-version 26.3.0 -c "format = 'this'"
 format = "this"
 $ black --required-version 31.5b2 -c "still = 'beta?!'"
 Oh no! 💥 💔 💥 The required version does not match the running version!
@@ -382,7 +382,7 @@ You can check the version of _Black_ you have installed using the `--version` fl
 
 ```console
 $ black --version
-black, 26.1.0
+black, 26.3.0
 ```
 
 #### `--config`