Pin poetry version below <2 (#5782)

Force `poetry` version below 2 to avoid it mangling file modification
times in `sdist`.

Fixes #5770

Author: snejus

.github/workflows/ci.yaml

@@ -21,7 +21,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install Python tools
-        uses: BrandonLWhite/pipx-install-action@v0.1.1
+        uses: BrandonLWhite/pipx-install-action@v1.0.1
       - name: Setup Python with poetry caching
         # poetry cache requires poetry to already be installed, weirdly
         uses: actions/setup-python@v5

.github/workflows/integration_test.yaml

@@ -9,7 +9,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install Python tools
-        uses: BrandonLWhite/pipx-install-action@v0.1.1
+        uses: BrandonLWhite/pipx-install-action@v1.0.1
       - uses: actions/setup-python@v5
         with:
           python-version: 3.9

.github/workflows/lint.yml

@@ -53,7 +53,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install Python tools
-        uses: BrandonLWhite/pipx-install-action@v0.1.1
+        uses: BrandonLWhite/pipx-install-action@v1.0.1
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}
@@ -74,7 +74,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install Python tools
-        uses: BrandonLWhite/pipx-install-action@v0.1.1
+        uses: BrandonLWhite/pipx-install-action@v1.0.1
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}
@@ -94,7 +94,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install Python tools
-        uses: BrandonLWhite/pipx-install-action@v0.1.1
+        uses: BrandonLWhite/pipx-install-action@v1.0.1
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}
@@ -118,7 +118,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install Python tools
-        uses: BrandonLWhite/pipx-install-action@v0.1.1
+        uses: BrandonLWhite/pipx-install-action@v1.0.1
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}

.github/workflows/make_release.yaml

@@ -19,7 +19,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install Python tools
-        uses: BrandonLWhite/pipx-install-action@v0.1.1
+        uses: BrandonLWhite/pipx-install-action@v1.0.1
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}
@@ -50,7 +50,7 @@ jobs:
           ref: ${{ env.NEW_TAG }}
 
       - name: Install Python tools
-        uses: BrandonLWhite/pipx-install-action@v0.1.1
+        uses: BrandonLWhite/pipx-install-action@v1.0.1
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}

CONTRIBUTING.rst

@@ -87,6 +87,15 @@ Install `poetry`_ and `poethepoet`_ using `pipx`_::
 
     $ pipx install poetry poethepoet
 
+.. admonition:: Check ``tool.pipx-install`` section in ``pyproject.toml`` to
+   see supported versions
+
+  ::
+
+      [tool.pipx-install]
+      poethepoet = ">=0.26"
+      poetry = "<2"
+
 .. _pipx: https://pipx.pypa.io/stable
 .. _pipx-installation-instructions: https://pipx.pypa.io/stable/installation/
 

docs/changelog.rst

@@ -6,18 +6,16 @@ Changelog goes here! Please add your entry to the bottom of one of the lists bel
 Unreleased
 ----------
 
-New features:
-
 Bug fixes:
-
 * :doc:`/reference/pathformat`: Fixed a regression where path legalization
   incorrectly removed parts of user-configured path formats that followed a dot
   (**.**).
   :bug:`5771`
 
 For packagers:
-
-Other changes:
+* Force ``poetry`` version below 2 to avoid it mangling file modification times
+  in ``sdist`` package.
+  :bug:`5770`
 
 2.3.0 (May 07, 2025)
 --------------------
@@ -115,8 +113,8 @@ Other changes:
   :bug:`5539`
 * :doc:`/plugins/smartplaylist`: URL-encode additional item `fields` within generated
   EXTM3U playlists instead of JSON-encoding them.
-* typehints: `./beets/importer.py` file now has improved typehints. 
-* typehints: `./beets/plugins.py` file now includes typehints. 
+* typehints: `./beets/importer.py` file now has improved typehints.
+* typehints: `./beets/plugins.py` file now includes typehints.
 * :doc:`plugins/ftintitle`: Optimize the plugin by avoiding unnecessary writes
   to the database.
 * Database models are now serializable with pickle.