Release 2.47.28

Signed-off-by: Jiahao XU <Jiahao_XU@outlook.com>
Co-authored-by: Taiki Endo <te316e89@gmail.com>

.deny.toml

@@ -0,0 +1,41 @@
+# https://embarkstudios.github.io/cargo-deny/checks/advisories/cfg.html
+[advisories]
+yanked = "deny"
+git-fetch-with-cli = true
+ignore = [
+]
+
+# https://embarkstudios.github.io/cargo-deny/checks/bans/cfg.html
+[bans]
+multiple-versions = "warn"
+wildcards = "deny"
+allow-wildcard-paths = true
+build.executables = "deny"
+build.interpreted = "deny"
+build.include-dependencies = true
+build.include-workspace = false # covered by tools/tidy.sh
+build.include-archives = true
+build.allow-build-scripts = [
+    { name = "proc-macro2" }, # via serde_derive
+    { name = "semver" },
+    { name = "serde" },
+]
+build.bypass = [
+]
+
+# https://embarkstudios.github.io/cargo-deny/checks/licenses/cfg.html
+[licenses]
+unused-allowed-license = "deny"
+private.ignore = true
+allow = [
+    "Apache-2.0",
+    "MIT",
+    "Unicode-3.0", # unicode-ident
+]
+
+# https://embarkstudios.github.io/cargo-deny/checks/sources/cfg.html
+[sources]
+unknown-registry = "deny"
+unknown-git = "deny"
+allow-git = [
+]

.github/.cspell/project-dictionary.txt

@@ -30,5 +30,6 @@ syft
 udeps
 wasmtime
 watchexec
+worktree
 xbuild
 xscale

.github/workflows/ci.yml

@@ -22,6 +22,8 @@ env:
   RUST_BACKTRACE: 1
   RUSTFLAGS: -D warnings
   RUSTUP_MAX_RETRIES: 10
+  # NB: sync with miri job's --exclude option
+  EXCLUDE: --exclude install-action-internal-codegen
 
 defaults:
   run:
@@ -32,6 +34,16 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  miri:
+    uses: taiki-e/github-actions/.github/workflows/miri.yml@main
+    with:
+      event_name: ${{ github.event_name }}
+      # NB: sync with env.EXCLUDE
+      args: --exclude install-action-internal-codegen
+  msrv:
+    uses: taiki-e/github-actions/.github/workflows/msrv.yml@main
+    with:
+      event_name: ${{ github.event_name }}
   tidy:
     uses: taiki-e/github-actions/.github/workflows/tidy.yml@main
     permissions:
@@ -237,9 +249,11 @@ jobs:
       - run: tools/manifest.sh
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - id: diff
+      - name: Handle diff
+        id: diff
         run: tools/ci/manifest.sh
         if: github.repository_owner == 'taiki-e' && (github.event_name == 'schedule' || github.event_name == 'push' && github.ref == 'refs/heads/main')
+      - run: git add -N . && git diff --exit-code
       - id: create-pull-request
         uses: peter-evans/create-pull-request@v7
         with:
@@ -263,4 +277,25 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PR_NUMBER: ${{ steps.create-pull-request.outputs.pull-request-number }}
         if: github.repository_owner == 'taiki-e' && (github.event_name == 'schedule' || github.event_name == 'push' && github.ref == 'refs/heads/main') && steps.diff.outputs.success == 'false' && (steps.create-pull-request.outputs.pull-request-operation == 'created' || steps.create-pull-request.outputs.pull-request-operation == 'updated')
-      - run: git add -N . && git diff --exit-code
+
+  manifest-schema:
+    strategy:
+      fail-fast: false
+      matrix:
+        rust:
+          - stable
+          - beta
+          - nightly
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    steps:
+      - uses: taiki-e/checkout-action@v1
+      - uses: taiki-e/github-actions/install-rust@main
+        with:
+          toolchain: ${{ matrix.rust }}
+      - uses: taiki-e/install-action@cargo-hack
+      - uses: taiki-e/install-action@cargo-minimal-versions
+      - run: cargo test --workspace --all-features ${EXCLUDE}
+      - run: cargo hack build --workspace --no-private --feature-powerset --no-dev-deps
+      - run: cargo minimal-versions build --workspace --no-private --detach-path-deps=skip-exact --all-features
+      - run: cargo minimal-versions build --workspace --no-private --detach-path-deps=skip-exact --all-features --direct

.github/workflows/manifest_sync.yml

@@ -0,0 +1,51 @@
+name: Manifest Synchronization
+
+permissions:
+  contents: read
+
+on:
+  release:
+    types: [released]
+
+env:
+  WORKSPACE: /tmp/workspace
+
+defaults:
+  run:
+    shell: bash --noprofile --norc -CeEuxo pipefail {0}
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: true
+
+      - name: Checkout manifest-schema branch
+        run: ./tools/ci/checkout-manifest-schema-branch.sh "${WORKSPACE}"
+
+      - name: Copy over schema
+        run: cp -- ./manifests/* "${WORKSPACE}"
+
+      - name: Stage changes
+        working-directory: ${{ env.WORKSPACE }}
+        run: git add .
+
+      - name: Show diff
+        working-directory: ${{ env.WORKSPACE }}
+        run: git diff HEAD
+
+      - name: Detect changes
+        id: changes
+        working-directory: ${{ env.WORKSPACE }}
+        run: |
+          # This output boolean tells us if the dependencies have actually changed
+          printf "count=%s\n" "$(git status --porcelain=v1 | wc -l)" >>"${GITHUB_OUTPUT}"
+
+      - name: Commit and push
+        # Only push if changes exist
+        if: steps.changes.outputs.count > 0
+        working-directory: ${{ env.WORKSPACE }}
+        run: |
+          git commit -m "Update manifest schema" && git push origin HEAD

CHANGELOG.md

@@ -10,6 +10,40 @@ Note: In this file, do not use the hard wrap in the middle of a sentence for com
 
 ## [Unreleased]
 
+## [2.47.28] - 2025-01-28
+
+No change on the `install-action` itself.
+
+- Provide `install-action-manifest-schema` crate to access to the `install-action` manifests from Rust code. ([#657](https://github.com/taiki-e/install-action/pull/657), thanks @NobodyXu)
+
+  This is being considered for use to speed up `cargo-binstall` in the future.
+
+## [2.47.27] - 2025-01-28
+
+- Update `editorconfig-checker@latest` to 3.2.0.
+
+- Update `cargo-lambda@latest` to 1.6.3.
+
+## [2.47.26] - 2025-01-27
+
+- Update `wash@latest` to 0.38.0.
+
+## [2.47.25] - 2025-01-24
+
+- Update `release-plz@latest` to 0.3.114.
+
+- Update `git-cliff@latest` to 2.8.0.
+
+## [2.47.24] - 2025-01-23
+
+- Update `syft@latest` to 1.19.0.
+
+- Update `just@latest` to 1.39.0.
+
+## [2.47.23] - 2025-01-22
+
+- Update `wasmtime@latest` to 29.0.1.
+
 ## [2.47.22] - 2025-01-21
 
 - Update `trunk@latest` to 0.21.7.
@@ -3374,7 +3408,13 @@ Note: This release is considered a breaking change because installing on version
 
 Initial release
 
-[Unreleased]: https://github.com/taiki-e/install-action/compare/v2.47.22...HEAD
+[Unreleased]: https://github.com/taiki-e/install-action/compare/v2.47.28...HEAD
+[2.47.28]: https://github.com/taiki-e/install-action/compare/v2.47.27...v2.47.28
+[2.47.27]: https://github.com/taiki-e/install-action/compare/v2.47.26...v2.47.27
+[2.47.26]: https://github.com/taiki-e/install-action/compare/v2.47.25...v2.47.26
+[2.47.25]: https://github.com/taiki-e/install-action/compare/v2.47.24...v2.47.25
+[2.47.24]: https://github.com/taiki-e/install-action/compare/v2.47.23...v2.47.24
+[2.47.23]: https://github.com/taiki-e/install-action/compare/v2.47.22...v2.47.23
 [2.47.22]: https://github.com/taiki-e/install-action/compare/v2.47.21...v2.47.22
 [2.47.21]: https://github.com/taiki-e/install-action/compare/v2.47.20...v2.47.21
 [2.47.20]: https://github.com/taiki-e/install-action/compare/v2.47.19...v2.47.20

Cargo.toml

@@ -1,6 +1,6 @@
 [workspace]
 resolver = "2"
-members = ["tools/codegen"]
+members = ["tools/codegen", "tools/manifest-schema"]
 
 # This table is shared by projects under github.com/taiki-e.
 # It is not intended for manual editing.

manifests/cargo-lambda.json

@@ -20,13 +20,35 @@
   },
   "license_markdown": "[MIT](https://github.com/cargo-lambda/cargo-lambda/blob/main/LICENSE)",
   "latest": {
-    "version": "1.6.2"
+    "version": "1.6.3"
   },
   "1": {
-    "version": "1.6.2"
+    "version": "1.6.3"
   },
   "1.6": {
-    "version": "1.6.2"
+    "version": "1.6.3"
+  },
+  "1.6.3": {
+    "x86_64_linux_musl": {
+      "etag": "0x8DD3F12D1829838",
+      "checksum": "670a1cf1ca2c01d30c8dd06ab7faae36158add03b0e9b2fbf0d1bbf8b8edf8e8"
+    },
+    "x86_64_macos": {
+      "etag": "0x8DD3F12D26A45C7",
+      "checksum": "1312ae530f4c3d8701640e159a19f2943461c81865890cf8d08d9807afcf3ca0"
+    },
+    "x86_64_windows": {
+      "etag": "0x8DD3F12D30451BF",
+      "checksum": "5274aea23d3e916b4939b817634254662b9b09899a0442c0b5efe7bc89891496"
+    },
+    "aarch64_linux_musl": {
+      "etag": "0x8DD3F12D3AE7838",
+      "checksum": "eda5196b2ea453fc357d1626720e79655fa64ef5e28a7e691698a268ebde5a34"
+    },
+    "aarch64_macos": {
+      "etag": "0x8DD3F12D4480F87",
+      "checksum": "4494a562a4372f670bd6975484cc4d33334789961131553c81d35f953a3f0287"
+    }
   },
   "1.6.2": {
     "x86_64_linux_musl": {

manifests/editorconfig-checker.json

@@ -3,10 +3,51 @@
   "template": null,
   "license_markdown": "[MIT](https://github.com/editorconfig-checker/editorconfig-checker/blob/main/LICENSE)",
   "latest": {
-    "version": "3.1.2"
+    "version": "3.2.0"
   },
   "3": {
-    "version": "3.1.2"
+    "version": "3.2.0"
+  },
+  "3.2": {
+    "version": "3.2.0"
+  },
+  "3.2.0": {
+    "x86_64_linux_gnu": {
+      "url": "https://github.com/editorconfig-checker/editorconfig-checker/releases/download/v3.2.0/ec-linux-amd64.tar.gz",
+      "etag": "0x8DD3F08FBCBE9E3",
+      "checksum": "5e6a63097904be33c8d18e960f54fd8f60ada5464fe0056cd3dbbd0678584d15",
+      "bin": "bin/ec-linux-amd64"
+    },
+    "x86_64_macos": {
+      "url": "https://github.com/editorconfig-checker/editorconfig-checker/releases/download/v3.2.0/ec-darwin-amd64.tar.gz",
+      "etag": "0x8DD3F08FC132A08",
+      "checksum": "3834ca689609122d3741b319ebb7aed2e53d69e4141c9b9cde18b2898c20f440",
+      "bin": "bin/ec-darwin-amd64"
+    },
+    "x86_64_windows": {
+      "url": "https://github.com/editorconfig-checker/editorconfig-checker/releases/download/v3.2.0/ec-windows-amd64.zip",
+      "etag": "0x8DD3F08FC7A7849",
+      "checksum": "af614995342fdf51308895f0df04c40d88d22b345c8df1dc7b5b379c1c54d441",
+      "bin": "bin/ec-windows-amd64.exe"
+    },
+    "aarch64_linux_gnu": {
+      "url": "https://github.com/editorconfig-checker/editorconfig-checker/releases/download/v3.2.0/ec-linux-arm64.tar.gz",
+      "etag": "0x8DD3F08FC1350E7",
+      "checksum": "1a49bfff89d0622ccdf81d9a680c7c8bdf5dd80416b7046f66c1822ad0d60f85",
+      "bin": "bin/ec-linux-arm64"
+    },
+    "aarch64_macos": {
+      "url": "https://github.com/editorconfig-checker/editorconfig-checker/releases/download/v3.2.0/ec-darwin-arm64.tar.gz",
+      "etag": "0x8DD3F08FC19D93F",
+      "checksum": "f5855029e0b52c237ee751b09090fdc9711659165c558c1184f45da0105f20ce",
+      "bin": "bin/ec-darwin-arm64"
+    },
+    "aarch64_windows": {
+      "url": "https://github.com/editorconfig-checker/editorconfig-checker/releases/download/v3.2.0/ec-windows-arm64.zip",
+      "etag": "0x8DD3F08FC3924EF",
+      "checksum": "a212ce886b95c7ede06888b6c2356a1af77ba1c721fa20c55015d3051342aa63",
+      "bin": "bin/ec-windows-arm64.exe"
+    }
   },
   "3.1": {
     "version": "3.1.2"

manifests/git-cliff.json

@@ -28,10 +28,39 @@
   },
   "license_markdown": "[MIT](https://github.com/orhun/git-cliff/blob/main/LICENSE-MIT) OR [Apache-2.0](https://github.com/orhun/git-cliff/blob/main/LICENSE-APACHE)",
   "latest": {
-    "version": "2.7.0"
+    "version": "2.8.0"
   },
   "2": {
-    "version": "2.7.0"
+    "version": "2.8.0"
+  },
+  "2.8": {
+    "version": "2.8.0"
+  },
+  "2.8.0": {
+    "x86_64_linux_musl": {
+      "etag": "0x8DD3C86C788509F",
+      "checksum": "505a5f672ad07837996e02be78781d152811396aadf060ed58979a7c7d3acc4e"
+    },
+    "x86_64_macos": {
+      "etag": "0x8DD3C86AA7DA163",
+      "checksum": "8e25260a526666f5381e124169bc36f9315919f61b89ba0b7f3443f0771c6499"
+    },
+    "x86_64_windows": {
+      "etag": "0x8DD3C879B6A6D65",
+      "checksum": "e1d7d1df5f679e6bd22aef5a60dee97cd69ec158f432a77e771b87283af94ad8"
+    },
+    "aarch64_linux_musl": {
+      "etag": "0x8DD3C86CF0150F9",
+      "checksum": "04fb2a52031f0a88ff88496b694d01fa655c31e21b17a5c7b8c4d2bc187be248"
+    },
+    "aarch64_macos": {
+      "etag": "0x8DD3C868B929459",
+      "checksum": "e61e10dc7ebf3b3d4e1cc10ea6e1a2fc0f1d5832adf31e52021ffc7ecf2b2cb0"
+    },
+    "aarch64_windows": {
+      "etag": "0x8DD3C87CA9EF12C",
+      "checksum": "ddef496b165c465aeede201c00a88cc21078511aee618803bc6f6ca789877928"
+    }
   },
   "2.7": {
     "version": "2.7.0"

manifests/just.json

@@ -19,10 +19,35 @@
   },
   "license_markdown": "[CC0-1.0](https://github.com/casey/just/blob/master/LICENSE)",
   "latest": {
-    "version": "1.38.0"
+    "version": "1.39.0"
   },
   "1": {
-    "version": "1.38.0"
+    "version": "1.39.0"
+  },
+  "1.39": {
+    "version": "1.39.0"
+  },
+  "1.39.0": {
+    "x86_64_linux_musl": {
+      "etag": "0x8DD3B20A92CDED8",
+      "checksum": "1c53fa85a8c021ce7b19814e1a5e1dc0aa10c04bddca75196f7ab6db6130d2cd"
+    },
+    "x86_64_macos": {
+      "etag": "0x8DD3B20A69851F1",
+      "checksum": "6c786ac5646e643cc21e4d7d2f5da12b690a54c32d35307224db34879344ad4c"
+    },
+    "x86_64_windows": {
+      "etag": "0x8DD3B2117A4C6AC",
+      "checksum": "b99304df08fdafaa2ea92714a0696727f7ff0cb8dd02527095aeb4419e5f6de9"
+    },
+    "aarch64_linux_musl": {
+      "etag": "0x8DD3B20B8C41FD7",
+      "checksum": "f1b9acdb4374983539c765d60374350932527df807b25975e05abb152c9021e7"
+    },
+    "aarch64_macos": {
+      "etag": "0x8DD3B209ED9E867",
+      "checksum": "ab1e1fc95bc3cd11ee9ecc2c764abbd60f6d4f99dad05be78276e5487e959051"
+    }
   },
   "1.38": {
     "version": "1.38.0"

manifests/release-plz.json

@@ -22,10 +22,36 @@
   },
   "license_markdown": "[MIT](https://github.com/release-plz/release-plz/blob/main/LICENSE-MIT) OR [Apache-2.0](https://github.com/release-plz/release-plz/blob/main/LICENSE-APACHE)",
   "latest": {
-    "version": "0.3.113"
+    "version": "0.3.114"
   },
   "0.3": {
-    "version": "0.3.113"
+    "version": "0.3.114"
+  },
+  "0.3.114": {
+    "x86_64_linux_musl": {
+      "etag": "0x8DD3C8410CD9FE0",
+      "checksum": "b0895ee201b67c177bf7b4defb3c1c4d15369960f9e37c4fb9abf12d99ec8ff5"
+    },
+    "x86_64_macos": {
+      "etag": "0x8DD3C84CF4B33C9",
+      "checksum": "a42de7752ee51e1725c504d20f172b2c9a3aae8715a407eda48ed94da083b668"
+    },
+    "x86_64_windows": {
+      "etag": "0x8DD3C84C2D46C3F",
+      "checksum": "a113c4d2e9f3cd9a17be6b2b15593944241413278d86ee2055697e88eca7b2b8"
+    },
+    "aarch64_linux_musl": {
+      "etag": "0x8DD3C8420CCA150",
+      "checksum": "75a00279f3533dafcd3c15332ca30379d576b8517598e83d4e52fd81e9d72998"
+    },
+    "aarch64_macos": {
+      "etag": "0x8DD3C8503A13166",
+      "checksum": "b2d75f28b873a6627e7c48b020cfba190e7a9ba58d2dfc0d5dde9845d4b2c1f6"
+    },
+    "aarch64_windows": {
+      "etag": "0x8DD3C851F4D3AF9",
+      "checksum": "1dfff2fd324a27a485a64cbc9fc8db2be544131f57439e206931a260090b9fb1"
+    }
   },
   "0.3.113": {
     "x86_64_linux_musl": {

manifests/syft.json

@@ -24,10 +24,35 @@
   },
   "license_markdown": "[Apache-2.0](https://github.com/anchore/syft/blob/main/LICENSE)",
   "latest": {
-    "version": "1.18.1"
+    "version": "1.19.0"
   },
   "1": {
-    "version": "1.18.1"
+    "version": "1.19.0"
+  },
+  "1.19": {
+    "version": "1.19.0"
+  },
+  "1.19.0": {
+    "x86_64_linux_musl": {
+      "etag": "0x8DD3B2008D5F4D4",
+      "checksum": "1dec148ea36aef68a866e35528974b5dbc106ba0b545f1a262ad977d48294637"
+    },
+    "x86_64_macos": {
+      "etag": "0x8DD3B2009AFA9C7",
+      "checksum": "bc6ddeef1c08e0925549033e75ce51e5b916baa505a2eee7fe197ed84f0db1bd"
+    },
+    "x86_64_windows": {
+      "etag": "0x8DD3B2009A55517",
+      "checksum": "405171c57db0c0a6c259a90673ae498482f2501e8ac9b685a94fa186dd6b9a4b"
+    },
+    "aarch64_linux_musl": {
+      "etag": "0x8DD3B2008D8B0E6",
+      "checksum": "3ec1412f1497a7aad795a36d09dc1df2bad349f07e274bbaf50c8c3746549048"
+    },
+    "aarch64_macos": {
+      "etag": "0x8DD3B2009A9961B",
+      "checksum": "a42c5b76d5f1555fd4a3de65ecd523c4f1364f9c71861a6530c7b8478205687e"
+    }
   },
   "1.18": {
     "version": "1.18.1"

manifests/wash.json

@@ -19,7 +19,32 @@
   },
   "license_markdown": "[Apache-2.0](https://github.com/wasmCloud/wasmCloud/blob/main/LICENSE)",
   "latest": {
-    "version": "0.37.0"
+    "version": "0.38.0"
+  },
+  "0.38": {
+    "version": "0.38.0"
+  },
+  "0.38.0": {
+    "x86_64_linux_musl": {
+      "etag": "0x8DD3EEC2CD0065E",
+      "checksum": "8bba2463f4e121fdbbebc4046aabe1ade54aa3bd72ba70a57ad4b0e0e657bec2"
+    },
+    "x86_64_macos": {
+      "etag": "0x8DD3EEC2BF542B2",
+      "checksum": "edec0fa45d5ed437322d2813714b5b268d3882bf5ba93f857eefef26f068037b"
+    },
+    "x86_64_windows": {
+      "etag": "0x8DD3EEC2C069451",
+      "checksum": "befd98782a0ab1081c5f4f9dad770c57126770820feddcc7246fc1fdcad99caa"
+    },
+    "aarch64_linux_musl": {
+      "etag": "0x8DD3EEC2BE7967B",
+      "checksum": "bab4fad652eaa9bb1e890daa0478ec223aaf448fb72eb00e59014034a3bca345"
+    },
+    "aarch64_macos": {
+      "etag": "0x8DD3EEC2BD97591",
+      "checksum": "c2d0443264d064c3f975809e945d19fb4180a3a1d21944e43ea261f7c3050450"
+    }
   },
   "0.37": {
     "version": "0.37.0"

manifests/wasmtime.json

@@ -28,13 +28,39 @@
   },
   "license_markdown": "[Apache-2.0 WITH LLVM-exception](https://github.com/bytecodealliance/wasmtime/blob/main/LICENSE)",
   "latest": {
-    "version": "29.0.0"
+    "version": "29.0.1"
   },
   "29": {
-    "version": "29.0.0"
+    "version": "29.0.1"
   },
   "29.0": {
-    "version": "29.0.0"
+    "version": "29.0.1"
+  },
+  "29.0.1": {
+    "x86_64_linux_gnu": {
+      "etag": "0x8DD3A6D256D8BBF",
+      "checksum": "579ec7086f34ff6bbc53483ae00f660be1570f3ef10af0880a4ba9867067a77c"
+    },
+    "x86_64_macos": {
+      "etag": "0x8DD3A6D266E4B06",
+      "checksum": "7f62746a61c759932f4307cec32f139b31c9e5db93eab6c02238dcb82bd9a6d8"
+    },
+    "x86_64_windows": {
+      "etag": "0x8DD3A6D2A99FEE2",
+      "checksum": "3d4c7b4145fb4426c4ece54302f598c33998f9d2cc8894059d7103b83d3dddff"
+    },
+    "aarch64_linux_gnu": {
+      "etag": "0x8DD3A6D1C888CBD",
+      "checksum": "5db4d27d008d726fe69adf8fcf59f42b0c2f0e51519970414860efda8b5e9655"
+    },
+    "aarch64_macos": {
+      "etag": "0x8DD3A6D1D6964A8",
+      "checksum": "56fb3c04c230eabcce92717081c51d3dc87d3416c3b059a2783e5496a29cf384"
+    },
+    "aarch64_windows": {
+      "etag": "0x8DD3A6D1F419085",
+      "checksum": "93b4a2bcbe9ad9c0505b246c6bd38550428be05876995230b607fde35bd772f1"
+    }
   },
   "29.0.0": {
     "x86_64_linux_gnu": {

tools/ci/checkout-manifest-schema-branch.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: Apache-2.0 OR MIT
+set -CeEuo pipefail
+IFS=$'\n\t'
+trap -- 's=$?; printf >&2 "%s\n" "${0##*/}:${LINENO}: \`${BASH_COMMAND}\` exit with ${s}"; exit ${s}' ERR
+cd -- "$(dirname -- "$0")"
+
+version="$(cargo metadata --format-version=1 --no-deps | jq -r '.packages[] | select(.name == "install-action-manifest-schema") | .version')"
+if [[ "${version}" == "0."* ]]; then
+  schema_version="0.$(cut -d. -f2 <<<"${version}")"
+else
+  schema_version="$(cut -d. -f1 <<<"${version}")"
+fi
+branch="manifest-schema-${schema_version}"
+
+git worktree add --force "${1?}"
+cd -- "$1"
+
+if git fetch origin "${branch}"; then
+  git checkout "origin/${branch}" -B "${branch}"
+elif ! git checkout "${branch}"; then
+  # New branch with no history. Credit: https://stackoverflow.com/a/13969482
+  git checkout --orphan "${branch}"
+  git rm -rf . || true
+  git config --local user.name github-actions
+  git config --local user.email github-actions@github.com
+  git commit -m 'Initial commit' --allow-empty
+fi

tools/codegen/Cargo.toml

@@ -4,6 +4,7 @@ edition = "2021"
 default-run = "generate-manifest"
 
 [dependencies]
+install-action-manifest-schema = { path = "../manifest-schema" }
 anyhow = "1"
 flate2 = "1"
 fs-err = "3"

tools/codegen/src/lib.rs

@@ -2,21 +2,9 @@
 
 #![allow(clippy::missing_panics_doc, clippy::too_long_first_doc_paragraph)]
 
-use std::{
-    cmp::{self, Reverse},
-    collections::BTreeMap,
-    env, fmt,
-    path::{Path, PathBuf},
-    slice,
-    str::FromStr,
-};
+use std::{env, path::PathBuf};
 
-use anyhow::Result;
-use serde::{
-    de::{self, Deserialize, Deserializer},
-    ser::{Serialize, Serializer},
-};
-use serde_derive::{Deserialize, Serialize};
+pub use install_action_manifest_schema::*;
 
 #[must_use]
 pub fn workspace_root() -> PathBuf {
@@ -25,366 +13,3 @@ pub fn workspace_root() -> PathBuf {
     dir.pop(); // tools
     dir
 }
-
-#[derive(Debug, Clone, PartialEq, Eq)]
-pub struct Version {
-    pub major: Option<u64>,
-    pub minor: Option<u64>,
-    pub patch: Option<u64>,
-    pub pre: semver::Prerelease,
-    pub build: semver::BuildMetadata,
-}
-
-impl Version {
-    #[must_use]
-    pub fn omitted(major: u64, minor: Option<u64>) -> Self {
-        Self {
-            major: Some(major),
-            minor,
-            patch: None,
-            pre: semver::Prerelease::default(),
-            build: semver::BuildMetadata::default(),
-        }
-    }
-    #[must_use]
-    pub fn latest() -> Self {
-        Self {
-            major: None,
-            minor: None,
-            patch: None,
-            pre: semver::Prerelease::default(),
-            build: semver::BuildMetadata::default(),
-        }
-    }
-    #[must_use]
-    pub fn to_semver(&self) -> Option<semver::Version> {
-        Some(semver::Version {
-            major: self.major?,
-            minor: self.minor?,
-            patch: self.patch?,
-            pre: self.pre.clone(),
-            build: self.build.clone(),
-        })
-    }
-}
-impl From<semver::Version> for Version {
-    fn from(v: semver::Version) -> Self {
-        Self {
-            major: Some(v.major),
-            minor: Some(v.minor),
-            patch: Some(v.patch),
-            pre: v.pre,
-            build: v.build,
-        }
-    }
-}
-impl PartialOrd for Version {
-    fn partial_cmp(&self, other: &Self) -> Option<cmp::Ordering> {
-        Some(self.cmp(other))
-    }
-}
-impl Ord for Version {
-    fn cmp(&self, other: &Self) -> cmp::Ordering {
-        pub(crate) fn convert(v: &Version) -> semver::Version {
-            semver::Version {
-                major: v.major.unwrap_or(u64::MAX),
-                minor: v.minor.unwrap_or(u64::MAX),
-                patch: v.patch.unwrap_or(u64::MAX),
-                pre: v.pre.clone(),
-                build: v.build.clone(),
-            }
-        }
-        convert(self).cmp(&convert(other))
-    }
-}
-impl fmt::Display for Version {
-    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
-        let Some(major) = self.major else {
-            f.write_str("latest")?;
-            return Ok(());
-        };
-        f.write_str(&major.to_string())?;
-        let Some(minor) = self.minor else {
-            return Ok(());
-        };
-        f.write_str(".")?;
-        f.write_str(&minor.to_string())?;
-        let Some(patch) = self.patch else {
-            return Ok(());
-        };
-        f.write_str(".")?;
-        f.write_str(&patch.to_string())?;
-        if !self.pre.is_empty() {
-            f.write_str("-")?;
-            f.write_str(&self.pre)?;
-        }
-        if !self.build.is_empty() {
-            f.write_str("+")?;
-            f.write_str(&self.build)?;
-        }
-        Ok(())
-    }
-}
-impl FromStr for Version {
-    type Err = semver::Error;
-    fn from_str(s: &str) -> Result<Self, Self::Err> {
-        if s == "latest" {
-            return Ok(Self::latest());
-        }
-        match s.parse::<semver::Version>() {
-            Ok(v) => Ok(v.into()),
-            Err(e) => match s.parse::<semver::Comparator>() {
-                Ok(v) => Ok(Self {
-                    major: Some(v.major),
-                    minor: v.minor,
-                    patch: v.patch,
-                    pre: semver::Prerelease::default(),
-                    build: semver::BuildMetadata::default(),
-                }),
-                Err(_e) => Err(e),
-            },
-        }
-    }
-}
-impl Serialize for Version {
-    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
-    where
-        S: Serializer,
-    {
-        String::serialize(&self.to_string(), serializer)
-    }
-}
-impl<'de> Deserialize<'de> for Version {
-    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
-    where
-        D: Deserializer<'de>,
-    {
-        String::deserialize(deserializer)?.parse().map_err(de::Error::custom)
-    }
-}
-
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
-pub struct Manifests {
-    pub rust_crate: Option<String>,
-    pub template: Option<ManifestTemplate>,
-    /// Markdown for the licenses.
-    pub license_markdown: String,
-    #[serde(flatten)]
-    pub map: BTreeMap<Reverse<Version>, ManifestRef>,
-}
-
-#[derive(Debug, Clone, Serialize, Deserialize)]
-#[serde(untagged)]
-pub enum ManifestRef {
-    Ref { version: Version },
-    Real(Manifest),
-}
-
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct Manifest {
-    #[serde(skip_serializing_if = "Option::is_none")]
-    pub previous_stable_version: Option<Version>,
-    #[serde(flatten)]
-    pub download_info: BTreeMap<HostPlatform, ManifestDownloadInfo>,
-}
-
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct ManifestDownloadInfo {
-    #[serde(skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
-    pub etag: String,
-    pub checksum: String,
-    /// Path to binaries in archive. Default to `${tool}${exe}`.
-    #[serde(skip_serializing_if = "Option::is_none")]
-    pub bin: Option<StringOrArray>,
-}
-
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct ManifestTemplate {
-    #[serde(flatten)]
-    pub download_info: BTreeMap<HostPlatform, ManifestTemplateDownloadInfo>,
-}
-
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct ManifestTemplateDownloadInfo {
-    pub url: String,
-    /// Path to binaries in archive. Default to `${tool}${exe}`.
-    #[serde(skip_serializing_if = "Option::is_none")]
-    pub bin: Option<StringOrArray>,
-}
-
-#[derive(Debug, Deserialize)]
-#[serde(deny_unknown_fields)]
-pub struct BaseManifest {
-    /// Link to the GitHub repository.
-    pub repository: String,
-    /// Alternative link for the project.  Automatically detected if possible.
-    pub website: Option<String>,
-    /// Markdown syntax for links to licenses.  Automatically detected if possible.
-    pub license_markdown: Option<String>,
-    /// Prefix of release tag.
-    pub tag_prefix: String,
-    /// Crate name, if this is Rust crate.
-    pub rust_crate: Option<String>,
-    pub default_major_version: Option<String>,
-    /// Asset name patterns.
-    pub asset_name: Option<StringOrArray>,
-    /// Path to binaries in archive. Default to `${tool}${exe}`.
-    pub bin: Option<StringOrArray>,
-    pub signing: Option<Signing>,
-    #[serde(default)]
-    pub broken: Vec<semver::Version>,
-    pub version_range: Option<String>,
-    /// Use glibc build if host_env is gnu.
-    #[serde(default)]
-    pub prefer_linux_gnu: bool,
-    /// Check that the version is yanked not only when updating the manifest,
-    /// but also when running the action.
-    #[serde(default)]
-    pub immediate_yank_reflection: bool,
-    pub platform: BTreeMap<HostPlatform, BaseManifestPlatformInfo>,
-}
-impl BaseManifest {
-    /// Validate the manifest.
-    pub fn validate(&self) {
-        for bin in self.bin.iter().chain(self.platform.values().flat_map(|m| &m.bin)) {
-            assert!(!bin.as_slice().is_empty());
-            for bin in bin.as_slice() {
-                let file_name = Path::new(bin).file_name().unwrap().to_str().unwrap();
-                if !self.repository.ends_with("/xbuild") {
-                    assert!(
-                        !(file_name.contains("${version") || file_name.contains("${rust")),
-                        "{bin}"
-                    );
-                }
-            }
-        }
-    }
-}
-
-#[derive(Debug, Deserialize)]
-#[serde(deny_unknown_fields)]
-pub struct Signing {
-    pub kind: SigningKind,
-}
-
-#[derive(Debug, Deserialize, PartialEq, Eq)]
-#[serde(rename_all = "kebab-case")]
-#[serde(deny_unknown_fields)]
-pub enum SigningKind {
-    /// algorithm: minisign
-    /// public key: package.metadata.binstall.signing.pubkey at Cargo.toml
-    /// <https://github.com/cargo-bins/cargo-binstall/blob/HEAD/SIGNING.md>
-    MinisignBinstall,
-}
-
-#[derive(Debug, Deserialize)]
-#[serde(deny_unknown_fields)]
-pub struct BaseManifestPlatformInfo {
-    /// Asset name patterns. Default to the value at `BaseManifest::asset_name`.
-    pub asset_name: Option<StringOrArray>,
-    /// Path to binaries in archive. Default to the value at `BaseManifest::bin`.
-    pub bin: Option<StringOrArray>,
-}
-
-#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
-#[serde(untagged)]
-pub enum StringOrArray {
-    String(String),
-    Array(Vec<String>),
-}
-
-impl StringOrArray {
-    #[must_use]
-    pub fn as_slice(&self) -> &[String] {
-        match self {
-            Self::String(s) => slice::from_ref(s),
-            Self::Array(v) => v,
-        }
-    }
-    #[must_use]
-    pub fn map(&self, mut f: impl FnMut(&String) -> String) -> Self {
-        match self {
-            Self::String(s) => Self::String(f(s)),
-            Self::Array(v) => Self::Array(v.iter().map(f).collect()),
-        }
-    }
-}
-
-/// GitHub Actions Runner supports Linux (x86_64, AArch64, Arm), Windows (x86_64, AArch64),
-/// and macOS (x86_64, AArch64).
-/// https://github.com/actions/runner/blob/v2.321.0/.github/workflows/build.yml#L21
-/// https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners#supported-architectures-and-operating-systems-for-self-hosted-runners
-///
-/// Note:
-/// - Static-linked binaries compiled for linux-musl will also work on linux-gnu systems and are
-///   usually preferred over linux-gnu binaries because they can avoid glibc version issues.
-///   (rustc enables statically linking for linux-musl by default, except for mips.)
-/// - Binaries compiled for x86_64 macOS will usually also work on AArch64 macOS.
-/// - Binaries compiled for x86_64 Windows will usually also work on AArch64 Windows 11+.
-/// - Ignore Arm for now, as we need to consider the version and whether hard-float is supported.
-///   https://github.com/rust-lang/rustup/pull/593
-///   https://github.com/cross-rs/cross/pull/1018
-///   Does it seem only armv7l+ is supported?
-///   https://github.com/actions/runner/blob/v2.321.0/src/Misc/externals.sh#L178
-///   https://github.com/actions/runner/issues/688
-// TODO: support musl with dynamic linking like wasmtime 22.0.0+'s musl binaries: https://github.com/bytecodealliance/wasmtime/releases/tag/v22.0.0
-#[allow(non_camel_case_types)]
-#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]
-pub enum HostPlatform {
-    x86_64_linux_gnu,
-    x86_64_linux_musl,
-    x86_64_macos,
-    x86_64_windows,
-    aarch64_linux_gnu,
-    aarch64_linux_musl,
-    aarch64_macos,
-    aarch64_windows,
-}
-
-impl HostPlatform {
-    #[must_use]
-    pub fn rust_target(self) -> &'static str {
-        match self {
-            Self::x86_64_linux_gnu => "x86_64-unknown-linux-gnu",
-            Self::x86_64_linux_musl => "x86_64-unknown-linux-musl",
-            Self::x86_64_macos => "x86_64-apple-darwin",
-            Self::x86_64_windows => "x86_64-pc-windows-msvc",
-            Self::aarch64_linux_gnu => "aarch64-unknown-linux-gnu",
-            Self::aarch64_linux_musl => "aarch64-unknown-linux-musl",
-            Self::aarch64_macos => "aarch64-apple-darwin",
-            Self::aarch64_windows => "aarch64-pc-windows-msvc",
-        }
-    }
-    #[must_use]
-    pub fn rust_target_arch(self) -> &'static str {
-        match self {
-            Self::aarch64_linux_gnu
-            | Self::aarch64_linux_musl
-            | Self::aarch64_macos
-            | Self::aarch64_windows => "aarch64",
-            Self::x86_64_linux_gnu
-            | Self::x86_64_linux_musl
-            | Self::x86_64_macos
-            | Self::x86_64_windows => "x86_64",
-        }
-    }
-    #[must_use]
-    pub fn rust_target_os(self) -> &'static str {
-        match self {
-            Self::aarch64_linux_gnu
-            | Self::aarch64_linux_musl
-            | Self::x86_64_linux_gnu
-            | Self::x86_64_linux_musl => "linux",
-            Self::aarch64_macos | Self::x86_64_macos => "macos",
-            Self::aarch64_windows | Self::x86_64_windows => "windows",
-        }
-    }
-    #[must_use]
-    pub fn exe_suffix(self) -> &'static str {
-        match self {
-            Self::x86_64_windows | Self::aarch64_windows => ".exe",
-            _ => "",
-        }
-    }
-}

tools/manifest-schema/Cargo.toml

@@ -0,0 +1,34 @@
+[package]
+name = "install-action-manifest-schema"
+version = "0.1.0"
+edition = "2021"
+rust-version = "1.79" # Align to cargo-binstall: https://crates.io/crates/cargo-binstall
+license = "Apache-2.0 OR MIT"
+repository = "https://github.com/taiki-e/install-action"
+keywords = []
+categories = []
+description = """
+Structured access to the install-action manifests.
+"""
+
+[package.metadata.docs.rs]
+targets = ["x86_64-unknown-linux-gnu"]
+
+[package.metadata.cargo_check_external_types]
+# The following are external types that are allowed to be exposed in our public API.
+allowed_external_types = [
+    "semver::*",
+    "serde::*",
+]
+
+[lib]
+doc-scrape-examples = false
+
+# Note: semver and serde are public dependencies.
+[dependencies]
+semver = { version = "1", features = ["serde"] }
+serde = "1.0.165"
+serde_derive = "1.0.165"
+
+[lints]
+workspace = true

tools/manifest-schema/LICENSE-APACHE

@@ -0,0 +1,177 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

tools/manifest-schema/LICENSE-MIT

@@ -0,0 +1,23 @@
+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.

tools/manifest-schema/src/lib.rs

@@ -0,0 +1,413 @@
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+
+/*!
+Structured access to the install-action manifests.
+*/
+
+#![doc(test(
+    no_crate_inject,
+    attr(
+        deny(warnings, rust_2018_idioms, single_use_lifetimes),
+        allow(dead_code, unused_variables)
+    )
+))]
+#![warn(
+    // Lints that may help when writing public library.
+    missing_debug_implementations,
+    // missing_docs,
+    clippy::alloc_instead_of_core,
+    // clippy::exhaustive_enums,
+    // clippy::exhaustive_structs,
+    clippy::impl_trait_in_params,
+    // clippy::missing_inline_in_public_items,
+    // clippy::std_instead_of_alloc,
+    // clippy::std_instead_of_core,
+)]
+#![allow(clippy::missing_panics_doc, clippy::too_long_first_doc_paragraph)]
+
+use std::{
+    cmp::{self, Reverse},
+    collections::BTreeMap,
+    fmt,
+    path::Path,
+    slice,
+    str::FromStr,
+};
+
+use serde::{
+    de::{self, Deserialize, Deserializer},
+    ser::{Serialize, Serializer},
+};
+use serde_derive::{Deserialize, Serialize};
+
+#[must_use]
+pub fn get_manifest_schema_branch_name() -> &'static str {
+    if env!("CARGO_PKG_VERSION_MAJOR") == "0" {
+        concat!("manifest-schema-0.", env!("CARGO_PKG_VERSION_MINOR"))
+    } else {
+        concat!("manifest-schema-", env!("CARGO_PKG_VERSION_MAJOR"))
+    }
+}
+
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct Version {
+    pub major: Option<u64>,
+    pub minor: Option<u64>,
+    pub patch: Option<u64>,
+    pub pre: semver::Prerelease,
+    pub build: semver::BuildMetadata,
+}
+
+impl Version {
+    #[must_use]
+    pub fn omitted(major: u64, minor: Option<u64>) -> Self {
+        Self {
+            major: Some(major),
+            minor,
+            patch: None,
+            pre: semver::Prerelease::default(),
+            build: semver::BuildMetadata::default(),
+        }
+    }
+    #[must_use]
+    pub fn latest() -> Self {
+        Self {
+            major: None,
+            minor: None,
+            patch: None,
+            pre: semver::Prerelease::default(),
+            build: semver::BuildMetadata::default(),
+        }
+    }
+    #[must_use]
+    pub fn to_semver(&self) -> Option<semver::Version> {
+        Some(semver::Version {
+            major: self.major?,
+            minor: self.minor?,
+            patch: self.patch?,
+            pre: self.pre.clone(),
+            build: self.build.clone(),
+        })
+    }
+}
+impl From<semver::Version> for Version {
+    fn from(v: semver::Version) -> Self {
+        Self {
+            major: Some(v.major),
+            minor: Some(v.minor),
+            patch: Some(v.patch),
+            pre: v.pre,
+            build: v.build,
+        }
+    }
+}
+impl PartialOrd for Version {
+    fn partial_cmp(&self, other: &Self) -> Option<cmp::Ordering> {
+        Some(self.cmp(other))
+    }
+}
+impl Ord for Version {
+    fn cmp(&self, other: &Self) -> cmp::Ordering {
+        pub(crate) fn convert(v: &Version) -> semver::Version {
+            semver::Version {
+                major: v.major.unwrap_or(u64::MAX),
+                minor: v.minor.unwrap_or(u64::MAX),
+                patch: v.patch.unwrap_or(u64::MAX),
+                pre: v.pre.clone(),
+                build: v.build.clone(),
+            }
+        }
+        convert(self).cmp(&convert(other))
+    }
+}
+impl fmt::Display for Version {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        let Some(major) = self.major else {
+            f.write_str("latest")?;
+            return Ok(());
+        };
+        f.write_str(&major.to_string())?;
+        let Some(minor) = self.minor else {
+            return Ok(());
+        };
+        f.write_str(".")?;
+        f.write_str(&minor.to_string())?;
+        let Some(patch) = self.patch else {
+            return Ok(());
+        };
+        f.write_str(".")?;
+        f.write_str(&patch.to_string())?;
+        if !self.pre.is_empty() {
+            f.write_str("-")?;
+            f.write_str(&self.pre)?;
+        }
+        if !self.build.is_empty() {
+            f.write_str("+")?;
+            f.write_str(&self.build)?;
+        }
+        Ok(())
+    }
+}
+impl FromStr for Version {
+    type Err = semver::Error;
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        if s == "latest" {
+            return Ok(Self::latest());
+        }
+        match s.parse::<semver::Version>() {
+            Ok(v) => Ok(v.into()),
+            Err(e) => match s.parse::<semver::Comparator>() {
+                Ok(v) => Ok(Self {
+                    major: Some(v.major),
+                    minor: v.minor,
+                    patch: v.patch,
+                    pre: semver::Prerelease::default(),
+                    build: semver::BuildMetadata::default(),
+                }),
+                Err(_e) => Err(e),
+            },
+        }
+    }
+}
+impl Serialize for Version {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: Serializer,
+    {
+        String::serialize(&self.to_string(), serializer)
+    }
+}
+impl<'de> Deserialize<'de> for Version {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: Deserializer<'de>,
+    {
+        String::deserialize(deserializer)?.parse().map_err(de::Error::custom)
+    }
+}
+
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+pub struct Manifests {
+    pub rust_crate: Option<String>,
+    pub template: Option<ManifestTemplate>,
+    /// Markdown for the licenses.
+    pub license_markdown: String,
+    #[serde(flatten)]
+    pub map: BTreeMap<Reverse<Version>, ManifestRef>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(untagged)]
+pub enum ManifestRef {
+    Ref { version: Version },
+    Real(Manifest),
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Manifest {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub previous_stable_version: Option<Version>,
+    #[serde(flatten)]
+    pub download_info: BTreeMap<HostPlatform, ManifestDownloadInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ManifestDownloadInfo {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub url: Option<String>,
+    pub etag: String,
+    pub checksum: String,
+    /// Path to binaries in archive. Default to `${tool}${exe}`.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub bin: Option<StringOrArray>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ManifestTemplate {
+    #[serde(flatten)]
+    pub download_info: BTreeMap<HostPlatform, ManifestTemplateDownloadInfo>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ManifestTemplateDownloadInfo {
+    pub url: String,
+    /// Path to binaries in archive. Default to `${tool}${exe}`.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub bin: Option<StringOrArray>,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(deny_unknown_fields)]
+pub struct BaseManifest {
+    /// Link to the GitHub repository.
+    pub repository: String,
+    /// Alternative link for the project.  Automatically detected if possible.
+    pub website: Option<String>,
+    /// Markdown syntax for links to licenses.  Automatically detected if possible.
+    pub license_markdown: Option<String>,
+    /// Prefix of release tag.
+    pub tag_prefix: String,
+    /// Crate name, if this is Rust crate.
+    pub rust_crate: Option<String>,
+    pub default_major_version: Option<String>,
+    /// Asset name patterns.
+    pub asset_name: Option<StringOrArray>,
+    /// Path to binaries in archive. Default to `${tool}${exe}`.
+    pub bin: Option<StringOrArray>,
+    pub signing: Option<Signing>,
+    #[serde(default)]
+    pub broken: Vec<semver::Version>,
+    pub version_range: Option<String>,
+    /// Use glibc build if host_env is gnu.
+    #[serde(default)]
+    pub prefer_linux_gnu: bool,
+    /// Check that the version is yanked not only when updating the manifest,
+    /// but also when running the action.
+    #[serde(default)]
+    pub immediate_yank_reflection: bool,
+    pub platform: BTreeMap<HostPlatform, BaseManifestPlatformInfo>,
+}
+impl BaseManifest {
+    /// Validate the manifest.
+    pub fn validate(&self) {
+        for bin in self.bin.iter().chain(self.platform.values().flat_map(|m| &m.bin)) {
+            assert!(!bin.as_slice().is_empty());
+            for bin in bin.as_slice() {
+                let file_name = Path::new(bin).file_name().unwrap().to_str().unwrap();
+                if !self.repository.ends_with("/xbuild") {
+                    assert!(
+                        !(file_name.contains("${version") || file_name.contains("${rust")),
+                        "{bin}"
+                    );
+                }
+            }
+        }
+    }
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(deny_unknown_fields)]
+pub struct Signing {
+    pub kind: SigningKind,
+}
+
+#[derive(Debug, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "kebab-case")]
+#[serde(deny_unknown_fields)]
+pub enum SigningKind {
+    /// algorithm: minisign
+    /// public key: package.metadata.binstall.signing.pubkey at Cargo.toml
+    /// <https://github.com/cargo-bins/cargo-binstall/blob/HEAD/SIGNING.md>
+    MinisignBinstall,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(deny_unknown_fields)]
+pub struct BaseManifestPlatformInfo {
+    /// Asset name patterns. Default to the value at `BaseManifest::asset_name`.
+    pub asset_name: Option<StringOrArray>,
+    /// Path to binaries in archive. Default to the value at `BaseManifest::bin`.
+    pub bin: Option<StringOrArray>,
+}
+
+#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
+#[serde(untagged)]
+pub enum StringOrArray {
+    String(String),
+    Array(Vec<String>),
+}
+
+impl StringOrArray {
+    #[must_use]
+    pub fn as_slice(&self) -> &[String] {
+        match self {
+            Self::String(s) => slice::from_ref(s),
+            Self::Array(v) => v,
+        }
+    }
+    #[must_use]
+    pub fn map<F: FnMut(&String) -> String>(&self, mut f: F) -> Self {
+        match self {
+            Self::String(s) => Self::String(f(s)),
+            Self::Array(v) => Self::Array(v.iter().map(f).collect()),
+        }
+    }
+}
+
+/// GitHub Actions Runner supports Linux (x86_64, AArch64, Arm), Windows (x86_64, AArch64),
+/// and macOS (x86_64, AArch64).
+/// <https://github.com/actions/runner/blob/v2.321.0/.github/workflows/build.yml#L21>
+/// <https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners#supported-architectures-and-operating-systems-for-self-hosted-runners>
+///
+/// Note:
+/// - Static-linked binaries compiled for linux-musl will also work on linux-gnu systems and are
+///   usually preferred over linux-gnu binaries because they can avoid glibc version issues.
+///   (rustc enables statically linking for linux-musl by default, except for mips.)
+/// - Binaries compiled for x86_64 macOS will usually also work on AArch64 macOS.
+/// - Binaries compiled for x86_64 Windows will usually also work on AArch64 Windows 11+.
+/// - Ignore Arm for now, as we need to consider the version and whether hard-float is supported.
+///   <https://github.com/rust-lang/rustup/pull/593>
+///   <https://github.com/cross-rs/cross/pull/1018>
+///   Does it seem only armv7l+ is supported?
+///   <https://github.com/actions/runner/blob/v2.321.0/src/Misc/externals.sh#L178>
+///   <https://github.com/actions/runner/issues/688>
+// TODO: support musl with dynamic linking like wasmtime 22.0.0+'s musl binaries: <https://github.com/bytecodealliance/wasmtime/releases/tag/v22.0.0>
+#[allow(non_camel_case_types)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]
+pub enum HostPlatform {
+    x86_64_linux_gnu,
+    x86_64_linux_musl,
+    x86_64_macos,
+    x86_64_windows,
+    aarch64_linux_gnu,
+    aarch64_linux_musl,
+    aarch64_macos,
+    aarch64_windows,
+}
+
+impl HostPlatform {
+    #[must_use]
+    pub fn rust_target(self) -> &'static str {
+        match self {
+            Self::x86_64_linux_gnu => "x86_64-unknown-linux-gnu",
+            Self::x86_64_linux_musl => "x86_64-unknown-linux-musl",
+            Self::x86_64_macos => "x86_64-apple-darwin",
+            Self::x86_64_windows => "x86_64-pc-windows-msvc",
+            Self::aarch64_linux_gnu => "aarch64-unknown-linux-gnu",
+            Self::aarch64_linux_musl => "aarch64-unknown-linux-musl",
+            Self::aarch64_macos => "aarch64-apple-darwin",
+            Self::aarch64_windows => "aarch64-pc-windows-msvc",
+        }
+    }
+    #[must_use]
+    pub fn rust_target_arch(self) -> &'static str {
+        match self {
+            Self::aarch64_linux_gnu
+            | Self::aarch64_linux_musl
+            | Self::aarch64_macos
+            | Self::aarch64_windows => "aarch64",
+            Self::x86_64_linux_gnu
+            | Self::x86_64_linux_musl
+            | Self::x86_64_macos
+            | Self::x86_64_windows => "x86_64",
+        }
+    }
+    #[must_use]
+    pub fn rust_target_os(self) -> &'static str {
+        match self {
+            Self::aarch64_linux_gnu
+            | Self::aarch64_linux_musl
+            | Self::x86_64_linux_gnu
+            | Self::x86_64_linux_musl => "linux",
+            Self::aarch64_macos | Self::x86_64_macos => "macos",
+            Self::aarch64_windows | Self::x86_64_windows => "windows",
+        }
+    }
+    #[must_use]
+    pub fn exe_suffix(self) -> &'static str {
+        match self {
+            Self::x86_64_windows | Self::aarch64_windows => ".exe",
+            _ => "",
+        }
+    }
+}