meson-python 0.15.0__tar.gz → 0.16.0__tar.gz

{meson_python-0.15.0 → meson_python-0.16.0}/.cirrus.yml

@@ -80,3 +80,9 @@ freebsd_task:
     image_family: freebsd-13-2
   install_script: pkg install -y git ninja
   << : *test
+
+macos-arm64_task:
+  macos_instance:
+    image: ghcr.io/cirruslabs/macos-ventura-xcode
+  install_script: brew install git ninja python@3.11
+  << : *test

meson_python-0.16.0/.github/workflows/docs.yml

@@ -0,0 +1,51 @@
+# SPDX-FileCopyrightText: 2022 The meson-python developers
+#
+# SPDX-License-Identifier: MIT
+
+name: docs
+
+on:
+  push:
+    tags:
+      - '[0-9]+.[0-9]+.[0-9]+'
+  pull_request:
+    branches:
+      - main
+      - release-*
+    paths:
+      - docs/**
+      - CHANGELOG.rst
+      - README.md
+  workflow_dispatch:
+    inputs:
+      tag:
+        required: true
+
+jobs:
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.push.tag || github.event.inputs.tag }}
+      - run: python -m pip install .[docs]
+      - run: python -m sphinx -W docs/ build/docs/
+      - uses: actions/upload-pages-artifact@v2
+        with:
+          path: build/docs/
+
+  deploy:
+    needs: build
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+    runs-on: ubuntu-latest
+    if: ${{ github.event.push.tag || github.event.inputs.tag }}
+    steps:
+      - uses: actions/deploy-pages@v2

{meson_python-0.15.0 → meson_python-0.16.0}/.github/workflows/tests.yml

@@ -6,6 +6,9 @@ name: tests
 
 on:
   push:
+    branches:
+      - main
+      - release-*
   pull_request:
     branches:
       - main
@@ -19,6 +22,7 @@ on:
       - '!LICENSE'
       - '!LICENSES/**'
       - '!README.rst'
+      - '!.github/workflows/docs.yml'
   workflow_dispatch:
     # Allow to run manually
 
@@ -71,6 +75,12 @@ jobs:
           - os: ubuntu
             python: '3.11'
             meson: '~=1.1.0'
+          - os: ubuntu
+            python: '3.12'
+            meson: '~=1.2.3'
+          - os: ubuntu
+            python: '3.12'
+            meson: '~=1.3'
           # Test with Meson master branch.
           - os: ubuntu
             python: '3.12'
@@ -81,10 +91,10 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Set up target Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python }}
 
@@ -112,7 +122,7 @@ jobs:
           python -m pytest --showlocals -vv --cov --cov-report=xml
 
       - name: Upload coverage report
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v4
         if: ${{ always() }}
 
   msvc:
@@ -127,10 +137,10 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Set up target Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python }}
 
@@ -165,7 +175,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup Cygwin
         uses: cygwin/cygwin-install-action@v2
@@ -200,7 +210,7 @@ jobs:
         # Cygwin Python cannot use binary wheels from PyPI. Building
         # some dependencies takes considerable time. Caching the built
         # wheels speeds up the CI job quite a bit.
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: ${{ steps.pip-cache-path.outputs.path }}
           key: cygwin-pip-${{ github.sha }}
@@ -241,7 +251,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Install pyston
         run: |
@@ -275,7 +285,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Install Homebrew Python
         run: |
@@ -304,10 +314,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.9
 

{meson_python-0.15.0 → meson_python-0.16.0}/.pre-commit-config.yaml

@@ -8,7 +8,7 @@ ci:
 
 repos:
 - repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v4.4.0
+  rev: v4.5.0
   hooks:
   - id: check-ast
   - id: check-builtin-literals
@@ -20,17 +20,13 @@ repos:
   - id: double-quote-string-fixer
   - id: end-of-file-fixer
   - id: trailing-whitespace
-- repo: https://github.com/PyCQA/isort
-  rev: 5.12.0
-  hooks:
-  - id: isort
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.0.261
+  rev: v0.1.5
   hooks:
   - id: ruff
-    args: [--fix, --show-fixes, --format, grouped]
+    args: [--fix, --show-fixes, --output-format, grouped]
 - repo: https://github.com/fsfe/reuse-tool
-  rev: v1.1.2
+  rev: v2.1.0
   hooks:
   - id: reuse
     name: add SPDX headers

meson_python-0.15.0/.readthedocs.yml → meson_python-0.16.0/.readthedocs.yaml

@@ -4,8 +4,12 @@
 
 version: 2
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
 python:
-  version: 3.8
   install:
     - method: pip
       path: .

{meson_python-0.15.0 → meson_python-0.16.0}/CHANGELOG.rst

@@ -11,6 +11,36 @@
 Changelog
 +++++++++
 
+0.16.0
+======
+
+- Correctly detect a wheel shipping shared libraries as being platform
+  dependent also when it does not ship compiled executables or Python
+  extension modules.
+- Use 11.0 as minimum macOS platform ABI tag on arm64: lower versions
+  do not exist on arm64.
+- Improve parsing of the ``$ARCHFLAGS`` environment
+  variable. Correctly handle repeated ``-arch`` flags.
+- Do not break when trying to log filename containing Unicode
+  characters that cannot be encoded in the encoding used by the
+  standard output stream.
+- Drop dependency on ``colorama`` on Windows.
+- Suppress all uses of ANSI terminal escapes when logging to a stream
+  that does not support them.
+- Fix ANSI escape coloring of error messages.
+- Respect the ``exclude_dirs`` and ``exclude_files`` arguments passed
+  to the ``install_subdir()`` Meson function in editable installs too.
+- Make ``pkgutil.iter_packages()`` work properly for modules loaded
+  from editable installs.
+- Add support for the ``custom_target()`` Meson function installing a
+  directory.
+- In editable installs, when a rebuild is triggered on module import,
+  emit a message indicating that the package is being rebuilt but
+  suppress any output when there is no work to do.
+
+Daniele Nicolodi, Loïc Estève, Ralf Gommers  --- 16-04-2024
+
+
 0.15.0
 ======
 

{meson_python-0.15.0 → meson_python-0.16.0}/PKG-INFO

@@ -1,11 +1,10 @@
 Metadata-Version: 2.1
 Name: meson-python
-Version: 0.15.0
+Version: 0.16.0
 Summary: Meson Python build backend (PEP 517)
 Keywords: meson build backend pep517 package
 Home-page: https://github.com/mesonbuild/meson-python
-Maintainer: Thomas Li
-Maintainer-Email: Ralf Gommers  <ralf.gommers@gmail.com>, Daniele Nicolodi <daniele@grinta.net>, Henry Schreiner <HenrySchreinerIII@gmail.com>
+Maintainer-Email: Ralf Gommers <ralf.gommers@gmail.com>, Daniele Nicolodi <daniele@grinta.net>, Henry Schreiner <HenrySchreinerIII@gmail.com>, Thomas Li <47963215+lithomas1@users.noreply.github.com>
 License: Copyright © 2022 the meson-python contributors
         Copyright © 2021 Quansight Labs and Filipe Laíns
         
@@ -32,12 +31,12 @@ Classifier: Programming Language :: Python
 Classifier: Topic :: Software Development :: Build Tools
 Project-URL: Homepage, https://github.com/mesonbuild/meson-python
 Project-URL: Repository, https://github.com/mesonbuild/meson-python
-Project-URL: Documentation, https://meson-python.readthedocs.io/
-Project-URL: Changelog, https://meson-python.readthedocs.io/en/latest/changelog.html
+Project-URL: Documentation, https://mesonbuild.com/meson-python/
+Project-URL: Changelog, https://mesonbuild.com/meson-python/changelog.html
 Requires-Python: >=3.7
-Requires-Dist: colorama; os_name == "nt"
 Requires-Dist: meson>=0.63.3; python_version < "3.12"
 Requires-Dist: meson>=1.2.3; python_version >= "3.12"
+Requires-Dist: packaging>=19.0
 Requires-Dist: pyproject-metadata>=0.7.1
 Requires-Dist: tomli>=1.0.0; python_version < "3.11"
 Requires-Dist: build; extra == "test"
@@ -47,8 +46,8 @@ Requires-Dist: pytest-mock; extra == "test"
 Requires-Dist: cython>=3.0.3; extra == "test"
 Requires-Dist: wheel; extra == "test"
 Requires-Dist: typing-extensions>=3.7.4; python_version < "3.11" and extra == "test"
-Requires-Dist: furo>=2021.08.31; extra == "docs"
-Requires-Dist: sphinx~=4.0; extra == "docs"
+Requires-Dist: furo>=2023.5.20; extra == "docs"
+Requires-Dist: sphinx~=6.2; extra == "docs"
 Requires-Dist: sphinx-copybutton>=0.5.0; extra == "docs"
 Requires-Dist: sphinx-design>=0.1.0; extra == "docs"
 Requires-Dist: sphinxext-opengraph>=0.7.0; extra == "docs"
@@ -63,8 +62,8 @@ Description-Content-Type: text/x-rst
 meson-python
 ============
 
-``meson-python`` is a Python build backend built on top of the Meson__
-build system. It enables to use Meson for the configuration and build
+``meson-python`` is a Python build back-end built on top of the Meson__
+build system. It enables using Meson for the configuration and build
 steps of Python packages. Meson is an open source build system meant
 to be both extremely fast, and, even more importantly, as user
 friendly as possible. ``meson-python`` is best suited for building
@@ -77,6 +76,6 @@ discussions__ space on GitHub. Bug reports and feature requests can be
 filed as GitHub issues__.
 
 __ https://mesonbuild.com/
-__ https://meson-python.readthedocs.io/en/latest/
+__ https://mesonbuild.com/meson-python/
 __ https://github.com/mesonbuild/meson-python/discussions/
 __ https://github.com/mesonbuild/meson-python/issues/

{meson_python-0.15.0 → meson_python-0.16.0}/README.rst

@@ -5,8 +5,8 @@
 meson-python
 ============
 
-``meson-python`` is a Python build backend built on top of the Meson__
-build system. It enables to use Meson for the configuration and build
+``meson-python`` is a Python build back-end built on top of the Meson__
+build system. It enables using Meson for the configuration and build
 steps of Python packages. Meson is an open source build system meant
 to be both extremely fast, and, even more importantly, as user
 friendly as possible. ``meson-python`` is best suited for building
@@ -19,6 +19,6 @@ discussions__ space on GitHub. Bug reports and feature requests can be
 filed as GitHub issues__.
 
 __ https://mesonbuild.com/
-__ https://meson-python.readthedocs.io/en/latest/
+__ https://mesonbuild.com/meson-python/
 __ https://github.com/mesonbuild/meson-python/discussions/
 __ https://github.com/mesonbuild/meson-python/issues/

{meson_python-0.15.0 → meson_python-0.16.0}/ci/alpine-3.docker

@@ -2,6 +2,6 @@
 #
 # SPDX-License-Identifier: MIT
 
-# 20221203
+# 20240305
 FROM alpine:3
-RUN apk add --no-cache python3-dev py3-pip build-base ninja git patchelf
+RUN apk add --no-cache python3-dev py3-pip build-base ninja-is-really-ninja git patchelf

{meson_python-0.15.0 → meson_python-0.16.0}/ci/debian-11.docker

@@ -2,6 +2,6 @@
 #
 # SPDX-License-Identifier: MIT
 
-# 20221203
+# 20240204
 FROM debian:bullseye
 RUN apt-get update && apt-get install -y git ninja-build patchelf python3-pip python3-venv && rm -rf /var/lib/apt/lists/*

{meson_python-0.15.0 → meson_python-0.16.0}/ci/debian-12.docker

@@ -2,6 +2,6 @@
 #
 # SPDX-License-Identifier: MIT
 
-# 20230816
+# 20240204
 FROM debian:bookworm
 RUN apt-get update && apt-get install -y git ninja-build patchelf python3-pip python3-venv && rm -rf /var/lib/apt/lists/*

{meson_python-0.15.0 → meson_python-0.16.0}/ci/fedora-37.docker

@@ -2,6 +2,6 @@
 #
 # SPDX-License-Identifier: MIT
 
-# 20221203
+# 20240204
 FROM fedora:37
 RUN dnf -y update && dnf -y install python3-devel python3-pip gcc ninja-build git patchelf && dnf clean all

{meson_python-0.15.0 → meson_python-0.16.0}/ci/miniconda.docker

@@ -2,6 +2,6 @@
 #
 # SPDX-License-Identifier: MIT
 
-# 20221203
+# 20240204
 FROM continuumio/miniconda3
 RUN apt-get update && apt-get install -y gcc ninja-build git patchelf && rm -rf /var/lib/apt/lists/*

{meson_python-0.15.0 → meson_python-0.16.0}/docs/changelog.rst

@@ -11,6 +11,36 @@
 Changelog
 +++++++++
 
+0.16.0
+======
+
+- Correctly detect a wheel shipping shared libraries as being platform
+  dependent also when it does not ship compiled executables or Python
+  extension modules.
+- Use 11.0 as minimum macOS platform ABI tag on arm64: lower versions
+  do not exist on arm64.
+- Improve parsing of the ``$ARCHFLAGS`` environment
+  variable. Correctly handle repeated ``-arch`` flags.
+- Do not break when trying to log filename containing Unicode
+  characters that cannot be encoded in the encoding used by the
+  standard output stream.
+- Drop dependency on ``colorama`` on Windows.
+- Suppress all uses of ANSI terminal escapes when logging to a stream
+  that does not support them.
+- Fix ANSI escape coloring of error messages.
+- Respect the ``exclude_dirs`` and ``exclude_files`` arguments passed
+  to the ``install_subdir()`` Meson function in editable installs too.
+- Make ``pkgutil.iter_packages()`` work properly for modules loaded
+  from editable installs.
+- Add support for the ``custom_target()`` Meson function installing a
+  directory.
+- In editable installs, when a rebuild is triggered on module import,
+  emit a message indicating that the package is being rebuilt but
+  suppress any output when there is no work to do.
+
+Daniele Nicolodi, Loïc Estève, Ralf Gommers  --- 16-04-2024
+
+
 0.15.0
 ======
 

{meson_python-0.15.0 → meson_python-0.16.0}/docs/conf.py

@@ -14,6 +14,7 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 
+import datetime
 import os
 import sys
 sys.path.insert(0, os.path.abspath('..'))
@@ -23,7 +24,7 @@ import mesonpy
 # -- Project information -----------------------------------------------------
 
 project = 'meson-python'
-copyright = '2021, The meson-python developers'
+copyright = f'2021\N{EN DASH}{datetime.date.today().year} The meson-python developers'
 
 # The short X.Y version
 version = mesonpy.__version__
@@ -92,7 +93,7 @@ html_theme_options = {
 
 # Open Graph
 
-ogp_site_url = 'https://meson-python.readthedocs.io'
+ogp_site_url = 'https://mesonbuild.com/meson-python/'
 ogp_site_name = 'meson-python documentation'
 
 

{meson_python-0.15.0 → meson_python-0.16.0}/docs/contributing/index.rst

@@ -8,5 +8,4 @@ Development
 
 .. toctree::
 
-   documentation
    release-process

{meson_python-0.15.0 → meson_python-0.16.0}/docs/contributing/release-process.rst

@@ -14,7 +14,7 @@ All releases are PGP signed with one of the keys listed in the
 there, and preferably signed by one of the other key holders.
 
 If your key is not signed by one of the other key holders, please make sure the
-PR that added your key to the :ref:`security` page was approved by at least one
+PR that added your key to the :doc:`../about` page was approved by at least one
 other maintainer.
 
 After that is done, you may release the project by following these steps:

meson_python-0.16.0/docs/how-to-guides/config-settings.rst

@@ -0,0 +1,61 @@
+.. SPDX-FileCopyrightText: 2023 The meson-python developers
+..
+.. SPDX-License-Identifier: MIT
+
+.. _how-to-guides-config-settings:
+
+***************************
+Using build config settings
+***************************
+
+Build config settings can be used to customize some aspects of the
+build. See the :doc:`../reference/config-settings` reference for a list
+of the settings implemented by ``meson-python``.
+
+How build config settings are specified depends on the Python package
+build front-end used. The most popular build front-end are `build`_ and
+`pip`_. These use the ``--config-settings`` long command line option or
+the ``-C`` short command line option:
+
+.. tab-set::
+
+    .. tab-item:: pypa/buid
+        :sync: key_pypa_build
+
+	.. code-block:: console
+
+	   $ python -m build \
+               -Csetup-args="-Doption=true" \
+               -Csetup-args="-Dvalue=1" \
+               -Ccompile-args="-j6"
+
+    .. tab-item:: pip
+        :sync: key_pip
+
+	.. code-block:: console
+
+	   $ python -m pip wheel . \
+               --config-settings=setup-args="-Doption=disable" \
+               --config-settings=compile-args="-j6"
+
+
+Refer to the `build`_ and `pip`_ documentation for details.  This
+example uses the ``python -m pip wheel`` command to build a Python wheel
+that can be later installed or distributed. To build a package and
+immediately install it, replace ``wheel`` with ``install``.  See the
+:ref:`how-to-guides-meson-args` guide for more examples.
+
+
+.. admonition:: Passing multiple settings
+   :class: caution
+
+   Please note that ``pip`` prior to 23.1 did not offer a way to set a
+   build config setting to a list of strings: later values for the
+   same key passed to ``--config-settings`` override earlier ones,
+   effectively limiting the number of options that can be passed to
+   each command invoked in the build process to one. This limitation
+   has been lifted in ``pip`` release 23.1.
+
+
+.. _build: https://pypa-build.readthedocs.io/en/stable/
+.. _pip: https://pip.pypa.io/

meson_python-0.16.0/docs/index.rst

@@ -0,0 +1,106 @@
+.. SPDX-FileCopyrightText: 2022 The meson-python developers
+..
+.. SPDX-License-Identifier: MIT
+
+:hide-toc:
+
+************
+meson-python
+************
+
+.. highlights::
+
+  A Python package build backend leveraging the Meson build system.
+
+``meson-python`` implement the Python build system hooks, enabling Python build
+front-ends such as ``pip`` and ``build`` to build and install Python packages
+based on a Meson_ build definition.
+
+Meson is characterized by build definitions written in a very readable
+domain-specific language and extremely fast builds.  Meson support for Windows,
+macOS, Linux, and other UNIX-like operative systems, and for all the major
+compiler tool-chains. It allows to compile and link together code written in
+many programming languages, including C, C++, Cython, D, Fortran, Objective C,
+and Rust. It has built-in multi-platform dependency provider that works well
+with distribution packages, and the capability to build dependencies as
+sub-projects.  If you are not familiar with Meson, we recommend checking the
+`Meson tutorial`_.
+
+``meson-python`` inherits the strengths of Meson and is thus best suited for
+Python packages building extension modules in compiled languages.
+``meson-python`` is suitable for small packages as well as very complex ones,
+see our :ref:`projects-using-meson-python` directory.
+
+To enable ``pip`` or ``build`` to build a Python source distribution (*sdist*)
+or a binary Python package (*wheel*) for a Meson project, it is sufficient to
+add to the root of the source tree next to the top-level ``meson.build`` a
+``pyproject.toml`` file specifying ``meson-python`` as the Python build
+backend:
+
+.. code-block:: toml
+
+   [build-system]
+   build-backend = 'mesonpy'
+   requires = ['meson-python']
+
+The package name and version are extracted from the metadata provided to Meson
+via the ``project()`` function in the ``meson.build`` file.  Package metadata
+can be overridden and extended using the standard package metadata format in the
+``project`` section of ``pyproject.toml``:
+
+.. code-block:: toml
+
+   [project]
+   name = 'example'
+   version = '1.0.0'
+   description = 'Example package using the meson-python build backend'
+   readme = 'README.rst'
+   license = {file = 'LICENSE.txt'}
+   authors = [
+     {name = 'Au Thor', email = 'author@example.com'},
+   ]
+
+   [project.scripts]
+   example = 'example.cli:main'
+
+Please refer to the `PyPA documentation`_ for detailed documentation about the
+``pyproject.toml`` file.  Please refer to our :ref:`tutorial` for guidance about
+the use of ``meson-python`` and Meson for Python packaging.
+
+
+.. _Meson: https://mesonbuild.com/
+.. _PyPA documentation: https://packaging.python.org/en/latest/specifications/declaring-project-metadata/
+.. _Meson tutorial: https://mesonbuild.com/Tutorial.html
+
+
+.. toctree::
+   :hidden:
+
+   tutorials/introduction
+   how-to-guides/editable-installs
+   how-to-guides/config-settings
+   how-to-guides/meson-args
+   how-to-guides/debug-builds
+   reference/limitations
+   projects-using-meson-python
+
+.. toctree::
+   :caption: Reference
+   :hidden:
+
+   reference/config-settings
+   reference/pyproject-settings
+   reference/environment-variables
+   explanations/default-options
+   reference/meson-compatibility
+
+.. toctree::
+   :caption: Project
+   :hidden:
+
+   changelog
+   about
+   contributing/index
+   Discussions <https://github.com/mesonbuild/meson-python/discussions>
+   Source Code <https://github.com/mesonbuild/meson-python>
+   Issue Tracker <https://github.com/mesonbuild/meson-python/issues>

meson_python-0.16.0/docs/projects-using-meson-python.rst

@@ -0,0 +1,33 @@
+.. SPDX-FileCopyrightText: 2023 The meson-python developers
+..
+.. SPDX-License-Identifier: MIT
+
+.. _projects-using-meson-python:
+
+********
+Examples
+********
+
+The following project use ``meson-python`` for their build system known to be
+adhering to best practices
+
+
+:`SciPy <https://github.com/scipy/scipy>`_: Probably the most complex
+   project using Meson and ``meson-python``.  It combines CPython
+   extensions and libraries written in C, C++, Fortran, Cython_, and
+   Pythran_.
+
+:`scikit-image <https://github.com/scikit-image/scikit-image>`_:
+   Another complex project using ``meson-python``.
+
+:`siphash24 <https://github.com/dnicolodi/python-siphash24>`_: A very
+   simple project. It demonstrates how Meson makes it trivial to
+   compile a CPython extension written in `Cython`_ via a simple
+   template engine and link it to a library compiled from a Meson
+   subproject. Also an example of how to use `cibuildwheel`_ to
+   produce Python wheels for several platforms.
+
+
+.. _Cython: https://github.com/cython/cython
+.. _Pythran: https://github.com/serge-sans-paille/pythran
+.. _cibuildwheel: https://github.com/pypa/cibuildwheel