vscode-offline 0.1.6__tar.gz → 0.1.7__tar.gz

vscode_offline-0.1.6/.github/workflows/publish.yml → vscode_offline-0.1.7/.github/workflows/build.yml

@@ -1,4 +1,4 @@
-name: Publish
+name: Build
 
 on:
   push:
@@ -8,8 +8,39 @@ on:
       - "v*"
 
 jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout project
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0 # Shallow clones should be disabled for a proper tag checkout
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --locked
+
+      - name: Lint with ruff
+        run: uv run ruff check
+
+      - name: Type check with pyright
+        run: uv run pyright
+
+      - name: Format with ruff
+        run: uv run ruff format --check
+
+      - name: Run tests with pytest
+        run: uv run pytest tests
+
   publish:
     runs-on: ubuntu-latest
+    # This job depends on the successful completion of the 'test' job
+    needs: test
 
     permissions:
       contents: write # IMPORTANT: this permission is mandatory for uploading release assets
@@ -19,7 +50,7 @@ jobs:
       - name: Checkout project
         uses: actions/checkout@v5
         with:
-          fetch-depth: 0  # Shallow clones should be disabled for a proper tag checkout
+          fetch-depth: 0 # Shallow clones should be disabled for a proper tag checkout
 
       - name: Set up uv
         uses: astral-sh/setup-uv@v6

{vscode_offline-0.1.6 → vscode_offline-0.1.7}/.gitignore

@@ -10,5 +10,8 @@ wheels/
 # Virtual environments
 .venv
 
+# Hatch VCS version file
+/src/vscode_offline/_version.py
+
 # VS Code offline installer directory
 vscode-offline-installer/

vscode_offline-0.1.7/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: vscode-offline
+Version: 0.1.7
+Summary: Download and install VS Code for offline environments
+Project-URL: Homepage, https://github.com/fanck0605/vscode-offline
+Author-email: Chuck Fan <fanck0605@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# vscode-offline
+
+[![Build Status](https://github.com/fanck0605/vscode-offline/workflows/Build/badge.svg)](https://github.com/fanck0605/vscode-offline/actions/workflows/build.yml)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![PyPI Version](https://img.shields.io/pypi/v/vscode-offline)](https://pypi.org/project/vscode-offline/)
+[![License](https://img.shields.io/github/license/fanck0605/vscode-offline)](https://github.com/fanck0605/vscode-offline/blob/master/LICENSE)
+
+**vscode-offline** 主要用于在无网环境下安装 VS Code 和 VS Code Server，方便使用 [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) 插件进行远程开发。
+
+## 安装
+
+```shell
+pip install -U vscode-offline
+```
+
+## 优势
+
+1. 自动识别并下载所有 `.vsix` 文件（包括间接依赖）
+2. 一键安装 VS Code Server 以及其所有插件
+
+## VS Code 离线安装
+
+（1）在联网环境安装好 VS Code 和你需要的插件，如 [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh), [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python) 等。
+
+（2）执行如下命令，下载 VS Code 安装包，和目前安装的所有的插件
+
+```shell
+vscode-offline download-all --client-platform win32-x64 --server-platform linux-x64
+```
+
+（3）复制 `./vscode-offline-installer` 到内网 Windows 机器，安装 `client-<version>` 下的 VS Code，然后执行如下命令安装所有插件
+
+```shell
+vscode-offline install-extensions --installer ./vscode-offline-installer
+```
+
+（4）复制 `./vscode-offline-installer` 到内网 Linux 服务器，执行如下命令安装 VS Code Server 和所有插件
+
+```shell
+vscode-offline install-server --installer ./vscode-offline-installer
+```
+
+## 指定 VS Code 版本号
+
+如果你想下载或安装指定版本的 VS Code，可以先通过 `code --version` 获取当前版本，然后通过 --code-version 参数指定版本号，例如：
+
+```shell
+vscode-offline download-all --code-version 1.104.3
+```
+
+也支持使用 commit hash 作为版本号，例如：
+
+```shell
+vscode-offline download-all --code-version commit:385651c938df8a906869babee516bffd0ddb9829
+```
+
+
+## 文件下载地址
+
+如果你不想使用 `vscode-offline`，也可以手动下载对应的文件。
+
+VS Code / VS Code Server / VS Code CLI  下载地址格式：
+
+```shell
+curl -O https://update.code.visualstudio.com/<version>/<platform>/stable
+curl -O https://update.code.visualstudio.com/commit:<commit>/<platform>/stable
+
+# 比如
+curl -O https://update.code.visualstudio.com/1.104.3/cli-alpine-x64/stable
+curl -O https://update.code.visualstudio.com/commit:385651c938df8a906869babee516bffd0ddb9829/win32-x64/stable
+```
+
+
+VS Code Extension 下载地址格式：
+
+```shell
+curl -O https://marketplace.visualstudio.com/_apis/public/gallery/publishers/<publisher>/vsextensions/<extension>/<version>/vspackage?targetPlatform=<platform>
+
+# 比如
+curl -O https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2025.14.0/vspackage?targetPlatform=linux-x64
+```
+
+Platform 映射关系:
+
+| VS Code             | VS Code Server      | VS Code CLI      | VS Code Extension |
+| ------------------- | ------------------- | ---------------- | ----------------- |
+| win32-x64           | server-win32-x64    | cli-win32-x64    | win32-x64         |
+| win32-x64-user      | server-win32-x64    | cli-win32-x64    | win32-x64         |
+| win32-x64-archive   | server-win32-x64    | cli-win32-x64    | win32-x64         |
+| win32-arm64         | server-win32-arm64  | cli-win32-arm64  | win32-arm64       |
+| win32-arm64-user    | server-win32-arm64  | cli-win32-arm64  | win32-arm64       |
+| win32-arm64-archive | server-win32-arm64  | cli-win32-arm64  | win32-arm64       |
+| linux-x64           | server-linux-x64    | cli-alpine-x64   | linux-x64         |
+| linux-deb-x64       | server-linux-x64    | cli-alpine-x64   | linux-x64         |
+| linux-rpm-x64       | server-linux-x64    | cli-alpine-x64   | linux-x64         |
+| linux-arm64         | server-linux-arm64  | cli-alpine-arm64 | linux-arm64       |
+| linux-deb-arm64     | server-linux-arm64  | cli-alpine-arm64 | linux-arm64       |
+| linux-rpm-arm64     | server-linux-arm64  | cli-alpine-arm64 | linux-arm64       |
+| linux-armhf         | server-linux-armhf  | cli-linux-armhf  | linux-armhf       |
+| linux-deb-armhf     | server-linux-armhf  | cli-linux-armhf  | linux-armhf       |
+| linux-rpm-armhf     | server-linux-armhf  | cli-linux-armhf  | linux-armhf       |
+| darwin              | server-darwin       | cli-darwin-x64   | darwin-x64        |
+| darwin-arm64        | server-darwin-arm64 | cli-darwin-arm64 | darwin-arm64      |
+
+
+## 贡献
+
+欢迎提交 Issue 和 PR 改进本项目。
+
+## License
+
+Copyright (c) 2025 Chuck Fan.
+
+Distributed under the terms of the  [MIT License](https://github.com/fanck0605/vscode-offline/blob/master/LICENSE).

vscode_offline-0.1.7/README.md

@@ -0,0 +1,114 @@
+# vscode-offline
+
+[![Build Status](https://github.com/fanck0605/vscode-offline/workflows/Build/badge.svg)](https://github.com/fanck0605/vscode-offline/actions/workflows/build.yml)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![PyPI Version](https://img.shields.io/pypi/v/vscode-offline)](https://pypi.org/project/vscode-offline/)
+[![License](https://img.shields.io/github/license/fanck0605/vscode-offline)](https://github.com/fanck0605/vscode-offline/blob/master/LICENSE)
+
+**vscode-offline** 主要用于在无网环境下安装 VS Code 和 VS Code Server，方便使用 [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) 插件进行远程开发。
+
+## 安装
+
+```shell
+pip install -U vscode-offline
+```
+
+## 优势
+
+1. 自动识别并下载所有 `.vsix` 文件（包括间接依赖）
+2. 一键安装 VS Code Server 以及其所有插件
+
+## VS Code 离线安装
+
+（1）在联网环境安装好 VS Code 和你需要的插件，如 [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh), [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python) 等。
+
+（2）执行如下命令，下载 VS Code 安装包，和目前安装的所有的插件
+
+```shell
+vscode-offline download-all --client-platform win32-x64 --server-platform linux-x64
+```
+
+（3）复制 `./vscode-offline-installer` 到内网 Windows 机器，安装 `client-<version>` 下的 VS Code，然后执行如下命令安装所有插件
+
+```shell
+vscode-offline install-extensions --installer ./vscode-offline-installer
+```
+
+（4）复制 `./vscode-offline-installer` 到内网 Linux 服务器，执行如下命令安装 VS Code Server 和所有插件
+
+```shell
+vscode-offline install-server --installer ./vscode-offline-installer
+```
+
+## 指定 VS Code 版本号
+
+如果你想下载或安装指定版本的 VS Code，可以先通过 `code --version` 获取当前版本，然后通过 --code-version 参数指定版本号，例如：
+
+```shell
+vscode-offline download-all --code-version 1.104.3
+```
+
+也支持使用 commit hash 作为版本号，例如：
+
+```shell
+vscode-offline download-all --code-version commit:385651c938df8a906869babee516bffd0ddb9829
+```
+
+
+## 文件下载地址
+
+如果你不想使用 `vscode-offline`，也可以手动下载对应的文件。
+
+VS Code / VS Code Server / VS Code CLI  下载地址格式：
+
+```shell
+curl -O https://update.code.visualstudio.com/<version>/<platform>/stable
+curl -O https://update.code.visualstudio.com/commit:<commit>/<platform>/stable
+
+# 比如
+curl -O https://update.code.visualstudio.com/1.104.3/cli-alpine-x64/stable
+curl -O https://update.code.visualstudio.com/commit:385651c938df8a906869babee516bffd0ddb9829/win32-x64/stable
+```
+
+
+VS Code Extension 下载地址格式：
+
+```shell
+curl -O https://marketplace.visualstudio.com/_apis/public/gallery/publishers/<publisher>/vsextensions/<extension>/<version>/vspackage?targetPlatform=<platform>
+
+# 比如
+curl -O https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2025.14.0/vspackage?targetPlatform=linux-x64
+```
+
+Platform 映射关系:
+
+| VS Code             | VS Code Server      | VS Code CLI      | VS Code Extension |
+| ------------------- | ------------------- | ---------------- | ----------------- |
+| win32-x64           | server-win32-x64    | cli-win32-x64    | win32-x64         |
+| win32-x64-user      | server-win32-x64    | cli-win32-x64    | win32-x64         |
+| win32-x64-archive   | server-win32-x64    | cli-win32-x64    | win32-x64         |
+| win32-arm64         | server-win32-arm64  | cli-win32-arm64  | win32-arm64       |
+| win32-arm64-user    | server-win32-arm64  | cli-win32-arm64  | win32-arm64       |
+| win32-arm64-archive | server-win32-arm64  | cli-win32-arm64  | win32-arm64       |
+| linux-x64           | server-linux-x64    | cli-alpine-x64   | linux-x64         |
+| linux-deb-x64       | server-linux-x64    | cli-alpine-x64   | linux-x64         |
+| linux-rpm-x64       | server-linux-x64    | cli-alpine-x64   | linux-x64         |
+| linux-arm64         | server-linux-arm64  | cli-alpine-arm64 | linux-arm64       |
+| linux-deb-arm64     | server-linux-arm64  | cli-alpine-arm64 | linux-arm64       |
+| linux-rpm-arm64     | server-linux-arm64  | cli-alpine-arm64 | linux-arm64       |
+| linux-armhf         | server-linux-armhf  | cli-linux-armhf  | linux-armhf       |
+| linux-deb-armhf     | server-linux-armhf  | cli-linux-armhf  | linux-armhf       |
+| linux-rpm-armhf     | server-linux-armhf  | cli-linux-armhf  | linux-armhf       |
+| darwin              | server-darwin       | cli-darwin-x64   | darwin-x64        |
+| darwin-arm64        | server-darwin-arm64 | cli-darwin-arm64 | darwin-arm64      |
+
+
+## 贡献
+
+欢迎提交 Issue 和 PR 改进本项目。
+
+## License
+
+Copyright (c) 2025 Chuck Fan.
+
+Distributed under the terms of the  [MIT License](https://github.com/fanck0605/vscode-offline/blob/master/LICENSE).

{vscode_offline-0.1.6 → vscode_offline-0.1.7}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "vscode-offline"
 dynamic = ["version"]
-description = "Download and install VS Code Server for offline environments"
+description = "Download and install VS Code for offline environments"
 readme = "README.md"
 authors = [{ name = "Chuck Fan", email = "fanck0605@qq.com" }]
 requires-python = ">=3.9"
@@ -45,6 +45,9 @@ dev = [
 [tool.hatch.version]
 source = "vcs"
 
+[tool.hatch.build.hooks.vcs]
+version-file = "src/vscode_offline/_version.py"
+
 [tool.ruff.lint]
 select = [
     "ANN", # flake8-annotations

vscode_offline-0.1.7/src/vscode_offline/__init__.py

@@ -0,0 +1,9 @@
+from vscode_offline._version import __commit_id__, __version__, __version_tuple__
+from vscode_offline.app import main
+
+__all__ = (
+    "__commit_id__",
+    "__version__",
+    "__version_tuple__",
+    "main",
+)

vscode_offline-0.1.7/src/vscode_offline/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.1.7'
+__version_tuple__ = version_tuple = (0, 1, 7)
+
+__commit_id__ = commit_id = None

{vscode_offline-0.1.6 → vscode_offline-0.1.7}/src/vscode_offline/app.py

@@ -4,6 +4,7 @@ import logging
 from argparse import ArgumentParser, Namespace
 from pathlib import Path
 
+from vscode_offline._version import __version__
 from vscode_offline.download import (
     download_vscode_client,
     download_vscode_extensions,
@@ -15,10 +16,14 @@ from vscode_offline.install import (
     install_vscode_server,
 )
 from vscode_offline.utils import (
+    get_client_platform,
     get_default_code_version,
+    get_extension_platform,
     get_host_platform,
+    get_server_platform,
     get_vscode_extensions_config,
     get_vscode_version_from_server_installer,
+    validate_platform,
 )
 
 
@@ -33,12 +38,14 @@ def cmd_download_server(args: Namespace) -> None:
     download_vscode_server(
         args.code_version,
         output=args.installer / f"server-{args.code_version.replace(':', '-')}",
-        platform=args.platform,
+        platform=get_server_platform(args.platform),
     )
     extensions_config = Path(args.extensions_config).expanduser()
     download_vscode_extensions(
         extensions_config,
-        target_platforms=[args.platform],
+        target_platforms={
+            get_extension_platform(args.platform),
+        },
         output=args.installer / "extensions",
     )
 
@@ -57,12 +64,12 @@ def cmd_install_server(args: Namespace) -> None:
 
     vscode_server_home = install_vscode_server(
         server_installer=args.installer / f"server-{args.code_version}",
-        platform=host_platform,
+        platform=get_server_platform(host_platform),
     )
     install_vscode_extensions(
         Path(vscode_server_home) / "bin/code-server",
         vsix_dir=args.installer / "extensions",
-        platform=host_platform,
+        platform=get_extension_platform(host_platform),
         exclude=SERVER_EXCLUDE_EXTENSIONS,
     )
 
@@ -71,7 +78,9 @@ def cmd_download_extensions(args: Namespace) -> None:
     extensions_config = Path(args.extensions_config).expanduser()
     download_vscode_extensions(
         extensions_config,
-        target_platforms=[args.platform],
+        target_platforms={
+            get_extension_platform(args.platform),
+        },
         output=args.installer / "extensions",
     )
 
@@ -81,7 +90,7 @@ def cmd_install_extensions(args: Namespace) -> None:
     install_vscode_extensions(
         args.code,
         vsix_dir=args.installer / "extensions",
-        platform=host_platform,
+        platform=get_extension_platform(host_platform),
     )
 
 
@@ -96,12 +105,14 @@ def cmd_download_client(args: Namespace) -> None:
     download_vscode_client(
         args.code_version,
         output=args.installer / f"client-{args.code_version.replace(':', '-')}",
-        platform=args.platform,
+        platform=get_client_platform(args.platform),
     )
     extensions_config = Path(args.extensions_config).expanduser()
     download_vscode_extensions(
         extensions_config,
-        target_platforms=[args.platform],
+        target_platforms={
+            get_extension_platform(args.platform),
+        },
         output=args.installer / "extensions",
     )
 
@@ -117,21 +128,29 @@ def cmd_download_all(args: Namespace) -> None:
     download_vscode_server(
         args.code_version,
         output=args.installer / f"server-{args.code_version.replace(':', '-')}",
-        platform=args.server_platform,
+        platform=get_server_platform(args.server_platform),
     )
     download_vscode_client(
         args.code_version,
         output=args.installer / f"client-{args.code_version.replace(':', '-')}",
-        platform=args.client_platform,
+        platform=get_client_platform(args.client_platform),
     )
     extensions_config = Path(args.extensions_config).expanduser()
     download_vscode_extensions(
         extensions_config,
-        target_platforms=[args.server_platform, args.client_platform],
+        target_platforms={
+            get_extension_platform(args.server_platform),
+            get_extension_platform(args.client_platform),
+        },
         output=args.installer / "extensions",
     )
 
 
+def cmd_version(args: Namespace) -> None:
+    # print version instead of logging
+    print(__version__)
+
+
 def make_argparser() -> ArgumentParser:
     parent_parser = ArgumentParser(add_help=False)
 
@@ -145,6 +164,12 @@ def make_argparser() -> ArgumentParser:
     parser = ArgumentParser()
     subparsers = parser.add_subparsers(required=True)
 
+    version_parser = subparsers.add_parser(
+        "version",
+        help="Show version information",
+    )
+    version_parser.set_defaults(func=cmd_version)
+
     download_server_parser = subparsers.add_parser(
         "download-server",
         help="Download VS Code Server and extensions",
@@ -158,7 +183,7 @@ def make_argparser() -> ArgumentParser:
     )
     download_server_parser.add_argument(
         "--platform",
-        type=str,
+        type=validate_platform,
         required=True,
         help="The target platform of the VS Code Server to download.",
     )
@@ -189,7 +214,7 @@ def make_argparser() -> ArgumentParser:
     download_extensions_parser.set_defaults(func=cmd_download_extensions)
     download_extensions_parser.add_argument(
         "--platform",
-        type=str,
+        type=validate_platform,
         required=True,
         help="The target platform of the VS Code extensions to download.",
     )
@@ -226,7 +251,7 @@ def make_argparser() -> ArgumentParser:
     )
     download_client_parser.add_argument(
         "--platform",
-        type=str,
+        type=validate_platform,
         required=True,
         help="The target platform of the VS Code to download.",
     )
@@ -250,14 +275,14 @@ def make_argparser() -> ArgumentParser:
     )
     download_all_parser.add_argument(
         "--server-platform",
-        type=str,
-        default="linux-x64",
+        type=validate_platform,
+        required=True,
         help="The target platform of the VS Code Server to download, defaults to linux-x64.",
     )
     download_all_parser.add_argument(
         "--client-platform",
-        type=str,
-        default="win32-x64",
+        type=validate_platform,
+        required=True,
         help="The target platform of the VS Code to download, defaults to win32-x64.",
     )
     download_all_parser.add_argument(