https://github.com/ziglang/zig-pypi
The Zig programming language, packaged for PyPI
https://github.com/ziglang/zig-pypi
pypi python zig
Last synced: about 1 month ago
JSON representation
The Zig programming language, packaged for PyPI
- Host: GitHub
- URL: https://github.com/ziglang/zig-pypi
- Owner: ziglang
- License: mit
- Created: 2021-07-12T16:16:50.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-06T02:18:13.000Z (2 months ago)
- Last Synced: 2025-03-31T22:14:57.161Z (about 1 month ago)
- Topics: pypi, python, zig
- Language: Python
- Homepage: https://pypi.org/project/ziglang/
- Size: 24.4 KB
- Stars: 167
- Watchers: 9
- Forks: 18
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-zig - zig-pypi🗒️The Zig programming language, packaged for PyPI
README
Zig PyPI distribution
=====================
This repository contains the script used to repackage the [releases][zigdl] of the [Zig programming language][zig] as [Python binary wheels][wheel]. This document is intended for maintainers; see the [package README][pkgreadme] for rationale and usage instructions.
The repackaged artifacts are published as the [ziglang PyPI package][pypi].
[zig]: https://ziglang.org/
[zigdl]: https://ziglang.org/download/
[wheel]: https://github.com/pypa/wheel
[pkgreadme]: README.pypi.md
[pypi]: https://pypi.org/project/ziglang/
Preparation
-----------
The script requires Python 3.9 and later and a [PEP 723][pep723] compatible script
runner, such as [`pipx`][pipx], [`pdm`][pdm], [`hatch`][hatch], [`uv`][uv], or
similar. Please refer to their ocumentation for installation instructions.
[pep723]: https://peps.python.org/pep-0723/
[pipx]: https://pipx.pypa.io/stable/examples/#pipx-run-examples
[pdm]: https://pdm-project.org/en/latest/usage/scripts/#single-file-scripts
[hatch]: https://hatch.pypa.io/latest/blog/2024/05/02/hatch-v1100/#python-script-runner/
[uv]: https://docs.astral.sh/uv/#script-support/
Building wheels
---------------
Run the repackaging script. Here's an example invocation with [`pdm`][pdm]:
```shell
$ pdm run make_wheels.py --help
usage: make_wheels.py [-h] [--version VERSION] [--suffix SUFFIX] [--outdir OUTDIR]
[--platform {x86_64-windows,x86_64-macos,aarch64-macos,i386-linux,x86-linux,x86_64-linux,aarch64-linux,armv7a-linux}]
Repackage official Zig downloads as Python wheels
options:
-h, --help show this help message and exit
--version VERSION version to package, use `latest` for latest release, `master` for nightly build
--suffix SUFFIX wheel version suffix
--outdir OUTDIR target directory
--platform {x86_64-windows,x86_64-macos,aarch64-macos,i386-linux,x86-linux,x86_64-linux,aarch64-linux,armv7a-linux}
platform to build for, can be repeated
```
This command will download the Zig release archives for every supported platform and convert them to binary wheels, which are placed under `dist/`. The Zig version and platforms can be passed as arguments.
The process of converting release archives to binary wheels is deterministic, and the output of the script should be bit-for-bit identical regardless of the environment and platform it runs under. To this end, it prints the SHA256 hashes of inputs and outputs; the hashes of the inputs will match the ones on the [Zig downloads page][zigdl], and the hashes of the outputs will match the ones on the [PyPI downloads page][pypidl].
[pypidl]: https://pypi.org/project/ziglang/#files
Uploading wheels
----------------
Run the publishing utility:
```shell
pdm run twine dist/*
```
This command will upload the binary wheels built in the previous step to PyPI.
License
-------
This script is distributed under the terms of the [MIT (Expat) license](LICENSE.txt).
Please refer to the [Zig license](https://ziglang.org/download/#license) for the terms
of use of the Zig programming language itself, or look in the `.dist-info/licenses/`
directory of the built wheels for individual licenses of the bundled components.