vscode-offline 0.1.0__tar.gz → 0.1.2__tar.gz

vscode_offline-0.1.2/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2025 Chuck Fan
+
+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.

vscode_offline-0.1.2/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: vscode-offline
+Version: 0.1.2
+Summary: Download and install VS Code Server for offline environments
+Author: Chuck Fan
+Author-email: Chuck Fan <fanck0605@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+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: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Project-URL: Homepage, https://github.com/fanck0605/vscode-offline
+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 Server 安装
+
+（1）在联网环境安装好 VSCode 和你需要的插件。
+
+（2）执行如下命令，将会自动下载 VS Code Server，和目前安装的所有的插件
+
+> `--commit` 可以指定对应 VSCode 的 Commit，默认自动获取当前环境 VSCode 的 Commit。
+>
+> 手动查看方式：*帮助* -> *关于* -> *Commit*，
+
+```shell
+vscode-offline download-server --target-platform linux-x64 --installer ./vscode-offline-installer
+```
+
+（3）复制 `./vscode-offline-installer` 到内网服务器
+
+```shell
+vscode-offline install-server --installer ./vscode-offline-installer
+```
+
+## VS Code 插件安装
+
+（1）联网环境执行如下命令，将会自动下载 VSCode 目前安装的所有的插件
+
+```shell
+vscode-offline download-extensions --target-platform win32-x64 --installer ./vscode-offline-installer
+```
+
+（2）复制 `./vscode-offline-installer` 到内网机器
+
+```shell
+vscode-offline install-extensions --installer ./vscode-offline-installer
+```
+
+## 贡献
+
+欢迎提交 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.2/README.md

@@ -0,0 +1,58 @@
+# vscode-offline
+
+vscode-offline 主要用于在无网环境下安装 VS Code Server，方便使用 *Remote - SSH* 插件进行远程开发。
+
+## 安装
+
+```shell
+pip install -U vscode-offline
+```
+
+## 优势
+
+1. 自动识别并下载所有 `.vsix` 文件（包括间接依赖）
+2. 一键安装 VS Code Server 以及所有插件
+
+## VS Code Server 安装
+
+（1）在联网环境安装好 VSCode 和你需要的插件。
+
+（2）执行如下命令，将会自动下载 VS Code Server，和目前安装的所有的插件
+
+> `--commit` 可以指定对应 VSCode 的 Commit，默认自动获取当前环境 VSCode 的 Commit。
+>
+> 手动查看方式：*帮助* -> *关于* -> *Commit*，
+
+```shell
+vscode-offline download-server --target-platform linux-x64 --installer ./vscode-offline-installer
+```
+
+（3）复制 `./vscode-offline-installer` 到内网服务器
+
+```shell
+vscode-offline install-server --installer ./vscode-offline-installer
+```
+
+## VS Code 插件安装
+
+（1）联网环境执行如下命令，将会自动下载 VSCode 目前安装的所有的插件
+
+```shell
+vscode-offline download-extensions --target-platform win32-x64 --installer ./vscode-offline-installer
+```
+
+（2）复制 `./vscode-offline-installer` 到内网机器
+
+```shell
+vscode-offline install-extensions --installer ./vscode-offline-installer
+```
+
+## 贡献
+
+欢迎提交 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.2/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+name = "vscode-offline"
+version = "0.1.2"
+description = "Download and install VS Code Server for offline environments"
+readme = "README.md"
+authors = [
+    { name = "Chuck Fan", email = "fanck0605@qq.com" }
+]
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3 :: Only",
+    "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",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Topic :: Utilities",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/fanck0605/vscode-offline"
+
+[project.scripts]
+vscode-offline = "vscode_offline:main"
+
+[build-system]
+requires = ["uv-build"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "lefthook>=1.13.6",
+    "ruff>=0.13.3",
+]
+
+[tool.ruff.lint]
+select = [
+    "I", # isort
+    "F", # Pyflakes
+]

vscode_offline-0.1.2/src/vscode_offline/app.py

@@ -0,0 +1,183 @@
+from __future__ import annotations
+
+import logging
+import os
+from argparse import ArgumentParser, Namespace
+from pathlib import Path
+
+from vscode_offline.download import (
+    download_vscode_extensions,
+    download_vscode_server,
+)
+from vscode_offline.install import (
+    SERVER_EXCLUDE_EXTENSIONS,
+    install_vscode_extensions,
+    install_vscode_server,
+)
+from vscode_offline.loggers import logger
+from vscode_offline.utils import (
+    get_host_platform,
+    get_vscode_cli_bin,
+    get_vscode_commit_from_code_version,
+    get_vscode_commit_from_installer,
+    get_vscode_extensions_config,
+    get_vscode_server_home,
+)
+
+
+def cmd_download_server(args: Namespace) -> None:
+    if args.commit is None:
+        args.commit = get_vscode_commit_from_code_version()
+        if args.commit is None:
+            logger.info(
+                "Cannot determine commit from `code --version`, please specify --commit manually."
+            )
+            raise ValueError("Please specify --commit when installing.")
+
+    download_vscode_server(
+        args.commit,
+        output=args.installer / f"cli-{args.commit}",
+        target_platform=args.target_platform,
+    )
+    extensions_config = Path(args.extensions_config).expanduser()
+    download_vscode_extensions(
+        extensions_config, args.target_platform, args.installer / "extensions"
+    )
+
+
+def cmd_install_server(args: Namespace) -> None:
+    host_platform = get_host_platform()
+    if args.commit is None:
+        try:
+            args.commit = get_vscode_commit_from_installer(
+                args.installer, host_platform
+            )
+        except Exception as e:
+            raise ValueError(
+                f"{e}, please specify `--commit` when installing."
+            ) from None
+
+    install_vscode_server(
+        args.commit,
+        cli_installer=args.installer / f"cli-{args.commit}",
+        vscode_cli_bin=get_vscode_cli_bin(args.commit),
+        platform=host_platform,
+    )
+    vscode_server_home = get_vscode_server_home(args.commit)
+    install_vscode_extensions(
+        Path(vscode_server_home) / "bin/code-server",
+        vsix_dir=args.installer / "extensions",
+        platform=host_platform,
+        exclude=SERVER_EXCLUDE_EXTENSIONS,
+    )
+
+
+def cmd_download_extensions(args: Namespace) -> None:
+    extensions_config = Path(args.extensions_config).expanduser()
+    download_vscode_extensions(
+        extensions_config, args.target_platform, args.installer / "extensions"
+    )
+
+
+def cmd_install_extensions(args: Namespace) -> None:
+    host_platform = get_host_platform()
+    install_vscode_extensions(
+        os.fspath("code"),
+        vsix_dir=args.installer / "extensions",
+        platform=host_platform,
+    )
+
+
+def make_argparser() -> ArgumentParser:
+    parent_parser = ArgumentParser(add_help=False)
+
+    parent_parser.add_argument(
+        "--installer",
+        type=Path,
+        default="./vscode-offline-installer",
+        help="The output directory for downloaded files. Also used as the installer directory.",
+    )
+
+    parser = ArgumentParser()
+    subparsers = parser.add_subparsers(required=True)
+
+    download_server_parser = subparsers.add_parser(
+        "download-server",
+        help="Download VS Code Server and extensions",
+        parents=[parent_parser],
+    )
+    download_server_parser.set_defaults(func=cmd_download_server)
+    download_server_parser.add_argument(
+        "--commit",
+        type=str,
+        help="The commit hash of the VS Code Server to download, must match the version of the VSCode client.",
+    )
+    download_server_parser.add_argument(
+        "--target-platform",
+        type=str,
+        required=True,
+        help="The target platform of the VS Code Server to download.",
+    )
+    download_server_parser.add_argument(
+        "--extensions-config",
+        type=Path,
+        default=get_vscode_extensions_config(),
+        help="Path to the extensions configuration file. Will search for extensions to download.",
+    )
+
+    install_server_parser = subparsers.add_parser(
+        "install-server",
+        help="Install VS Code Server and extensions",
+        parents=[parent_parser],
+    )
+    install_server_parser.set_defaults(func=cmd_install_server)
+    install_server_parser.add_argument(
+        "--commit",
+        type=str,
+        help="The commit hash of the VS Code Server to install.",
+    )
+
+    download_extensions_parser = subparsers.add_parser(
+        "download-extensions",
+        help="Download VS Code Server and extensions",
+        parents=[parent_parser],
+    )
+    download_extensions_parser.set_defaults(func=cmd_download_extensions)
+    download_extensions_parser.add_argument(
+        "--target-platform",
+        type=str,
+        required=True,
+        help="The target platform of the VSCode extensions to download.",
+    )
+    download_extensions_parser.add_argument(
+        "--extensions-config",
+        type=Path,
+        default=get_vscode_extensions_config(),
+        help="Path to the extensions configuration file. Will search for extensions to download.",
+    )
+
+    install_extensions_parser = subparsers.add_parser(
+        "install-extensions",
+        help="Install VSCode extensions",
+        parents=[parent_parser],
+    )
+    install_extensions_parser.set_defaults(func=cmd_install_extensions)
+    download_extensions_parser.add_argument(
+        "--code",
+        type=str,
+        default="code",
+        help="Path to the `code` binary.",
+    )
+
+    return parser
+
+
+def main() -> None:
+    logging.basicConfig(level=logging.INFO)
+    parser = make_argparser()
+    args = parser.parse_args()
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()

{vscode_offline-0.1.0 → vscode_offline-0.1.2}/src/vscode_offline/download.py

@@ -7,13 +7,14 @@ from urllib.error import HTTPError
 from urllib.request import urlopen
 
 from vscode_offline.loggers import logger
+from vscode_offline.utils import get_cli_os_arch
 
 
 def _download_file(url: str, filename: str) -> None:
     with urlopen(url) as resp:
         content_encoding = resp.headers.get("Content-Encoding")
         if content_encoding in {"gzip", "deflate"}:
-            logger.info(f"Content encoding is {content_encoding}, using GzipFile")
+            logger.info(f"Content-Encoding is {content_encoding}, using GzipFile")
             reader = GzipFile(fileobj=resp)
         elif not content_encoding:
             reader = resp
@@ -32,7 +33,11 @@ def download_file(
     url: str,
     filename: str,
 ) -> None:
-    logger.info(f"Downloading {filename}")
+    if os.path.exists(filename):
+        logger.info(f"File {filename} already exists, skipping download.")
+        return
+
+    logger.info(f"Downloading {url}")
     tmp_filename = f"{filename}.tmp"
 
     for i in range(3):
@@ -86,21 +91,27 @@ def download_vscode_extensions(
             if e.code != 404:
                 raise
             download_extension(publisher, name, version, output=output)
-        logger.info("============================================")
 
 
 def download_vscode_server(
-    commit: str, output: str, target_platform: str, cli_os: str
+    commit: str,
+    output: str,
+    target_platform: str,
 ) -> None:
+    """Download VS Code Server and CLI for the given commit and target platform.
+
+    See Also:
+        https://www.cnblogs.com/michaelcjl/p/18262833
+        https://blog.csdn.net/qq_69668825/article/details/144224417
+    """
     os.makedirs(output, exist_ok=True)
     download_file(
-        f"https://vscode.download.prss.microsoft.com/dbazure/download/stable/{commit}/vscode-server-linux-x64.tar.gz",
-        f"{output}/vscode-server-linux-x64.tar.gz",
+        f"https://update.code.visualstudio.com/commit:{commit}/server-{target_platform}/stable",
+        f"{output}/vscode-server-{target_platform}.tar.gz",
     )
-    logger.info("============================================")
-    cli_os_ = cli_os.replace("-", "_")
+    target_os_arch = get_cli_os_arch(target_platform)
+    target_os_arch_ = target_os_arch.replace("-", "_")
     download_file(
-        f"https://vscode.download.prss.microsoft.com/dbazure/download/stable/{commit}/vscode_{cli_os_}_cli.tar.gz",
-        f"{output}/vscode_{cli_os_}_cli.tar.gz",
+        f"https://update.code.visualstudio.com/commit:{commit}/cli-{target_os_arch}/stable",
+        f"{output}/vscode_cli_{target_os_arch_}_cli.tar.gz",
     )
-    logger.info("============================================")

vscode_offline-0.1.2/src/vscode_offline/install.py

@@ -0,0 +1,99 @@
+from __future__ import annotations
+
+import os
+import subprocess
+from collections.abc import Set as AbstractSet
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+from vscode_offline.loggers import logger
+from vscode_offline.utils import get_cli_os_arch, get_vscode_server_home
+
+# These extensions are excluded because they are not needed in a VS Code Server.
+SERVER_EXCLUDE_EXTENSIONS = frozenset(
+    [
+        "ms-vscode-remote.remote-ssh",
+        "ms-vscode-remote.remote-ssh-edit",
+        "ms-vscode-remote.remote-wsl",
+        "ms-vscode-remote.remote-containers",
+        "ms-vscode.remote-explorer",
+        "ms-vscode-remote.vscode-remote-extensionpack",
+        "ms-vscode.remote-server",
+    ]
+)
+
+
+def get_extension_identifier(filename: str) -> str:
+    filename = os.path.splitext(filename)[0]
+    identifier_version = filename.rsplit("@", maxsplit=1)[0]
+    extension_identifier = identifier_version.rsplit("-", maxsplit=1)[0]
+    return extension_identifier
+
+
+def get_extension_target_platform(filename: str) -> str | None:
+    filename = os.path.splitext(filename)[0]
+    parts = filename.rsplit("@", maxsplit=1)
+    if len(parts) != 2:
+        return None
+    return parts[1]
+
+
+def install_vscode_extensions(
+    vscode_bin: str | os.PathLike[str],
+    vsix_dir: str,
+    platform: str,
+    exclude: AbstractSet[str] = frozenset(),
+) -> None:
+    for vsix_file in Path(vsix_dir).glob("*.vsix"):
+        extension_identifier = get_extension_identifier(vsix_file.name)
+        if extension_identifier in exclude:
+            logger.info(f"Skipping excluded extension {extension_identifier}")
+            continue
+        # Skip extensions that are not for the current platform
+        extension_target_platform = get_extension_target_platform(vsix_file.name)
+        if (
+            extension_target_platform is not None
+            and extension_target_platform != platform
+        ):
+            logger.info(
+                f"Skipping extension {extension_identifier} for platform {extension_target_platform}"
+            )
+            continue
+        logger.info(f"Installing {vsix_file}")
+        subprocess.check_call([vscode_bin, "--install-extension", vsix_file, "--force"])
+        logger.info(f"Installed {vsix_file}")
+
+
+def install_vscode_server(
+    commit: str,
+    cli_installer: str,
+    vscode_cli_bin: os.PathLike[str],
+    platform: str,
+) -> None:
+    cli_os = get_cli_os_arch(platform)
+    cli_os_ = cli_os.replace("-", "_")
+
+    vscode_cli_tarball = Path(cli_installer) / f"vscode_cli_{cli_os_}_cli.tar.gz"
+    with TemporaryDirectory() as tmpdir:
+        subprocess.check_call(["tar", "-xzf", vscode_cli_tarball, "-C", tmpdir])
+        tmpfile = Path(tmpdir) / "code"
+        if os.path.exists(vscode_cli_bin):
+            os.remove(vscode_cli_bin)
+        os.makedirs(os.path.dirname(vscode_cli_bin), exist_ok=True)
+        os.rename(tmpfile, vscode_cli_bin)
+    logger.info(f"Extracted vscode_cli_{cli_os_}_cli.tar.gz to {vscode_cli_bin}")
+
+    vscode_server_tarball = Path(cli_installer) / f"vscode-server-{platform}.tar.gz"
+    vscode_server_home = get_vscode_server_home(commit)
+    os.makedirs(vscode_server_home, exist_ok=True)
+    subprocess.check_call(
+        [
+            "tar",
+            "-xzf",
+            vscode_server_tarball,
+            "-C",
+            vscode_server_home,
+            "--strip-components=1",
+        ]
+    )
+    logger.info(f"Extracted vscode-server-{platform}.tar.gz to {vscode_server_home}")

vscode_offline-0.1.2/src/vscode_offline/utils.py

@@ -0,0 +1,92 @@
+from __future__ import annotations
+
+import os
+import subprocess
+from pathlib import Path
+
+from vscode_offline.loggers import logger
+
+_vscode_data = Path("~/.vscode").expanduser()
+_vscode_server_data = Path("~/.vscode-server").expanduser()
+
+
+def get_vscode_cli_bin(commit: str) -> os.PathLike[str]:
+    return _vscode_server_data / f"code-{commit}"
+
+
+def get_vscode_server_home(commit: str) -> os.PathLike[str]:
+    return _vscode_server_data / f"cli/servers/Stable-{commit}/server"
+
+
+def get_vscode_extensions_config() -> os.PathLike[str]:
+    p = _vscode_data / "extensions/extensions.json"
+    if p.exists():
+        return p
+    s = _vscode_server_data / "extensions/extensions.json"
+    if s.exists():
+        return s
+    return p  # default to this path
+
+
+def get_vscode_commit_from_installer(installer: os.PathLike[str], platform: str) -> str:
+    directories = list(Path(installer).glob(f"cli-*/vscode-server-{platform}.tar.gz"))
+    if len(directories) > 1:
+        raise ValueError(
+            f"Multiple matching installers found in {installer} for platform {platform}"
+        )
+    elif len(directories) == 0:
+        raise ValueError(
+            f"No matching installer found in {installer} for platform {platform}"
+        )
+
+    commit = directories[0].parent.name[len("cli-") :]
+    logger.info(f"Getting commit from {platform} installer: {commit}")
+    return commit
+
+
+def get_vscode_commit_from_code_version() -> str | None:
+    res = subprocess.run(["code", "--version"], stdout=subprocess.PIPE)
+    if res.returncode != 0:
+        return None
+    lines = res.stdout.splitlines()
+    if len(lines) < 2:
+        return None  # Unexpected output
+
+    # The commit hash is usually on the second line
+    commit = lines[1].strip().decode("utf-8")
+    logger.info(f"Getting commit from `code --version`: {commit}")
+
+    return lines[1].strip().decode("utf-8")
+
+
+def get_target_platform_from_installer(cli_installer: str) -> str | None:
+    directories = list(Path(cli_installer).glob("vscode-server-*.tar.gz"))
+    if len(directories) == 1:
+        return directories[0].name[len("vscode-server-") : -len(".tar.gz")]
+    return None
+
+
+# Mapping from target platform to CLI OS and architecture used in download URLs
+_cli_os_arch_mapping = {
+    "linux-x64": "alpine-x64",
+    "linux-arm64": "alpine-arm64",
+}
+
+
+def get_cli_os_arch(platform: str) -> str:
+    """Get the CLI OS and architecture for the given target platform."""
+    if platform not in _cli_os_arch_mapping:
+        raise ValueError(f"Unsupported target platform: {platform}")
+    return _cli_os_arch_mapping[platform]
+
+
+def get_host_platform() -> str:
+    """Get the host platform in the format used by VS Code Server install."""
+    (osname, _, _, _, machine) = os.uname()
+
+    if osname.lower() == "linux":
+        if machine in ("x86_64", "amd64"):
+            return "linux-x64"
+        elif machine in ("aarch64", "arm64"):
+            return "linux-arm64"
+    raise ValueError(f"Unsupported host platform: {osname}-{machine}")

vscode_offline-0.1.0/PKG-INFO

@@ -1,50 +0,0 @@
-Metadata-Version: 2.3
-Name: vscode-offline
-Version: 0.1.0
-Summary: Download and install vscode server for offline environments
-Author: Chuck Fan
-Author-email: Chuck Fan <fanck0605@qq.com>
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-
-# vscode-offline
-
-vscode-offline 主要用于在无网环境下安装 VSCode Server，方便使用 *Remote - SSH* 插件进行远程开发。
-
-## 安装
-
-```shell
-pip install -U vscode-offline
-```
-
-## 用法
-
-（1）在联网环境安装好 VSCode 和你需要的插件。
-
-（2）联网环境执行如下命令，将会自动下载当前 VSCode 所有的插件
-
-> `--commit` 为对应 VSCode 的 Commit 号，*帮助* -> *关于* -> *Commit*
-
-```shell
-vscode-offline download \
-    --commit 385651c938df8a906869babee516bffd0ddb9829 \
-    --target-platform linux-x64 \
-    --installer ./vscode-offline-installer
-```
-
-（3）复制 `vscode-offline-installer` 到内网服务器
-
-```shell
-vscode-offline install \
-    --commit 385651c938df8a906869babee516bffd0ddb9829 \
-    --target-platform linux-x64 \
-    --installer ./vscode-offline-installer
-```
-
-## 贡献
-
-欢迎提交 Issue 和 PR 改进本项目。
-
-## 许可证
-
-[MIT License](./LICENSE)

vscode_offline-0.1.0/README.md

@@ -1,41 +0,0 @@
-# vscode-offline
-
-vscode-offline 主要用于在无网环境下安装 VSCode Server，方便使用 *Remote - SSH* 插件进行远程开发。
-
-## 安装
-
-```shell
-pip install -U vscode-offline
-```
-
-## 用法
-
-（1）在联网环境安装好 VSCode 和你需要的插件。
-
-（2）联网环境执行如下命令，将会自动下载当前 VSCode 所有的插件
-
-> `--commit` 为对应 VSCode 的 Commit 号，*帮助* -> *关于* -> *Commit*
-
-```shell
-vscode-offline download \
-    --commit 385651c938df8a906869babee516bffd0ddb9829 \
-    --target-platform linux-x64 \
-    --installer ./vscode-offline-installer
-```
-
-（3）复制 `vscode-offline-installer` 到内网服务器
-
-```shell
-vscode-offline install \
-    --commit 385651c938df8a906869babee516bffd0ddb9829 \
-    --target-platform linux-x64 \
-    --installer ./vscode-offline-installer
-```
-
-## 贡献
-
-欢迎提交 Issue 和 PR 改进本项目。
-
-## 许可证
-
-[MIT License](./LICENSE)

vscode_offline-0.1.0/pyproject.toml

@@ -1,28 +0,0 @@
-[project]
-name = "vscode-offline"
-version = "0.1.0"
-description = "Download and install vscode server for offline environments"
-readme = "README.md"
-authors = [
-    { name = "Chuck Fan", email = "fanck0605@qq.com" }
-]
-requires-python = ">=3.9"
-dependencies = []
-
-[project.scripts]
-vscode-offline = "vscode_offline:main"
-
-[build-system]
-requires = ["uv-build"]
-build-backend = "uv_build"
-
-[dependency-groups]
-dev = [
-    "ruff>=0.13.3",
-]
-
-[tool.ruff.lint]
-select = [
-    "I", # isort
-    "F", # Pyflakes
-]

vscode_offline-0.1.0/src/vscode_offline/app.py

@@ -1,104 +0,0 @@
-from __future__ import annotations
-
-import logging
-from argparse import ArgumentParser, Namespace
-from pathlib import Path
-
-from vscode_offline.download import download_vscode_extensions, download_vscode_server
-from vscode_offline.install import install_vscode_extensions, install_vscode_server
-from vscode_offline.paths import (
-    get_vscode_cli_bin,
-    get_vscode_extensions_config,
-    get_vscode_server_home,
-)
-
-cli_os_mapping = {
-    "linux-x64": "cli-alpine-x64",
-}
-
-
-def download(args: Namespace) -> None:
-    download_vscode_server(
-        args.commit,
-        output=args.installer / f"cli-{args.commit}",
-        target_platform=args.target_platform,
-        cli_os=cli_os_mapping[args.target_platform],
-    )
-    extensions_config = Path(args.extensions_config).expanduser()
-    download_vscode_extensions(
-        extensions_config, args.target_platform, args.installer / "extensions"
-    )
-
-
-def install(args: Namespace) -> None:
-    install_vscode_server(
-        args.commit,
-        installer=args.installer / f"cli-{args.commit}",
-        vscode_cli_bin=get_vscode_cli_bin(args.commit),
-        target_platform=args.target_platform,
-        cli_os=cli_os_mapping[args.target_platform],
-    )
-    vscode_server_home = get_vscode_server_home(args.commit)
-    install_vscode_extensions(
-        Path(vscode_server_home) / "bin/code-server",
-        vsix_dir=args.installer / "extensions",
-    )
-
-
-def make_argparser() -> ArgumentParser:
-    parent_parser = ArgumentParser(add_help=False)
-
-    parent_parser.add_argument(
-        "--commit",
-        type=str,
-        required=True,
-        help="The commit hash of the VSCode server to download, must match the version of the VSCode client.",
-    )
-    parent_parser.add_argument(
-        "--target-platform",
-        type=str,
-        default="linux-x64",
-        help="The target platform for the VSCode server.",
-    )
-    parent_parser.add_argument(
-        "--installer",
-        type=Path,
-        default="./vscode-offline-installer",
-        help="The output directory for downloaded files. Also used as the installer directory.",
-    )
-
-    parser = ArgumentParser()
-    subparsers = parser.add_subparsers(required=True)
-
-    download_parser = subparsers.add_parser(
-        "download",
-        help="Download VSCode server and extensions",
-        parents=[parent_parser],
-    )
-    download_parser.set_defaults(func=download)
-    download_parser.add_argument(
-        "--extensions-config",
-        type=Path,
-        default=get_vscode_extensions_config(),
-        help="Path to the extensions configuration file. Will search for extensions to download.",
-    )
-
-    install_parsers = subparsers.add_parser(
-        "install",
-        help="Install VSCode server and extensions",
-        parents=[parent_parser],
-    )
-    install_parsers.set_defaults(func=install)
-
-    return parser
-
-
-def main() -> None:
-    logging.basicConfig(level=logging.INFO)
-    parser = make_argparser()
-    args = parser.parse_args()
-    args.func(args)
-
-
-if __name__ == "__main__":
-    main()

vscode_offline-0.1.0/src/vscode_offline/install.py

@@ -1,74 +0,0 @@
-from __future__ import annotations
-
-import os
-import subprocess
-from pathlib import Path
-from tempfile import TemporaryDirectory
-
-from vscode_offline.loggers import logger
-from vscode_offline.paths import get_vscode_server_home
-
-EXCLUDE_EXTENSIONS = {
-    "ms-vscode-remote.remote-ssh",
-    "ms-vscode-remote.remote-ssh-edit",
-    "ms-vscode-remote.remote-wsl",
-    "ms-vscode-remote.remote-containers",
-    "ms-vscode.remote-explorer",
-    "ms-vscode-remote.vscode-remote-extensionpack",
-    "ms-vscode.remote-server",
-}
-
-
-def get_extension_identifier(filename: str) -> str:
-    filename = os.path.splitext(filename)[0]
-    identifier_version = filename.rsplit("@", maxsplit=1)[0]
-    extension_identifier = identifier_version.rsplit("-", maxsplit=1)[0]
-    return extension_identifier
-
-
-def install_vscode_extensions(vscode_bin: os.PathLike[str], vsix_dir: str) -> None:
-    for vsix_file in Path(vsix_dir).glob("*.vsix"):
-        extension_identifier = get_extension_identifier(vsix_file.name)
-        if extension_identifier in EXCLUDE_EXTENSIONS:
-            logger.info(f"Skipping excluded extension {extension_identifier}")
-            continue
-        logger.info(f"Installing {vsix_file}")
-        subprocess.check_call([vscode_bin, "--install-extension", vsix_file, "--force"])
-        logger.info(f"Installed {vsix_file}")
-
-
-def install_vscode_server(
-    commit: str,
-    installer: str,
-    vscode_cli_bin: os.PathLike[str],
-    target_platform: str,
-    cli_os: str,
-) -> None:
-    cli_os_ = cli_os.replace("-", "_")
-
-    vscode_cli_tarball = Path(installer) / f"vscode_{cli_os_}_cli.tar.gz"
-    with TemporaryDirectory() as tmpdir:
-        subprocess.check_call(["tar", "-xzf", vscode_cli_tarball, "-C", tmpdir])
-        tmpfile = Path(tmpdir) / "code"
-        if os.path.exists(vscode_cli_bin):
-            os.remove(vscode_cli_bin)
-        os.makedirs(os.path.dirname(vscode_cli_bin), exist_ok=True)
-        os.rename(tmpfile, vscode_cli_bin)
-    logger.info(f"Extracted vscode_{cli_os_}_cli.tar.gz to {vscode_cli_bin}")
-
-    vscode_server_tarball = Path(installer) / f"vscode-server-{target_platform}.tar.gz"
-    vscode_server_home = get_vscode_server_home(commit)
-    os.makedirs(vscode_server_home, exist_ok=True)
-    subprocess.check_call(
-        [
-            "tar",
-            "-xzf",
-            vscode_server_tarball,
-            "-C",
-            vscode_server_home,
-            "--strip-components=1",
-        ]
-    )
-    logger.info(
-        f"Extracted vscode-server-{target_platform}.tar.gz to {vscode_server_home}"
-    )

vscode_offline-0.1.0/src/vscode_offline/paths.py

@@ -1,25 +0,0 @@
-from __future__ import annotations
-
-import os
-from pathlib import Path
-
-VSCODE_DATA = Path("~/.vscode").expanduser()
-VSCODE_SERVER_DATA = Path("~/.vscode-server").expanduser()
-
-
-def get_vscode_cli_bin(commit: str) -> os.PathLike[str]:
-    return VSCODE_SERVER_DATA / f"code-{commit}"
-
-
-def get_vscode_server_home(commit: str) -> os.PathLike[str]:
-    return VSCODE_SERVER_DATA / f"cli/servers/Stable-{commit}/server"
-
-
-def get_vscode_extensions_config() -> os.PathLike[str]:
-    p = VSCODE_DATA / "extensions/extensions.json"
-    if p.exists():
-        return p
-    s = VSCODE_SERVER_DATA / "extensions/extensions.json"
-    if s.exists():
-        return s
-    return p  # default to this path