Modernize package setup

Author: snejus

.github/workflows/main.yml

@@ -2,24 +2,27 @@ name: Python Tests
 
 on: [push]
 
-jobs:
-  build:
 
+jobs:
+  test:
+    name: Run tests
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python: ["3.8", "3.9", "3.10", "3.11"]
-
+        python: ["3.9", "3.10", "3.11"]
     steps:
-      - uses: actions/checkout@v2
-      - name: Setup Python
-        uses: actions/setup-python@v2
+      - uses: actions/checkout@v4
+      - name: Install Python tools
+        uses: BrandonLWhite/[email protected]
+      - name: Setup Python with poetry caching
+        # poetry cache requires poetry to already be installed, weirdly
+        uses: actions/setup-python@v5
         with:
-          python-version: ${{ matrix.python }}
+          python-version: ${{ matrix.python-version }}
+          cache: poetry
       - name: Install ffmpeg
         run: sudo apt install -y --no-install-recommends ffmpeg
-      - name: Install tox and any other packages
-        run: pip install tox
-      - name: Run tox
-        # Run tox using the version of Python in `PATH`
-        run: tox -e py
+      - name: Test
+        run: |-
+          poetry install --extras=test
+          poe test

README.rst

@@ -55,7 +55,7 @@ A second optional parameter to ``audio_open`` specifies which backends to try
 ``available_backends`` function to get a list backends that are usable on the
 current system.
 
-Audioread supports Python 3 (3.8+).
+Audioread supports Python 3 (3.9+).
 
 Example
 -------

audioread/version.py

@@ -1,29 +1,61 @@
-[build-system]
-requires = ["flit_core >=3.2,<4"]
-build-backend = "flit_core.buildapi"
-
 [project]
 name = "audioread"
+version = "3.1.0a0"
+description = "Multi-library, cross-platform audio decoding."
 authors = [
-    {name = "Adrian Sampson", email = "[email protected]"}
+    { name = "Adrian Sampson", email = "[email protected]" },
 ]
 readme = "README.rst"
-requires-python = ">=3.6"
-dynamic = ["version", "description"]
-urls.Home = "https://github.com/beetbox/audioread"
+license = "MIT"
+requires-python = ">=3.9"
 classifiers = [
-    'Topic :: Multimedia :: Sound/Audio :: Conversion',
-    'Intended Audience :: Developers',
-    'Programming Language :: Python :: 3',
-    'Programming Language :: Python :: 3.8',
-    'Programming Language :: Python :: 3.9',
-    'Programming Language :: Python :: 3.10',
-    'Programming Language :: Python :: 3.11',
-    'License :: OSI Approved :: MIT License',
+    "Topic :: Multimedia :: Sound/Audio :: Conversion",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "License :: OSI Approved :: MIT License",
 ]
-license = {file = "LICENSE"}
+
+[project.urls]
+Homepage = "https://github.com/beetbox/audioread"
+Repository = "https://github.com/beetbox/audioread"
+"Bug Tracker" = "https://github.com/beetbox/audioread/issues"
 
 [project.optional-dependencies]
-test = [
-    "tox"
-]
+test = ["pytest >= 8.4.2", "pytest-cov >= 7.0.0"]
+mad = ["pymad[mad] (>=0.11.3,<0.12.0)"]
+gi = ["pygobject (>=3.54.2,<4.0.0)"]
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pipx-install]
+poethepoet = ">=0.26"
+poetry = ">=2.1"
+
+[tool.poetry.requires-plugins]
+poethepoet = ">=0.32"
+
+[tool.poe.tasks.test]
+help = "Run tests with pytest"
+cmd = "pytest $OPTS"
+env.OPTS.default = "-p no:cov"
+
+[tool.poe.tasks.test-with-coverage]
+help = "Run tests and record coverage"
+ref = "test"
+# record coverage in audioread package
+# save xml for coverage upload to coveralls
+# save html report for local dev use
+# measure coverage across logical branches
+# show which tests cover specific lines in the code (see the HTML report)
+env.OPTS = """
+--cov=audioread
+--cov-report=xml:.reports/coverage.xml
+--cov-report=html:.reports/html
+--cov-branch
+--cov-context=test
+"""

poetry.lock

@@ -0,0 +1,18 @@
+[coverage:run]
+data_file = .reports/coverage/data
+branch = true
+relative_files = true
+
+[coverage:report]
+precision = 2
+skip_empty = true
+show_missing = true
+exclude_also =
+    @atexit.register
+    if TYPE_CHECKING
+    if typing.TYPE_CHECKING
+    raise AssertionError
+    raise NotImplementedError
+
+[coverage:html]
+show_contexts = true