From feada3f19ac3e4cd9ff902b89f56b1abb65bc355 Mon Sep 17 00:00:00 2001
From: Jakub Kuczys <me@jacken.men>
Date: Thu, 8 Sep 2022 22:35:09 +0200
Subject: [PATCH 1/4] Support version specifiers in GH action

---
 action/main.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/action/main.py b/action/main.py
index cd920f5fe0d..03228cb13e8 100644
--- a/action/main.py
+++ b/action/main.py
@@ -14,9 +14,10 @@
 
 run([sys.executable, "-m", "venv", str(ENV_PATH)], check=True)
 
-req = "black[colorama]"
-if VERSION:
-    req += f"=={VERSION}"
+version_specifier = VERSION
+if VERSION and VERSION[0] in "0123456789":
+    version_specifier = f"=={VERSION}"
+req = f"black[colorama]{version_specifier}"
 pip_proc = run(
     [str(ENV_BIN / "python"), "-m", "pip", "install", req],
     stdout=PIPE,

From e7417d395957ea58c65e5f8eb0308fc9923da8a5 Mon Sep 17 00:00:00 2001
From: Jakub Kuczys <me@jacken.men>
Date: Thu, 8 Sep 2022 22:37:45 +0200
Subject: [PATCH 2/4] Add changelog entry

---
 CHANGES.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.md b/CHANGES.md
index 25c3d4889a0..a10a1bd3f7e 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -42,6 +42,9 @@
 
 <!-- For example, Docker, GitHub Actions, pre-commit, editors -->
 
+- Update GitHub action to support use of version specifiers (i.e. `<23`) for Black
+  version (#3265)
+
 ### Documentation
 
 <!-- Major changes to documentation and policies. Small docs changes

From 63fec34a178aedd21b7e16614ca9f346516f0db3 Mon Sep 17 00:00:00 2001
From: Jakub Kuczys <me@jacken.men>
Date: Sun, 11 Sep 2022 17:58:59 +0200
Subject: [PATCH 3/4] Document the new behavior

---
 docs/integrations/github_actions.md | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/docs/integrations/github_actions.md b/docs/integrations/github_actions.md
index c9697cc05de..d77b9693678 100644
--- a/docs/integrations/github_actions.md
+++ b/docs/integrations/github_actions.md
@@ -32,9 +32,12 @@ We recommend the use of the `@stable` tag, but per version tags also exist if yo
 that. Note that the action's version you select is independent of the version of _Black_
 the action will use.
 
-The version of _Black_ the action will use can be configured via `version`. The action
-defaults to the latest release available on PyPI. Only versions available from PyPI are
-supported, so no commit SHAs or branch names.
+The version of _Black_ the action will use can be configured via `version`. This can be
+any
+[valid version specifier](https://packaging.python.org/en/latest/glossary/#term-Version-Specifier)
+or just the version number if you want an exact version. The action defaults to the
+latest release available on PyPI. Only versions available from PyPI are supported, so no
+commit SHAs or branch names.
 
 You can also configure the arguments passed to _Black_ via `options` (defaults to
 `'--check --diff'`) and `src` (default is `'.'`)
@@ -48,3 +51,15 @@ Here's an example configuration:
     src: "./src"
     version: "21.5b1"
 ```
+
+If you want to match versions covered by Black's
+[stability policy](labels/stability-policy), you can use the compatible release operator
+(`~=`):
+
+```yaml
+- uses: psf/black@stable
+  with:
+    options: "--check --verbose"
+    src: "./src"
+    version: "~= 22.0"
+```

From e537d415e2755e4ead8ba0ae97c1224240f88392 Mon Sep 17 00:00:00 2001
From: Jakub Kuczys <me@jacken.men>
Date: Mon, 12 Sep 2022 03:47:10 +0200
Subject: [PATCH 4/4] Huh, how'd that get in there?

Co-authored-by: Richard Si <63936253+ichard26@users.noreply.github.com>
---
 CHANGES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGES.md b/CHANGES.md
index a10a1bd3f7e..03c5b5319c5 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -42,7 +42,7 @@
 
 <!-- For example, Docker, GitHub Actions, pre-commit, editors -->
 
-- Update GitHub action to support use of version specifiers (i.e. `<23`) for Black
+- Update GitHub Action to support use of version specifiers (e.g. `<23`) for Black
   version (#3265)
 
 ### Documentation