xbuild 0.0.1__tar.gz

xbuild-0.0.1/.github/dependabot.yml

@@ -0,0 +1,18 @@
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates on Sunday, 8PM UTC
+      interval: "weekly"
+      day: "sunday"
+      time: "20:00"
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      # Check for updates on Sunday, 8PM UTC
+      interval: "weekly"
+      day: "sunday"
+      time: "20:00"

xbuild-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,82 @@
+name: CI
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_call:
+
+# Cancel active CI runs for a PR before starting another run
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+defaults:
+  run:
+    shell: bash  # https://github.com/beeware/briefcase/pull/912
+
+env:
+  FORCE_COLOR: "1"
+
+jobs:
+  pre-commit:
+    name: Pre-commit checks
+    uses: beeware/.github/.github/workflows/pre-commit-run.yml@main
+    with:
+      pre-commit-source: "--group pre-commit"
+
+  package:
+    name: Build Package
+    needs: [ pre-commit ]
+    runs-on: "ubuntu-24.04"
+    permissions:
+      id-token: write
+      attestations: write
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v5.0.0
+      with:
+        fetch-depth: 0
+
+    - name: Build and inspect package
+      uses: hynek/build-and-inspect-python-package@v2.13.0
+      with:
+        attest-build-provenance-github: 'true'
+
+  unit-tests:
+    name: Unit tests
+    needs: [ package ]
+    runs-on: "ubuntu-24.04"
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ "3.13", "3.14" ]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v5.0.0
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5.6.0
+      with:
+        python-version: "${{ matrix.python-version }}"
+        allow-prereleases: true
+
+    - name: Install test requirements
+      run: |
+        python -m pip install -U pip
+        python -m pip install --group ci
+
+    - name: Test
+      run: |
+        python -m tox -e py
+
+    # # This step is only needed if you're trying to diagnose test failures that
+    # # only occur in CI, and can't be reproduced locally. When it runs, it will
+    # # open an SSH server (URL reported in the logs) so you can ssh into the CI
+    # # machine.
+    # - name: Setup tmate session
+    #   uses: mxschmitt/action-tmate@v3
+    #   if: failure()

xbuild-0.0.1/.github/workflows/pre-commit-update.yml

@@ -0,0 +1,15 @@
+name: Update pre-commit
+
+on:
+  schedule:
+    - cron: "0 20 * * SUN"  # Sunday @ 2000 UTC
+  workflow_dispatch:
+
+jobs:
+  pre-commit-update:
+    name: Update pre-commit
+    uses: beeware/.github/.github/workflows/pre-commit-update.yml@main
+    secrets: inherit
+    with:
+      pre-commit-source: --group pre-commit
+      create-changenote: false

xbuild-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,22 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: published
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      # This permission is required for trusted publishing.
+      id-token: write
+    steps:
+      - uses: dsaltares/fetch-gh-release-asset@1.1.2
+        with:
+          version: tags/${{ github.event.release.tag_name }}
+          file: ${{ github.event.repository.name }}.*
+          regex: true
+          target: dist/
+
+      - name: Publish release to production PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

xbuild-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,48 @@
+name: Create Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  ci:
+    name: CI
+    uses: ./.github/workflows/ci.yml
+
+  release:
+    name: Create Release
+    needs: ci
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      # This permission is required for trusted publishing.
+      id-token: write
+    steps:
+      - name: Set build variables
+        run: |
+          echo "VERSION=${GITHUB_REF_NAME#v}" | tee -a $GITHUB_ENV
+
+      - name: Set up Python
+        uses: actions/setup-python@v5.6.0
+        with:
+          python-version: "3.x"
+
+      - name: Get packages
+        uses: actions/download-artifact@v5.0.0
+        with:
+          pattern: Packages
+          path: dist
+
+      - name: Create release
+        uses: ncipollo/release-action@v1.18.0
+        with:
+          name: ${{ env.VERSION }}
+          draft: true
+          artifacts: dist/*
+          artifactErrorsFailBuild: true
+
+      - name: Publish release to Test PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

xbuild-0.0.1/.gitignore

@@ -0,0 +1,26 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+
+# Distribution / packaging
+build/lib/
+dist/
+*.egg-info/
+.eggs
+
+# Testing and coverage
+.cache
+.tox/
+.mypy_cache/
+.pytest_cache
+htmlcov/
+.coverage
+coverage.xml
+tests/integration/
+.integration-sources
+.tox
+Dockerfile
+
+# In-repo spaces for local testing
+local/
+temp/

xbuild-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,27 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-toml
+      - id: check-yaml
+      - id: check-case-conflict
+      - id: check-docstring-first
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+  - repo: https://github.com/PyCQA/docformatter
+    rev: v1.7.7
+    hooks:
+      - id: docformatter
+        args: [--in-place, --black]
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.11
+    hooks:
+      - id: ruff-format
+      - id: ruff-check
+        args: [ --fix ]
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+    - id: codespell
+      # remove toml extra once Python 3.10 is no longer supported
+      additional_dependencies: ['.[toml]']

xbuild-0.0.1/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.0.1 (5 Sep 2025)
+
+Initial release.
+
+Includes `xvenv`, a tool for creating cross platform environments. This has undergone initial testing to verify it works for iOS, Android and Emscripten environments. The created environment is sufficient to trick `pip` into installing binaries for the target platform into the environment; and for tools like `wheel` to trigger builds with compiler invocations derived from `sysconfgdata`. This won't generally result in a *successful* build, as there will usually be other environmental requirements; but the a cross-platform build will be attempted.

xbuild-0.0.1/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing
+
+BeeWare <3's contributions!
+
+Please be aware, BeeWare operates under a Code of Conduct.
+
+See [CONTRIBUTING to BeeWare](http://beeware.org/contributing) for details.

xbuild-0.0.1/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2025 Russell Keith-Magee.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    3. Neither the name of xbuild nor the names of its
+       contributors may be used to endorse or promote products derived from this
+       software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

xbuild-0.0.1/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: xbuild
+Version: 0.0.1
+Summary: A PEP517 build frontend for cross-compiling wheels.
+Author-email: Russell Keith-Magee <russell@keith-magee.com>
+Maintainer-email: Russell Keith-Magee <russell@keith-magee.com>
+License-Expression: BSD-3-Clause
+Project-URL: Project, https://github.com/beeware/xbuild
+Project-URL: Funding, https://beeware.org/contributing/membership/
+Project-URL: Tracker, https://github.com/beeware/xbuild/issues
+Project-URL: Source, https://github.com/beeware/xbuild
+Keywords: pep517,build
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Software Distribution
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: build==1.3.0
+Dynamic: license-file
+
+# xbuild
+
+[![Python Versions](https://img.shields.io/pypi/pyversions/xbuild.svg)](https://pypi.python.org/pypi/xbuild)
+[![PyPI Version](https://img.shields.io/pypi/v/xbuild.svg)](https://pypi.python.org/pypi/xbuild)
+[![Maturity](https://img.shields.io/pypi/status/xbuild.svg)](https://pypi.python.org/pypi/xbuild)
+[![BSD License](https://img.shields.io/pypi/l/xbuild.svg)](https://github.com/beeware/xbuild/blob/master/LICENSE)
+[![Discord server](https://img.shields.io/discord/836455665257021440?label=Discord%20Chat&logo=discord&style=plastic)](https://beeware.org/bee/chat/)
+
+`xbuild` is PEP517 build frontend that has additions and extensions to support cross-compiling wheels for platforms where compilation cannot be performed natively - most notably:
+
+* Android
+* Emscripten (WASM)
+* iOS
+
+## Usage
+
+### Creating a cross virtual environment
+
+To create a cross virtual environment, you will need a distribution of Python that has been compiled for Android, Emscripten or iOS. Create a virtual environment for your build platform (i.e., the platform where you will be compiling), then use the `xvenv` script to convert that virtual environment in to a cross environment.
+
+    $ python3 -m venv venv
+    $ source venv/bin/activate
+    (venv) $ pip install xbuild
+    (venv) $ python -m venv x-venv
+    (venv) $ xvenv --sysconfig path/to/_sysconfig_vars__...json x-venv
+
+You can then activate the cross virtual environment. For example, if `x-venv` was constructed using an iOS simulator sysconfig vars file (`_sysconfig_vars__ios_arm64-iphonesimulator.json`), you would see output like:
+
+    $ source x-venv/bin/activate
+    (x-venv) $ python -c "import sys; print(sys.platform)"
+    ios
+    (x-venv) $ python -c "import sys; print(sys.implementation._multiarch)"
+    arm64-iphonesimulator
+
+This should now print the platform identifier for the target platform, not your build platform.
+
+You can also configure xvenv with a `_sysconfigdata` Python file (e.g., `_sysconfigdata__ios_arm64-iphonesimulator.py`), instead of the `_sysconfig_var` JSON file. You'll have to use `_sysconfigdata` if you're on Python 3.13 (as the JSON format was only introduced in Python 3.14)
+
+If you are in the cross environment, and you need to temporarily convert it back to the build platform, you can do so with the `XBUILD_ENV` environment variable. For example, if `x-venv` is an iOS cross environment:
+
+    $ source x-venv/bin/activate
+    (x-venv) $ python -c "import sys; print(sys.platform)"
+    ios
+    (x-venv) $ XBUILD_ENV=off python -c "import sys; print(sys.platform)"
+    darwin
+
+## How this works
+
+The cross build environment does not run the target platform binaries on the build platform - it uses binaries for the build platform, but monkey-patches the Python interpreter at startup so that any question asking details about the platform returns details about the target platform. For example, if you create an iOS cross-platform environment on a macOS machine, you'll be using the macOS `python.exe`; but if you ask for `sys.platform`, the answer will be `ios`, not `darwin`.
+
+## Contributing
+
+To set up a development environment:
+
+    $ python3 -m venv venv
+    $ source venv/bin/activate
+    (venv) $ python -m pip install -U pip
+    (venv) $ python -m pip install -e . --group dev
+
+## Community
+
+`xbuild` is part of the [BeeWare suite](http://beeware.org). You can talk to the community through:
+
+- [@pybeeware on Twitter](https://twitter.com/pybeeware)
+- [Discord](https://beeware.org/bee/chat/)
+
+We foster a welcoming and respectful community as described in our [BeeWare Community Code of Conduct](http://beeware.org/community/behavior/).
+
+## Contributing
+
+If you experience problems with `xbuild`, [log them on GitHub](https://github.com/beeware/xbuild/issues). If you want to contribute code, please [fork the code](https://github.com/beeware/xbuild) and [submit a pull request](https://github.com/beeware/xbuild/pulls).

xbuild-0.0.1/README.md

@@ -0,0 +1,71 @@
+# xbuild
+
+[![Python Versions](https://img.shields.io/pypi/pyversions/xbuild.svg)](https://pypi.python.org/pypi/xbuild)
+[![PyPI Version](https://img.shields.io/pypi/v/xbuild.svg)](https://pypi.python.org/pypi/xbuild)
+[![Maturity](https://img.shields.io/pypi/status/xbuild.svg)](https://pypi.python.org/pypi/xbuild)
+[![BSD License](https://img.shields.io/pypi/l/xbuild.svg)](https://github.com/beeware/xbuild/blob/master/LICENSE)
+[![Discord server](https://img.shields.io/discord/836455665257021440?label=Discord%20Chat&logo=discord&style=plastic)](https://beeware.org/bee/chat/)
+
+`xbuild` is PEP517 build frontend that has additions and extensions to support cross-compiling wheels for platforms where compilation cannot be performed natively - most notably:
+
+* Android
+* Emscripten (WASM)
+* iOS
+
+## Usage
+
+### Creating a cross virtual environment
+
+To create a cross virtual environment, you will need a distribution of Python that has been compiled for Android, Emscripten or iOS. Create a virtual environment for your build platform (i.e., the platform where you will be compiling), then use the `xvenv` script to convert that virtual environment in to a cross environment.
+
+    $ python3 -m venv venv
+    $ source venv/bin/activate
+    (venv) $ pip install xbuild
+    (venv) $ python -m venv x-venv
+    (venv) $ xvenv --sysconfig path/to/_sysconfig_vars__...json x-venv
+
+You can then activate the cross virtual environment. For example, if `x-venv` was constructed using an iOS simulator sysconfig vars file (`_sysconfig_vars__ios_arm64-iphonesimulator.json`), you would see output like:
+
+    $ source x-venv/bin/activate
+    (x-venv) $ python -c "import sys; print(sys.platform)"
+    ios
+    (x-venv) $ python -c "import sys; print(sys.implementation._multiarch)"
+    arm64-iphonesimulator
+
+This should now print the platform identifier for the target platform, not your build platform.
+
+You can also configure xvenv with a `_sysconfigdata` Python file (e.g., `_sysconfigdata__ios_arm64-iphonesimulator.py`), instead of the `_sysconfig_var` JSON file. You'll have to use `_sysconfigdata` if you're on Python 3.13 (as the JSON format was only introduced in Python 3.14)
+
+If you are in the cross environment, and you need to temporarily convert it back to the build platform, you can do so with the `XBUILD_ENV` environment variable. For example, if `x-venv` is an iOS cross environment:
+
+    $ source x-venv/bin/activate
+    (x-venv) $ python -c "import sys; print(sys.platform)"
+    ios
+    (x-venv) $ XBUILD_ENV=off python -c "import sys; print(sys.platform)"
+    darwin
+
+## How this works
+
+The cross build environment does not run the target platform binaries on the build platform - it uses binaries for the build platform, but monkey-patches the Python interpreter at startup so that any question asking details about the platform returns details about the target platform. For example, if you create an iOS cross-platform environment on a macOS machine, you'll be using the macOS `python.exe`; but if you ask for `sys.platform`, the answer will be `ios`, not `darwin`.
+
+## Contributing
+
+To set up a development environment:
+
+    $ python3 -m venv venv
+    $ source venv/bin/activate
+    (venv) $ python -m pip install -U pip
+    (venv) $ python -m pip install -e . --group dev
+
+## Community
+
+`xbuild` is part of the [BeeWare suite](http://beeware.org). You can talk to the community through:
+
+- [@pybeeware on Twitter](https://twitter.com/pybeeware)
+- [Discord](https://beeware.org/bee/chat/)
+
+We foster a welcoming and respectful community as described in our [BeeWare Community Code of Conduct](http://beeware.org/community/behavior/).
+
+## Contributing
+
+If you experience problems with `xbuild`, [log them on GitHub](https://github.com/beeware/xbuild/issues). If you want to contribute code, please [fork the code](https://github.com/beeware/xbuild) and [submit a pull request](https://github.com/beeware/xbuild/pulls).

xbuild-0.0.1/pyproject.toml

@@ -0,0 +1,108 @@
+[build-system]
+requires = [
+    "setuptools==80.9.0",
+    "setuptools_scm==9.2.0",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+dynamic = ["version"]
+name = "xbuild"
+description = "A PEP517 build frontend for cross-compiling wheels."
+readme = "README.md"
+requires-python = ">= 3.13"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+authors = [
+    {name="Russell Keith-Magee", email="russell@keith-magee.com"},
+]
+maintainers = [
+    {name="Russell Keith-Magee", email="russell@keith-magee.com"},
+]
+keywords = [
+    "pep517",
+    "build",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Software Distribution",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "build == 1.3.0",
+]
+
+[project.scripts]
+xbuild = "xbuild.__main__:entrypoint"
+xvenv = "xvenv.__main__:entrypoint"
+
+[project.urls]
+Project = "https://github.com/beeware/xbuild"
+Funding = "https://beeware.org/contributing/membership/"
+Tracker = "https://github.com/beeware/xbuild/issues"
+Source = "https://github.com/beeware/xbuild"
+
+[dependency-groups]
+# Extras used by developers *of* briefcase are pinned to specific versions to
+# ensure environment consistency.
+pre-commit = [
+    "pre-commit == 4.3.0",
+]
+test = [
+    "pytest == 8.4.1",
+]
+ci = [
+    "setuptools_scm == 9.2.0",
+    "tox-uv == 1.28.0",
+]
+dev = [
+    {include-group = "pre-commit"},
+    {include-group = "test"},
+    {include-group = "ci"},
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools_scm]
+# An empty table is needed to enable setuptools_scm
+
+[tool.ruff.lint]
+# In addition to the default rules, these additional rules will be used:
+extend-select = [
+    "E",      # pycodestyle
+    "W",      # pycodestyle
+    "F",      # pyflakes
+    "UP",     # pyupgrade
+    "B",      # flake8-bugbear
+    "YTT",    # flake8-2020
+    "ASYNC",  # flake8-async
+    "C4",     # flake8-comprehensions
+    "I",      # isort
+    # The SIM rules are *very* opinionated, and don't necessarily make for better code.
+    # They may be worth occasionally turning on just to see if something could actually
+    # use improvement.
+    # "SIM",    # flake8-simplify
+]
+
+[tool.ruff.lint.isort]
+known-first-party = [
+    "xbuild",
+    "xvenv",
+]
+known-third-party = [
+    "build",
+]
+
+[tool.check-wheel-contents]
+toplevel = [
+    "xbuild",
+    "xvenv",
+]

xbuild-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xbuild-0.0.1/src/xbuild/__init__.py

@@ -0,0 +1,20 @@
+__all__ = [
+    "__version__",
+]
+
+try:
+    # Read version from SCM metadata
+    # This will only exist in a development environment
+    from setuptools_scm import get_version
+
+    # Excluded from coverage because a pure test environment (such as the one
+    # used by tox in CI) won't have setuptools_scm
+    __version__ = get_version("../..", relative_to=__file__)  # pragma: no cover
+except (ModuleNotFoundError, LookupError):  # pragma: no-cover-if-missing-setuptools_scm
+    # If setuptools_scm isn't in the environment, the call to import will fail.
+    # If it *is* in the environment, but the code isn't a git checkout (e.g.,
+    # it's been pip installed non-editable) the call to get_version() will fail.
+    # If either of these occurs, read version from the installer metadata.
+    from importlib.metadata import version
+
+    __version__ = version("xbuild")