saucectl 0.202.0 → 0.205.0

package/README.md

@@ -16,30 +16,83 @@ The command should be globally available:
 
 ```sh
 $ saucectl -v
-saucectl version 0.4.0
-(build 7468a24c788b4ca4d67d50372c839edf03e5df6a)
+saucectl version 0.197.2
+(build a301436d5b178bcfda8db106c50bfb78ac5be679)
 ```
 
 __Note:__ When you run the command for the first time, it will initially download the binary. This only happens once.
 
-__Note:__ `saucectl` installation is disabled on Sauce Labs Cloud. If you wish to force the installation, set the `SAUCECTL_FORCE_INSTALL` environment variable to `true`.
+__Note:__ `saucectl` installation is disabled on Sauce Labs Cloud. If you wish to force the installation, set
+the `SAUCECTL_FORCE_INSTALL` environment variable to `true`.
 
 ### Install Binary from a Specified Source
 
 If you want the installer to download `saucectl` from a specific source, set the following environment variable:
 
-```
+**macOS/Linux:**
+```bash
 export SAUCECTL_INSTALL_BINARY=http://localhost:9000/saucectl_0.32.2_mac_64-bit.tar.gz
 ```
 
+**Windows (PowerShell):**
+```powershell
+$env:SAUCECTL_INSTALL_BINARY = "http://localhost:9000/saucectl_0.32.2_win_64-bit.zip"
+```
+
+**Windows (Command Prompt):**
+```cmd
+set SAUCECTL_INSTALL_BINARY=http://localhost:9000/saucectl_0.32.2_win_64-bit.zip
+```
+
 ### Install Binary from a Mirror Site
 
-Override the default download site by setting the `SAUCECTL_INSTALL_BINARY_MIRROR` environment variable to a custom URL. The default site is [Sauce Labs saucectl releases](https://github.com/saucelabs/saucectl/releases/download).
+Override the default download site by setting the `SAUCECTL_INSTALL_BINARY_MIRROR` environment variable to a
+custom URL. The default site is [Sauce Labs saucectl releases](https://github.com/saucelabs/saucectl/releases/download).
 
+**macOS/Linux:**
 ```bash
 SAUCECTL_INSTALL_BINARY_MIRROR=https://your-mirror-download-site.com/foo/bar npm i -g saucectl
 ```
 
+**Windows (PowerShell):**
+```powershell
+$env:SAUCECTL_INSTALL_BINARY_MIRROR = "https://your-mirror-download-site.com/foo/bar"
+npm i -g saucectl
+```
+
+**Windows (Command Prompt):**
+```cmd
+set SAUCECTL_INSTALL_BINARY_MIRROR=https://your-mirror-download-site.com/foo/bar
+npm i -g saucectl
+```
+
+### Use a Local Binary
+
+If you already have a `saucectl` binary on your machine, you can point the installer directly to it by setting
+the `SAUCECTL_INSTALL_BINARY_LOCAL` environment variable to the absolute (or relative) path of the binary.
+No download will occur. The binary will be copied into the package's `bin` directory.
+
+**macOS/Linux:**
+```bash
+export SAUCECTL_INSTALL_BINARY_LOCAL=/usr/local/bin/saucectl
+npm i -g saucectl
+```
+
+**Windows (PowerShell):**
+```powershell
+$env:SAUCECTL_INSTALL_BINARY_LOCAL = "C:\tools\saucectl.exe"
+npm i -g saucectl
+```
+
+**Windows (Command Prompt):**
+```cmd
+set SAUCECTL_INSTALL_BINARY_LOCAL=C:\tools\saucectl.exe
+npm i -g saucectl
+```
+
+> **Note:** `SAUCECTL_INSTALL_BINARY_LOCAL` takes precedence over `SAUCECTL_INSTALL_BINARY` and
+> `SAUCECTL_INSTALL_BINARY_MIRROR` if multiple variables are set simultaneously.
+
 ---
 
 For more information about `saucectl`, visit its main repository: [saucelabs/saucectl](https://github.com/saucelabs/saucectl).

package/index.js

@@ -1,15 +1,51 @@
 #!/usr/bin/env node
 const { spawn } = require('child_process');
 const path = require('path');
+const fs = require('fs');
 const { BinWrapper } = require('@saucelabs/bin-wrapper');
 const { Writable } = require('stream');
 
-const version = '0.202.0';
+const version = '0.205.0';
 const defaultBinInstallBase =
   'https://github.com/saucelabs/saucectl/releases/download';
-const binWrapper = (binInstallURL = null, binInstallBase = null) => {
+const binWrapper = (
+  binInstallURL = null,
+  binInstallBase = null,
+  binLocalPath = null,
+) => {
   const bw = new BinWrapper();
 
+  if (binLocalPath) {
+    const resolvedPath = path.resolve(binLocalPath);
+    if (!fs.existsSync(resolvedPath)) {
+      console.error(
+        `Please ensure the path provided by SAUCECTL_INSTALL_BINARY_LOCAL exists: ${resolvedPath}`,
+      );
+      return;
+    }
+    if (!fs.statSync(resolvedPath).isFile()) {
+      console.error(
+        `Please ensure the path provided by SAUCECTL_INSTALL_BINARY_LOCAL points to a file, not a directory: ${resolvedPath}`,
+      );
+      return;
+    }
+    if (binInstallURL || binInstallBase) {
+      console.warn(
+        'SAUCECTL_INSTALL_BINARY_LOCAL is set alongside other binary source environment variables. The local path takes precedence.',
+      );
+    }
+    const binName = process.platform.startsWith('win')
+      ? 'saucectl.exe'
+      : 'saucectl';
+    const binDir = path.join(__dirname, 'bin');
+    fs.mkdirSync(binDir, { recursive: true });
+    fs.copyFileSync(resolvedPath, path.join(binDir, binName));
+    fs.chmodSync(path.join(binDir, binName), 0o755);
+    bw.dest(binDir);
+    bw.use(binName);
+    return bw;
+  }
+
   if (binInstallURL) {
     try {
       new URL(binInstallURL);
@@ -134,6 +170,7 @@ if (require.main === module) {
   const bw = binWrapper(
     process.env.SAUCECTL_INSTALL_BINARY,
     process.env.SAUCECTL_INSTALL_BINARY_MIRROR,
+    process.env.SAUCECTL_INSTALL_BINARY_LOCAL,
   );
   main(bw, process.argv.slice(2));
 }

package/install.js

@@ -23,10 +23,15 @@ async function install() {
       return;
     }
   }
-  console.info('Fetching saucectl binary');
+  console.info(
+    process.env.SAUCECTL_INSTALL_BINARY_LOCAL
+      ? 'Locating local saucectl binary'
+      : 'Fetching saucectl binary',
+  );
   const bw = binWrapper(
     process.env.SAUCECTL_INSTALL_BINARY,
     process.env.SAUCECTL_INSTALL_BINARY_MIRROR,
+    process.env.SAUCECTL_INSTALL_BINARY_LOCAL,
   );
   if (!bw) {
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saucectl",
-  "version": "0.202.0",
+  "version": "0.205.0",
   "description": "Node.js wrapper for saucectl",
   "main": "index.js",
   "bin": "index.js",