apify-cli 0.21.7-beta.3 → 0.21.8-beta.0

package/dist/lib/command-framework/help/CommandHelp.js

@@ -0,0 +1,228 @@
+import chalk from 'chalk';
+import indent from 'indent-string';
+import width from 'string-width';
+import stripAnsi from 'strip-ansi';
+import widestLine from 'widest-line';
+import wrap from 'wrap-ansi';
+import { BaseCommandRenderer } from './_BaseCommandRenderer.js';
+import { getMaxLineWidth } from './consts.js';
+/*
+Executes Actor remotely using your authenticated account.
+
+USAGE
+  $ apify call [ACTORID] -o [--json] [-b <value>] [-t <value>] [-m <value>] [-i <value> | --input-file <value>] [-s]
+
+ARGUMENTS
+  ACTORID  Name or ID of the Actor to run (e.g. "my-actor", "apify/hello-world" or "E2jjCZBezvAZnX8Rb"). If not provided, the command runs the remote Actor specified in the '.actor/actor.json' file.
+
+FLAGS
+  -b, --build=<value>       Tag or number of the build to run (e.g. "latest" or "1.2.34").
+  -i, --input=<value>       Optional JSON input to be given to the Actor.
+  -m, --memory=<value>      Amount of memory allocated for the Actor run, in megabytes.
+  -o, --output-dataset      (required) Prints out the entire default dataset on successful run of the Actor.
+  -s, --silent              Prevents printing the logs of the Actor run to the console.
+  -t, --timeout=<value>     Timeout for the Actor run in seconds. Zero value means there is no timeout.
+      --input-file=<value>  Optional path to a file with JSON input to be given to the Actor. The file must be a valid JSON file. You can also specify `-` to read from standard input.
+
+DESCRIPTION
+  Blah blah blah
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+USAGE
+  $ apify login [-t <value>] [-m console|manual]
+
+FLAGS
+  -m, --method=<option>  [Optional] Method of logging in to Apify
+                         <options: console|manual>
+  -t, --token=<value>    [Optional] Apify API token
+
+ */
+export class CommandHelp extends BaseCommandRenderer {
+    render() {
+        const result = [];
+        this.pushShortDescription(result);
+        this.pushUsageString(result);
+        if (this.command.description) {
+            this.pushDescription(result);
+        }
+        return result.join('\n').trim();
+    }
+    selectiveRender(options) {
+        const result = [];
+        if (options.showShortDescription) {
+            this.pushShortDescription(result);
+        }
+        if (options.showUsageString) {
+            this.pushUsageString(result);
+        }
+        if (options.showDescription && this.command.description) {
+            this.pushDescription(result);
+        }
+        return result.join('\n').trim();
+    }
+    pushUsageString(result) {
+        result.push(chalk.bold('USAGE'));
+        const baseString = `$ ${this.entrypoint} ${this.command.name}`;
+        const indentLevel = 2 + width(baseString);
+        const finalString = [baseString];
+        const args = Object.entries(this.command.args ?? {});
+        if (args.length) {
+            for (const [argName, arg] of args) {
+                if (typeof arg === 'string') {
+                    throw new RangeError('This is a type-check only value, do not actually use it');
+                }
+                this.pushNewLineBeforeNewEntryIfLengthIsPastTheLimit({
+                    state: finalString,
+                    itemToAdd: arg.required ? `<${argName}>` : `[${argName}]`,
+                    indentSize: indentLevel,
+                });
+            }
+        }
+        const flags = Object.entries(this.command.flags ?? {});
+        if (this.command.enableJsonFlag) {
+            flags.push([
+                'json',
+                {
+                    choicesType: null,
+                    flagTag: 'boolean',
+                    hasDefault: false,
+                    required: false,
+                    stdin: null,
+                    builder: null,
+                    aliases: undefined,
+                    char: undefined,
+                    description: 'Format the command output as JSON',
+                    hidden: undefined,
+                    exclusive: undefined,
+                },
+            ]);
+        }
+        const sortedFlags = new Map(flags.sort((a, b) => {
+            if (typeof a[1] === 'string') {
+                throw new RangeError('This is a type-check only value, do not actually use it');
+            }
+            if (typeof b[1] === 'string') {
+                throw new RangeError('This is a type-check only value, do not actually use it');
+            }
+            if (a[1].required && !b[1].required) {
+                return -1;
+            }
+            if (!a[1].required && b[1].required) {
+                return 1;
+            }
+            return a[0].localeCompare(b[0]);
+        }));
+        const flagsToIgnore = new Set();
+        if (flags.length) {
+            for (const [flagName, flag] of sortedFlags) {
+                if (typeof flag === 'string') {
+                    throw new RangeError('This is a type-check only value, do not actually use it');
+                }
+                if (flagsToIgnore.has(flagName)) {
+                    continue;
+                }
+                let requiredState = flag.required;
+                const flagString = this.makeFlagString(flagName, flag);
+                const flagParts = [flagString];
+                if (flag.exclusive?.length) {
+                    for (const exclusiveFlagName of flag.exclusive) {
+                        flagsToIgnore.add(exclusiveFlagName);
+                        const exclusiveFlag = sortedFlags.get(exclusiveFlagName);
+                        const exclusiveFlagString = this.makeFlagString(exclusiveFlagName, exclusiveFlag);
+                        flagParts.push(exclusiveFlagString);
+                        if (exclusiveFlag.required) {
+                            requiredState = true;
+                        }
+                    }
+                }
+                this.pushNewLineBeforeNewEntryIfLengthIsPastTheLimit({
+                    state: finalString,
+                    itemToAdd: requiredState ? flagParts.join(' | ') : `[${flagParts.join(' | ')}]`,
+                    indentSize: indentLevel,
+                });
+            }
+        }
+        const wrapped = wrap(finalString.join(' '), getMaxLineWidth() - indentLevel);
+        // + 1 here is to align everything properly
+        const indented = indent(wrapped, indentLevel + 1).trim();
+        result.push(`  ${indented}`, '');
+        if (args.length) {
+            this.pushArguments(result, args);
+        }
+        if (flags.length) {
+            this.pushFlags(result, sortedFlags);
+        }
+    }
+    pushArguments(result, args) {
+        if (!args.length) {
+            return;
+        }
+        result.push(chalk.bold('ARGUMENTS'));
+        const widestArgNameLength = widestLine(args.map(([argName]) => argName).join('\n'));
+        for (const [argName, arg] of args) {
+            const fullString = `${argName.padEnd(widestArgNameLength)}  ${arg.description}`;
+            // -2 for the space between the name and the description
+            const wrapped = wrap(fullString, getMaxLineWidth() - widestArgNameLength - 2);
+            // +2 for the space between the name and the description
+            // +2 for the indent
+            const indented = indent(wrapped, widestArgNameLength + 2 + 2).trim();
+            result.push(`  ${indented}`);
+        }
+        result.push('');
+    }
+    pushFlags(result, flags) {
+        if (!flags.size) {
+            return;
+        }
+        result.push(chalk.bold('FLAGS'));
+        const linesOfFlags = new Map();
+        for (const [flagName, flag] of flags) {
+            const stringParts = [];
+            if (flag.char) {
+                stringParts.push(`-${flag.char},`);
+            }
+            else {
+                stringParts.push(' '.repeat(3));
+            }
+            switch (flag.flagTag) {
+                case 'boolean':
+                    stringParts.push(`--${this.kebabFlagName(flagName)}`);
+                    break;
+                case 'string':
+                case 'integer': {
+                    const flagValues = flag.choicesType ? '<option>' : '<value>';
+                    stringParts.push(`--${this.kebabFlagName(flagName)}=${chalk.underline(flagValues)}`);
+                    break;
+                }
+                default:
+                    throw new Error(`Unhandled flag tag: ${flag.flagTag}`);
+            }
+            linesOfFlags.set(stringParts.join(' '), flag);
+        }
+        const widestFlagNameLength = widestLine([...linesOfFlags.keys()].join('\n'));
+        for (const [flagString, flag] of linesOfFlags) {
+            const paddingToAdd = widestFlagNameLength - stripAnsi(flagString).length;
+            let fullString = `${flagString}${' '.repeat(paddingToAdd)}  ${flag.description ?? ''}`;
+            if (flag.choicesType?.length) {
+                fullString += `\n<options: ${flag.choicesType.join('|')}>`;
+            }
+            const wrapped = wrap(fullString, getMaxLineWidth() - widestFlagNameLength);
+            const indented = indent(wrapped, widestFlagNameLength)
+                .trim()
+                .split('\n')
+                .map((line) => {
+                // For lines that don't start with a short flag, add 4 spaces to indent them further, and align with the flags that also have a short form
+                if (!/^-[a-z]/.test(line.trim())) {
+                    return `    ${line}`;
+                }
+                return line;
+            })
+                .join('\n');
+            result.push(`  ${indented}`);
+        }
+        result.push('');
+    }
+}
+//# sourceMappingURL=CommandHelp.js.map

package/dist/lib/command-framework/help/CommandHelp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandHelp.js","sourceRoot":"","sources":["../../../../src/lib/command-framework/help/CommandHelp.ts"],"names":[],"mappings":"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"}

package/dist/lib/command-framework/help/CommandWithSubcommands.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommandRenderer, type SelectiveRenderOptions } from './_BaseCommandRenderer.js';
+export declare class CommandWithSubcommandsHelp extends BaseCommandRenderer {
+    render(): string;
+    selectiveRender(options: SelectiveRenderOptions): string;
+    protected pushSubcommands(result: string[]): void;
+}
+//# sourceMappingURL=CommandWithSubcommands.d.ts.map

package/dist/lib/command-framework/help/CommandWithSubcommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandWithSubcommands.d.ts","sourceRoot":"","sources":["../../../../src/lib/command-framework/help/CommandWithSubcommands.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAG7F,qBAAa,0BAA2B,SAAQ,mBAAmB;IAC3D,MAAM;IAcN,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM;IAkB/D,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE;CAyB1C"}

package/dist/lib/command-framework/help/CommandWithSubcommands.js

@@ -0,0 +1,75 @@
+/*
+Manages secure environment variables for Actors.
+
+USAGE
+  $ apify secrets
+
+DESCRIPTION
+  Manages secure environment variables for Actors.
+
+  Example:
+  $ apify secrets add mySecret TopSecretValue123
+
+  The "mySecret" value can be used in an environment variable defined in '.actor/actor.json' file by adding the "@"
+  prefix:
+
+  {
+  "actorSpecification": 1,
+  "name": "my_actor",
+  "environmentVariables": { "SECRET_ENV_VAR": "@mySecret" },
+  "version": "0.1"
+  }
+
+  When the Actor is pushed to Apify cloud, the "SECRET_ENV_VAR" and its value is stored as a secret environment variable
+  of the Actor.
+
+COMMANDS
+  secrets add  Adds a new secret to '~/.apify' for use in Actor environment variables.
+  secrets rm   Permanently deletes a secret from your stored credentials.
+*/
+import chalk from 'chalk';
+import indentString from 'indent-string';
+import widestLine from 'widest-line';
+import wrapAnsi from 'wrap-ansi';
+import { BaseCommandRenderer } from './_BaseCommandRenderer.js';
+import { getMaxLineWidth } from './consts.js';
+export class CommandWithSubcommandsHelp extends BaseCommandRenderer {
+    render() {
+        const result = [];
+        this.pushShortDescription(result);
+        if (this.command.description) {
+            this.pushDescription(result);
+        }
+        this.pushSubcommands(result);
+        return result.join('\n').trim();
+    }
+    selectiveRender(options) {
+        const result = [];
+        if (options.showShortDescription) {
+            this.pushShortDescription(result);
+        }
+        if (options.showDescription && this.command.description) {
+            this.pushDescription(result);
+        }
+        if (options.showSubcommands) {
+            this.pushSubcommands(result);
+        }
+        return result.join('\n').trim();
+    }
+    pushSubcommands(result) {
+        if (!this.command.subcommands?.length) {
+            return;
+        }
+        result.push(chalk.bold('SUBCOMMANDS'));
+        const widestSubcommandNameLength = widestLine(this.command.subcommands.map((subcommand) => `${this.command.name} ${subcommand.name}`).join('\n'));
+        for (const subcommand of this.command.subcommands) {
+            const shortDescription = subcommand.shortDescription || subcommand.description?.split('\n')[0] || '';
+            const fullString = `${this.command.name} ${subcommand.name.padEnd(widestSubcommandNameLength - this.command.name.length - 1)}  ${shortDescription}`;
+            const wrapped = wrapAnsi(fullString, getMaxLineWidth() - widestSubcommandNameLength - 2);
+            const indented = indentString(wrapped, widestSubcommandNameLength + 2 + 2).trim();
+            result.push(`  ${indented}`);
+        }
+        result.push('');
+    }
+}
+//# sourceMappingURL=CommandWithSubcommands.js.map

package/dist/lib/command-framework/help/CommandWithSubcommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandWithSubcommands.js","sourceRoot":"","sources":["../../../../src/lib/command-framework/help/CommandWithSubcommands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BE;AAEF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAA+B,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,OAAO,0BAA2B,SAAQ,mBAAmB;IAC3D,MAAM;QACZ,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAElC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC9B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAE7B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAEM,eAAe,CAAC,OAA+B;QACrD,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAClC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC7B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAES,eAAe,CAAC,MAAgB;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;YACvC,OAAO;QACR,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAEvC,MAAM,0BAA0B,GAAG,UAAU,CAC5C,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAClG,CAAC;QAEF,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACnD,MAAM,gBAAgB,GAAG,UAAU,CAAC,gBAAgB,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAErG,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,0BAA0B,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,gBAAgB,EAAE,CAAC;YAEpJ,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,0BAA0B,GAAG,CAAC,CAAC,CAAC;YAEzF,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,0BAA0B,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAElF,MAAM,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;CACD"}

package/dist/lib/command-framework/help/_BaseCommandRenderer.d.ts

@@ -0,0 +1,25 @@
+import { type BuiltApifyCommand } from '../apify-command.js';
+import type { FlagTag, TaggedFlagBuilder } from '../flags.js';
+export interface SelectiveRenderOptions {
+    showShortDescription?: boolean;
+    showDescription?: boolean;
+    showUsageString?: boolean;
+    showSubcommands?: boolean;
+}
+export declare abstract class BaseCommandRenderer {
+    protected readonly command: typeof BuiltApifyCommand;
+    readonly entrypoint: string;
+    constructor(entrypoint: string, command: typeof BuiltApifyCommand);
+    abstract render(): string;
+    abstract selectiveRender(options: SelectiveRenderOptions): string;
+    protected pushShortDescription(result: string[]): void;
+    protected pushDescription(result: string[]): void;
+    protected pushNewLineBeforeNewEntryIfLengthIsPastTheLimit({ state, itemToAdd, indentSize, }: {
+        state: string[];
+        itemToAdd: string;
+        indentSize: number;
+    }): void;
+    protected kebabFlagName(flagName: string): string;
+    protected makeFlagString(flagName: string, flag: TaggedFlagBuilder<FlagTag, string[] | null, unknown, unknown>): string;
+}
+//# sourceMappingURL=_BaseCommandRenderer.d.ts.map

package/dist/lib/command-framework/help/_BaseCommandRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_BaseCommandRenderer.d.ts","sourceRoot":"","sources":["../../../../src/lib/command-framework/help/_BaseCommandRenderer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,iBAAiB,EAAyC,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG9D,MAAM,WAAW,sBAAsB;IACtC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,8BAAsB,mBAAmB;IACxC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,iBAAiB,CAAC;IAErD,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,iBAAiB;aAKxD,MAAM,IAAI,MAAM;aAEhB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM;IAExE,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE;IAS/C,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE;IAe1C,SAAS,CAAC,+CAA+C,CAAC,EACzD,KAAK,EACL,SAAS,EACT,UAAU,GACV,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAa7D,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM;IAIxC,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;CAsB9G"}

package/dist/lib/command-framework/help/_BaseCommandRenderer.js

@@ -0,0 +1,63 @@
+import chalk from 'chalk';
+import indent from 'indent-string';
+import width from 'string-width';
+import wrap from 'wrap-ansi';
+import { camelCaseToKebabCase, kebabCaseString } from '../apify-command.js';
+import { getMaxLineWidth } from './consts.js';
+export class BaseCommandRenderer {
+    command;
+    entrypoint;
+    constructor(entrypoint, command) {
+        this.entrypoint = entrypoint;
+        this.command = command;
+    }
+    pushShortDescription(result) {
+        if (this.command.shortDescription) {
+            result.push(this.command.shortDescription, '');
+            // Fallback to first line of description
+        }
+        else if (this.command.description) {
+            result.push(this.command.description.split('\n')[0], '');
+        }
+    }
+    pushDescription(result) {
+        if (!this.command.description) {
+            return;
+        }
+        result.push(chalk.bold('DESCRIPTION'));
+        const wrapped = wrap(this.command.description, getMaxLineWidth() - 2, { trim: false });
+        const indented = indent(wrapped, 2);
+        result.push(indented);
+        result.push('');
+    }
+    pushNewLineBeforeNewEntryIfLengthIsPastTheLimit({ state, itemToAdd, indentSize, }) {
+        // Check the _last line_ of the state, not the whole string, as otherwise we get false positives
+        const currentLength = width(state.join(' ').split('\n').at(-1) || '') + indentSize;
+        const sizeOfItemToAdd = width(itemToAdd);
+        if (currentLength + sizeOfItemToAdd > getMaxLineWidth()) {
+            state.push('\n');
+        }
+        state.push(itemToAdd);
+    }
+    kebabFlagName(flagName) {
+        return kebabCaseString(camelCaseToKebabCase(flagName)).toLowerCase();
+    }
+    makeFlagString(flagName, flag) {
+        const flagKey = this.kebabFlagName(flagName);
+        const mainFlagPart = flag.char ? `-${flag.char}` : `--${flagKey}`;
+        switch (flag.flagTag) {
+            case 'boolean': {
+                return mainFlagPart;
+            }
+            case 'string':
+            case 'integer': {
+                const flagValues = flag.choicesType?.length ? `${flag.choicesType.join('|')}` : '<value>';
+                return `${mainFlagPart} ${flagValues}`;
+            }
+            default: {
+                throw new RangeError(`Unhandled flag type: ${flag.flagTag}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=_BaseCommandRenderer.js.map

package/dist/lib/command-framework/help/_BaseCommandRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_BaseCommandRenderer.js","sourceRoot":"","sources":["../../../../src/lib/command-framework/help/_BaseCommandRenderer.ts"],"names":[],"mappings":"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"}

package/dist/lib/command-framework/help/consts.d.ts

@@ -0,0 +1,2 @@
+export declare function getMaxLineWidth(): number;
+//# sourceMappingURL=consts.d.ts.map

package/dist/lib/command-framework/help/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../../../src/lib/command-framework/help/consts.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,WAwB9B"}

package/dist/lib/command-framework/help/consts.js

@@ -0,0 +1,27 @@
+let cachedMaxLineWidth;
+export function getMaxLineWidth() {
+    if (cachedMaxLineWidth) {
+        return cachedMaxLineWidth;
+    }
+    const override = Number(process.env.APIFY_CLI_MAX_LINE_WIDTH);
+    if (!Number.isNaN(override)) {
+        cachedMaxLineWidth = override;
+    }
+    else if (!process.stdout.isTTY) {
+        cachedMaxLineWidth = 80;
+    }
+    else {
+        const windowWidth = process.stdout.getWindowSize?.()[0] ?? -1;
+        if (windowWidth < 1) {
+            cachedMaxLineWidth = 80;
+        }
+        else if (windowWidth < 40) {
+            cachedMaxLineWidth = 40;
+        }
+        else {
+            cachedMaxLineWidth = windowWidth;
+        }
+    }
+    return cachedMaxLineWidth;
+}
+//# sourceMappingURL=consts.js.map

package/dist/lib/command-framework/help/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../../../src/lib/command-framework/help/consts.ts"],"names":[],"mappings":"AAAA,IAAI,kBAAsC,CAAC;AAE3C,MAAM,UAAU,eAAe;IAC9B,IAAI,kBAAkB,EAAE,CAAC;QACxB,OAAO,kBAAkB,CAAC;IAC3B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAE9D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,kBAAkB,GAAG,QAAQ,CAAC;IAC/B,CAAC;SAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClC,kBAAkB,GAAG,EAAE,CAAC;IACzB,CAAC;SAAM,CAAC;QACP,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAE9D,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACrB,kBAAkB,GAAG,EAAE,CAAC;QACzB,CAAC;aAAM,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YAC7B,kBAAkB,GAAG,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACP,kBAAkB,GAAG,WAAW,CAAC;QAClC,CAAC;IACF,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC3B,CAAC"}

package/dist/lib/command-framework/help.d.ts

@@ -0,0 +1,7 @@
+import type { BuiltApifyCommand } from './apify-command.js';
+import type { SelectiveRenderOptions } from './help/_BaseCommandRenderer.js';
+export declare function registerCommandForHelpGeneration(entrypoint: string, command: typeof BuiltApifyCommand): void;
+export declare function renderHelpForCommand(command: typeof BuiltApifyCommand): string;
+export declare function selectiveRenderHelpForCommand(command: typeof BuiltApifyCommand, options: SelectiveRenderOptions): string;
+export declare function renderMainHelpMenu(entrypoint: string): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/lib/command-framework/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/lib/command-framework/help.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAuB,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAOlG,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,iBAAiB,QAkBrG;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,iBAAiB,UAQrE;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,iBAAiB,EAAE,OAAO,EAAE,sBAAsB,UAQ/G;AASD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,UA0FpD"}

package/dist/lib/command-framework/help.js

@@ -0,0 +1,104 @@
+import chalk from 'chalk';
+import indentString from 'indent-string';
+import widestLine from 'widest-line';
+import wrapAnsi from 'wrap-ansi';
+import { cliDescription, cliVersion } from '../consts.js';
+import { error } from '../outputs.js';
+import { mapGroupBy } from '../utils.js';
+import { CommandHelp } from './help/CommandHelp.js';
+import { CommandWithSubcommandsHelp } from './help/CommandWithSubcommands.js';
+import { getMaxLineWidth } from './help/consts.js';
+const commands = new Map();
+export function registerCommandForHelpGeneration(entrypoint, command) {
+    if (command.name.toLowerCase() !== command.name) {
+        error({
+            message: `Command name "${command.name}" is not correctly set up internally. Make sure you fill out the "name" field in the command class extension.`,
+        });
+        return;
+    }
+    if (command.subcommands?.length) {
+        commands.set(command, new CommandWithSubcommandsHelp(entrypoint, command));
+        for (const subcommand of command.subcommands) {
+            registerCommandForHelpGeneration(`${entrypoint} ${command.name}`, subcommand);
+        }
+    }
+    else {
+        commands.set(command, new CommandHelp(entrypoint, command));
+    }
+}
+export function renderHelpForCommand(command) {
+    const renderer = commands.get(command);
+    if (!renderer) {
+        throw new Error(`No help renderer found for command ${command.name}`);
+    }
+    return renderer.render();
+}
+export function selectiveRenderHelpForCommand(command, options) {
+    const renderer = commands.get(command);
+    if (!renderer) {
+        throw new Error(`No help renderer found for command ${command.name}`);
+    }
+    return renderer.selectiveRender(options);
+}
+function sortByName(itemA, itemB) {
+    return itemA[0].name.localeCompare(itemB[0].name);
+}
+export function renderMainHelpMenu(entrypoint) {
+    const result = [];
+    result.push(cliDescription, '');
+    result.push(chalk.bold('VERSION'));
+    result.push(`  ${cliVersion}`);
+    result.push('');
+    result.push(chalk.bold('USAGE'));
+    result.push(`  $ ${entrypoint} <command> [options]`);
+    result.push('');
+    const allGroupedByType = mapGroupBy(commands, ([command, helpGenerator]) => {
+        // We register the help generators for all subcommands with an entrypoint that includes the root command,
+        // so we need to ignore those
+        if (helpGenerator.entrypoint.includes(' ')) {
+            return 'ignored';
+        }
+        if (command.hidden) {
+            return 'ignored';
+        }
+        if (helpGenerator instanceof CommandWithSubcommandsHelp) {
+            return 'subcommand';
+        }
+        return 'command';
+    });
+    const groupedSubcommands = allGroupedByType.get('subcommand')?.sort(sortByName);
+    const groupedCommands = allGroupedByType.get('command')?.sort(sortByName);
+    if (groupedSubcommands?.length) {
+        result.push(chalk.bold('TOPICS'));
+        const lines = [];
+        const widestTopicNameLength = widestLine(groupedSubcommands.map(([subcommand]) => subcommand.name).join('\n'));
+        for (const [subcommand] of groupedSubcommands) {
+            if (subcommand.hidden) {
+                continue;
+            }
+            const shortDescription = subcommand.shortDescription || subcommand.description?.split('\n')[0] || '';
+            const fullString = `${subcommand.name.padEnd(widestTopicNameLength)}  ${shortDescription}`;
+            const wrapped = wrapAnsi(fullString, getMaxLineWidth() - widestTopicNameLength - 2);
+            lines.push(`  ${indentString(wrapped, widestTopicNameLength + 2 + 2).trim()}`);
+        }
+        result.push(...lines, '');
+    }
+    if (groupedCommands?.length) {
+        result.push(chalk.bold('COMMANDS'));
+        const lines = [];
+        const widestCommandNameLength = widestLine(groupedCommands.map(([command]) => command.name).join('\n'));
+        for (const [command] of groupedCommands) {
+            if (command.hidden) {
+                continue;
+            }
+            const shortDescription = command.shortDescription || command.description?.split('\n')[0] || '';
+            const fullString = `${command.name.padEnd(widestCommandNameLength)}  ${shortDescription}`;
+            const wrapped = wrapAnsi(fullString, getMaxLineWidth() - widestCommandNameLength - 2);
+            lines.push(`  ${indentString(wrapped, widestCommandNameLength + 2 + 2).trim()}`);
+        }
+        result.push(...lines, '');
+    }
+    result.push(chalk.bold('TROUBLESHOOTING'), '  For general support, reach out to us at https://apify.com/contact', '', '  If you believe you are encountering a bug, file it at https://github.com/apify/apify-cli/issues/new');
+    return result.join('\n').trim();
+}
+//# sourceMappingURL=help.js.map

package/dist/lib/command-framework/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/lib/command-framework/help.ts"],"names":[],"mappings":"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"}

package/dist/lib/commands/read-stdin.d.ts

@@ -1,2 +1,3 @@
-export declare function readStdin(stdinStream: typeof process.stdin): Promise<Buffer<ArrayBuffer> | undefined>;
+import process from 'node:process';
+export declare function readStdin(stdinStream?: typeof process.stdin): Promise<Buffer<ArrayBuffer> | undefined>;
 //# sourceMappingURL=read-stdin.d.ts.map

package/dist/lib/commands/read-stdin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-stdin.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/read-stdin.ts"],"names":[],"mappings":"AAMA,wBAAsB,SAAS,CAAC,WAAW,EAAE,OAAO,OAAO,CAAC,KAAK,4CA6BhE"}
+{"version":3,"file":"read-stdin.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/read-stdin.ts"],"names":[],"mappings":"AAEA,OAAO,OAAO,MAAM,cAAc,CAAC;AAKnC,wBAAsB,SAAS,CAAC,WAAW,GAAE,OAAO,OAAO,CAAC,KAAqB,4CA8FhF"}