Fix jack_build.py, use in CI, update docs

Author: mgeier

.github/workflows/test.yml

@@ -13,7 +13,7 @@ jobs:
         - os: ubuntu-latest
           jack: jackd1
         # x86_64:
-        - os: macos-13
+        - os: macos-15-intel
         # arm64:
         - os: macos-latest
         - os: windows-latest
@@ -48,6 +48,7 @@ jobs:
     - name: Install Python package
       run: |
         uv sync --locked
+        uv run jack_build.py
     - name: Run tests
       run: |
         uv run pytest

CONTRIBUTING.rst

@@ -11,7 +11,8 @@ newest development version from Github_::
 
    git clone https://github.com/spatialaudio/jackclient-python.git
    cd jackclient-python
-   python3 -m pip install -e .
+   python -m pip install -e .
+   python jack_build.py
 
 ... where ``-e`` stands for ``--editable``.
 This way, your installation always stays up-to-date, even if you pull new
@@ -29,24 +30,24 @@ If you make changes to the documentation, you can locally re-create the HTML
 pages using Sphinx_.
 You can install it and a few other necessary packages with::
 
-   python3 -m pip install -r doc/requirements.txt
+   python -m pip install -r doc/requirements.txt
 
 To create the HTML pages, use::
 
-   python3 setup.py build_sphinx
+   python -m sphinx doc _build
 
-The generated files will be available in the directory ``build/sphinx/html/``.
+The generated files will be available in the directory ``_build/``.
 
 .. _Sphinx: https://www.sphinx-doc.org/
 
 There are no proper tests (yet?), but the code examples from the README file
 can be verified with pytest_.
 If you haven't installed it already, you can install it with::
 
-   python3 -m pip install pytest
+   python -m pip install pytest
 
 As soon as pytest_ is installed, you can run the (rudimentary) tests with::
 
-   python3 -m pytest
+   python -m pytest
 
 .. _pytest: https://pytest.org/

doc/installation.rst

@@ -6,16 +6,16 @@ Installation
 
 You can use ``pip`` to install the ``jack`` module::
 
-   python3 -m pip install JACK-Client
+   python -m pip install JACK-Client
 
 Depending on your Python installation (see `Requirements`_ below),
-you may have to use ``python`` instead of ``python3``.
+you may have to use ``python3`` instead of ``python``.
 If you have installed the module already, you can use the ``--upgrade`` flag to
 get the newest release.
 
 To un-install, use::
 
-   python3 -m pip uninstall JACK-Client
+   python -m pip uninstall JACK-Client
 
 Requirements
 ------------
@@ -38,7 +38,7 @@ pip/setuptools:
    page.
    If you happen to have ``pip`` but not ``setuptools``, use this command::
 
-      python3 -m pip install setuptools
+      python -m pip install setuptools
 
    To upgrade to a newer version of an already installed package (including
    ``pip`` itself), use the ``--upgrade`` flag.
@@ -71,7 +71,7 @@ NumPy (optional):
    You can also install NumPy with ``pip``, but depending on your platform, this
    might require a compiler and several additional libraries::
 
-      python3 -m pip install NumPy
+      python -m pip install NumPy
 
 .. _JACK: https://jackaudio.org/
 .. _NumPy: https://numpy.org/

jack_build.py

@@ -318,4 +318,4 @@
 """, packed=True)
 
 if __name__ == '__main__':
-    ffibuilder.compile(verbose=True)
+    ffibuilder.compile(tmpdir='src', verbose=True)