pyship 0.1.6__py3-none-any.whl → 0.3.1__py3-none-any.whl

pyship/uv_util.py

@@ -0,0 +1,157 @@
+import platform
+import shutil
+import subprocess
+import zipfile
+from pathlib import Path
+
+from typeguard import typechecked
+from balsa import get_logger
+
+from pyship import __application_name__, pyship_print
+
+log = get_logger(__application_name__)
+
+UV_GITHUB_RELEASE_URL = "https://github.com/astral-sh/uv/releases/latest/download"
+
+
+@typechecked
+def find_or_bootstrap_uv(cache_dir: Path) -> Path:
+    """
+    Find uv on PATH, in cache, or download the standalone binary.
+    :param cache_dir: directory to cache the uv binary
+    :return: path to the uv executable
+    """
+    # check PATH first
+    uv_on_path = shutil.which("uv")
+    if uv_on_path is not None:
+        uv_path = Path(uv_on_path)
+        log.info(f"found uv on PATH: {uv_path}")
+        return uv_path
+
+    # check cache
+    uv_cache_dir = Path(cache_dir, "uv")
+    uv_exe = Path(uv_cache_dir, "uv.exe")
+    if uv_exe.exists():
+        log.info(f"found cached uv: {uv_exe}")
+        return uv_exe
+
+    # download uv standalone binary
+    pyship_print("downloading uv...")
+    uv_cache_dir.mkdir(parents=True, exist_ok=True)
+
+    machine = platform.machine().lower()
+    if machine in ("amd64", "x86_64"):
+        arch = "x86_64"
+    elif machine in ("arm64", "aarch64"):
+        arch = "aarch64"
+    else:
+        arch = machine
+
+    zip_name = f"uv-{arch}-pc-windows-msvc.zip"
+    zip_url = f"{UV_GITHUB_RELEASE_URL}/{zip_name}"
+    zip_path = Path(uv_cache_dir, zip_name)
+
+    import requests
+
+    response = requests.get(zip_url, stream=True)
+    response.raise_for_status()
+    with open(zip_path, "wb") as f:
+        shutil.copyfileobj(response.raw, f)
+
+    with zipfile.ZipFile(zip_path) as zf:
+        zf.extractall(uv_cache_dir)
+
+    # the zip extracts into a subdirectory; find uv.exe
+    if not uv_exe.exists():
+        for candidate in uv_cache_dir.rglob("uv.exe"):
+            shutil.move(str(candidate), str(uv_exe))
+            break
+
+    if not uv_exe.exists():
+        raise FileNotFoundError(f"could not find uv.exe after extracting {zip_path}")
+
+    log.info(f"downloaded uv to {uv_exe}")
+    return uv_exe
+
+
+@typechecked
+def uv_python_install(uv_path: Path, python_version: str) -> Path:
+    """
+    Install a Python version via uv and return its path.
+    :param uv_path: path to uv executable
+    :param python_version: Python version string (e.g. "3.12.4")
+    :return: path to the installed Python interpreter
+    """
+    pyship_print(f"installing Python {python_version} via uv...")
+    subprocess.run([str(uv_path), "python", "install", python_version], check=True, capture_output=True, text=True)
+
+    result = subprocess.run([str(uv_path), "python", "find", python_version], check=True, capture_output=True, text=True)
+    python_path = Path(result.stdout.strip())
+    log.info(f"uv python find {python_version} -> {python_path}")
+    return python_path
+
+
+@typechecked
+def uv_venv_create(uv_path: Path, venv_dir: Path, python_version: str) -> None:
+    """
+    Create a relocatable venv using uv.
+    :param uv_path: path to uv executable
+    :param venv_dir: destination directory for the venv
+    :param python_version: Python version string
+    """
+    pyship_print(f"creating relocatable venv at {venv_dir}...")
+    cmd = [str(uv_path), "venv", "--relocatable", "--python", python_version, str(venv_dir)]
+    log.info(f"uv venv cmd: {cmd}")
+    subprocess.run(cmd, check=True, capture_output=True, text=True)
+
+
+@typechecked
+def uv_pip_install(uv_path: Path, target_python: Path, packages: list, find_links: list, upgrade: bool = True) -> None:
+    """
+    Install packages into a venv using uv pip.
+    :param uv_path: path to uv executable
+    :param target_python: path to the Python interpreter in the target venv
+    :param packages: list of package names or paths to install
+    :param find_links: list of directories for --find-links
+    :param upgrade: whether to pass -U flag
+    """
+    cmd = [str(uv_path), "pip", "install", "--python", str(target_python)]
+    if upgrade:
+        cmd.append("-U")
+    cmd.extend(packages)
+    for link in find_links:
+        link_path = Path(link)
+        if link_path.exists():
+            cmd.extend(["-f", str(link_path)])
+    log.info(f"uv pip install cmd: {cmd}")
+    result = subprocess.run(cmd, capture_output=True, text=True)
+    log.info(result.stdout)
+    if result.stderr:
+        log.info(result.stderr)
+    if result.returncode != 0:
+        log.error(f"uv pip install failed (exit {result.returncode}): {result.stderr}")
+        result.check_returncode()
+
+
+@typechecked
+def uv_build(uv_path: Path, project_dir: Path, output_dir: Path) -> Path:
+    """
+    Build a wheel using uv build.
+    :param uv_path: path to uv executable
+    :param project_dir: project directory containing pyproject.toml
+    :param output_dir: directory for the built wheel
+    :return: path to the built wheel
+    """
+    pyship_print(f"building wheel via uv in {project_dir}...")
+    output_dir.mkdir(parents=True, exist_ok=True)
+    cmd = [str(uv_path), "build", "--wheel", "--out-dir", str(output_dir)]
+    log.info(f"uv build cmd: {cmd}")
+    result = subprocess.run(cmd, cwd=str(project_dir), check=True, capture_output=True, text=True)
+    log.info(result.stdout)
+
+    # find the wheel that was just built
+    wheels = list(output_dir.glob("*.whl"))
+    if len(wheels) == 0:
+        raise FileNotFoundError(f"no wheel found in {output_dir} after uv build")
+    # return the most recently modified wheel
+    return sorted(wheels, key=lambda p: p.stat().st_mtime)[-1]

pyship-0.3.1.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: pyship
+Version: 0.3.1
+Summary: freezer, installer and updater for Python applications
+Home-page: https://github.com/jamesabel/pyship
+Download-URL: https://github.com/jamesabel/pyship
+Author: abel
+Author-email: j@abel.co
+License: MIT License
+Keywords: freezer,installer,ship
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools
+Requires-Dist: wheel
+Requires-Dist: ismain
+Requires-Dist: balsa
+Requires-Dist: requests
+Requires-Dist: attrs
+Requires-Dist: typeguard
+Requires-Dist: toml
+Requires-Dist: semver
+Requires-Dist: python-dateutil
+Requires-Dist: wheel-inspect
+Requires-Dist: boto3
+Requires-Dist: awsimple
+Requires-Dist: platformdirs
+Requires-Dist: pyshipupdate
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+
+# PyShip
+
+[![CI](https://github.com/jamesabel/pyship/actions/workflows/ci.yml/badge.svg)](https://github.com/jamesabel/pyship/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/jamesabel/pyship/branch/main/graph/badge.svg)](https://codecov.io/gh/jamesabel/pyship)
+
+Enables shipping a python application to end users.
+
+## PyShip's Major Features
+
+* Freeze practically any Python application
+* Creates an installer
+* Uploads application installer and updates to the cloud
+* Automatic application updating in the background (no user intervention)
+* OS native application (e.g. .exe for Windows)
+* Run on OS startup option
+
+## Documentation and Examples
+
+[Learn PyShip By Example](https://github.com/jamesabel/pyshipexample)
+
+[Short video on pyship given at Pyninsula](https://abelpublic.s3.us-west-2.amazonaws.com/pyship_pyninsula_10_2020.mkv)
+
+## Testing
+
+Run tests with:
+
+```batch
+venv\Scripts\python.exe -m pytest test_pyship/ -v
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `AWSIMPLE_USE_MOTO_MOCK` | Set to `0` to use real AWS instead of [moto](https://github.com/getmoto/moto) mock. Required for `test_f_update` which tests cross-process S3 updates. Requires valid AWS credentials configured. | `1` (use moto) |
+| `MAKE_NSIS_PATH` | Path to the NSIS `makensis.exe` executable. | `C:\Program Files (x86)\NSIS\makensis.exe` |
+
+### Test Modes
+
+- **Default (moto mock)**: All tests run with mocked AWS S3. No credentials needed. `test_f_update` is skipped.
+- **Real AWS** (`AWSIMPLE_USE_MOTO_MOCK=0`): All tests run against real AWS S3. `test_f_update` runs and tests cross-process updates.

pyship-0.3.1.dist-info/RECORD

@@ -0,0 +1,34 @@
+pyship/__init__.py,sha256=5lL2td91Xm31z8x4XcTZW591rO3hvFzXpAtTiKdt064,1438
+pyship/__main__.py,sha256=KtAdk7BCWhXbhywlFB8P4HbvypVkqJXbxgMW3XVD-To,84
+pyship/_version_.py,sha256=oP5tZarLvBvusPvGrBXb6FMKD55dVUQDZ9LYYFZi4A0,389
+pyship/app_info.py,sha256=kxWMOhksgPijODj76LUkHuxKzPeHNWMN2Dv4D9PfAp4,6383
+pyship/arguments.py,sha256=p4cA8FwbNSZqg4XI6LsYit1QN7TpAWWZH2xrgLf-f-g,1882
+pyship/clip.py,sha256=N6es31zy0l3kakf1Enxt2fqkcMQoaUSXMlcCqhHJdWI,3700
+pyship/cloud.py,sha256=k8m-254Akpp3NALeP0pJzFs21_2qZmmK0GHfSC-Z0sw,1282
+pyship/constants.py,sha256=Y-yA_MMwL572UbZqmhILrJL6NH9xK3q5jELJR6atw7I,243
+pyship/create_launcher.py,sha256=HxfOFC9zJf5yhTm9XtCaR49Jn9-SNkpzWgHSLyhnu6k,3794
+pyship/download.py,sha256=QHbdVwxLNBToMEC0tOF2ZquDpoydRu0-cj7LOERr5Q4,2460
+pyship/launcher_stub.py,sha256=iezFuelAps8_tmjMZdb7G6MkccWp9a2wFqtIxgLRICk,6677
+pyship/logging.py,sha256=cIB7487tN8TsKeDHwwzjA30rHRW5Ci5GA5uPbaEXaY0,966
+pyship/main.py,sha256=pALpy8ooWsKkUpWUtGWO567I9u1fbIFWdBU0dnWm2K4,866
+pyship/nsis.py,sha256=xPW1f10CEKfDgvu4jd7e-tJqUfgm3AbAPC1E5rmLzO4,13066
+pyship/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyship/pyship.ico,sha256=9oiMtmA7NiBmxM0NmMJQU5jXmnbEWCdqTaO3XvJ7ozY,103500
+pyship/pyship.py,sha256=3kmYP_UNF4oexNlvLqTrVqE3s0-5rAgHsETaQp69LV0,5682
+pyship/pyship_custom_print.py,sha256=FrVy3XCZg8sex4a-aKtghqz1BlfO2DGgcpsdviQcssw,628
+pyship/pyship_exceptions.py,sha256=teUOh3FuRUU9hyv7L4owACQZPWNdwpYTEz6l-Ao35nw,959
+pyship/pyship_get_icon.py,sha256=BQp_xYl8CXt2e7nDB0llSxr0hbP7to2fkQqPeu8WpIg,2050
+pyship/pyship_path.py,sha256=RpU2n7pWXTr0501S7U8KxWCpBc8jOqKPuaX0X6IWPI8,262
+pyship/pyship_subprocess.py,sha256=hH4MW_j2zLJLDmLDkkl2JWupXrvSemAeCPAEtPdSGyk,3212
+pyship/uv_util.py,sha256=dcPtE0XYeQ3KFLMGA0qr_FhuTi1hprlWddFBa5hssNM,5662
+pyship/launcher/__init__.py,sha256=OujoBeud36d3e8V6QzCWe5A-ilkaMeC5AmnoE72u62U,256
+pyship/launcher/__main__.py,sha256=KhFSf1RU5Cj15y0c4FlzvIvDpWWi9NKYy0gzJ-w7KQE,115
+pyship/launcher/hash.py,sha256=THEh8G-StEJeh5tH24RnAQpYB0Zv1nnBwqOoStN6_NY,1153
+pyship/launcher/launcher_standalone.py,sha256=1HIXieq17IQFuldBAkmo7tjpsjADQVw7R8zXXQpEMXs,10654
+pyship/launcher/metadata.py,sha256=PnOkYLQf6NYvPiZWhf0LAUjmFWzURKWriRQJSy3T-x4,1969
+pyship/launcher/restart_monitor.py,sha256=jfzchLxGuC_xUNdPAr849FhAdozJ6BX9M-gqLd-gGIA,952
+pyship-0.3.1.dist-info/licenses/LICENSE,sha256=wJpPh6rC_YhbTZ7ZIy1VjrqeLdJ8Pz0ppx2MUi7s8Dg,1088
+pyship-0.3.1.dist-info/METADATA,sha256=9q0ykIxrTYTZevR0Q1pNkEvnqIErD8wSmXh6-Uk0Rwc,2703
+pyship-0.3.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pyship-0.3.1.dist-info/top_level.txt,sha256=mlozeft-UInVAceSajzNvtkn2vPa8El9j0RulsTVtlU,7
+pyship-0.3.1.dist-info/RECORD,,

{pyship-0.1.6.dist-info → pyship-0.3.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.40.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pyship/atomic_zip.py

@@ -1,41 +0,0 @@
-from pathlib import Path
-from tempfile import mkdtemp
-import zipfile
-import os
-
-from typeguard import typechecked
-from balsa import get_logger
-
-from pyshipupdate import mkdirs, rmdir
-from pyship import __application_name__
-
-log = get_logger(__application_name__)
-
-
-@typechecked
-def atomic_unzip(zip_file_path: Path, destination_dir: Path) -> bool:
-    """
-    Unzip a zip file to a directory in a safe, atomic way.  This avoids the issue where if an unzip fails in the middle it can potentially leave a directory with partially unzipped contents.
-    In other words, atomic_unzip is all or nothing.
-    :param zip_file_path: path to zip file to unzip
-    :param destination_dir: destination dir for unzipped contents
-    :return: True on success, False on failure
-    """
-
-    log.info(f'unzipping "{zip_file_path}" to "{destination_dir}"')
-    success_flag = False
-    temp_dir = mkdtemp(dir=destination_dir.parent)
-    try:
-        mkdirs(temp_dir, True)
-
-        zip_ref = zipfile.ZipFile(zip_file_path, "r")
-        zip_ref.extractall(temp_dir)
-        zip_ref.close()
-
-        rmdir(destination_dir)  # in case dest already exists
-        os.rename(temp_dir, str(destination_dir))
-        success_flag = True
-    except IOError as e:
-        log.info(f"{zip_file_path=} {destination_dir=} {e}")
-
-    return success_flag