@salesforce/plugin-apex 1.5.1 → 2.2.0

package/lib/reporters/testReporter.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestReporter = void 0;
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const apex_node_1 = require("@salesforce/apex-node");
+const core_1 = require("@salesforce/core");
+const utils_1 = require("../utils");
+const jsonReporter_1 = require("./jsonReporter");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-apex', 'runtest');
+class TestReporter {
+    /**
+     * Create a TestReporter that will format test results
+     *
+     * @param ux a new Ux instance based on if the command is in json mode
+     * @param connection a connection to the org the tests are being run against - used for getting username for hints
+     * @param bin the bin of the cli, used for providing suggestions in the users cli
+     */
+    constructor(ux, connection, bin) {
+        this.ux = ux;
+        this.connection = connection;
+        this.bin = bin;
+    }
+    async report(result, options) {
+        if (options['output-dir']) {
+            const jsonOutput = this.formatResultInJson(result);
+            const outputDirConfig = this.buildOutputDirConfig(result, jsonOutput, options['output-dir'], options['result-format'], options['detailed-coverage'], options.synchronous);
+            const testService = new apex_node_1.TestService(this.connection);
+            await testService.writeResultFiles(result, outputDirConfig, options['code-coverage']);
+        }
+        try {
+            if (result.summary && result.summary.outcome === "Failed" /* ApexTestRunResultStatus.Failed */) {
+                process.exitCode = utils_1.FAILURE_EXIT_CODE;
+            }
+            switch (options['result-format']) {
+                case 'human':
+                    this.logHuman(result, options['detailed-coverage'], options['output-dir']);
+                    break;
+                case 'tap':
+                    this.logTap(result);
+                    break;
+                case 'junit':
+                    this.logJUnit(result);
+                    break;
+                case 'json':
+                    // when --json flag is specified, we should log CLI json format
+                    if (!options.json) {
+                        this.ux.styledJSON({
+                            status: process.exitCode,
+                            result: this.formatResultInJson(result),
+                        });
+                    }
+                    break;
+                default:
+                    this.logHuman(result, options['detailed-coverage'], options['output-dir']);
+            }
+        }
+        catch (e) {
+            this.ux.styledJSON(result);
+            throw messages.createError('testResultProcessErr', [e.message]);
+        }
+        return this.formatResultInJson(result);
+    }
+    /**
+     * Builds output directory configuration with CLI format result files
+     *
+     * @param result Test results from async/sync test run
+     * @param jsonOutput JSON CLI format of test results
+     * @param outputDir Output directory for result files
+     * @param resultFormat Result format for output files
+     * @param detailedCoverage Boolean to control detailed coverage reporting
+     * @param synchronous Whether the test run was synchronous
+     * @returns Output directory configuration
+     */
+    // eslint-disable-next-line class-methods-use-this
+    buildOutputDirConfig(result, jsonOutput, outputDir, resultFormat, detailedCoverage, synchronous = false) {
+        const outputDirConfig = {
+            dirPath: outputDir,
+        };
+        if ('summary' in result) {
+            jsonOutput = jsonOutput;
+            if (typeof resultFormat !== 'undefined' || synchronous) {
+                outputDirConfig.fileInfos = [
+                    {
+                        filename: result.summary.testRunId ? `test-result-${result.summary.testRunId}.json` : 'test-result.json',
+                        content: jsonOutput,
+                    },
+                    ...(jsonOutput.coverage
+                        ? [
+                            {
+                                filename: 'test-result-codecoverage.json',
+                                content: jsonOutput.coverage?.coverage,
+                            },
+                        ]
+                        : []),
+                ];
+                outputDirConfig.resultFormats = [apex_node_1.ResultFormat.junit];
+            }
+            if (typeof resultFormat === 'undefined' && synchronous) {
+                resultFormat = apex_node_1.ResultFormat.human;
+            }
+            switch (resultFormat) {
+                case apex_node_1.ResultFormat.tap:
+                    outputDirConfig.fileInfos?.push({
+                        filename: 'test-result.txt',
+                        content: new apex_node_1.TapReporter().format(result),
+                    });
+                    outputDirConfig.resultFormats?.push(apex_node_1.ResultFormat.tap);
+                    break;
+                case apex_node_1.ResultFormat.junit:
+                    outputDirConfig.fileInfos?.push({
+                        filename: 'test-result.xml',
+                        content: new apex_node_1.JUnitReporter().format(result),
+                    });
+                    break;
+                case apex_node_1.ResultFormat.human:
+                    outputDirConfig.fileInfos?.push({
+                        filename: 'test-result.txt',
+                        content: new apex_node_1.HumanReporter().format(result, detailedCoverage),
+                    });
+                    break;
+                default:
+                    break;
+            }
+        }
+        return outputDirConfig;
+    }
+    formatResultInJson(result) {
+        try {
+            const reporter = new jsonReporter_1.JsonReporter();
+            return reporter.format(result);
+        }
+        catch (e) {
+            this.ux.styledJSON(result);
+            throw messages.createError('testResultProcessErr', [e.message]);
+        }
+    }
+    logHuman(result, detailedCoverage, outputDir) {
+        if (outputDir) {
+            this.ux.log(messages.getMessage('outputDirHint', [outputDir]));
+        }
+        const humanReporter = new apex_node_1.HumanReporter();
+        const output = humanReporter.format(result, detailedCoverage);
+        this.ux.log(output);
+    }
+    logTap(result) {
+        const reporter = new apex_node_1.TapReporter();
+        const hint = this.formatReportHint(result);
+        this.ux.log(reporter.format(result, [hint]));
+    }
+    logJUnit(result) {
+        const reporter = new apex_node_1.JUnitReporter();
+        this.ux.log(reporter.format(result));
+    }
+    formatReportHint(result) {
+        let reportArgs = `-i ${result.summary.testRunId}`;
+        const username = this.connection?.getUsername();
+        if (username) {
+            reportArgs += ` -o ${username}`;
+        }
+        return messages.getMessage('apexTestReportFormatHint', [this.bin, reportArgs]);
+    }
+}
+exports.TestReporter = TestReporter;
+//# sourceMappingURL=testReporter.js.map

package/lib/reporters/testReporter.js.map

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

package/lib/utils.d.ts

@@ -3,6 +3,4 @@ export declare const FAILURE_EXIT_CODE = 100;
 export declare const colorSuccess: chalk.Chalk;
 export declare const colorError: chalk.Chalk;
 export declare const resultFormat: string[];
-export declare const logLevels: string[];
-export declare function buildDescription(shortDescription: string, longDescription: string): string;
 export declare function colorLogs(log: string): string;

package/lib/utils.js

@@ -6,30 +6,12 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.colorLogs = exports.buildDescription = exports.logLevels = exports.resultFormat = exports.colorError = exports.colorSuccess = exports.FAILURE_EXIT_CODE = void 0;
+exports.colorLogs = exports.resultFormat = exports.colorError = exports.colorSuccess = exports.FAILURE_EXIT_CODE = void 0;
 const chalk = require("chalk");
 exports.FAILURE_EXIT_CODE = 100;
 exports.colorSuccess = chalk.bold.green;
 exports.colorError = chalk.bold.red;
 exports.resultFormat = ['human', 'tap', 'junit', 'json'];
-exports.logLevels = [
-    'trace',
-    'debug',
-    'info',
-    'warn',
-    'error',
-    'fatal',
-    'TRACE',
-    'DEBUG',
-    'INFO',
-    'WARN',
-    'ERROR',
-    'FATAL',
-];
-function buildDescription(shortDescription, longDescription) {
-    return `${shortDescription}\n${longDescription}`;
-}
-exports.buildDescription = buildDescription;
 const colorMap = new Map([
     [new RegExp(/\b([\w]+\.)+(\w)+\b/g), chalk.blueBright],
     [new RegExp(/\b(DEBUG)\b/g), chalk.bold.cyan],
@@ -45,8 +27,7 @@ function replace(regex, word) {
     if (!color) {
         throw new Error('Error retrieving colors');
     }
-    const result = word.replace(regex, (match) => `${color(match)}`);
-    return result;
+    return word.replace(regex, (match) => `${color(match)}`);
 }
 function colorLogs(log) {
     for (const c of colorMap.keys()) {

package/lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+BAA+B;AAElB,QAAA,iBAAiB,GAAG,GAAG,CAAC;AAExB,QAAA,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;AAChC,QAAA,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;AAE5B,QAAA,YAAY,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACjD,QAAA,SAAS,GAAG;IACvB,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;CACR,CAAC;AAEF,SAAgB,gBAAgB,CAAC,gBAAwB,EAAE,eAAuB;IAChF,OAAO,GAAG,gBAAgB,KAAK,eAAe,EAAE,CAAC;AACnD,CAAC;AAFD,4CAEC;AAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACvB,CAAC,IAAI,MAAM,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC;IACtD,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC7C,CAAC,IAAI,MAAM,CAAC,8BAA8B,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;IAC9D,CAAC,IAAI,MAAM,CAAC,qBAAqB,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;IACtD,CAAC,IAAI,MAAM,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACzD,CAAC,IAAI,MAAM,CAAC,4BAA4B,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IAC1D,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACxC,CAAC,IAAI,MAAM,CAAC,+BAA+B,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC;CAChE,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,KAAa,EAAE,IAAY;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE;QACV,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;KAC5C;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,SAAS,CAAC,GAAW;IACnC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE;QAC/B,GAAG,GAAG,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;KACvB;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AALD,8BAKC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+BAA+B;AAClB,QAAA,iBAAiB,GAAG,GAAG,CAAC;AACxB,QAAA,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;AAChC,QAAA,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;AAE5B,QAAA,YAAY,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAE9D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACvB,CAAC,IAAI,MAAM,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC;IACtD,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC7C,CAAC,IAAI,MAAM,CAAC,8BAA8B,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;IAC9D,CAAC,IAAI,MAAM,CAAC,qBAAqB,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;IACtD,CAAC,IAAI,MAAM,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACzD,CAAC,IAAI,MAAM,CAAC,4BAA4B,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IAC1D,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACxC,CAAC,IAAI,MAAM,CAAC,+BAA+B,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC;CAChE,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,KAAa,EAAE,IAAY;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE;QACV,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;KAC5C;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,SAAS,CAAC,GAAW;IACnC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE;QAC/B,GAAG,GAAG,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;KACvB;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AALD,8BAKC"}

package/messages/get.md

@@ -0,0 +1,45 @@
+# summary
+
+Fetch the specified log or given number of most recent logs from the org.
+
+# description
+
+To get the IDs for your debug logs, run "<%= config.bin %> apex log list". Executing this command without flags returns the most recent log.
+
+# examples
+
+- Fetch the log in your default org using an ID:
+
+  <%= config.bin %> <%= command.id %> --log-id <log id>
+
+- Fetch the log in the org with the specified username using an ID:
+
+  <%= config.bin %> <%= command.id %> --log-id <log id> --target-org me@my.org
+
+- Fetch the two most recent logs in your default org:
+
+  <%= config.bin %> <%= command.id %> --number 2
+
+- Similar to previous example, but save the two log files in the specified directory:
+
+  <%= config.bin %> <%= command.id %> --output-dir /Users/sfdxUser/logs --number 2
+
+# flags.log-id.summary
+
+ID of the specific log to display.
+
+# flags.number.summary
+
+Number of the most recent logs to display.
+
+# flags.output-dir.summary
+
+Directory for saving the log files.
+
+# flags.output-dir.description
+
+The location can be an absolute path or relative to the current working directory. The default is the current directory.
+
+# noResultsFound
+
+No results found

package/messages/list.md

@@ -0,0 +1,63 @@
+# summary
+
+Display a list of IDs and general information about debug logs.
+
+# description
+
+Run this command in a project to list the IDs and general information for all debug logs in your default org.
+
+To fetch a specific log from your org, obtain the ID from this command's output, then run the “<%= config.bin %> apex log get” command.
+
+# examples
+
+- List the IDs and information about the debug logs in your default org:
+
+  <%= config.bin %> <%= command.id %>
+
+- Similar to previous example, but use the org with the specified username:
+
+  <%= config.bin %> <%= command.id %> --target-org me@my.org
+
+# noDebugLogsFound
+
+No debug logs found in org
+
+# appColHeader
+
+APPLICATION
+
+# durationColHeader
+
+DURATION (MS)
+
+# idColHeader
+
+ID
+
+# locationColHeader
+
+LOCATION
+
+# sizeColHeader
+
+SIZE (B)
+
+# userColHeader
+
+LOG USER
+
+# operationColHeader
+
+OPERATION
+
+# requestColHeader
+
+REQUEST
+
+# timeColHeader
+
+START TIME
+
+# statusColHeader
+
+STATUS

package/messages/report.md

@@ -0,0 +1,45 @@
+# summary
+
+Display test results for a specific asynchronous test run.
+
+# description
+
+Provide a test run ID to display test results for an enqueued or completed asynchronous test run. The test run ID is displayed after running the "<%= config.bin %> apex test run" command.
+
+# examples
+
+- Display test results for your default org using a test run ID:
+
+  <%= config.bin %> <%= command.id %> --test-run-id <test run id>
+
+- Similar to previous example, but output the result in JUnit format:
+
+  <%= config.bin %> <%= command.id %> --test-run-id <test run id> --result-format junit
+
+- Also retrieve code coverage results and output in JSON format:
+
+  <%= config.bin %> <%= command.id %> --test-run-id <test run id> --code-coverage --json
+
+- Specify a directory in which to save the test results from the org with the specified username (rather than your default org):
+
+  <%= config.bin %> <%= command.id %> --test-run-id <test run id> --code-coverage --output-dir <path to outputdir> --target-org me@myorg',
+
+# flags.test-run-id.summary
+
+ID of the test run.
+
+# flags.result-format.summary
+
+Format of the results.
+
+# flags.code-coverage.summary
+
+Retrieve code coverage results.
+
+# flags.output-dir.summary
+
+Directory in which to store test result files.
+
+# apexLibErr
+
+Unknown error in Apex Library: %s

package/messages/run.md

@@ -0,0 +1,48 @@
+# summary
+
+Execute anonymous Apex code entered on the command line or from a local file.
+
+# description
+
+If you don’t run this command from within a Salesforce DX project, you must specify the —-target-org flag.
+
+To execute your code interactively, run this command with no flags. At the prompt, enter all your Apex code; press CTRL-D when you're finished. Your code is then executed in a single execute anonymous request.
+For more information, see "Anonymous Blocks" in the Apex Developer Guide.
+
+# flags.file
+
+Path to a local file that contains Apex code.
+
+# examples
+
+- Execute the Apex code that's in the ~/test.apex file in the org with the specified username:
+
+  <%= config.bin %> <%= command.id %> --target-org testusername@salesforce.org --apex-code-file ~/test.apex
+
+- Similar to previous example, but execute the code in your default org:
+
+  <%= config.bin %> <%= command.id %> --apex-code-file ~/test.apex
+
+- Run the command with no flags to start interactive mode; the code will execute in your default org when you exit. At the prompt, start type Apex code and press the Enter key after each line. Press CTRL+D when finished.
+
+  <%= config.bin %> <%= command.id %>
+
+# executeCompileSuccess
+
+Compiled successfully.
+
+# executeRuntimeSuccess
+
+Executed successfully.
+
+# executeRuntimeFailure
+
+Execution failed.
+
+# executeCompileFailure
+
+Compilation failed.
+
+# executeRuntimeSuccess
+
+Executed successfully.

package/messages/runtest.md

@@ -0,0 +1,129 @@
+# summary
+
+Invoke Apex tests in an org.
+
+# description
+
+Specify which tests to run by using the --class-names, --suite-names, or --tests flags. Alternatively, use the --test-level flag to run all the tests in your org, local tests, or specified tests.
+To see code coverage results, use the --code-coverage flag with --result-format. The output displays a high-level summary of the test run and the code coverage values for classes in your org. If you specify human-readable result format, use the --detailed-coverage flag to see detailed coverage results for each test method run.
+
+NOTE: The testRunCoverage value (JSON and JUnit result formats) is a percentage of the covered lines and total lines from all the Apex classes evaluated by the tests in this run.
+
+# examples
+
+- Run all Apex tests and suites in your default org:
+
+  <%= config.bin %> <%= command.id %>
+
+- Run the specified Apex test classes in your default org and display results in human-readable form:
+
+  <%= config.bin %> <%= command.id %> --class-names "MyClassTest,MyOtherClassTest" --result-format human
+
+- Run the specified Apex test suites in your default org and include code coverage results and additional details:
+
+  <%= config.bin %> <%= command.id %> --suite-names "MySuite,MyOtherSuite" --code-coverage --detailed-coverage
+
+- Run the specified Apex tests in your default org and display results in human-readable output:
+
+  <%= config.bin %> <%= command.id %> --tests "MyClassTest.testCoolFeature,MyClassTest.testAwesomeFeature,AnotherClassTest,namespace.TheirClassTest.testThis" --result-format human
+
+- Run all tests in the org with the specified username with the specified test level; save the output to the specified directory:
+
+  <%= config.bin %> <%= command.id %> --test-level RunLocalTests --output-dir <path to outputdir> --target-org me@my.org
+
+# flags.result-format.summary
+
+Format of the test results.
+
+# flags.class-names.summary
+
+Comma-separated list of Apex test class names to run; default is all classes.
+
+# flags.class-names.description
+
+If you select --class-names, you can't specify --suite-names or --tests.
+
+# flags.suite-names.summary
+
+Comma-separated list of Apex test suite names to run; default is all suites.
+
+# flags.suite-names.description
+
+If you select --suite-names, you can't specify --class-names or --tests.
+
+# flags.tests.summary
+
+Comma-separated list of Apex test class names or IDs and, if applicable, test methods to run; default is all tests.
+
+# flags.tests.description
+
+If you specify --tests, you can't specify --class-names or --suite-names
+
+# flags.code-coverage.summary
+
+Retrieve code coverage results.
+
+# flags.output-dir.summary
+
+Directory in which to store test run files.
+
+# flags.test-level.summary
+
+Level of tests to run; default is RunLocalTests.
+
+# flags.test-level.description
+
+Here's what the levels mean:
+
+- RunSpecifiedTests — Only the tests that you specify are run.
+- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed packages.
+- RunAllTestsInOrg — All tests are in your org and in installed managed packages are run
+
+# flags.wait.summary
+
+Sets the streaming client socket timeout in minutes; specify a longer wait time if timeouts occur frequently.
+
+# flags.synchronous.summary
+
+Runs test methods from a single Apex class synchronously; if not specified, tests are run asynchronously.
+
+# flags.detailed-coverage.summary
+
+Display detailed code coverage per test.
+
+# missingReporterErr
+
+Select a result format when specifying code coverage
+
+# runTestReportCommand
+
+Run "%s apex get test -i %s -o %s" to retrieve test results
+
+# classSuiteTestErr
+
+Specify either classnames, suitenames, or tests
+
+# syncClassErr
+
+Synchronous test runs can include test methods from only one Apex class. Omit the --synchronous flag or include tests from only one class
+
+# testLevelErr
+
+When specifying classnames, suitenames, or tests, indicate RunSpecifiedTests as the testlevel
+
+# testResultProcessErr
+
+Encountered an error when processing test results
+%s
+
+# apexTestReportFormatHint
+
+Run "%s apex get test %s --result-format <format>" to retrieve test results in a different format.
+
+# outputDirHint
+
+Test result files written to %s
+
+# apexLibErr
+
+Unknown error in Apex Library: %s

package/messages/tail.md

@@ -0,0 +1,37 @@
+# summary
+
+Activate debug logging and display logs in the terminal.
+
+# description
+
+You can also pipe the logs to a file.
+
+# examples
+
+- Activate debug logging:
+
+  <%= config.bin %> <%= command.id %>
+
+- Specify a debug level:
+
+  <%= config.bin %> <%= command.id %> --debug-level MyDebugLevel
+
+- Skip the trace flag setup and apply default colors:
+
+  <%= config.bin %> <%= command.id %> --color --skip-trace-flag
+
+# flags.color.summary
+
+Apply default colors to noteworthy log lines.
+
+# flags.debug-level.summary
+
+Debug level to set on the DEVELOPER_LOG trace flag for your user.
+
+# flags.skip-trace-flag.summary
+
+Skip trace flag setup. Assumes that a trace flag and debug level are fully set up.
+
+# finishedTailing
+
+Finished tailing logs