pyenv-native 0.1.10__tar.gz

pyenv_native-0.1.10/.gitignore

@@ -0,0 +1,38 @@
+/target/
+/dist/
+/python-package/dist/
+/packaging/winget/manifests/
+/packaging/homebrew/Formula/
+/python-package/src/**/*.pyc
+/python-package/tests/**/*.pyc
+**/__pycache__/
+/.tmp*/
+/test-install/
+
+# Compiled binaries and debug symbols
+*.exe
+*.pdb
+
+# AI Memory
+MEMORY.md
+.gemini/
+
+# IDEs
+.vscode/
+.idea/
+
+# Rust
+Cargo.lock
+
+# OS Junk
+.DS_Store
+Thumbs.db
+
+# Local publish script (operator-only, not for distribution)
+/scripts/publish.ps1
+
+# Reproduction and scratch scripts
+/repro_*.rs
+/temp_*.rs
+/clippy_errors.txt
+/walkthrough.md

pyenv_native-0.1.10/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roy Dawson IV
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyenv_native-0.1.10/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: pyenv-native
+Version: 0.1.10
+Summary: Python install package for the native-first pyenv-native runtime bundles.
+Project-URL: Homepage, https://github.com/imyourboyroy
+Project-URL: Repository, https://github.com/imyourboyroy/pyenv-native
+Project-URL: Issues, https://github.com/imyourboyroy/pyenv-native/issues
+Author-email: Roy Dawson IV <Roy.Dawson.IV@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: bootstrap,pipx,pyenv,python,windows
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: System :: Installation/Setup
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# pyenv-native
+
+![PyPI Channel](https://img.shields.io/badge/channel-PyPI%20%2F%20pipx-3775A9?style=for-the-badge&logo=pypi&logoColor=white)
+![Runtime](https://img.shields.io/badge/runtime-install%20package%20for%20native%20bundles-2563eb?style=for-the-badge)
+![License](https://img.shields.io/badge/license-MIT-15803D?style=for-the-badge)
+
+`pyenv-native` on PyPI is the Python convenience package for installing the native `pyenv-native` release bundles.
+
+Those bundles install both:
+- `pyenv`
+- `pyenv-mcp`
+
+It exists for users who:
+- already have Python installed,
+- want a `pip` or `pipx` entrypoint,
+- still want the real runtime to remain native.
+
+## Important principle
+
+> This package installs `pyenv-native`.
+> It does **not** replace `pyenv-native` with a Python implementation.
+
+## Release selection behavior
+
+By default, the package targets the **latest published GitHub release**.
+
+## What it does
+
+- downloads native release bundles,
+- verifies checksums,
+- reads bundle metadata,
+- extracts the bundle,
+- runs the bundled installer,
+- installs the companion `pyenv-mcp` server when the bundle provides it,
+- supports GitHub Release-based installs,
+- works with Windows ZIP bundles and Linux/macOS `.tar.gz` bundles.
+
+## Quick start
+
+### `pipx` latest release
+
+```powershell
+pipx install pyenv-native
+pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv
+```
+
+### `pip` latest release
+
+```powershell
+python -m pip install pyenv-native
+pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv
+```
+
+### POSIX latest release
+
+```sh
+python -m pip install pyenv-native
+pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~/.pyenv
+```
+
+## Commands
+
+```text
+pyenv-native verify <bundle-archive> [--checksum-path <bundle.sha256>]
+pyenv-native download [--bundle-url <url> | --release-base-url <url> | --github-repo <owner/repo>] [--tag <tag>]
+pyenv-native install [--bundle-path <bundle-archive> | --release-base-url <url> | --github-repo <owner/repo>] [--tag <tag>] [--install-root <dir>]
+```
+
+## Examples
+
+Verify a local bundle:
+
+```powershell
+pyenv-native verify .\dist\pyenv-native-windows-x64.zip --checksum-path .\dist\pyenv-native-windows-x64.zip.sha256
+```
+
+Install from a local bundle:
+
+```powershell
+pyenv-native install --bundle-path .\dist\pyenv-native-windows-x64.zip --checksum-path .\dist\pyenv-native-windows-x64.zip.sha256 --install-root ~\.pyenv
+```
+
+Install from the latest GitHub release:
+
+```powershell
+pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv
+```
+
+Install a POSIX bundle:
+
+```sh
+pyenv-native install --bundle-path ./dist/pyenv-native-linux-x64.tar.gz --checksum-path ./dist/pyenv-native-linux-x64.tar.gz.sha256 --install-root ~/.pyenv --shell bash
+```
+
+## Relationship to the main project
+
+For the full project overview, install scripts, release-bundle flow, and command reference, see the main repository README:
+
+- <https://github.com/imyourboyroy/pyenv-native>

pyenv_native-0.1.10/README.md

@@ -0,0 +1,99 @@
+# pyenv-native
+
+![PyPI Channel](https://img.shields.io/badge/channel-PyPI%20%2F%20pipx-3775A9?style=for-the-badge&logo=pypi&logoColor=white)
+![Runtime](https://img.shields.io/badge/runtime-install%20package%20for%20native%20bundles-2563eb?style=for-the-badge)
+![License](https://img.shields.io/badge/license-MIT-15803D?style=for-the-badge)
+
+`pyenv-native` on PyPI is the Python convenience package for installing the native `pyenv-native` release bundles.
+
+Those bundles install both:
+- `pyenv`
+- `pyenv-mcp`
+
+It exists for users who:
+- already have Python installed,
+- want a `pip` or `pipx` entrypoint,
+- still want the real runtime to remain native.
+
+## Important principle
+
+> This package installs `pyenv-native`.
+> It does **not** replace `pyenv-native` with a Python implementation.
+
+## Release selection behavior
+
+By default, the package targets the **latest published GitHub release**.
+
+## What it does
+
+- downloads native release bundles,
+- verifies checksums,
+- reads bundle metadata,
+- extracts the bundle,
+- runs the bundled installer,
+- installs the companion `pyenv-mcp` server when the bundle provides it,
+- supports GitHub Release-based installs,
+- works with Windows ZIP bundles and Linux/macOS `.tar.gz` bundles.
+
+## Quick start
+
+### `pipx` latest release
+
+```powershell
+pipx install pyenv-native
+pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv
+```
+
+### `pip` latest release
+
+```powershell
+python -m pip install pyenv-native
+pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv
+```
+
+### POSIX latest release
+
+```sh
+python -m pip install pyenv-native
+pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~/.pyenv
+```
+
+## Commands
+
+```text
+pyenv-native verify <bundle-archive> [--checksum-path <bundle.sha256>]
+pyenv-native download [--bundle-url <url> | --release-base-url <url> | --github-repo <owner/repo>] [--tag <tag>]
+pyenv-native install [--bundle-path <bundle-archive> | --release-base-url <url> | --github-repo <owner/repo>] [--tag <tag>] [--install-root <dir>]
+```
+
+## Examples
+
+Verify a local bundle:
+
+```powershell
+pyenv-native verify .\dist\pyenv-native-windows-x64.zip --checksum-path .\dist\pyenv-native-windows-x64.zip.sha256
+```
+
+Install from a local bundle:
+
+```powershell
+pyenv-native install --bundle-path .\dist\pyenv-native-windows-x64.zip --checksum-path .\dist\pyenv-native-windows-x64.zip.sha256 --install-root ~\.pyenv
+```
+
+Install from the latest GitHub release:
+
+```powershell
+pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv
+```
+
+Install a POSIX bundle:
+
+```sh
+pyenv-native install --bundle-path ./dist/pyenv-native-linux-x64.tar.gz --checksum-path ./dist/pyenv-native-linux-x64.tar.gz.sha256 --install-root ~/.pyenv --shell bash
+```
+
+## Relationship to the main project
+
+For the full project overview, install scripts, release-bundle flow, and command reference, see the main repository README:
+
+- <https://github.com/imyourboyroy/pyenv-native>

pyenv_native-0.1.10/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pyenv-native"
+version = "0.1.10"
+description = "Python install package for the native-first pyenv-native runtime bundles."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+  { name = "Roy Dawson IV", email = "Roy.Dawson.IV@gmail.com" },
+]
+keywords = ["pyenv", "python", "windows", "bootstrap", "pipx"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development",
+  "Topic :: System :: Installation/Setup",
+]
+
+[project.urls]
+Homepage = "https://github.com/imyourboyroy"
+Repository = "https://github.com/imyourboyroy/pyenv-native"
+Issues = "https://github.com/imyourboyroy/pyenv-native/issues"
+
+[project.scripts]
+pyenv-native = "pyenv_native_bootstrap.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pyenv_native_bootstrap"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/pyenv_native_bootstrap",
+  "tests",
+  "LICENSE",
+  "README.md",
+  "pyproject.toml",
+]
+
+
+

pyenv_native-0.1.10/src/pyenv_native_bootstrap/__init__.py

@@ -0,0 +1,6 @@
+# ./python-package/src/pyenv_native_bootstrap/__init__.py
+"""Package metadata for the pyenv-native bootstrap helper."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.10"

pyenv_native-0.1.10/src/pyenv_native_bootstrap/__main__.py

@@ -0,0 +1,8 @@
+# ./python-package/src/pyenv_native_bootstrap/__main__.py
+"""Module runner for `python -m pyenv_native_bootstrap`."""
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pyenv_native-0.1.10/src/pyenv_native_bootstrap/bundle.py

@@ -0,0 +1,163 @@
+# ./python-package/src/pyenv_native_bootstrap/bundle.py
+"""Bundle metadata, checksum, and download helpers for pyenv-native release assets."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import tarfile
+import urllib.request
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Optional
+from zipfile import ZipFile
+
+from . import __version__
+
+
+@dataclass(frozen=True)
+class BundleManifest:
+    """Describes a built release bundle and the scripts it carries."""
+
+    bundle_name: str
+    bundle_version: str
+    platform: str
+    architecture: str
+    executable: str
+    install_script: str
+    uninstall_script: str
+
+
+def sha256_file(path: Path) -> str:
+    """Return the SHA-256 digest for a file."""
+
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for chunk in iter(lambda: handle.read(1024 * 1024), b""):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def parse_checksum_text(text: str, expected_file_name: Optional[str] = None) -> str:
+    """Extract a SHA-256 value from a checksum file or raw string."""
+
+    lines = [line.strip() for line in text.splitlines() if line.strip()]
+    if not lines:
+        raise ValueError("checksum text did not contain any usable lines")
+
+    for line in lines:
+        parts = line.split()
+        if len(parts) == 1 and len(parts[0]) == 64:
+            return parts[0].lower()
+        if len(parts) >= 2 and len(parts[0]) == 64:
+            candidate_name = parts[-1].lstrip("*")
+            if expected_file_name is None or candidate_name == expected_file_name:
+                return parts[0].lower()
+
+    raise ValueError("checksum text did not contain a valid SHA-256 entry")
+
+
+def is_tar_bundle(bundle_path: Path) -> bool:
+    """Return true when a bundle path uses a tar-based archive format."""
+
+    suffixes = [suffix.lower() for suffix in bundle_path.suffixes]
+    return suffixes[-2:] == [".tar", ".gz"] or bundle_path.suffix.lower() == ".tgz"
+
+
+def read_manifest_from_bundle(bundle_path: Path) -> BundleManifest:
+    """Read and parse the bundle manifest embedded inside a release archive."""
+
+    if is_tar_bundle(bundle_path):
+        with tarfile.open(bundle_path, "r:*") as archive:
+            member = next(
+                (
+                    candidate
+                    for candidate in archive.getmembers()
+                    if Path(candidate.name).name == "bundle-manifest.json"
+                ),
+                None,
+            )
+            if member is None:
+                raise FileNotFoundError("bundle-manifest.json was not found in the bundle archive")
+            handle = archive.extractfile(member)
+            if handle is None:
+                raise FileNotFoundError("bundle-manifest.json could not be extracted")
+            payload = json.loads(handle.read().decode("utf-8-sig"))
+    else:
+        with ZipFile(bundle_path, "r") as archive:
+            with archive.open("bundle-manifest.json", "r") as handle:
+                payload = json.loads(handle.read().decode("utf-8-sig"))
+
+    return BundleManifest(
+        bundle_name=payload["bundle_name"],
+        bundle_version=payload["bundle_version"],
+        platform=payload["platform"],
+        architecture=payload["architecture"],
+        executable=payload["executable"],
+        install_script=payload["install_script"],
+        uninstall_script=payload["uninstall_script"],
+    )
+
+
+def read_manifest_from_zip(bundle_path: Path) -> BundleManifest:
+    """Backward-compatible wrapper for zip-based bundle manifest reads."""
+
+    return read_manifest_from_bundle(bundle_path)
+
+
+def download_file(url: str, destination: Path) -> Path:
+    """Download a file to a destination path, replacing any prior file."""
+
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    request = urllib.request.Request(
+        url,
+        headers={"User-Agent": f"pyenv-native/{__version__}"},
+    )
+    with urllib.request.urlopen(request) as response, destination.open("wb") as handle:  # noqa: S310
+        handle.write(response.read())
+    return destination
+
+
+def load_checksum_text(
+    checksum: Optional[str],
+    checksum_path: Optional[Path],
+    checksum_url: Optional[str],
+    cache_path: Path,
+) -> Optional[str]:
+    """Load checksum content from an inline value, local file, or remote URL."""
+
+    if checksum:
+        return checksum.strip()
+    if checksum_path:
+        return checksum_path.read_text(encoding="utf-8")
+    if checksum_url:
+        checksum_target = cache_path.with_suffix(cache_path.suffix + ".sha256")
+        download_file(checksum_url, checksum_target)
+        return checksum_target.read_text(encoding="utf-8")
+    return None
+
+
+def verify_bundle_checksum(
+    bundle_path: Path,
+    checksum: Optional[str] = None,
+    checksum_path: Optional[Path] = None,
+    checksum_url: Optional[str] = None,
+) -> str:
+    """Verify the bundle against a supplied checksum source and return the digest."""
+
+    checksum_text = load_checksum_text(
+        checksum=checksum,
+        checksum_path=checksum_path,
+        checksum_url=checksum_url,
+        cache_path=bundle_path,
+    )
+    actual = sha256_file(bundle_path)
+    if checksum_text is None:
+        return actual
+
+    expected = parse_checksum_text(checksum_text, bundle_path.name)
+    if actual.lower() != expected.lower():
+        raise ValueError(
+            f"checksum mismatch for {bundle_path}: expected {expected}, got {actual}"
+        )
+    return actual