Prepare release 25.1.0 (#4563)

CHANGES.md

@@ -1,11 +1,9 @@
 # Change Log
 
-## Unreleased
+## 25.1.0
 
 ### Highlights
 
-<!-- Include any especially major or disruptive changes here -->
-
 This release introduces the new 2025 stable style (#4558), stabilizing
 the following changes:
 
@@ -27,8 +25,6 @@ The following changes were not in any previous release:
 
 ### Stable style
 
-<!-- Changes that affect Black's stable style -->
-
 - Fix formatting cells in IPython notebooks with magic methods and starting or trailing
   empty lines (#4484)
 - Fix crash when formatting `with` statements containing tuple generators/unpacking
@@ -36,8 +32,6 @@ The following changes were not in any previous release:
 
 ### Preview style
 
-<!-- Changes that affect Black's preview style -->
-
 - Fix/remove string merging changing f-string quotes on f-strings with internal quotes
   (#4498)
 - Collapse multiple empty lines after an import into one (#4489)
@@ -45,47 +39,20 @@ The following changes were not in any previous release:
   parentheses around long dictionary values (#4377)
 - Move `wrap_long_dict_values_in_parens` from the unstable to preview style (#4561)
 
-### Configuration
-
-<!-- Changes to how Black can be configured -->
-
 ### Packaging
 
-<!-- Changes to how Black is packaged, such as dependency requirements -->
-
 - Store license identifier inside the `License-Expression` metadata field, see
   [PEP 639](https://peps.python.org/pep-0639/). (#4479)
 
-### Parser
-
-<!-- Changes to the parser or to version autodetection -->
-
 ### Performance
 
-<!-- Changes that improve Black's performance. -->
-
 - Speed up the `is_fstring_start` function in Black's tokenizer (#4541)
 
-### Output
-
-<!-- Changes to Black's terminal output and error messages -->
-
-### _Blackd_
-
-<!-- Changes to blackd -->
-
 ### Integrations
 
-<!-- For example, Docker, GitHub Actions, pre-commit, editors -->
-
 - If using stdin with `--stdin-filename` set to a force excluded path, stdin won't be
   formatted. (#4539)
 
-### Documentation
-
-<!-- Major changes to documentation and policies. Small docs changes
-     don't need a changelog entry. -->
-
 ## 24.10.0
 
 ### Highlights

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: 24.10.0
+    rev: 25.1.0
     hooks:
       - id: black
         # It is recommended to specify the latest version of Python
@@ -35,7 +35,7 @@ include Jupyter Notebooks. To use this hook, simply replace the hook's `id: blac
 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: 24.10.0
+    rev: 25.1.0
     hooks:
       - id: black-jupyter
         # It is recommended to specify the latest version of Python

docs/usage_and_configuration/the_basics.md

@@ -269,8 +269,8 @@ configuration file for consistent results across environments.
 
 ```console
 $ black --version
-black, 24.10.0 (compiled: yes)
+black, 25.1.0 (compiled: yes)
-$ black --required-version 24.10.0 -c "format = 'this'"
+$ black --required-version 25.1.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!
@@ -366,7 +366,7 @@ You can check the version of _Black_ you have installed using the `--version` fl
 
 ```console
 $ black --version
-black, 24.10.0
+black, 25.1.0
 ```
 
 #### `--config`