vscode-offline 0.1.6__py3-none-any.whl → 0.1.8__py3-none-any.whl

vscode_offline/__init__.py

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

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.8'
+__version_tuple__ = version_tuple = (0, 1, 8)
+
+__commit_id__ = commit_id = None

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,
 )
 
 
@@ -32,13 +37,15 @@ 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,
+        output=args.installer / args.code_version.replace(":", "-"),
+        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",
     )
 
@@ -56,13 +63,13 @@ def cmd_install_server(args: Namespace) -> None:
             ) from None
 
     vscode_server_home = install_vscode_server(
-        server_installer=args.installer / f"server-{args.code_version}",
-        platform=host_platform,
+        server_installer=args.installer / args.code_version.replace(":", "-"),
+        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),
     )
 
 
@@ -95,13 +104,15 @@ 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,
+        output=args.installer / args.code_version.replace(":", "-"),
+        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",
     )
 
@@ -116,22 +127,30 @@ 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,
+        output=args.installer / args.code_version.replace(":", "-"),
+        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,
+        output=args.installer / args.code_version.replace(":", "-"),
+        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(

vscode_offline/download.py

@@ -2,18 +2,19 @@ from __future__ import annotations
 
 import json
 import os
-from collections.abc import Sequence
+from collections.abc import Set as AbstractSet
 from gzip import GzipFile
-from io import DEFAULT_BUFFER_SIZE
 from pathlib import Path
 from urllib.error import HTTPError
 from urllib.request import urlopen
 
 from vscode_offline.loggers import logger
-from vscode_offline.utils import get_cli_platform, get_filename_from_headers
+from vscode_offline.utils import extract_filename_from_headers, get_cli_platform
 
+_DOWNLOAD_CHUNK_SIZE = 4 * 1024 * 1024  # 4 MiB
 
-def _download_file(
+
+def _download_file_once(
     url: str,
     directory: str | os.PathLike[str],
     filename: str | None = None,
@@ -31,12 +32,12 @@ def _download_file(
         if filename:
             file_path = Path(directory).joinpath(filename)
         else:
-            filename = get_filename_from_headers(resp.headers)
+            filename = extract_filename_from_headers(resp.headers)
             if not filename:
                 raise ValueError(
-                    "Cannot get filename from HTTP headers, please specify argument `filename`."
+                    "Cannot extract filename from HTTP headers, please specify argument `filename`."
                 )
-            logger.info(f"Get filename `{filename}` from HTTP headers.")
+            logger.info(f"Extracted filename {filename} from HTTP headers.")
             file_path = Path(directory).joinpath(filename)
             if file_path.exists():
                 logger.info(f"File {file_path} already exists, skipping download.")
@@ -45,7 +46,7 @@ def _download_file(
         tmp_file_path = Path(directory).joinpath(f"{filename}.tmp")
         with reader, tmp_file_path.open("wb") as fp:
             while True:
-                chunk = reader.read(DEFAULT_BUFFER_SIZE)
+                chunk = reader.read(_DOWNLOAD_CHUNK_SIZE)
                 if not chunk:
                     break
                 fp.write(chunk)
@@ -58,7 +59,7 @@ def _download_file(
         return file_path
 
 
-def download_file(
+def _download_file(
     url: str,
     directory: str | os.PathLike[str],
     filename: str | None = None,
@@ -70,35 +71,47 @@ def download_file(
             return
 
     logger.info(f"Downloading {url} ...")
-    for i in range(3):
+    attempt_num = 0
+    while True:
         try:
-            _download_file(url, directory, filename)
+            _download_file_once(url, directory, filename)
             break
         except Exception as e:
             if isinstance(e, HTTPError) and e.code == 404:
                 raise
-            logger.info(f"Attempt {i + 1} times failed: {e}")
+            attempt_num += 1
+            if attempt_num >= 3:
+                raise
+            logger.info(f"Attempt {attempt_num} times failed: {e}")
 
 
-def download_extension(
+def _download_extension(
     publisher: str,
     name: str,
     version: str,
     platform: str | None = None,
-    output: str = ".",
+    output: str | os.PathLike[str] = ".",
 ) -> None:
     url = f"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{name}/{version}/vspackage"
     if platform:
         url = f"{url}?targetPlatform={platform}"
     filename = f"{publisher}.{name}-{version}{f'@{platform}' if platform else ''}.vsix"
-    download_file(url, output, filename)
+    _download_file(url, output, filename)
 
 
 def download_vscode_extensions(
     extensions_config: os.PathLike[str],
-    target_platforms: Sequence[str],
-    output: str = ".",
+    target_platforms: AbstractSet[str],
+    output: str | os.PathLike[str] = ".",
 ) -> None:
+    """Download VS Code extensions listed in the given extensions config file.
+
+    Args:
+        extensions_config: Path to the extensions config file, which is a JSON file
+            containing a list of extensions with their publisher, name, and version.
+        target_platforms: List of target platforms for which to download the extensions.
+        output: Directory to save the downloaded extensions.
+    """
     logger.info(f"Reading extensions config from {extensions_config}")
     with open(extensions_config) as fp:
         data = json.loads(fp.read())
@@ -112,7 +125,7 @@ def download_vscode_extensions(
         requires_fallback_download = False
         for target_platform in target_platforms:
             try:
-                download_extension(
+                _download_extension(
                     publisher, name, version, target_platform, output=output
                 )
             except HTTPError as e:
@@ -121,7 +134,7 @@ def download_vscode_extensions(
                     continue
                 raise
         if requires_fallback_download:
-            download_extension(publisher, name, version, output=output)
+            _download_extension(publisher, name, version, output=output)
 
 
 def _download_vscode(
@@ -135,7 +148,7 @@ def _download_vscode(
     # "VS CodeSetup-x64-1.104.3.exe" for windows VS Code,
     # "vscode-server-linux-x64.tar.gz" for linux VS Code Server,
     # "vscode_cli_alpine_x64_cli.tar.gz" for linux VS Code CLI.
-    download_file(
+    _download_file(
         f"https://update.code.visualstudio.com/{version}/{platform}/stable", output
     )
 

vscode_offline/utils.py

@@ -4,9 +4,12 @@ import os
 import shutil
 import subprocess
 import sys
+from argparse import ArgumentTypeError
 from collections.abc import Mapping
+from collections.abc import Set as AbstractSet
 from email.parser import HeaderParser
 from pathlib import Path
+from typing import Final
 
 from vscode_offline.loggers import logger
 
@@ -35,9 +38,7 @@ def get_vscode_extensions_config() -> os.PathLike[str]:
 def get_vscode_version_from_server_installer(
     installer: os.PathLike[str], platform: str
 ) -> str:
-    directories = list(
-        Path(installer).glob(f"server-*/vscode-server-{platform}.tar.gz")
-    )
+    directories = list(Path(installer).glob(f"*/vscode-server-{platform}.tar.gz"))
     if len(directories) > 1:
         raise ValueError(
             f"Multiple matching installers found in {installer} for platform {platform}"
@@ -47,9 +48,9 @@ def get_vscode_version_from_server_installer(
             f"No matching installer found in {installer} for platform {platform}"
         )
 
-    version = directories[0].parent.name[len("server-") :]
+    version = directories[0].parent.name
     logger.info(f"Getting version from {platform} installer: {version}")
-    return version
+    return version.replace("commit-", "commit:")
 
 
 def get_default_code_version() -> str | None:
@@ -80,20 +81,151 @@ def get_default_code_version() -> str | None:
     return version
 
 
-# Mapping from target platform to CLI OS and architecture used in download URLs
-_cli_platform_mapping = {
+# Mapping from other platforms to VS Code client platform used in download URLs
+_client_platform_mapping: Final[Mapping[str, str]] = {
+    "linux-x64": "linux-x64",
+    "alpine-x64": "linux-x64",
+    "linux-deb-x64": "linux-deb-x64",
+    "linux-rpm-x64": "linux-rpm-x64",
+    "linux-arm64": "linux-arm64",
+    "alpine-arm64": "linux-arm64",
+    "linux-deb-arm64": "linux-deb-arm64",
+    "linux-rpm-arm64": "linux-rpm-arm64",
+    "linux-armhf": "linux-armhf",
+    "linux-deb-armhf": "linux-deb-armhf",
+    "linux-rpm-armhf": "linux-rpm-armhf",
+    "win32-x64": "win32-x64",
+    "win32-x64-user": "win32-x64-user",
+    "win32-x64-archive": "win32-x64-archive",
+    "win32-arm64": "win32-arm64",
+    "win32-arm64-user": "win32-arm64-user",
+    "win32-arm64-archive": "win32-arm64-archive",
+    "darwin": "darwin",
+    "darwin-x64": "darwin",
+    "darwin-arm64": "darwin-arm64",
+}
+
+# Mapping from other platforms to VS Code server platform used in download URLs
+_server_platform_mapping: Final[Mapping[str, str]] = {
+    "linux-x64": "linux-x64",
+    "alpine-x64": "linux-x64",
+    "linux-deb-x64": "linux-x64",
+    "linux-rpm-x64": "linux-x64",
+    "linux-arm64": "linux-arm64",
+    "alpine-arm64": "linux-arm64",
+    "linux-deb-arm64": "linux-arm64",
+    "linux-rpm-arm64": "linux-arm64",
+    "linux-armhf": "linux-armhf",
+    "linux-deb-armhf": "linux-armhf",
+    "linux-rpm-armhf": "linux-armhf",
+    "win32-x64": "win32-x64",
+    "win32-x64-user": "win32-x64",
+    "win32-x64-archive": "win32-x64",
+    "win32-arm64": "win32-arm64",
+    "win32-arm64-user": "win32-arm64",
+    "win32-arm64-archive": "win32-arm64",
+    "darwin": "darwin",
+    "darwin-x64": "darwin",
+    "darwin-arm64": "darwin-arm64",
+}
+
+
+# Mapping from other platforms to VS Code CLI platform used in download URLs
+_cli_platform_mapping: Final[Mapping[str, str]] = {
     "linux-x64": "alpine-x64",
+    "alpine-x64": "alpine-x64",
+    "linux-deb-x64": "alpine-x64",
+    "linux-rpm-x64": "alpine-x64",
     "linux-arm64": "alpine-arm64",
-    "linux-armhf": "linux-arm64",
+    "alpine-arm64": "alpine-arm64",
+    "linux-deb-arm64": "alpine-arm64",
+    "linux-rpm-arm64": "alpine-arm64",
+    "linux-armhf": "linux-armhf",
+    "linux-deb-armhf": "linux-armhf",
+    "linux-rpm-armhf": "linux-armhf",
+    "win32-x64": "win32-x64",
+    "win32-x64-user": "win32-x64",
+    "win32-x64-archive": "win32-x64",
+    "win32-arm64": "win32-arm64",
+    "win32-arm64-user": "win32-arm64",
+    "win32-arm64-archive": "win32-arm64",
+    "darwin": "darwin-x64",
+    "darwin-x64": "darwin-x64",
+    "darwin-arm64": "darwin-arm64",
+}
+
+
+# Mapping from other platforms to extension target platform used in download URLs
+_extension_platform_mapping: Final[Mapping[str, str]] = {
+    "linux-x64": "linux-x64",
+    "alpine-x64": "linux-x64",
+    "linux-deb-x64": "linux-x64",
+    "linux-rpm-x64": "linux-x64",
+    "linux-arm64": "linux-arm64",
+    "alpine-arm64": "linux-arm64",
+    "linux-deb-arm64": "linux-arm64",
+    "linux-rpm-arm64": "linux-arm64",
+    "linux-armhf": "linux-armhf",
+    "linux-deb-armhf": "linux-armhf",
+    "linux-rpm-armhf": "linux-armhf",
     "win32-x64": "win32-x64",
+    "win32-x64-user": "win32-x64",
+    "win32-x64-archive": "win32-x64",
+    "win32-arm64": "win32-arm64",
+    "win32-arm64-user": "win32-arm64",
+    "win32-arm64-archive": "win32-arm64",
+    "darwin": "darwin-x64",
+    "darwin-x64": "darwin-x64",
+    "darwin-arm64": "darwin-arm64",
 }
 
 
+def get_client_platform(platform: str) -> str:
+    """Get the VS Code platform for the given platform."""
+    return _client_platform_mapping.get(platform, platform)
+
+
+def get_server_platform(platform: str) -> str:
+    """Get the VS Code server platform for the given platform."""
+    return _server_platform_mapping.get(platform, platform)
+
+
 def get_cli_platform(platform: str) -> str:
-    """Get the CLI OS and architecture for the given target platform."""
-    if platform not in _cli_platform_mapping:
-        raise ValueError(f"Unsupported target platform: {platform}")
-    return _cli_platform_mapping[platform]
+    """Get the VS Code CLI platform for the given platform."""
+    return _cli_platform_mapping.get(platform, platform)
+
+
+def get_extension_platform(platform: str) -> str:
+    """Get the VS Code extension target platform for the given platform."""
+    return _extension_platform_mapping.get(platform, platform)
+
+
+_all_platforms: Final[AbstractSet[str]] = {
+    *_client_platform_mapping.keys(),
+    *_client_platform_mapping.values(),
+    *_server_platform_mapping.keys(),
+    *_server_platform_mapping.values(),
+    *_cli_platform_mapping.keys(),
+    *_cli_platform_mapping.values(),
+    *_extension_platform_mapping.keys(),
+    *_extension_platform_mapping.values(),
+}
+
+
+assert (
+    _client_platform_mapping.keys()
+    == _server_platform_mapping.keys()
+    == _cli_platform_mapping.keys()
+    == _extension_platform_mapping.keys()
+    == _all_platforms
+)
+
+
+def validate_platform(platform: str) -> str:
+    """Check if the given platform is a valid VS Code platform."""
+    if platform in _all_platforms:
+        return platform
+    raise ArgumentTypeError(f"Unsupported platform: {platform!r}")
 
 
 def get_host_platform() -> str:
@@ -110,10 +242,12 @@ def get_host_platform() -> str:
             return "linux-x64"
         elif machine in ("aarch64", "arm64"):
             return "linux-arm64"
+        elif machine in ("armv7l", "armhf"):
+            return "linux-armhf"
     raise ValueError(f"Unsupported host platform: {osname}-{machine}")
 
 
-def get_filename_from_headers(headers: Mapping[str, str]) -> str | None:
+def extract_filename_from_headers(headers: Mapping[str, str]) -> str | None:
     """Get the filename from HTTP headers.
 
     Args:

vscode_offline-0.1.8.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: vscode-offline
+Version: 0.1.8
+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 机器，安装 `./vscode-offline-installer/<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.8.dist-info/RECORD

@@ -0,0 +1,13 @@
+vscode_offline/__init__.py,sha256=-TweZdViMkxGYKEAvUN-6g0oUKnKapeC8ytTsWgxjRk,210
+vscode_offline/_version.py,sha256=Zaz3s9gl_rzsS46-ymJOALojMxviW77EJq_agE8knLk,704
+vscode_offline/app.py,sha256=XMq400ghmtlaTfLbtTTI7TRk56ZOjFTd6VzIRGDQl60,9951
+vscode_offline/download.py,sha256=l10xenEUoE4rp4Uy1lWHjy_cYGYWFLwPeJ81oLrV3PQ,6060
+vscode_offline/install.py,sha256=plZxKrlwy5FgyEAtDWRt0ZfvPWTB2tMRf54_kzVK5h0,4320
+vscode_offline/loggers.py,sha256=vX91NMtNo1xfxq5y4BCtm_uhCTKtCODqBJHNvcT7JdQ,104
+vscode_offline/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vscode_offline/utils.py,sha256=YhDydIllSMSJfICJLqmdiIcKfEihct63woVFBGj80Ew,8581
+vscode_offline-0.1.8.dist-info/METADATA,sha256=KDQK_DgRiBov3RnjC1txFVIlCVHa4gedFH22qoyIVEQ,6050
+vscode_offline-0.1.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+vscode_offline-0.1.8.dist-info/entry_points.txt,sha256=XyuZLe7bgm2RmZp9oh9qCxcrAwHypD8XrTnm4G0_CzM,55
+vscode_offline-0.1.8.dist-info/licenses/LICENSE,sha256=pUIXFkLeTS986b7dopOVLyuw72fJsUxhl8H3rEMIycA,1053
+vscode_offline-0.1.8.dist-info/RECORD,,

vscode_offline-0.1.6.dist-info/METADATA

@@ -1,83 +0,0 @@
-Metadata-Version: 2.4
-Name: vscode-offline
-Version: 0.1.6
-Summary: Download and install VS Code Server 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
-
-vscode-offline 主要用于在无网环境下安装 VS Code Server，方便使用 *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 --installer ./vscode-offline-installer
-```
-
-（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
-```
-
-## 贡献
-
-欢迎提交 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.dist-info/RECORD

@@ -1,11 +0,0 @@
-vscode_offline/__init__.py,sha256=dr6Jtj0XT9eQEC4fzNigEYsAIEfCsaom3HDbUsS-2O4,57
-vscode_offline/app.py,sha256=Rm-uSkJrRmJVmyjiubPpRQTofttQdTADsGyEeZDSeY0,9142
-vscode_offline/download.py,sha256=blu2WjG8zhuBrHrrV-v-FUf2fXbIt7fVSX8DoUX_Ikk,5442
-vscode_offline/install.py,sha256=plZxKrlwy5FgyEAtDWRt0ZfvPWTB2tMRf54_kzVK5h0,4320
-vscode_offline/loggers.py,sha256=vX91NMtNo1xfxq5y4BCtm_uhCTKtCODqBJHNvcT7JdQ,104
-vscode_offline/utils.py,sha256=vpVSmE4JN0O-ezpzNJo9R9Y3YjzmzslhRVTG5H_-We0,4038
-vscode_offline-0.1.6.dist-info/METADATA,sha256=UPt5DA0VlejIxNXCWUCztcKc36pacYF6I_mN6SnW98s,2803
-vscode_offline-0.1.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-vscode_offline-0.1.6.dist-info/entry_points.txt,sha256=XyuZLe7bgm2RmZp9oh9qCxcrAwHypD8XrTnm4G0_CzM,55
-vscode_offline-0.1.6.dist-info/licenses/LICENSE,sha256=pUIXFkLeTS986b7dopOVLyuw72fJsUxhl8H3rEMIycA,1053
-vscode_offline-0.1.6.dist-info/RECORD,,