ensure-node 0.0.0__tar.gz

ensure_node-0.0.0/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.3
+Name: ensure-node
+Version: 0.0.0
+Summary: Ensure Node.js to be installed.
+Author: Kl1nge5
+Author-email: Kl1nge5 <ninthseason@qq.com>
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: tqdm>=4.67.3
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# ensure-node
+
+`ensure-node` 是一个轻量 Python 工具库，用来确保指定版本的 Node.js 发行包就绪。
+
+```python
+from ensure_node import ensure_node
+import subprocess
+# 安装指定版本的 Node.js
+npx, node, npm = ensure_node("https://nodejs.org/dist/latest/node-v25.8.2-win-x64.zip")
+# 使用相关工具
+completed_process = subprocess.run([
+    str(npx),
+    "--version"
+], capture_output=True)
+print(completed_process.stdout.decode())
+```
+
+目前仅在 Windows 平台上测试过，可能支持 Linux 平台，不支持 MacOS 平台。
+
+只支持 .zip / .tar.gz / .tar.xz 格式的文件。

ensure_node-0.0.0/README.md

@@ -0,0 +1,20 @@
+# ensure-node
+
+`ensure-node` 是一个轻量 Python 工具库，用来确保指定版本的 Node.js 发行包就绪。
+
+```python
+from ensure_node import ensure_node
+import subprocess
+# 安装指定版本的 Node.js
+npx, node, npm = ensure_node("https://nodejs.org/dist/latest/node-v25.8.2-win-x64.zip")
+# 使用相关工具
+completed_process = subprocess.run([
+    str(npx),
+    "--version"
+], capture_output=True)
+print(completed_process.stdout.decode())
+```
+
+目前仅在 Windows 平台上测试过，可能支持 Linux 平台，不支持 MacOS 平台。
+
+只支持 .zip / .tar.gz / .tar.xz 格式的文件。

ensure_node-0.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "ensure-node"
+version = "0.0.0"
+description = "Ensure Node.js to be installed."
+readme = "README.md"
+authors = [
+    { name = "Kl1nge5", email = "ninthseason@qq.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "httpx>=0.28.1",
+    "tqdm>=4.67.3",
+]
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "ruff>=0.15.8",
+]

ensure_node-0.0.0/src/ensure_node/__init__.py

@@ -0,0 +1,3 @@
+from .ensure_node import ensure_node
+
+__all__ = ["ensure_node"]

ensure_node-0.0.0/src/ensure_node/downloader.py

@@ -0,0 +1,32 @@
+import httpx
+from httpx import URL
+from tqdm import tqdm
+import pathlib
+import time
+
+KB = 1024
+MB = 1024 * 1024
+
+def stream_downlaod(url: URL | str, save_path: pathlib.Path, chunk_size: int = 1 * MB, delay_every_chunk: float = 0) -> None:
+    with httpx.stream("GET", url) as r:
+        content_length = int(r.headers.get("Content-Length", 0))
+        save_path.parent.mkdir(parents=True, exist_ok=True)
+        file_desc = save_path.open("wb")
+
+        progress_bar = tqdm(total=content_length, unit="bytes", leave=False)
+        if delay_every_chunk > 0:
+            for chunk in r.iter_bytes(chunk_size):
+                file_desc.write(chunk)
+                progress_bar.update(chunk_size)
+                time.sleep(delay_every_chunk)
+        else:
+            for chunk in r.iter_bytes(chunk_size):
+                file_desc.write(chunk)
+                progress_bar.update(chunk_size)
+
+        file_desc.close()
+
+
+def fetch_file_metadata(url: URL | str):
+    resp = httpx.head(url)
+    print(resp.headers)

ensure_node-0.0.0/src/ensure_node/ensure_node.py

@@ -0,0 +1,42 @@
+from pathlib import Path
+from .downloader import stream_downlaod
+import shutil
+
+class NodeTriple:
+    def __init__(self, npx: Path, node: Path, npm: Path) -> None:
+        self.npx = npx
+        self.node = node
+        self.npm = npm
+
+    def __repr__(self) -> str:
+        return f"{{\n\tnpx: {self.npx}\n\tnode: {self.node}\n\tnpm: {self.npm}\n}}"
+    
+    def __iter__(self):
+        yield self.npx
+        yield self.node
+        yield self.npm
+
+
+def ensure_node(node_url: str,
+                save_dir: Path = Path.home() / ".ensure_node") -> NodeTriple:
+    cache_dir = save_dir / "cache"
+    cache_dir.mkdir(parents=True, exist_ok=True)
+    filename = node_url.split("/")[-1]
+    file_identity = filename.strip(".zip").strip(".tar.gz").strip(".tar.xz")
+    file_identity_path = save_dir / file_identity
+    file_save_path = cache_dir / filename
+    if file_identity_path.exists():
+        return _return_triple(file_identity, file_identity_path)
+    stream_downlaod(node_url, file_save_path)
+    shutil.unpack_archive(file_save_path, save_dir)
+    return _return_triple(file_identity, file_identity_path)
+
+
+def _return_triple(file_identity, file_identity_path) -> NodeTriple:
+    if "win" in file_identity:
+        return NodeTriple(file_identity_path / "npx.cmd", file_identity_path / "node.exe", file_identity_path / "npm.cmd")
+    if "linux" in file_identity:
+        return NodeTriple(file_identity_path / "bin" / "npx", \
+               file_identity_path / "bin" / "node", \
+               file_identity_path / "bin" / "npm")
+    raise RuntimeError