opsscript-gate 0.6.2__tar.gz → 0.6.3__tar.gz

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/.github/workflow-templates/opsscript-gate.yml

@@ -25,7 +25,7 @@ jobs:
           persist-credentials: false
 
       - name: Run OpsScript Gate
-        uses: Mresyzz/opsscript-gate@v0.6.2
+        uses: Mresyzz/opsscript-gate@v0.6.3
         with:
           shell: auto
           network: none

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.6.3] - 2026-10-01
+
+### Added
+- Added `opsscript-gate doctor` to diagnose Python and Docker prerequisites before a local run.
+
+### Changed
+- Expanded package and Marketplace keywords for shell installers, ShellCheck users, portability, and BusyBox.
+- Clarified the Action description around shell installer runtime compatibility.
+
 ## [0.6.2] - 2026-10-01
 
 ### Changed

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/CITATION.cff

@@ -5,8 +5,8 @@ type: software
 authors:
   - family-names: Mresyzz
     given-names: Mresy
-version: 0.6.2
-date-released: 2026-09-30
+version: 0.6.3
+date-released: 2026-10-01
 repository-code: https://github.com/Mresyzz/opsscript-gate
 url: https://github.com/Mresyzz/opsscript-gate
 license: MIT

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: opsscript-gate
-Version: 0.6.2
+Version: 0.6.3
 Summary: Run Linux shell scripts in Debian, Ubuntu and Alpine containers to catch runtime compatibility failures before merge
 Project-URL: Homepage, https://mresyzz.github.io/InstallReady/
 Project-URL: Demo, https://mresyzz.github.io/InstallReady/?repo=Mresyzz%2Fopsscript-gate
@@ -11,7 +11,7 @@ Project-URL: Documentation, https://github.com/Mresyzz/opsscript-gate/tree/main/
 Author: Mresyzz
 License: MIT
 License-File: LICENSE
-Keywords: alpine,bootstrap,ci,compatibility,cross-distro,debian,devops,docker,github-actions,installer,linux,posix,shell,shellcheck-alternative,testing,ubuntu
+Keywords: alpine,bootstrap,busybox,ci,compatibility,cross-distro,debian,devops,docker,github-actions,installer,installer-testing,linux,posix,shell,shell-portability,shellcheck,shellcheck-alternative,testing,ubuntu
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
@@ -56,7 +56,7 @@ Try the browser scanner: [InstallReady](https://mresyzz.github.io/InstallReady/?
 
 ---
 
-## Current release: v0.6.2
+## Current release: v0.6.3
 
 The current release includes a project config file, a dry-run plan, presets, exclusions,
 saved reports, and changed-script selection for pull requests. The project controls
@@ -64,6 +64,7 @@ were introduced in v0.5.0; projects on v0.4.1 and earlier do not include them.
 
 ```bash
 opsscript-gate init
+opsscript-gate doctor
 opsscript-gate run --dry-run
 opsscript-gate run --format json --output reports/compatibility.json
 ```
@@ -71,6 +72,7 @@ opsscript-gate run --format json --output reports/compatibility.json
 `init` creates `.opsscript-gate.json` and a GitHub Actions workflow without replacing
 existing files. Review its exclusions (`tests/*`, `examples/*`) and offline network
 default before running. No Docker is required for `init` or `--dry-run`.
+Use `opsscript-gate doctor` to check Python and Docker before a real run.
 
 Useful for standalone installers, container entrypoints and release scripts that
 must work on both GNU/Linux and Alpine/BusyBox. Each script runs independently;
@@ -99,7 +101,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - uses: Mresyzz/opsscript-gate@v0.6.2
+      - uses: Mresyzz/opsscript-gate@v0.6.3
 ```
 
 This zero-configuration form discovers shell scripts in the repository. Use
@@ -110,7 +112,7 @@ repository has a single installer. For self-hosted model installers, see the
 Or test a specific script with custom execution modes:
 
 ```yaml
-      - uses: Mresyzz/opsscript-gate@v0.6.2
+      - uses: Mresyzz/opsscript-gate@v0.6.3
         with:
           script-path: scripts/install.sh
           shell: auto
@@ -141,7 +143,7 @@ unrelated scripts:
       - uses: actions/checkout@v7
         with:
           fetch-depth: 0
-      - uses: Mresyzz/opsscript-gate@v0.6.2
+      - uses: Mresyzz/opsscript-gate@v0.6.3
         with:
           changed-since: ${{ github.event.pull_request.base.sha }}
           preset: minimal
@@ -353,6 +355,12 @@ Customize the matrix at any time via `--matrix` or Action input `matrix`.
 
 ## CLI reference
 
+Check local prerequisites before starting containers:
+
+```text
+opsscript-gate doctor [--format table|json]
+```
+
 ```text
 usage: opsscript-gate run [-h] [--matrix MATRIX] [-j JOBS] [--timeout TIMEOUT]
                           [--format {table,markdown,json}]

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/README.md

@@ -26,7 +26,7 @@ Try the browser scanner: [InstallReady](https://mresyzz.github.io/InstallReady/?
 
 ---
 
-## Current release: v0.6.2
+## Current release: v0.6.3
 
 The current release includes a project config file, a dry-run plan, presets, exclusions,
 saved reports, and changed-script selection for pull requests. The project controls
@@ -34,6 +34,7 @@ were introduced in v0.5.0; projects on v0.4.1 and earlier do not include them.
 
 ```bash
 opsscript-gate init
+opsscript-gate doctor
 opsscript-gate run --dry-run
 opsscript-gate run --format json --output reports/compatibility.json
 ```
@@ -41,6 +42,7 @@ opsscript-gate run --format json --output reports/compatibility.json
 `init` creates `.opsscript-gate.json` and a GitHub Actions workflow without replacing
 existing files. Review its exclusions (`tests/*`, `examples/*`) and offline network
 default before running. No Docker is required for `init` or `--dry-run`.
+Use `opsscript-gate doctor` to check Python and Docker before a real run.
 
 Useful for standalone installers, container entrypoints and release scripts that
 must work on both GNU/Linux and Alpine/BusyBox. Each script runs independently;
@@ -69,7 +71,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - uses: Mresyzz/opsscript-gate@v0.6.2
+      - uses: Mresyzz/opsscript-gate@v0.6.3
 ```
 
 This zero-configuration form discovers shell scripts in the repository. Use
@@ -80,7 +82,7 @@ repository has a single installer. For self-hosted model installers, see the
 Or test a specific script with custom execution modes:
 
 ```yaml
-      - uses: Mresyzz/opsscript-gate@v0.6.2
+      - uses: Mresyzz/opsscript-gate@v0.6.3
         with:
           script-path: scripts/install.sh
           shell: auto
@@ -111,7 +113,7 @@ unrelated scripts:
       - uses: actions/checkout@v7
         with:
           fetch-depth: 0
-      - uses: Mresyzz/opsscript-gate@v0.6.2
+      - uses: Mresyzz/opsscript-gate@v0.6.3
         with:
           changed-since: ${{ github.event.pull_request.base.sha }}
           preset: minimal
@@ -323,6 +325,12 @@ Customize the matrix at any time via `--matrix` or Action input `matrix`.
 
 ## CLI reference
 
+Check local prerequisites before starting containers:
+
+```text
+opsscript-gate doctor [--format table|json]
+```
+
 ```text
 usage: opsscript-gate run [-h] [--matrix MATRIX] [-j JOBS] [--timeout TIMEOUT]
                           [--format {table,markdown,json}]

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/README.zh-CN.md

@@ -10,9 +10,9 @@ Bash 依赖、包管理器假设和交互式阻塞。它与 ShellCheck 互补。
 
 也可以直接打开 [InstallReady 在线扫描器](https://mresyzz.github.io/InstallReady/?repo=Mresyzz%2Fopsscript-gate)，无需登录即可检查公开仓库。
 
-## 当前版本 v0.6.2
+## 当前版本 v0.6.3
 
-v0.6.2 已作为正式版本发布；如果你要从源码验证当前分支，也可以执行：
+v0.6.3 已作为正式版本发布；如果你要从源码验证当前分支，也可以执行：
 
 ```bash
 pip install -e .
@@ -23,13 +23,15 @@ opsscript-gate run examples/basic/clean_setup.sh --dry-run
 
 ```bash
 opsscript-gate init
+opsscript-gate doctor
 opsscript-gate run --dry-run
 opsscript-gate run --format json --output reports/compatibility.json
 ```
 
-`init` 生成配置和 GitHub 工作流，不覆盖已有文件。工作流引用 `v0.6.2`。
+`init` 生成配置和 GitHub 工作流，不覆盖已有文件。工作流引用 `v0.6.3`。
 预览不需要 Docker；真实运行需要 Python 3.10+
 和可访问的 Linux Docker 引擎。
+`opsscript-gate doctor` 可以在真实运行前检查 Python 和 Docker。
 
 生成的配置默认排除 `tests/*`、`examples/*`，使用 Debian + Alpine，尊重
 脚本 shebang，并关闭网络。请根据实际脚本审核配置；需要下载文件时启用
@@ -47,13 +49,16 @@ opsscript-gate run --format json --output reports/compatibility.json
 返回码 `0` 表示全部通过，`1` 表示检查失败或发生错误。`--dry-run` 成功只表示
 执行计划生成成功。容器不是不可信代码的安全沙箱。
 
+需要排查本地环境时运行 `opsscript-gate doctor --format json`；它会检查 Python、
+Docker daemon 和可选的项目配置。
+
 在 Pull Request 中只检查本次修改的脚本，可以先获取完整 Git 历史，再传入目标分支提交：
 
 ```yaml
 - uses: actions/checkout@v7
   with:
     fetch-depth: 0
-- uses: Mresyzz/opsscript-gate@v0.6.2
+- uses: Mresyzz/opsscript-gate@v0.6.3
   with:
     changed-since: ${{ github.event.pull_request.base.sha }}
     preset: minimal

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/action.yml

@@ -1,5 +1,5 @@
 name: 'OpsScript Gate'
-description: 'Run Linux shell scripts in Debian, Ubuntu and Alpine containers to catch runtime compatibility failures before merge'
+description: 'Run Linux shell installers across Debian, Ubuntu, and Alpine; a ShellCheck companion for runtime compatibility in CI.'
 author: 'Mresyzz'
 branding:
   icon: 'shield'

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/docs/configuration.md

@@ -7,11 +7,15 @@ have these commands.
 
 ```bash
 opsscript-gate init
+opsscript-gate doctor
 opsscript-gate run --dry-run
 ```
 
 `init` refuses to overwrite either `.opsscript-gate.json` or
-`.github/workflows/opsscript-gate.yml`. The generated workflow uses the v0.6.2 tag.
+`.github/workflows/opsscript-gate.yml`. The generated workflow uses the v0.6.3 tag.
+
+`doctor` checks Python and Docker connectivity without executing repository scripts.
+Use `opsscript-gate doctor --format json` when collecting a support report.
 
 The generated config uses the two-image `minimal` preset, honors recognized shell
 shebangs, disables networking, and excludes `tests/*` and `examples/*`. Review these
@@ -95,7 +99,7 @@ For pull requests, set `changed-since` to the base commit and fetch full Git his
 - uses: actions/checkout@v7
   with:
     fetch-depth: 0
-- uses: Mresyzz/opsscript-gate@v0.6.2
+- uses: Mresyzz/opsscript-gate@v0.6.3
   with:
     changed-since: ${{ github.event.pull_request.base.sha }}
     preset: minimal
@@ -105,7 +109,7 @@ The Action passes when no changed shell scripts are selected. This keeps unrelat
 documentation or application changes from starting container jobs.
 
 ```yaml
-- uses: Mresyzz/opsscript-gate@v0.6.2
+- uses: Mresyzz/opsscript-gate@v0.6.3
   with:
     config: .opsscript-gate.json
     format: json

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/docs/gpt-oss.md

@@ -33,7 +33,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
 
-      - uses: Mresyzz/opsscript-gate@v0.6.2
+      - uses: Mresyzz/opsscript-gate@v0.6.3
         with:
           changed-since: ${{ github.event.pull_request.base.sha }}
           preset: minimal

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/examples/github-actions/README.md

@@ -2,4 +2,4 @@
 
 This example shows a GitHub Actions workflow for checking a shell script on pull requests.
 
-Copy `workflow.yml` into your repository at `.github/workflows/script-gate.yml` and point `script-path` to the script you want to validate. The example uses the current v0.6.2 Action release.
+Copy `workflow.yml` into your repository at `.github/workflows/script-gate.yml` and point `script-path` to the script you want to validate. The example uses the current v0.6.3 Action release.

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/examples/github-actions/workflow.yml

@@ -19,7 +19,7 @@ jobs:
           persist-credentials: false
 
       - name: Run OpsScript Gate
-        uses: Mresyzz/opsscript-gate@v0.6.2
+        uses: Mresyzz/opsscript-gate@v0.6.3
         with:
           script-path: 'scripts/deploy.sh'
           shell: auto

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "opsscript-gate"
-version = "0.6.2"
+version = "0.6.3"
 description = "Run Linux shell scripts in Debian, Ubuntu and Alpine containers to catch runtime compatibility failures before merge"
 readme = "README.md"
 license = { text = "MIT" }
@@ -29,6 +29,10 @@ keywords = [
     "ubuntu",
     "alpine",
     "shellcheck-alternative",
+    "shellcheck",
+    "shell-portability",
+    "installer-testing",
+    "busybox",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/src/opsscript_gate/__init__.py

@@ -1,4 +1,4 @@
 """OpsScript Gate: Lightweight cross-distro compatibility pre-check for Linux ops scripts."""
 
-__version__ = "0.6.2"
+__version__ = "0.6.3"
 __all__ = ["__version__"]

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/src/opsscript_gate/cli.py

@@ -24,6 +24,7 @@ from opsscript_gate.runner import (
     DEFAULT_MATRIX,
     DEFAULT_TIMEOUT,
     DockerDaemonError,
+    get_docker_client,
     run_matrix,
 )
 
@@ -43,6 +44,16 @@ def build_parser() -> argparse.ArgumentParser:
 
     subparsers = parser.add_subparsers(dest="command", help="Available subcommands")
     subparsers.add_parser("init", help="Create project configuration and GitHub workflow")
+    doctor_parser = subparsers.add_parser(
+        "doctor",
+        help="Check the local environment before running containers",
+    )
+    doctor_parser.add_argument(
+        "--format",
+        choices=["table", "json"],
+        default="table",
+        help="Output format: 'table' (default) or 'json'",
+    )
 
     # 'run' subcommand
     run_parser = subparsers.add_parser(
@@ -149,6 +160,38 @@ def main(argv: list[str] | None = None) -> int:
             sys.stderr.write(f"Error: {err}\n")
             return 1
 
+    if args.command == "doctor":
+        checks = [
+            {
+                "name": "python",
+                "ok": sys.version_info >= (3, 10),
+                "detail": f"Python {sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}",
+            }
+        ]
+        try:
+            get_docker_client()
+            checks.append({"name": "docker", "ok": True, "detail": "Docker daemon is reachable"})
+        except DockerDaemonError as err:
+            checks.append({"name": "docker", "ok": False, "detail": str(err)})
+
+        config_path = Path(".opsscript-gate.json")
+        checks.append({
+            "name": "project",
+            "ok": True,
+            "detail": f"Found {config_path}" if config_path.is_file() else "No project config (optional)",
+        })
+        passed = all(check["ok"] for check in checks)
+        if args.format == "json":
+            print(json.dumps({"status": "PASS" if passed else "FAIL", "checks": checks}, indent=2))
+        else:
+            print("OpsScript Gate doctor")
+            for check in checks:
+                marker = "PASS" if check["ok"] else "FAIL"
+                print(f"[{marker}] {check['name']}: {check['detail']}")
+            if not passed:
+                print("Run `opsscript-gate init` after fixing the failed check, then preview with `opsscript-gate run --dry-run`.")
+        return 0 if passed else 1
+
     if args.command == "run":
         try:
             config = load_config(args.config)

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/src/opsscript_gate/config.py

@@ -63,7 +63,7 @@ jobs:
       - uses: actions/checkout@v7
         with:
           persist-credentials: false
-      - uses: Mresyzz/opsscript-gate@v0.6.2
+      - uses: Mresyzz/opsscript-gate@v0.6.3
         with:
           config: .opsscript-gate.json
 """,

{opsscript_gate-0.6.2 → opsscript_gate-0.6.3}/tests/test_onboarding.py

@@ -8,6 +8,7 @@ from opsscript_gate.cli import main
 from opsscript_gate.config import CONFIG_NAME, init_project, load_config
 from opsscript_gate.discovery import discover_changed_scripts, discover_scripts, is_shell_script
 from opsscript_gate.models import RunReport, SingleResult, DistroStatus
+from opsscript_gate.runner import DockerDaemonError
 
 
 @pytest.fixture
@@ -35,6 +36,27 @@ def test_init_preview_and_no_overwrite(project, capsys):
     assert Path(CONFIG_NAME).read_bytes() == original
 
 
+def test_doctor_reports_local_prerequisites(project, capsys):
+    with patch("opsscript_gate.cli.get_docker_client"):
+        assert main(["doctor"]) == 0
+    output = capsys.readouterr().out
+    assert "OpsScript Gate doctor" in output
+    assert "[PASS] python" in output
+    assert "[PASS] docker" in output
+    assert "No project config (optional)" in output
+
+
+def test_doctor_json_reports_docker_failure(project, capsys):
+    with patch(
+        "opsscript_gate.cli.get_docker_client",
+        side_effect=DockerDaemonError("Docker is not running"),
+    ):
+        assert main(["doctor", "--format", "json"]) == 1
+    report = json.loads(capsys.readouterr().out)
+    assert report["status"] == "FAIL"
+    assert next(check for check in report["checks"] if check["name"] == "docker")["ok"] is False
+
+
 def test_init_existing_workflow_leaves_config_absent(project):
     workflow = project / ".github/workflows/opsscript-gate.yml"
     workflow.parent.mkdir(parents=True)