From b70b2c619671f0c6adc722742181bd2fa6e2a2f4 Mon Sep 17 00:00:00 2001 From: Jelle Zijlstra Date: Fri, 8 Sep 2023 20:24:49 -0700 Subject: [PATCH] Prepare release 23.9.0 (#3863) --- CHANGES.md | 48 +++++++++++++-------- docs/contributing/release_process.md | 2 + docs/integrations/source_version_control.md | 4 +- docs/usage_and_configuration/the_basics.md | 6 +-- 4 files changed, 37 insertions(+), 23 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index b0fa5f8..3829526 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -14,14 +14,10 @@ -- More concise formatting for dummy implementations (#3796) - ### Configuration -- Black now applies exclusion and ignore logic before resolving symlinks (#3846) - ### Packaging @@ -34,9 +30,6 @@ -- Avoid importing `IPython` if notebook cells do not contain magics (#3782) -- Improve caching by comparing file hashes as fallback for mtime and size. (#3821) - ### Output @@ -45,23 +38,45 @@ -- Fix an issue in `blackd` with single character input (#3558) - ### Integrations +### Documentation + + + +## 23.9.0 + +### Preview style + +- More concise formatting for dummy implementations (#3796) +- In stub files, add a blank line between a statement with a body (e.g an + `if sys.version_info > (3, x):`) and a function definition on the same level (#3862) +- Fix a bug whereby spaces were removed from walrus operators within subscript(#3823) + +### Configuration + +- Black now applies exclusion and ignore logic before resolving symlinks (#3846) + +### Performance + +- Avoid importing `IPython` if notebook cells do not contain magics (#3782) +- Improve caching by comparing file hashes as fallback for mtime and size (#3821) + +### _Blackd_ + +- Fix an issue in `blackd` with single character input (#3558) + +### Integrations + - 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 (#3828) - The `.black.env` folder specified by `ENV_PATH` will now be removed on the completion - of the GitHub Action. (#3759) - -### Documentation - - + of the GitHub Action (#3759) ## 23.7.0 @@ -80,7 +95,6 @@ (#3740) - Fix error in AST validation when _Black_ removes trailing whitespace in a type comment (#3773) -- Fix a bug whereby spaces were removed from walrus operators within subscript (#3823) ### Preview style @@ -171,8 +185,6 @@ expected to become part of Black's stable style in January 2024. - For stubs, enforce one blank line after a nested class with a body other than just `...` (#3564) - Improve handling of multiline strings by changing line split behavior (#1879) -- In stub files, add a blank line between a statement with a body (e.g an - `if sys.version_info > (3, x):`) and a function definition on the same level. (#3862) ### Parser diff --git a/docs/contributing/release_process.md b/docs/contributing/release_process.md index be9b08a..02865d6 100644 --- a/docs/contributing/release_process.md +++ b/docs/contributing/release_process.md @@ -43,6 +43,8 @@ To cut a release: 1. Remove any empty sections for the current release 1. (_optional_) Read through and copy-edit the changelog (eg. by moving entries, fixing typos, or rephrasing entries) + 1. Double-check that no changelog entries since the last release were put in the + wrong section (e.g., run `git diff CHANGES.md`) 1. Add a new empty template for the next release above ([template below](#changelog-template)) 1. Update references to the latest version in diff --git a/docs/integrations/source_version_control.md b/docs/integrations/source_version_control.md index 24e7328..2841497 100644 --- a/docs/integrations/source_version_control.md +++ b/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: 23.7.0 + rev: 23.9.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: 23.7.0 + rev: 23.9.0 hooks: - id: black-jupyter # It is recommended to specify the latest version of Python diff --git a/docs/usage_and_configuration/the_basics.md b/docs/usage_and_configuration/the_basics.md index 5efb50a..6ae9441 100644 --- a/docs/usage_and_configuration/the_basics.md +++ b/docs/usage_and_configuration/the_basics.md @@ -193,8 +193,8 @@ configuration file for consistent results across environments. ```console $ black --version -black, 23.7.0 (compiled: yes) -$ black --required-version 23.7.0 -c "format = 'this'" +black, 23.9.0 (compiled: yes) +$ black --required-version 23.9.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! @@ -285,7 +285,7 @@ You can check the version of _Black_ you have installed using the `--version` fl ```console $ black --version -black, 23.7.0 +black, 23.9.0 ``` #### `--config` -- 2.39.2