Add a python-zig entry point, for use with uv etc.

Author: torshepherd

README.pypi.md

@@ -31,6 +31,21 @@ import sys, subprocess
 subprocess.call([sys.executable, "-m", "ziglang"])
 ```
 
+Binary wrapper
+--------------
+
+The [ziglang][pypi] Python package installs a binary wrapper for the Zig compiler under the name `python-zig`; the name is different to avoid conflicts with any system-wide or user-wide `zig` binaries that may be already installed.
+
+
+Using with `uv`
+---------------
+
+The Zig compiler distributed in this Python package can be launched by [uv](https://docs.astral.sh/uv) without installation:
+
+```shell
+uvx --from ziglang python-zig
+```
+
 License
 -------
 

make_wheels.py

@@ -89,6 +89,9 @@ def write_wheel(out_dir, *, name, version, tag, metadata, description, contents)
 
     return write_wheel_file(os.path.join(out_dir, wheel_name), {
         **contents,
+        f'{dist_info}/entry_points.txt': make_message([],
+            '[console_scripts]\npython-zig = ziglang.__main__:dummy'
+        ),
         f'{dist_info}/METADATA': make_message([
             ('Metadata-Version', '2.4'),
             ('Name', name),
@@ -201,6 +204,8 @@ def write_ziglang_wheel(out_dir, *, version, platform, archive):
     os.execv(argv[0], argv)
 else:
     import subprocess; sys.exit(subprocess.call(argv))
+
+def dummy(): """Dummy function for an entrypoint. Zig is executed as a side effect of the import."""
 '''.encode('ascii')
 
     # 1. Check for missing required licenses paths