vscode-offline 0.1.3__tar.gz → 0.1.5__tar.gz

vscode_offline-0.1.5/.editorconfig

@@ -0,0 +1,16 @@
+root = true
+
+[*]
+indent_style = space
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+# Disable rules for VS Code settings files
+[.vscode/**]
+indent_style = unset
+charset = unset
+end_of_line = unset
+trim_trailing_whitespace = unset
+insert_final_newline = unset

vscode_offline-0.1.5/.github/workflows/publish.yml

@@ -0,0 +1,50 @@
+name: Publish
+
+on:
+  push:
+    branches:
+      - "**"
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write # IMPORTANT: this permission is mandatory for uploading release assets
+      id-token: write # IMPORTANT: this permission is mandatory for trusted publishing
+
+    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: Build distribution
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: vscode-offline
+          path: |
+            dist/vscode_offline-*.tar.gz
+            dist/vscode_offline-*.whl
+
+      - name: Upload release assets
+        uses: softprops/action-gh-release@v2
+        if: startsWith(github.ref, 'refs/tags/v')
+        with:
+          files: |
+            dist/vscode_offline-*.tar.gz
+            dist/vscode_offline-*.whl
+
+      - name: Publish release to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.13.0
+        if: startsWith(github.ref, 'refs/tags/v')

vscode_offline-0.1.5/.github/workflows/test.yml

@@ -0,0 +1,38 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - "**"
+    tags:
+      - "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

vscode_offline-0.1.5/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+.ruff_cache/
+
+# Virtual environments
+.venv
+
+# VS Code offline installer directory
+vscode-offline-installer/

vscode_offline-0.1.5/.python-version

@@ -0,0 +1 @@
+3.9

vscode_offline-0.1.5/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  "recommendations": [
+    "ms-python.python",
+    "charliermarsh.ruff",
+    "editorconfig.editorconfig",
+    "redhat.vscode-yaml",
+    "github.vscode-github-actions"
+  ]
+}

vscode_offline-0.1.5/.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "[python]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.codeActionsOnSave": {
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit"
+    }
+  },
+  "python.testing.pytestArgs": [
+    "tests"
+  ],
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestEnabled": true
+}

{vscode_offline-0.1.3 → vscode_offline-0.1.5}/PKG-INFO

@@ -1,25 +1,24 @@
 Metadata-Version: 2.4
 Name: vscode-offline
-Version: 0.1.3
+Version: 0.1.5
 Summary: Download and install VS Code Server for offline environments
-Author: Chuck Fan
+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: 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
@@ -37,38 +36,40 @@ pip install -U vscode-offline
 1. 自动识别并下载所有 `.vsix` 文件（包括间接依赖）
 2. 一键安装 VS Code Server 以及所有插件
 
-## VS Code Server 安装
+## VS Code 离线安装
 
-（1）在联网环境安装好 VSCode 和你需要的插件。
+（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 Server，和目前安装的所有的插件
+（2）执行如下命令，下载 VS Code 安装包，和目前安装的所有的插件
 
-> `--commit` 可以指定对应 VSCode 的 Commit，默认自动获取当前环境 VSCode 的 Commit。
->
-> 手动查看方式：*帮助* -> *关于* -> *Commit*，
+```shell
+vscode-offline download-all --installer ./vscode-offline-installer
+```
+
+（3）复制 `./vscode-offline-installer` 到内网 Windows 机器，安装 `client-<version>` 下的 VS Code，然后执行如下命令安装所有插件
 
 ```shell
-vscode-offline download-server --target-platform linux-x64 --installer ./vscode-offline-installer
+vscode-offline install-extensions --installer ./vscode-offline-installer
 ```
 
-（3）复制 `./vscode-offline-installer` 到内网服务器
+（4）复制 `./vscode-offline-installer` 到内网 Linux 服务器，执行如下命令安装 VS Code Server 和所有插件
 
 ```shell
 vscode-offline install-server --installer ./vscode-offline-installer
 ```
 
-## VS Code 插件安装
+## 指定 VS Code 版本号
 
-（1）联网环境执行如下命令，将会自动下载 VSCode 目前安装的所有的插件
+如果你想下载或安装指定版本的 VS Code，可以先通过 `code --version` 获取当前版本，然后通过 --code-version 参数指定版本号，例如：
 
 ```shell
-vscode-offline download-extensions --target-platform win32-x64 --installer ./vscode-offline-installer
+vscode-offline download-all --code-version 1.104.3
 ```
 
-（2）复制 `./vscode-offline-installer` 到内网机器
+也支持使用 commit hash 作为版本号，例如：
 
 ```shell
-vscode-offline install-extensions --installer ./vscode-offline-installer
+vscode-offline download-all --code-version commit:385651c938df8a906869babee516bffd0ddb9829
 ```
 
 ## 贡献

vscode_offline-0.1.5/README.md

@@ -0,0 +1,60 @@
+# 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.5/lefthook.yml

@@ -0,0 +1,15 @@
+lefthook: uv run lefthook
+
+pre-commit:
+  jobs:
+    - run: ruff check --fix {staged_files}
+      glob: "*.py"
+      stage_fixed: true
+
+    - run: pyright {staged_files}
+      glob: "*.py"
+      stage_fixed: true
+
+    - run: ruff format {staged_files}
+      glob: "*.py"
+      stage_fixed: true

{vscode_offline-0.1.3 → vscode_offline-0.1.5}/pyproject.toml

@@ -1,11 +1,13 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
 [project]
 name = "vscode-offline"
-version = "0.1.3"
+dynamic = ["version"]
 description = "Download and install VS Code Server for offline environments"
 readme = "README.md"
-authors = [
-    { name = "Chuck Fan", email = "fanck0605@qq.com" }
-]
+authors = [{ name = "Chuck Fan", email = "fanck0605@qq.com" }]
 requires-python = ">=3.9"
 license = "MIT"
 license-files = ["LICENSE"]
@@ -31,19 +33,21 @@ 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",
     "pyright>=1.1.406",
+    "pytest>=8.4.2",
+    "pytest-cov>=7.0.0",
     "ruff>=0.13.3",
 ]
 
+[tool.hatch.version]
+source = "vcs"
+
 [tool.ruff.lint]
 select = [
-    "I", # isort
-    "F", # Pyflakes
+    "ANN", # flake8-annotations
+    "I",   # isort
+    "F",   # Pyflakes
 ]

vscode_offline-0.1.5/pyrightconfig.json

@@ -0,0 +1,3 @@
+{
+    "typeCheckingMode": "strict"
+}

vscode_offline-0.1.5/src/vscode_offline/app.py

@@ -0,0 +1,281 @@
+from __future__ import annotations
+
+import logging
+from argparse import ArgumentParser, Namespace
+from pathlib import Path
+
+from vscode_offline.download import (
+    download_vscode_client,
+    download_vscode_extensions,
+    download_vscode_server,
+)
+from vscode_offline.install import (
+    SERVER_EXCLUDE_EXTENSIONS,
+    install_vscode_extensions,
+    install_vscode_server,
+)
+from vscode_offline.utils import (
+    get_default_code_version,
+    get_host_platform,
+    get_vscode_extensions_config,
+    get_vscode_version_from_server_installer,
+)
+
+
+def cmd_download_server(args: Namespace) -> None:
+    if args.code_version is None:
+        args.code_version = get_default_code_version()
+        if args.code_version is None:
+            raise ValueError(
+                "Cannot determine version from `code --version`, please specify `--version` when downloading."
+            )
+
+    download_vscode_server(
+        args.code_version,
+        output=args.installer / f"server-{args.code_version.replace(':', '-')}",
+        platform=args.platform,
+    )
+    extensions_config = Path(args.extensions_config).expanduser()
+    download_vscode_extensions(
+        extensions_config,
+        target_platforms=[args.platform],
+        output=args.installer / "extensions",
+    )
+
+
+def cmd_install_server(args: Namespace) -> None:
+    host_platform = get_host_platform()
+    if args.code_version is None:
+        try:
+            args.code_version = get_vscode_version_from_server_installer(
+                args.installer, host_platform
+            )
+        except Exception as e:
+            raise ValueError(
+                f"{e}, please specify `--version` when installing."
+            ) from None
+
+    vscode_server_home = install_vscode_server(
+        server_installer=args.installer / f"server-{args.code_version}",
+        platform=host_platform,
+    )
+    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,
+        target_platforms=[args.platform],
+        output=args.installer / "extensions",
+    )
+
+
+def cmd_install_extensions(args: Namespace) -> None:
+    host_platform = get_host_platform()
+    install_vscode_extensions(
+        args.code,
+        vsix_dir=args.installer / "extensions",
+        platform=host_platform,
+    )
+
+
+def cmd_download_client(args: Namespace) -> None:
+    if args.code_version is None:
+        args.code_version = get_default_code_version()
+        if args.code_version is None:
+            raise ValueError(
+                "Cannot determine version from `code --version`, please specify `--version` manually."
+            )
+
+    download_vscode_client(
+        args.code_version,
+        output=args.installer / f"client-{args.code_version.replace(':', '-')}",
+        platform=args.platform,
+    )
+    extensions_config = Path(args.extensions_config).expanduser()
+    download_vscode_extensions(
+        extensions_config,
+        target_platforms=[args.platform],
+        output=args.installer / "extensions",
+    )
+
+
+def cmd_download_all(args: Namespace) -> None:
+    if args.code_version is None:
+        args.code_version = get_default_code_version()
+        if args.code_version is None:
+            raise ValueError(
+                "Cannot determine version from `code --version`, please specify `--version` manually."
+            )
+
+    download_vscode_server(
+        args.code_version,
+        output=args.installer / f"server-{args.code_version.replace(':', '-')}",
+        platform=args.server_platform,
+    )
+    download_vscode_client(
+        args.code_version,
+        output=args.installer / f"client-{args.code_version.replace(':', '-')}",
+        platform=args.client_platform,
+    )
+    extensions_config = Path(args.extensions_config).expanduser()
+    download_vscode_extensions(
+        extensions_config,
+        target_platforms=[args.server_platform, args.client_platform],
+        output=args.installer / "extensions",
+    )
+
+
+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(
+        "--code-version",
+        type=str,
+        help="The version of the VS Code Server to download, must match the version of the VS Code Client.",
+    )
+    download_server_parser.add_argument(
+        "--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(
+        "--code-version",
+        type=str,
+        help="The version 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(
+        "--platform",
+        type=str,
+        required=True,
+        help="The target platform of the VS Code 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 VS Code extensions",
+        parents=[parent_parser],
+    )
+    install_extensions_parser.set_defaults(func=cmd_install_extensions)
+    install_extensions_parser.add_argument(
+        "--code",
+        type=str,
+        default="code",
+        help="Path to the `code` binary.",
+    )
+
+    download_client_parser = subparsers.add_parser(
+        "download-client",
+        help="Download VS Code and extensions",
+        parents=[parent_parser],
+    )
+    download_client_parser.set_defaults(func=cmd_download_client)
+    download_client_parser.add_argument(
+        "--code-version",
+        type=str,
+        help="The version of the VS Code to download, must match the version of the VS Code Client.",
+    )
+    download_client_parser.add_argument(
+        "--platform",
+        type=str,
+        required=True,
+        help="The target platform of the VS Code to download.",
+    )
+    download_client_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.",
+    )
+
+    download_all_parser = subparsers.add_parser(
+        "download-all",
+        help="Download VS Code server, client and extensions, all in one command",
+        parents=[parent_parser],
+    )
+    download_all_parser.set_defaults(func=cmd_download_all)
+    download_all_parser.add_argument(
+        "--code-version",
+        type=str,
+        help="The version of the VS Code to download, defaults to `code --version` at current environment.",
+    )
+    download_all_parser.add_argument(
+        "--server-platform",
+        type=str,
+        default="linux-x64",
+        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",
+        help="The target platform of the VS Code to download, defaults to win32-x64.",
+    )
+    download_all_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.",
+    )
+
+    return parser
+
+
+def main() -> None:
+    logging.basicConfig(level=logging.INFO)
+    parser = make_argparser()
+    args = parser.parse_args()
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()