add test_uvx_zipapps for uvx usage

Author: ClericPy

README.md

@@ -77,12 +77,34 @@ So, what could `zipapps` be?
 
 ## 4. Activate the `.pyz` environment
 
-1. use `zipimport` (Recommended)
+1. use `importlib` (Recommended)
    1. `sys.path.insert(0, "some_lib_venv.pyz");importlib.import_module("ensure_zipapps")`
    2. automatically unzip cache, and add the path to sys.path
       1. it can be run multiple times
 2. if they are all pure-python code and **no need to decompress**
    1. `impory sys; sys.path.insert(0, "bottle.pyz")`
+3. use `zipimport`
+
+```python
+# 1. use zipapps lib
+from zipapps.activate_zipapps import activate
+activate("app.pyz")
+
+# or use source code directly
+from zipimport import zipimporter
+
+importer = zipimporter("app.pyz")
+try:
+    spec = importer.find_spec("ensure_zipapps")
+    if spec and spec.loader:
+        module = spec.loader.load_module("ensure_zipapps")
+    else:
+        raise ImportError("Module not found")
+except AttributeError:
+    module = importer.load_module("ensure_zipapps")
+del module
+sys.modules.pop("ensure_zipapps", None)
+```
 
 
 # Command line usage

changelog.md

@@ -14,6 +14,9 @@
     - `--uv=uv` or `--uv=path/to/uv`
   - Added `--freeze-deps` as an alias for `--freeze-reqs`
   - fix deprecated warning since 3.10 `zipimporter.load_module`
+  - add `uvx` use case to test_utils.py
+    - `uvx zipapps six`
+    - `python -m zipapps six --uv=uv`
 - 2024.08.07
   - [**Compatible WARNING**]: update `sys_paths` insert index from `-1` to `0`
   - disable `--download-python`, use `python -m zipapps.download_python` instead

test_utils.py

@@ -4,7 +4,6 @@
 import shutil
 import subprocess
 import sys
-import zipimport
 from getpass import getuser
 from pathlib import Path
 from tempfile import gettempdir
@@ -751,6 +750,7 @@ def test_pip_install_target():
 
 def test_uv_path():
     # `pip install uv` before testing
+    _clean_paths(root=False)
     output = subprocess.check_output(
         [sys.executable, "-m", "zipapps", "six", "--uv", "uv"], stderr=subprocess.STDOUT
     )
@@ -763,6 +763,34 @@ def test_uv_path():
     assert b"Collecting six" in output, output.decode("utf-8", "replace")
 
 
+def test_uvx_zipapps():
+    # `pip install uv` before testing
+    _clean_paths(root=False)
+    if shutil.which("uvx") is None:
+        raise RuntimeError("uvx not found, please install uvx first")
+    subprocess.Popen(["uvx", "--with", "..", "zipapps", "-o", "app.pyz", "six"]).wait()
+    proc = subprocess.Popen(
+        [sys.executable, "app.pyz", "-c", "import six;print(six.__file__)"],
+        stderr=subprocess.STDOUT,
+        stdout=subprocess.PIPE,
+    )
+    output = proc.communicate()[0]
+    assert b"app.pyz" in output, output.decode("utf-8", "replace")
+    _clean_paths(root=False)
+    if shutil.which("uvx") is None:
+        raise RuntimeError("uvx not found, please install uvx first")
+    subprocess.Popen(
+        ["uvx", "--with", "..", "zipapps", "-o", "app.pyz", "--uv", "uv", "six"]
+    ).wait()
+    proc = subprocess.Popen(
+        [sys.executable, "app.pyz", "-c", "import six;print(six.__file__)"],
+        stderr=subprocess.STDOUT,
+        stdout=subprocess.PIPE,
+    )
+    output = proc.communicate()[0]
+    assert b"app.pyz" in output, output.decode("utf-8", "replace")
+
+
 def main():
     """
     test all cases