pkgconf 2.4.3.post2__py3-none-win_arm64.whl

pkgconf/__init__.py

@@ -0,0 +1,150 @@
+import logging
+import operator
+import os
+import pathlib
+import shlex
+import shutil
+import subprocess
+import sys
+import sysconfig
+import warnings
+
+from collections.abc import Sequence
+from typing import Any, Optional
+
+
+if sys.version_info >= (3, 10):
+    import importlib.metadata as importlib_metadata
+else:
+    import importlib_metadata
+
+
+__version__ = '2.4.3-2'
+
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class PathWarning(Warning):
+    def __init__(self, message: str, entrypoint: importlib_metadata.EntryPoint) -> None:
+        self._message = message
+        self._entrypoint = entrypoint
+
+    def __str__(self) -> str:
+        return (
+            f'Skipping PKG_CONFIG_PATH entry: {self._message}'
+            f'- Entrypoint: {self._entrypoint}'
+            f'- Distribution: {self._distribution_info()}'
+        )
+
+    def _distribution_info(self) -> str:
+        info = f'{self._entrypoint.dist}-{self._entrypoint.dist.version}'
+        metadata_path = self._find_metadata_path()
+        if metadata_path:
+            info += f' at {metadata_path!r}'
+        return info
+
+    def _find_metadata_path(self) -> Optional[str]:
+        try:
+            dist_root = self._entrypoint.dist.locate_file('')
+        except NotImplementedError:
+            return None
+
+        for file in self._entrypoint.dist.files() or []:
+            if file.parts[0].endswith('.dist-info'):
+                return str(dist_root / file.parts[0])
+        return None
+
+
+def _get_system_executable() -> Optional[pathlib.Path]:
+    if os.environ.get('PKGCONF_PYPI_EMBEDDED_ONLY'):
+        return None
+
+    scripts = sysconfig.get_path('scripts')
+    path_list = os.environ.get('PATH', os.defpath).split(os.pathsep)
+    if scripts in path_list:
+        path_list.remove(scripts)
+    path = os.pathsep.join(path_list)
+
+    executable = shutil.which('pkgconf', path=path) or shutil.which('pkg-config', path=path)
+    if executable:
+        return pathlib.Path(executable)
+    return None
+
+
+def get_executable() -> pathlib.Path:
+    """Get the pkgconf executable."""
+    if os.name == 'posix':
+        executable_name = 'pkgconf'
+    elif os.name == 'nt':
+        executable_name = 'pkgconf.EXE'
+    else:
+        raise NotImplementedError
+
+    for path in __path__:
+        executable = pathlib.Path(path) / '.bin' / executable_name
+        if executable.exists():
+            return executable
+
+    warnings.warn('Bundled pkgconf not found, using the system executable', stacklevel=2)
+    executable = _get_system_executable()
+    if executable:
+        return executable
+
+    msg = 'No pkgconf/pkg-config executable available'
+    raise RuntimeError(msg)
+
+
+def _find_entrypoints() -> Sequence[importlib_metadata.EntryPoint]:
+    """Return the list of pkg_config entrypoints sorted by name."""
+    entrypoints = importlib_metadata.entry_points(group='pkg_config')
+    return sorted(entrypoints, key=operator.attrgetter('name'))
+
+
+def _resolve_entrypoint_path(entrypoint: importlib_metadata.EntryPoint) -> str:
+    """Return a filesystem path for module specified in the entrypoint.
+
+    XXX: This only considers files provided by the distribution that registered the entrypoint.
+    """
+    assert entrypoint.dist
+    subpath = pathlib.PurePath(*entrypoint.value.split('.'))
+    try:
+        module_path = entrypoint.dist.locate_file(subpath).resolve()
+    except NotImplementedError:
+        warnings.warn(
+            PathWarning(
+                'Unable to resolve the file-system path for the entrypoint, '
+                f"as {entrypoint.dist} doesn't implement locate_file()"
+            ),
+            stacklevel=2,
+        )
+    return os.fspath(module_path)
+
+
+def get_pkg_config_path() -> Sequence[str]:
+    """Calculate PKG_CONFIG_PATH for Python packages in the current environment.
+
+    Python packages may register a directory for their pkg-config files by
+    specifying a "pkg-config" entrypoint.
+
+    TODO: Document the entrypoint creation and point to that here.
+    [project.entry-points.pkg-config]
+    entrypoint-name = 'project.package'
+    """
+    return [_resolve_entrypoint_path(ep) for ep in _find_entrypoints()]
+
+
+def run_pkgconf(*args: str, **subprocess_kwargs: Any) -> subprocess.CompletedProcess:
+    """Run the pkgconf executable.
+
+    :param args: Arguments to pass to the pkgconf call.
+    :param subprocess_kwargs: Keyword arguments to pass to the subprocess.run call.
+    """
+    env = os.environ.copy()
+    PKG_CONFIG_PATH = env.get('PKG_CONFIG_PATH', '').split(os.pathsep) + get_pkg_config_path()
+    PKG_CONFIG_PATH = list(dict.fromkeys(PKG_CONFIG_PATH))  # Remove duplicated entried
+    env['PKG_CONFIG_PATH'] = os.pathsep.join(PKG_CONFIG_PATH)
+    cmd = [os.fspath(get_executable()), *args]
+    _LOGGER.info('Running the Python pkgconf')
+    _LOGGER.info('$ ' + shlex.join(('PKG_CONFIG_PATH=' + shlex.quote(env['PKG_CONFIG_PATH']), *cmd)))
+    return subprocess.run(cmd, env=env, **subprocess_kwargs)

pkgconf/__main__.py

@@ -0,0 +1,121 @@
+import logging
+import os
+import shlex
+import subprocess
+import sys
+import sysconfig
+import warnings
+
+from typing import Optional, TextIO, Union
+
+import pkgconf
+
+
+_LOGGER = logging.getLogger(__name__)
+
+
+def main() -> None:
+    args = sys.argv[1:]
+
+    # If we find that we are calling ourselves, exit immediately
+    if os.environ.get('PKGCONF_PYPI_RECURSIVE') == __file__:
+        _LOGGER.info('Giving up, pkgconf recursion loop detected')
+        sys.exit(1)
+
+    os.environ['PKGCONF_PYPI_RECURSIVE'] = __file__
+    returncode = 1
+    try:
+        returncode = pkgconf.run_pkgconf(*args, check=True).returncode
+    except subprocess.SubprocessError as e:
+        # If our pkgconf lookup fails, fallback to the system pkgconf/pkg-config.
+        # For simplicity, the previous call will output to stdout/stderr
+        # regardless of its success, since capturing stdout/stderr in order to
+        # replay is tricky. If the fallback path triggers, it will also output
+        # to stdout/stderr, meaning we will have the output of both process
+        # calls. While a bit unexpected, I believe this is the best option for
+        # debugging.
+        system_executable = pkgconf._get_system_executable()
+        if system_executable:
+            cmd = [os.fspath(system_executable), *args]
+            _LOGGER.info(f'Running the system {system_executable.name}')
+            _LOGGER.info('$ ' + shlex.join(cmd))
+            returncode = subprocess.run(cmd).returncode
+        elif isinstance(e, subprocess.CalledProcessError):
+            returncode = e.returncode
+
+    sys.exit(returncode)
+
+
+def _venv_paths(config_vars: dict[str, str]) -> str:
+    if 'venv' in sysconfig.get_scheme_names():
+        return sysconfig.get_paths('venv', vars=config_vars)
+    return sysconfig.get_paths(vars=config_vars)
+
+
+def _entrypoint():
+    # Since project.script entrypoints use an hardcoded interpreter path from
+    # the environment they were installed in, when stacking environments (eg.
+    # using venv's --system-site-packages option), the entrypoint will run in
+    # the base environment and, as such, it will not have access to the
+    # entrypoints from the "child" environment. Because of this, when a virtual
+    # environment is enabled, instead of running main() from this process, we
+    # will run 'python -m pkgconf', so that we have access to the full
+    # environment.
+    if 'VIRTUAL_ENV' in os.environ:
+        venv_vars = sysconfig.get_config_vars().copy()
+        venv_vars['base'] = venv_vars['platbase'] = os.environ['VIRTUAL_ENV']
+        scripts = _venv_paths(venv_vars)['scripts']
+        python_path = os.path.join(scripts, 'python')
+        process = subprocess.run([python_path, '-m', 'pkgconf', *sys.argv[1:]])
+        sys.exit(process.returncode)
+    else:
+        _setup_cli()
+        main()
+
+
+def _use_colors() -> bool:
+    if 'NO_COLOR' in os.environ:
+        if 'FORCE_COLOR' in os.environ:
+            warnings.warn('Both NO_COLOR and FORCE_COLOR environment variables are set, disabling color', stacklevel=2)
+        return False
+    elif 'FORCE_COLOR' in os.environ or sys.stdout.isatty():
+        if os.name == 'nt':
+            try:
+                import colorama
+            except ModuleNotFoundError:
+                return False
+            colorama.init()
+        return True
+    return False
+
+
+def _setup_cli():
+    if _use_colors():
+        dim = '\33[2m'
+        yellow = '\33[93m'
+        reset = '\33[0m'
+    else:
+        dim = yellow = reset = ''
+
+    logging.basicConfig(
+        stream=sys.stderr,
+        format=f'{dim}> %(message)s{reset}',
+        level=logging.INFO,
+    )
+
+    def _showwarning(
+        message: Union[Warning, str],
+        category: type[Warning],
+        filename: str,
+        lineno: int,
+        file: Optional[TextIO] = None,
+        line: Optional[str] = None,
+    ) -> None:  # pragma: no cover
+        print(f'{yellow}WARNING{reset} {message}', file=sys.stderr)
+
+    warnings.showwarning = _showwarning
+
+
+if __name__ == '__main__':
+    _setup_cli()
+    main()

pkgconf/diagnose.py

@@ -0,0 +1,22 @@
+import os
+
+import pkgconf
+
+
+def report() -> None:
+    print(f'pkgconf executable: {pkgconf.get_executable()}')
+
+    print('entrypoints:')
+    for entrypoint in pkgconf._find_entrypoints():
+        print(f'  {entrypoint.name}:')
+        print(f'    value: {entrypoint.value}')
+        print(f'     path: {pkgconf._resolve_entrypoint_path(entrypoint)}')
+
+    print(f'PKG_CONFIG_PATH: {os.pathsep.join(pkgconf.get_pkg_config_path())}')
+
+
+if __name__ == '__main__':
+    try:
+        report()
+    except (KeyboardInterrupt, BrokenPipeError):  # pragma: no cover
+        pass

pkgconf-2.4.3.post2.dist-info/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2024 pypackaging-native contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the “Software”), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pkgconf-2.4.3.post2.dist-info/METADATA

@@ -0,0 +1,83 @@
+Metadata-Version: 2.1
+Name: pkgconf
+Version: 2.4.3.post2
+Summary: `pkgconf` is a program which helps with discovering library dependencies and configuring compiler and linker flags.
+Author-Email: Ralf Gommers <ralf.gommers@gmail.com>, =?utf-8?q?Filipe_La=C3=ADns?= <lains@riseup.net>
+License: Copyright (c) 2024 pypackaging-native contributors
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy of
+         this software and associated documentation files (the “Software”), to deal in
+         the Software without restriction, including without limitation the rights to
+         use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+         of the Software, and to permit persons to whom the Software is furnished to do
+         so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+         
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: ISC License (ISCL)
+Classifier: Programming Language :: C
+Classifier: Topic :: Software Development
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS
+Project-URL: homepage, https://pkgconf-pypi.readthedocs.io/en/latest/
+Project-URL: issues, https://github.com/pypackaging-native/pkgconf-pypi/issues
+Project-URL: source, https://github.com/pypackaging-native/pkgconf-pypi
+Requires-Python: >=3.9
+Requires-Dist: colorama; os_name == "nt"
+Requires-Dist: importlib_metadata; python_version < "3.10"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov>=5; extra == "test"
+Requires-Dist: pytest-mock>=2; extra == "test"
+Requires-Dist: pytest-order>=1; extra == "test"
+Requires-Dist: pytest-github-actions-annotate-failures; extra == "test"
+Requires-Dist: meson-python; extra == "test"
+Requires-Dist: environment-helpers>=0.1.3; extra == "test"
+Provides-Extra: docs
+Requires-Dist: sphinx~=7.0; extra == "docs"
+Requires-Dist: furo; extra == "docs"
+Requires-Dist: sphinx-design; extra == "docs"
+Description-Content-Type: text/markdown
+
+# pkgconf-pypi
+
+[![CI test](https://github.com/pypackaging-native/pkgconf-pypi/actions/workflows/test.yml/badge.svg)](https://github.com/pypackaging-native/pkgconf-pypi/actions/workflows/test.yml)
+[![CI build](https://github.com/pypackaging-native/pkgconf-pypi/actions/workflows/build.yml/badge.svg)](https://github.com/pypackaging-native/pkgconf-pypi/actions/workflows/build.yml)
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/pypackaging-native/pkgconf-pypi/main.svg)](https://results.pre-commit.ci/latest/github/pypackaging-native/pkgconf-pypi/main)
+[![codecov](https://codecov.io/gh/pypackaging-native/pkgconf-pypi/graph/badge.svg)](https://codecov.io/gh/pypackaging-native/pkgconf-pypi)
+
+[![Documentation Status](https://readthedocs.org/projects/pkgconf-pypi/badge/?version=latest)](https://pkgconf-pypi.readthedocs.io/en/latest/?badge=latest)
+[![PyPI version](https://badge.fury.io/py/pkgconf.svg)](https://pypi.org/project/pkgconf/)
+[![Discord](https://img.shields.io/discord/803025117553754132?label=Discord%20chat%20pkgconf-pypi)](https://discord.gg/pypa)
+
+This goal of this repo is to facility building and publishing of
+[pkgconf](https://github.com/pkgconf/pkgconf) binaries on PyPI, primarily for
+ease of installing in a cross-platform manner. This is useful when `pkgconf` is
+for example needed in workflows of other Python packages.
+
+## Choices
+
+The intent is to:
+
+- distribute `pkgconf` without any modifications
+- configure the build with no system directory
+- install `pkg-config` as an alias in the scripts directory of the Python
+  environment
+
+## Links
+
+Documentation: https://pkgconf-pypi.readthedocs.io

pkgconf-2.4.3.post2.dist-info/RECORD

@@ -0,0 +1,10 @@
+pkgconf-2.4.3.post2.dist-info/METADATA,sha256=eyvk4tXOLiYPYHNHu2uYKXHvosUj8xfzA8x3GvNO2DQ,4546
+pkgconf-2.4.3.post2.dist-info/WHEEL,sha256=B3B4KN1DoTlWtNhRRRGkD-knxtCiXk730NQ8ihkn3eI,85
+pkgconf-2.4.3.post2.dist-info/entry_points.txt,sha256=rqbdxRekoww-gAluYeeJvZ_y1v2Lz4Vn5txhiwhXsUM,100
+pkgconf-2.4.3.post2.dist-info/LICENSE,sha256=ZkgDE-MK5aHoknemDQt1la7dQ91Mw6i5YRVW120ARTg,1102
+pkgconf/.bin/pkgconf.exe,sha256=i2-rwUR4a2a2717ZOP4yelYKT0PzIjo2YoEreP4AnoU,86528
+pkgconf/__init__.py,sha256=FUwhqiljnIzWIeyICov4n8Xg2AF-eEe1AE6d1EKqT7U,5071
+pkgconf/__main__.py,sha256=0yaqleseScIlGtCMXO3YQNuczhFaC91c_6w8kQhCjCs,4161
+pkgconf/diagnose.py,sha256=b8UX1QhUwHdhqPMjPvQ8-cUqeSONTen8pYRDrxmzYnY,592
+pkgconf/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pkgconf-2.4.3.post2.dist-info/RECORD,,

pkgconf-2.4.3.post2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: meson
+Root-Is-Purelib: false
+Tag: py3-none-linux_x86_64

pkgconf-2.4.3.post2.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+pkg-config = pkgconf.__main__:_entrypoint
+pkgconf = pkgconf.__main__:_entrypoint
+