# All files / src/helpers command-line.helper.ts

97.71% Statements 171/175
94.73% Branches 54/57
100% Functions 11/11
97.71% Lines 171/175

Press n or j to go to the next uncovered block, b, p or k for the previous block.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97
    98
    99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130
    131
    132
    133
    134
    135
    136
    137
    138
    139
    140
    141
    142
    143
    144
    145
    146
    147
    148
    149
    150
    151
    152
    153
    154
    155
    156
    157
    158
    159
    160
    161
    162
    163
    164
    165
    166
    167
    168
    169
    170
    171
    172
    173
    174
    175
    1761x
    1x
    1x
    33x
    33x
    241x
    241x
    241x
    241x
    33x
    33x
    1x
    34x
    34x
    246x
    246x
    34x
    34x
    34x
    34x
    1x
    21x
    21x
    21x
    21x
    21x
    21x
    21x
    21x
    21x
    21x

    21x
    21x
    1x
    24x
    24x
    21x
    21x
    24x
    24x
    24x
    24x

    24x
    24x
    24x
    24x
    1x
    21x
    21x
    21x
    21x
    21x
    21x
    21x
    28x
    28x
    28x
    1x
    1x
    28x
    28x
    5x
    5x
    5x
    5x
    5x
    28x
    22x
    22x
    21x
    21x
    21x
    21x
    1x
    37x
    37x
    15x
    15x
    5x
    15x
    5x
    15x
    15x
    37x
    37x
    37x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    24x
    24x
    81x
    81x
    81x
    81x
    81x
    4x
    4x
    4x
    81x
    4x
    77x
    73x
    73x
    81x
    24x
    24x
    24x
    1x
    1x
    1x
    1x
    1x
    1x
    1x
    24x
    24x
    81x
    81x
    81x
    81x
    81x
    4x
    81x
    77x
    77x
    77x
    7x
    77x
    4x
    4x
    81x
    81x
    24x
    24x
    24x
    1x
    162x
    162x
    162x
    162x
    162x
    162x
    56x
    56x
    106x
    106x
    106x
    162x
    510x
    510x
    510x
    102x
    102x
    510x
    162x
    162x
     import { PropertyOptions, ArgumentConfig, ArgumentOptions, CommandLineOption } from '../contracts';
    import { isBoolean } from './options.helper';

    export function createCommandLineConfig<T>(config: ArgumentOptions<T>): CommandLineOption[] {
        return Object.keys(config).map((key) => {
            const argConfig: any = config[key as keyof T];
            const definition: PropertyOptions<any> = typeof argConfig === 'object' ? argConfig : { type: argConfig };

            return { name: key, ...definition };
        });
    }

    export function normaliseConfig<T>(config: ArgumentConfig<T>): ArgumentOptions<T> {
        Object.keys(config).forEach((key) => {
            const argConfig: any = config[key as keyof T];
            config[key as keyof T] = typeof argConfig === 'object' ? argConfig : { type: argConfig };
        });

        return config as ArgumentOptions<T>;
    }

    export function mergeConfig<T>(
        parsedConfig: Partial<T>,
        parsedConfigWithoutDefaults: Partial<T>,
        fileContent: Record<string, unknown>,
        options: ArgumentOptions<T>,
        jsonPath: keyof T | undefined,
    ): Partial<T> {
        const configPath: string | undefined = jsonPath ? (parsedConfig[jsonPath] as any) : undefined;
        const configFromFile = resolveConfigFromFile(fileContent, configPath);
        if (configFromFile == null) {
            throw new Error(`Could not resolve config object from specified file and path`);
        }
        return { ...parsedConfig, ...applyTypeConversion(configFromFile, options), ...parsedConfigWithoutDefaults };
    }

    function resolveConfigFromFile<T>(configfromFile: any, configPath?: string): Partial<Record<keyof T, any>> {
        if (configPath == null || configPath == '') {
            return configfromFile as Partial<Record<keyof T, any>>;
        }
        const paths = configPath.split('.');
        const key = paths.shift();

        if (key == null) {
            return configfromFile;
        }

        const config = configfromFile[key];
        return resolveConfigFromFile(config, paths.join('.'));
    }

    function applyTypeConversion<T>(
        configfromFile: Partial<Record<keyof T, any>>,
        options: ArgumentOptions<T>,
    ): Partial<T> {
        const transformedParams: Partial<T> = {};

        Object.keys(configfromFile).forEach((prop) => {
            const key = prop as keyof T;
            const argumentOptions = options[key];
            if (argumentOptions == null) {
                return;
            }
            const fileValue = configfromFile[key];
            if (argumentOptions.multiple || argumentOptions.lazyMultiple) {
                const fileArrayValue = Array.isArray(fileValue) ? fileValue : [fileValue];

                transformedParams[key] = fileArrayValue.map((arrayValue) =>
                    convertType(arrayValue, argumentOptions),
                ) as any;
            } else {
                transformedParams[key] = convertType(fileValue, argumentOptions) as any;
            }
        });

        return transformedParams;
    }

    function convertType<T>(value: any, propOptions: PropertyOptions<T>): any {
        if (propOptions.type.name === 'Boolean') {
            switch (value) {
                case 'true':
                    return propOptions.type(true);
                case 'false':
                    return propOptions.type(false);
            }
        }

        return propOptions.type(value);
    }

    type ArgsAndLastOption = { args: string[]; lastOption?: PropertyOptions<any> };
    type PartialAndLastOption<T> = {
        partial: Partial<T>;
        lastOption?: PropertyOptions<any>;
        lastName?: Extract<keyof T, string>;
    };
    const argNameRegExp = /^-{1,2}(\w+)(=(\w+))?$/;
    const booleanValue = ['1', '0', 'true', 'false'];

    /**
     * commandLineArgs throws an error if we pass aa value for a boolean arg as follows:
     * myCommand -a=true --booleanArg=false --otherArg true
     * this function removes these booleans so as to avoid errors from commandLineArgs
     * @param args
     * @param config
     */
    export function removeBooleanValues<T>(args: string[], config: ArgumentOptions<T>): string[] {
        function removeBooleanArgs(argsAndLastValue: ArgsAndLastOption, arg: string): ArgsAndLastOption {
            const { argOptions, argValue } = getParamConfig(arg, config);

            const lastOption = argsAndLastValue.lastOption;

            if (lastOption != null && isBoolean(lastOption) && booleanValue.some((boolValue) => boolValue === arg)) {
                const args = argsAndLastValue.args.concat();
                args.pop();
                return { args };
            } else if (argOptions != null && isBoolean(argOptions) && argValue != null) {
                return { args: argsAndLastValue.args };
            } else {
                return { args: [...argsAndLastValue.args, arg], lastOption: argOptions };
            }
        }

        return args.reduce<ArgsAndLastOption>(removeBooleanArgs, { args: [] }).args;
    }

    /**
     * Gets the values of any boolean arguments that were specified on the command line with a value
     * These arguments were removed by removeBooleanValues
     * @param args
     * @param config
     */
    export function getBooleanValues<T>(args: string[], config: ArgumentOptions<T>): Partial<T> {
        function getBooleanValues(argsAndLastOption: PartialAndLastOption<T>, arg: string): PartialAndLastOption<T> {
            const { argOptions, argName, argValue } = getParamConfig(arg, config);

            const lastOption = argsAndLastOption.lastOption;

            if (argOptions != null && isBoolean(argOptions) && argValue != null && argName != null) {
                argsAndLastOption.partial[argName] = convertType(argValue, argOptions) as any;
            } else if (
                argsAndLastOption.lastName != null &&
                lastOption != null &&
                isBoolean(lastOption) &&
                booleanValue.some((boolValue) => boolValue === arg)
            ) {
                argsAndLastOption.partial[argsAndLastOption.lastName] = convertType(arg, lastOption) as any;
            }
            return { partial: argsAndLastOption.partial, lastName: argName, lastOption: argOptions };
        }

        return args.reduce<PartialAndLastOption<T>>(getBooleanValues, { partial: {} }).partial;
    }

    function getParamConfig<T>(
        arg: string,
        config: ArgumentOptions<T>,
    ): { argName?: Extract<keyof T, string>; argOptions?: PropertyOptions<any>; argValue?: string } {
        const regExpResult = argNameRegExp.exec(arg);
        if (regExpResult == null) {
            return {};
        }

        const nameOrAlias = regExpResult[1];

        for (const argName in config) {
            const argConfig = config[argName];

            if (argName === nameOrAlias || argConfig.alias === nameOrAlias) {
                return { argOptions: argConfig as PropertyOptions<any>, argName, argValue: regExpResult[3] };
            }
        }
        return {};
    }