mirror of
https://github.com/appium/appium.git
synced 2026-10-19 06:22:22 +08:00
Mykola Mokhnach
2ed7bb04d8
BREAKING CHANGE: @appium/docutils is now an ESM-only package. It can no longer be loaded via CommonJS require(); consumers must use import or dynamic import(). Deep imports into the package's internals are no longer possible — only the public entry point is exposed via exports.
84 lines
2.6 KiB
TypeScript
84 lines
2.6 KiB
TypeScript
/**
|
|
* Provides functions to validate user-provided options as part of Yargs' post-parsing "check" phase
|
|
* @module
|
|
*/
|
|
|
|
import {fs, util} from '@appium/support';
|
|
import type {Options} from 'yargs';
|
|
|
|
import {getLogger} from '../logger.js';
|
|
import {kebabCase} from '../utils/index.js';
|
|
|
|
const log = getLogger('check');
|
|
|
|
/**
|
|
* Data structure describing a missing file; returned by {@linkcode filterMissing}
|
|
*/
|
|
interface MissingFileData {
|
|
/**
|
|
* Arbitrary identifier; intent was to map to an option name
|
|
*/
|
|
id: string;
|
|
/**
|
|
* Normalized filepath
|
|
*/
|
|
path: string;
|
|
}
|
|
|
|
/**
|
|
* Takes user-provided paths and checks for existence.
|
|
*
|
|
* Filters options to consider based on group name only.
|
|
*
|
|
* Meant to be used as a "fail-fast" strategy on the CLI, so we don't go all the way through some
|
|
* expensive behavior before realizing we're missing a path.
|
|
* @param opts Options object for a yargs command
|
|
* @param group Group name to filter on
|
|
* @param argv User-provided args
|
|
* @returns `true` if all paths exist or otherwise an error message
|
|
*/
|
|
export async function checkMissingPaths<T extends Record<string, Options>>(
|
|
opts: T,
|
|
group: string,
|
|
argv: Record<string, unknown>,
|
|
): Promise<true | string> {
|
|
const argsToCheck = Object.keys(opts).filter((id) => opts[id]?.group === group && id in argv);
|
|
|
|
// yargs is pretty loose about allowing CLI args multiple times, and the value could potentially
|
|
// be a `string[]` instead of `string`; we don't want to allow more than one path per arg.
|
|
if (!argsToCheck.every((id) => typeof argv[id] === 'string')) {
|
|
return 'Paths may only be provided once each';
|
|
}
|
|
|
|
const pathsToCheck: MissingFileData[] = argsToCheck.map((id) => ({
|
|
id,
|
|
path: String(argv[id]), // this must be a string per the above check
|
|
}));
|
|
|
|
log.debug(
|
|
'Checking for existence of %s: %s',
|
|
util.pluralize('path', pathsToCheck.length),
|
|
pathsToCheck.map(({path}) => path),
|
|
);
|
|
|
|
const missingPaths = await filterMissing(pathsToCheck);
|
|
|
|
if (missingPaths.length) {
|
|
return missingPaths
|
|
.map(({id, path}) => `Default or specified path via --${kebabCase(id)} (${path}) does not exist`)
|
|
.join('\n');
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Given a list of objects with `id` and `path` props, filters out the ones that do not exist
|
|
* @param paths Filepaths
|
|
* @returns Missing files
|
|
*/
|
|
async function filterMissing(paths: MissingFileData[]): Promise<MissingFileData[]> {
|
|
const exists = await Promise.all(paths.map(async ({id, path}) => ({id, path, exists: await fs.exists(path)})));
|
|
return exists.filter((result) => !result.exists).map(({id, path}) => ({id, path}));
|
|
}
|