appium-geckodriver 1.2.10 → 1.3.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.3.0](https://github.com/appium/appium-geckodriver/compare/v1.2.11...v1.3.0) (2024-02-10)
+
+
+### Features
+
+* Add doctor checks ([#97](https://github.com/appium/appium-geckodriver/issues/97)) ([c256614](https://github.com/appium/appium-geckodriver/commit/c2566146fab45a9057eb10eedc91c9b8a7597126))
+
+## [1.2.11](https://github.com/appium/appium-geckodriver/compare/v1.2.10...v1.2.11) (2024-01-16)
+
+
+### Miscellaneous Chores
+
+* **deps-dev:** bump semantic-release from 22.0.12 to 23.0.0 ([#95](https://github.com/appium/appium-geckodriver/issues/95)) ([3c9a332](https://github.com/appium/appium-geckodriver/commit/3c9a33222b2f66bc452fe6c0481a91186deba8ff))
+
 ## [1.2.10](https://github.com/appium/appium-geckodriver/compare/v1.2.9...v1.2.10) (2023-12-02)
 
 

package/README.md

@@ -12,13 +12,12 @@ Under the hood this driver is a wrapper/proxy over `geckodriver` binary. Check t
 
 > **Note**
 >
-> Since version 1.0.0 Gecko driver has dropped the support of Appium 1, and is only compatible to Appium 2. Use the `appium driver install gecko` 
+> Since version 1.0.0 Gecko driver has dropped the support of Appium 1, and is only compatible to Appium 2. Use the `appium driver install gecko`
 > command to add it to your Appium 2 dist.
 
+## Requirements
 
-## Usage
-
-It is mandatory to have both Firefox browser installed and the geckodriver binary downloaded on the platform where automated tests are going to be executed. Firefox could be downloaded from the [official download site](https://www.mozilla.org/en-GB/firefox/all/) and the driver binary could be retrieved from the GitHub [releases page](https://github.com/mozilla/geckodriver/releases). The binary must be put into one of the folders included to PATH environment variable. On macOS it also might be necessary to run `xcattr -cr "<binary_path>"` to avoid [notarization](https://firefox-source-docs.mozilla.org/testing/geckodriver/Notarization.html) issues.
+It is mandatory to have both Firefox browser installed and the geckodriver binary downloaded on the platform where automated tests are going to be executed. Firefox could be downloaded from the [official download site](https://www.mozilla.org/en-GB/firefox/all/) and the driver binary could be retrieved from the GitHub [releases page](https://github.com/mozilla/geckodriver/releases). The binary must be put into one of the folders included to PATH environment variable. On macOS it also might be necessary to run `xattr -cr "<binary_path>"` to avoid [notarization](https://firefox-source-docs.mozilla.org/testing/geckodriver/Notarization.html) issues.
 
 Then you need to decide where the automated test is going to be executed. Gecko driver supports the following target platforms:
  - macOS
@@ -26,9 +25,17 @@ Then you need to decide where the automated test is going to be executed. Gecko
  - Linux
  - Android (note that `android` *cannot* be passed as a value to `platformName` capability; it should always equal to the *host* platform name)
 
-In order to run your automated tests on Android it is necessary to have [Android SDK](https://developer.android.com/studio) installed, so the destination device is marked as `online` in the `adb devices -l` command output.
+In order to run your automated tests on an Android device it is necessary to have [Android SDK](https://developer.android.com/studio) installed, so the destination device is marked as `online` in the `adb devices -l` command output.
+
+### Doctor
+
+Since driver version 1.3.0 you can automate the validation for the most of the above
+requirements as well as various optional ones needed by driver extensions by running the
+`appium driver doctor gecko` server command.
 
-Gecko driver allows to define multiple criterions for platform selection and also to fine-tune your automation session properties. This could be done via the following session capabilities:
+## Capabilities
+
+Gecko driver allows defining of multiple criterions for platform selection and also to fine-tune your automation session properties. This could be done via the following session capabilities:
 
 Capability Name | Description
 --- | ---
@@ -49,7 +56,6 @@ setWindowRect | See https://www.w3.org/TR/webdriver/#capabilities
 timeouts | See https://www.w3.org/TR/webdriver/#capabilities
 unhandledPromptBehavior | See https://www.w3.org/TR/webdriver/#capabilities
 
-
 ## Example
 
 ```python
@@ -146,7 +152,6 @@ def test_feature_status_page_filters(driver):
         filt.click()
 ```
 
-
 ## Development
 
 ```bash

package/build/lib/doctor/optional-checks.d.ts

@@ -0,0 +1,47 @@
+export const androidHomeCheck: EnvVarAndPathCheck;
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class AndroidSdkCheck {
+    /** @type {import('@appium/types').AppiumLogger} */
+    log: import('@appium/types').AppiumLogger;
+    TOOL_NAMES: string[];
+    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+    fix(): Promise<string>;
+    hasAutofix(): boolean;
+    isOptional(): boolean;
+}
+export const androidSdkCheck: AndroidSdkCheck;
+export type EnvVarCheckOptions = {
+    /**
+     * If set to true then
+     * the path is expected to be a valid folder
+     */
+    expectDir?: boolean | undefined;
+    /**
+     * If set to true then
+     * the path is expected to be a valid file
+     */
+    expectFile?: boolean | undefined;
+};
+/**
+ * @typedef EnvVarCheckOptions
+ * @property {boolean} [expectDir] If set to true then
+ * the path is expected to be a valid folder
+ * @property {boolean} [expectFile] If set to true then
+ * the path is expected to be a valid file
+ */
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+declare class EnvVarAndPathCheck {
+    /**
+     * @param {string} varName
+     * @param {EnvVarCheckOptions} [opts={}]
+     */
+    constructor(varName: string, opts?: EnvVarCheckOptions | undefined);
+    varName: string;
+    opts: EnvVarCheckOptions;
+    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+    fix(): Promise<string>;
+    hasAutofix(): boolean;
+    isOptional(): boolean;
+}
+export {};
+//# sourceMappingURL=optional-checks.d.ts.map

package/build/lib/doctor/optional-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-checks.d.ts","sourceRoot":"","sources":["../../../lib/doctor/optional-checks.js"],"names":[],"mappings":"AAyEA,kDAA0F;AAE1F,wDAAwD;AACxD;IACE,mDAAmD;IACnD,KADW,OAAO,eAAe,EAAE,YAAY,CAC3C;IAEJ,qBAAiC;IAEjC,+DAsBC;IAED,uBAMC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,8CAAqD;;;;;;;;;;;;;AAjHrD;;;;;;GAMG;AAEH,wDAAwD;AACxD;IACE;;;OAGG;IACH,qBAHW,MAAM,yCAMhB;IAFC,gBAAsB;IACtB,yBAAgB;IAGlB,+DA2BC;IAED,uBAMC;IAED,sBAEC;IAED,sBAEC;CACF"}

package/build/lib/doctor/optional-checks.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.androidSdkCheck = exports.AndroidSdkCheck = exports.androidHomeCheck = void 0;
+/* eslint-disable require-await */
+const support_1 = require("@appium/support");
+const appium_adb_1 = require("appium-adb");
+const ENVIRONMENT_VARS_TUTORIAL_URL = 'https://github.com/appium/java-client/blob/master/docs/environment.md';
+const ANDROID_SDK_LINK1 = 'https://developer.android.com/studio#cmdline-tools';
+const ANDROID_SDK_LINK2 = 'https://developer.android.com/studio/intro/update#sdk-manager';
+/**
+ * @typedef EnvVarCheckOptions
+ * @property {boolean} [expectDir] If set to true then
+ * the path is expected to be a valid folder
+ * @property {boolean} [expectFile] If set to true then
+ * the path is expected to be a valid file
+ */
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+class EnvVarAndPathCheck {
+    /**
+     * @param {string} varName
+     * @param {EnvVarCheckOptions} [opts={}]
+     */
+    constructor(varName, opts = {}) {
+        this.varName = varName;
+        this.opts = opts;
+    }
+    async diagnose() {
+        const varValue = process.env[this.varName];
+        if (!varValue) {
+            return support_1.doctor.nokOptional(`${this.varName} environment variable is NOT set!`);
+        }
+        if (!(await support_1.fs.exists(varValue))) {
+            let errMsg = `${this.varName} is set to '${varValue}' but this path does not exist!`;
+            if (support_1.system.isWindows() && varValue.includes('%')) {
+                errMsg += ` Consider replacing all references to other environment variables with absolute paths.`;
+            }
+            return support_1.doctor.nokOptional(errMsg);
+        }
+        const stat = await support_1.fs.stat(varValue);
+        if (this.opts.expectDir && !stat.isDirectory()) {
+            return support_1.doctor.nokOptional(`${this.varName} is expected to be a valid folder, got a file path instead`);
+        }
+        if (this.opts.expectFile && stat.isDirectory()) {
+            return support_1.doctor.nokOptional(`${this.varName} is expected to be a valid file, got a folder path instead`);
+        }
+        return support_1.doctor.okOptional(`${this.varName} is set to: ${varValue}`);
+    }
+    async fix() {
+        return (`Make sure the environment variable ${this.varName} is properly configured for the Appium process. ` +
+            `Android SDK is required if you want to run your tests on an Android device. ` +
+            `Refer ${ENVIRONMENT_VARS_TUTORIAL_URL} for more details.`);
+    }
+    hasAutofix() {
+        return false;
+    }
+    isOptional() {
+        return true;
+    }
+}
+exports.androidHomeCheck = new EnvVarAndPathCheck('ANDROID_HOME', { expectDir: true });
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+class AndroidSdkCheck {
+    constructor() {
+        this.TOOL_NAMES = ['adb', 'emulator'];
+    }
+    async diagnose() {
+        const listOfTools = this.TOOL_NAMES.join(', ');
+        const sdkRoot = (0, appium_adb_1.getSdkRootFromEnv)();
+        if (!sdkRoot) {
+            return support_1.doctor.nokOptional(`${listOfTools} could not be found because ANDROID_HOME is NOT set!`);
+        }
+        this.log.info(`   Checking ${listOfTools}`);
+        const missingBinaries = [];
+        for (const binary of this.TOOL_NAMES) {
+            try {
+                this.log.info(`     '${binary}' exists in ${await (0, appium_adb_1.getAndroidBinaryPath)(binary)}`);
+            }
+            catch (e) {
+                missingBinaries.push(binary);
+            }
+        }
+        if (missingBinaries.length > 0) {
+            return support_1.doctor.nokOptional(`${missingBinaries.join(', ')} could NOT be found in '${sdkRoot}'!`);
+        }
+        return support_1.doctor.okOptional(`${listOfTools} exist in '${sdkRoot}'`);
+    }
+    async fix() {
+        return (`Manually install Android SDK and set ANDROID_HOME enviornment variable. ` +
+            `Android SDK is required if you want to run your tests on an Android device. ` +
+            `Read ${[ANDROID_SDK_LINK1, ANDROID_SDK_LINK2].join(' and ')}.`);
+    }
+    hasAutofix() {
+        return false;
+    }
+    isOptional() {
+        return true;
+    }
+}
+exports.AndroidSdkCheck = AndroidSdkCheck;
+exports.androidSdkCheck = new AndroidSdkCheck();
+//# sourceMappingURL=optional-checks.js.map

package/build/lib/doctor/optional-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-checks.js","sourceRoot":"","sources":["../../../lib/doctor/optional-checks.js"],"names":[],"mappings":"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"}

package/build/lib/doctor/required-checks.d.ts

@@ -0,0 +1,9 @@
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+export class GeckodriverCheck {
+    diagnose(): Promise<import("@appium/types").DoctorCheckResult>;
+    fix(): Promise<string>;
+    hasAutofix(): boolean;
+    isOptional(): boolean;
+}
+export const geckodriverCheck: GeckodriverCheck;
+//# sourceMappingURL=required-checks.d.ts.map

package/build/lib/doctor/required-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-checks.d.ts","sourceRoot":"","sources":["../../../lib/doctor/required-checks.js"],"names":[],"mappings":"AAOA,wDAAwD;AACxD;IACE,+DAKC;IAED,uBAOC;IAED,sBAEC;IAED,sBAEC;CACF;AACD,gDAAuD"}

package/build/lib/doctor/required-checks.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.geckodriverCheck = exports.GeckodriverCheck = void 0;
+/* eslint-disable require-await */
+const utils_1 = require("./utils");
+const support_1 = require("@appium/support");
+const GD_DOWNLOAD_LINK = 'https://github.com/mozilla/geckodriver/releases';
+const GD_BINARY = `geckodriver${support_1.system.isWindows() ? '.exe' : ''}`;
+/** @satisfies {import('@appium/types').IDoctorCheck} */
+class GeckodriverCheck {
+    async diagnose() {
+        const gdPath = await (0, utils_1.resolveExecutablePath)(GD_BINARY);
+        return gdPath
+            ? support_1.doctor.ok(`${GD_BINARY} is installed at: ${gdPath}`)
+            : support_1.doctor.nok(`${GD_BINARY} cannot be found`);
+    }
+    async fix() {
+        return (`${GD_BINARY} is required to pass W3C commands to the remote browser. ` +
+            `Please download the binary from ${GD_DOWNLOAD_LINK} and store it ` +
+            `to any folder listed in the PATH environment variable. Folders that ` +
+            `are currently present in PATH: ${process.env.PATH}`);
+    }
+    hasAutofix() {
+        return false;
+    }
+    isOptional() {
+        return false;
+    }
+}
+exports.GeckodriverCheck = GeckodriverCheck;
+exports.geckodriverCheck = new GeckodriverCheck();
+//# sourceMappingURL=required-checks.js.map

package/build/lib/doctor/required-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-checks.js","sourceRoot":"","sources":["../../../lib/doctor/required-checks.js"],"names":[],"mappings":";;;AAAA,kCAAkC;AAClC,mCAA8C;AAC9C,6CAA+C;AAE/C,MAAM,gBAAgB,GAAG,iDAAiD,CAAC;AAC3E,MAAM,SAAS,GAAG,cAAc,gBAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAEnE,wDAAwD;AACxD,MAAa,gBAAgB;IAC3B,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAqB,EAAC,SAAS,CAAC,CAAC;QACtD,OAAO,MAAM;YACX,CAAC,CAAC,gBAAM,CAAC,EAAE,CAAC,GAAG,SAAS,qBAAqB,MAAM,EAAE,CAAC;YACtD,CAAC,CAAC,gBAAM,CAAC,GAAG,CAAC,GAAG,SAAS,kBAAkB,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,CACL,GAAG,SAAS,2DAA2D;YACvE,mCAAmC,gBAAgB,gBAAgB;YACnE,sEAAsE;YACtE,kCAAkC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CACrD,CAAC;IACJ,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAxBD,4CAwBC;AACY,QAAA,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/build/lib/doctor/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Return an executable path of cmd
+ *
+ * @param {string} cmd Standard output by command
+ * @return {Promise<string?>} The full path of cmd. `null` if the cmd is not found.
+ */
+export function resolveExecutablePath(cmd: string): Promise<string | null>;
+//# sourceMappingURL=utils.d.ts.map

package/build/lib/doctor/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../lib/doctor/utils.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,2CAHW,MAAM,GACL,QAAQ,MAAM,QAAE,CAU3B"}

package/build/lib/doctor/utils.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveExecutablePath = void 0;
+const support_1 = require("@appium/support");
+/**
+ * Return an executable path of cmd
+ *
+ * @param {string} cmd Standard output by command
+ * @return {Promise<string?>} The full path of cmd. `null` if the cmd is not found.
+ */
+async function resolveExecutablePath(cmd) {
+    try {
+        const executablePath = await support_1.fs.which(cmd);
+        if (executablePath && (await support_1.fs.exists(executablePath))) {
+            return executablePath;
+        }
+    }
+    catch (err) { }
+    return null;
+}
+exports.resolveExecutablePath = resolveExecutablePath;
+//# sourceMappingURL=utils.js.map

package/build/lib/doctor/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../lib/doctor/utils.js"],"names":[],"mappings":";;;AAAA,6CAAmC;AAEnC;;;;;GAKG;AACI,KAAK,UAAU,qBAAqB,CAAC,GAAG;IAC7C,IAAI;QACF,MAAM,cAAc,GAAG,MAAM,YAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,cAAc,IAAI,CAAC,MAAM,YAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE;YACvD,OAAO,cAAc,CAAC;SACvB;KACF;IAAC,OAAO,GAAG,EAAE,GAAE;IAChB,OAAO,IAAI,CAAC;AACd,CAAC;AARD,sDAQC"}