feat: support finding binary using file path

TICKET: VL-4112

Author: louib

README.md

@@ -1,8 +1,8 @@
 # install-github-release-binary
 
-[![Build Status]](https://github.com/EricCrosson/install-github-release-binary/actions/workflows/release.yml)
+[![Build Status]](https://github.com/BitGo/install-github-release-binary/actions/workflows/release.yml)
 
-[build status]: https://github.com/EricCrosson/install-github-release-binary/actions/workflows/release.yml/badge.svg?event=push
+[build status]: https://github.com/BitGo/install-github-release-binary/actions/workflows/release.yml/badge.svg?event=push
 
 **install-github-release-binary** is an opinionated GitHub Action for adding a binary from a GitHub Release to your CI `$PATH`.
 
@@ -18,7 +18,6 @@ This action only supports installing from releases where the release:
 
 - is tagged with the full `{major}.{minor}.{patch}` semantic version
 - contains raw binary assets (archives not supported)
-- assets are labeled with the binary name and [target triple] in the format `<binary name>-<target triple>`
 
 You can create compatible releases with [semantic-release], using a workflow like [semantic-release-action/rust].
 
@@ -32,35 +31,45 @@ Use this action in a step:
 
 ```yaml
 - name: Install flux-capacitor
-  uses: EricCrosson/install-github-release-binary@v2
+  uses: BitGo/install-github-release-binary@v2
   with:
-    targets: EricCrosson/flux-capacitor@v1
+    targets: BitGo/flux-capacitor@v1
 ```
 
 > [!NOTE]
 > I recommend adding an explicit step name, otherwise the step will only reference
-> `EricCrosson/install-github-release-binary@v2`, not your targets.
+> `BitGo/install-github-release-binary@v2`, not your targets.
 
 Install multiple binaries:
 
 ```yaml
 - name: Install future tools
-  uses: EricCrosson/install-github-release-binary@v2
+  uses: BitGo/install-github-release-binary@v2
   with:
     targets: |
-      EricCrosson/flux-capacitor@v1
-      EricCrosson/steam-locomotive@v7.5.3
-      EricCrosson/hoverboard@11.7.3:sha256-8a4600be96d2ec013209042458ce97a9652fcc46c1c855d0217aa42e330fc06e
+      BitGo/flux-capacitor@v1
+      BitGo/steam-locomotive@v7.5.3
+      BitGo/hoverboard@11.7.3:sha256-8a4600be96d2ec013209042458ce97a9652fcc46c1c855d0217aa42e330fc06e
 ```
 
 Install a binary from a release with multiple binaries available:
 
 ```yaml
 - name: Install flux-capacitor
-  uses: EricCrosson/install-github-release-binary@v2
+  uses: BitGo/install-github-release-binary@v2
   with:
     targets: |
-      EricCrosson/future-tools/flux-capacitor@v1
+      BitGo/future-tools/flux-capacitor@v1
+```
+
+Install a specific binary with checksum validation:
+
+```yaml
+- name: Install argocd CLI
+  uses: BitGo/install-github-release-binary@v2
+  with:
+    targets: |
+      argoproj/argo-cd/argocd-linux-amd64@v3.1.4:sha256-7def0aa3cc9ebcd6acdddc27244e7ea4de448d872a9ab0cf6cab4b1e653841a6
 ```
 
 ## Inputs
@@ -82,11 +91,11 @@ Optionally, include:
 
 Examples:
 
-- `EricCrosson/flux-capacitor@v1`
-- `EricCrosson/flux-capacitor@v1.2`
-- `EricCrosson/flux-capacitor@v1.2.3`
-- `EricCrosson/flux-capacitor@v1.2.3:sha256-ad91159c656d427ad8fe5ded2946f29f3a612c6b7a4af6129e9aa85256b7299e`
-- `EricCrosson/future-tools/flux-capacitor@v1`
+- `BitGo/flux-capacitor@v1`
+- `BitGo/flux-capacitor@v1.2`
+- `BitGo/flux-capacitor@v1.2.3`
+- `BitGo/flux-capacitor@v1.2.3:sha256-ad91159c656d427ad8fe5ded2946f29f3a612c6b7a4af6129e9aa85256b7299e`
+- `BitGo/future-tools/flux-capacitor@v1`
 
 [semantic version number]: https://semver.org/
 

dist/index.js

@@ -144,12 +144,22 @@ export async function fetchReleaseAssetMetadataFromTag(
   // When the binary name is provided, look for matching binary and target triple.
   if (isSome(binaryName)) {
     const targetLabel = `${binaryName.value}-${targetTriple}`;
-    const asset = releaseMetadata.data.assets.find(
+
+    // First try to find asset by label (original behavior)
+    let asset = releaseMetadata.data.assets.find(
       (asset) => asset.label === targetLabel,
     );
+
+    // If not found by label, try to find asset by exact name match
+    if (asset === undefined) {
+      asset = releaseMetadata.data.assets.find(
+        (asset) => asset.name === binaryName.value,
+      );
+    }
+
     if (asset === undefined) {
       throw new Error(
-        `Expected to find asset in release ${slug.owner}/${slug.repository}@${tag} with label ${targetLabel}`,
+        `Expected to find asset in release ${slug.owner}/${slug.repository}@${tag} with label ${targetLabel} or name ${binaryName.value}`,
       );
     }
     return {
@@ -160,7 +170,7 @@ export async function fetchReleaseAssetMetadataFromTag(
 
   // When the binary name is not provided, support two use cases:
   // 1. There is only one binary uploaded to this release, a named binary.
-  // 2. There is an asset label matching the target triple (with no binary name).
+  // 2. There is an asset label or name matching the target triple (with no binary name).
   // In both cases, we assume that's the binary the user meant.
   // If there is ambiguity, exit with an error.
   const matchingTargetTriples = releaseMetadata.data.assets.filter(

src/fetch.ts

@@ -8,6 +8,20 @@ const ALL_TARGET_TRIPLES: readonly TargetTriple[] = [
   "x86_64-unknown-linux-musl",
 ] as unknown as readonly TargetTriple[];
 
+// Go-style mappings for the supported target triples
+// Format: {os}-{arch} or {os}_{arch}
+const GO_STYLE_TRIPLES: Record<string, string[]> = {
+  // Maps Go-style platform identifiers to their corresponding architecture
+  "darwin-arm64": ["aarch64-apple-darwin"],
+  "darwin_arm64": ["aarch64-apple-darwin"],
+  "linux-arm64": ["aarch64-unknown-linux-musl"],
+  "linux_arm64": ["aarch64-unknown-linux-musl"],
+  "darwin-amd64": ["x86_64-apple-darwin"],
+  "darwin_amd64": ["x86_64-apple-darwin"],
+  "linux-amd64": ["x86_64-unknown-linux-musl"],
+  "linux_amd64": ["x86_64-unknown-linux-musl"],
+};
+
 function architectureLabel(arch: string): string {
   switch (arch) {
     case "arm64":
@@ -54,16 +68,30 @@ export function getTargetTriple(
 }
 
 /**
- * String the string of its target triple suffix
+ * Strip the string of its target triple suffix
  */
 export function stripTargetTriple(value: string): Option<string> {
-  // Can't strip away the target tuple if nothing else remains
+  // Can't strip away the target triple if nothing else remains
   if (ALL_TARGET_TRIPLES.find((targetTriple) => targetTriple === value)) {
     return none();
   }
-  const stripped = ALL_TARGET_TRIPLES.reduce(
-    (value, targetTriple) => value.replace(new RegExp(`-${targetTriple}$`), ""),
-    value,
-  );
-  return some(stripped);
+
+  // First try to strip standard target triples
+  for (const targetTriple of ALL_TARGET_TRIPLES) {
+    const pattern = new RegExp(`-${targetTriple}$`);
+    if (value.match(pattern)) {
+      return some(value.replace(pattern, ""));
+    }
+  }
+
+  // Then check for Go-style triples
+  for (const goTriple of Object.keys(GO_STYLE_TRIPLES)) {
+    const pattern = new RegExp(`-(${goTriple})$`);
+    if (value.match(pattern)) {
+      return some(value.replace(pattern, ""));
+    }
+  }
+
+  // If no triple was found, return the original value
+  return some(value);
 }

src/platform.ts

@@ -35,3 +35,24 @@ test(
   "should strip a target triple into none",
   check("x86_64-unknown-linux-musl", none()),
 );
+
+// Tests for Go-style binary name stripping
+test(
+  "should strip linux-amd64",
+  check("argocd-linux-amd64", some("argocd")),
+);
+
+test(
+  "should strip linux_amd64",
+  check("argocd-linux_amd64", some("argocd")),
+);
+
+test(
+  "should strip darwin-arm64",
+  check("argocd-darwin-arm64", some("argocd")),
+);
+
+test(
+  "should strip darwin_arm64",
+  check("argocd-darwin_arm64", some("argocd")),
+);