npm - @salesforce/plugin-apex - Versions diffs - 3.6.15 → 3.6.17 - Mend

@salesforce/plugin-apex 3.6.15 → 3.6.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md CHANGED Viewed

@@ -148,7 +148,7 @@ FLAG DESCRIPTIONS
     directory.
 ```
-_See code: [src/commands/apex/get/log.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.15/src/commands/apex/get/log.ts)_
+_See code: [src/commands/apex/get/log.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.17/src/commands/apex/get/log.ts)_
 ## `sf apex get test`
@@ -208,7 +208,7 @@ EXAMPLES
       me@myorg'
 ```
-_See code: [src/commands/apex/get/test.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.15/src/commands/apex/get/test.ts)_
+_See code: [src/commands/apex/get/test.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.17/src/commands/apex/get/test.ts)_
 ## `sf apex list log`
@@ -248,7 +248,7 @@ EXAMPLES
     $ sf apex list log --target-org me@my.org
 ```
-_See code: [src/commands/apex/list/log.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.15/src/commands/apex/list/log.ts)_
+_See code: [src/commands/apex/list/log.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.17/src/commands/apex/list/log.ts)_
 ## `sf apex run`
@@ -295,7 +295,7 @@ EXAMPLES
     $ sf apex run
 ```
-_See code: [src/commands/apex/run.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.15/src/commands/apex/run.ts)_
+_See code: [src/commands/apex/run.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.17/src/commands/apex/run.ts)_
 ## `sf apex run test`
@@ -438,7 +438,7 @@ FLAG DESCRIPTIONS
     --tests Test1 --tests Test2
 ```
-_See code: [src/commands/apex/run/test.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.15/src/commands/apex/run/test.ts)_
+_See code: [src/commands/apex/run/test.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.17/src/commands/apex/run/test.ts)_
 ## `sf apex tail log`
@@ -481,6 +481,6 @@ EXAMPLES
     $ sf apex tail log --color --skip-trace-flag
 ```
-_See code: [src/commands/apex/tail/log.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.15/src/commands/apex/tail/log.ts)_
+_See code: [src/commands/apex/tail/log.ts](https://github.com/salesforcecli/plugin-apex/blob/3.6.17/src/commands/apex/tail/log.ts)_
 <!-- commandsstop -->

package/oclif.manifest.json CHANGED Viewed

@@ -106,18 +106,16 @@
         "run:apex"
       ]
     },
-    "apex:get:log": {
+    "apex:list:log": {
       "aliases": [
-        "force:apex:log:get"
+        "force:apex:log:list"
       ],
       "args": {},
       "deprecateAliases": true,
-      "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.",
+      "description": "Run this command in a project to list the IDs and general information for all debug logs in your default org.\n\nTo 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": [
-        "Fetch the log in your default org using an ID:\n<%= config.bin %> <%= command.id %> --log-id <log id>",
-        "Fetch the log in the org with the specified username using an ID:\n<%= config.bin %> <%= command.id %> --log-id <log id> --target-org me@my.org",
-        "Fetch the two most recent logs in your default org:\n<%= config.bin %> <%= command.id %> --number 2",
-        "Similar to previous example, but save the two log files in the specified directory:\n<%= config.bin %> <%= command.id %> --output-dir /Users/sfdxUser/logs --number 2"
+        "List the IDs and information about the debug logs in your default org:\n<%= config.bin %> <%= command.id %>",
+        "Similar to previous example, but use the org with the specified username:\n<%= config.bin %> <%= command.id %> --target-org me@my.org"
       ],
       "flags": {
         "json": {
@@ -170,106 +168,79 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "log-id": {
-          "aliases": [
-            "logid"
-          ],
-          "char": "i",
-          "deprecateAliases": true,
-          "name": "log-id",
-          "summary": "ID of the specific log to display.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "number": {
-          "char": "n",
-          "name": "number",
-          "summary": "Number of the most recent logs to display.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-dir": {
-          "aliases": [
-            "outputdir",
-            "output-directory"
-          ],
-          "char": "d",
-          "deprecateAliases": true,
-          "description": "The location can be an absolute path or relative to the current working directory. The default is the current directory.",
-          "name": "output-dir",
-          "summary": "Directory for saving the log files.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "apex:get:log",
+      "id": "apex:list:log",
       "pluginAlias": "@salesforce/plugin-apex",
       "pluginName": "@salesforce/plugin-apex",
       "pluginType": "core",
       "strict": true,
-      "summary": "Fetch the specified log or given number of most recent logs from the org.",
+      "summary": "Display a list of IDs and general information about debug logs.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "apex",
-        "get",
+        "list",
         "log.js"
       ],
       "aliasPermutations": [
-        "force:apex:log:get",
-        "apex:force:log:get",
-        "apex:log:force:get",
-        "apex:log:get:force",
-        "force:log:apex:get",
-        "log:force:apex:get",
-        "log:apex:force:get",
-        "log:apex:get:force",
-        "force:log:get:apex",
-        "log:force:get:apex",
-        "log:get:force:apex",
-        "log:get:apex:force",
-        "force:apex:get:log",
-        "apex:force:get:log",
-        "apex:get:force:log",
-        "apex:get:log:force",
-        "force:get:apex:log",
-        "get:force:apex:log",
-        "get:apex:force:log",
-        "get:apex:log:force",
-        "force:get:log:apex",
-        "get:force:log:apex",
-        "get:log:force:apex",
-        "get:log:apex:force"
+        "force:apex:log:list",
+        "apex:force:log:list",
+        "apex:log:force:list",
+        "apex:log:list:force",
+        "force:log:apex:list",
+        "log:force:apex:list",
+        "log:apex:force:list",
+        "log:apex:list:force",
+        "force:log:list:apex",
+        "log:force:list:apex",
+        "log:list:force:apex",
+        "log:list:apex:force",
+        "force:apex:list:log",
+        "apex:force:list:log",
+        "apex:list:force:log",
+        "apex:list:log:force",
+        "force:list:apex:log",
+        "list:force:apex:log",
+        "list:apex:force:log",
+        "list:apex:log:force",
+        "force:list:log:apex",
+        "list:force:log:apex",
+        "list:log:force:apex",
+        "list:log:apex:force"
       ],
       "permutations": [
-        "apex:get:log",
-        "get:apex:log",
-        "get:log:apex",
-        "apex:log:get",
-        "log:apex:get",
-        "log:get:apex"
+        "apex:list:log",
+        "list:apex:log",
+        "list:log:apex",
+        "apex:log:list",
+        "log:apex:list",
+        "log:list:apex"
       ]
     },
-    "apex:get:test": {
+    "apex:run:test": {
       "aliases": [
-        "force:apex:test:report"
+        "force:apex:test:run"
       ],
       "args": {},
       "deprecateAliases": true,
-      "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.\n\nTo 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.",
+      "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.\n\nTo 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.\n\nBy default, Apex tests run asynchronously and immediately return a test run ID. You can use the --wait flag to specify the number of minutes to wait; if the tests finish in that timeframe, the command displays the results. If the tests haven't finished by the end of the wait time, the command displays a test run ID. Use the \"<%= config.bin %> apex get test --test-run-id\" command to get the results.\n\nYou must have the \"View All Data\" system permission to use this command. The permission is disabled by default and can be enabled only by a system administrator.\n\nNOTE: 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": [
-        "Display test results for your default org using a test run ID:\n<%= config.bin %> <%= command.id %> --test-run-id <test run id>",
-        "Similar to previous example, but output the result in JUnit format:\n<%= config.bin %> <%= command.id %> --test-run-id <test run id> --result-format junit",
-        "Also retrieve code coverage results and output in JSON format:\n<%= 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):\n<%= config.bin %> <%= command.id %> --test-run-id <test run id> --code-coverage --output-dir <path to outputdir> --target-org me@myorg'"
+        "Run all Apex tests and suites in your default org:\n<%= config.bin %> <%= command.id %>",
+        "Run the specified Apex test classes in your default org and display results in human-readable form:\n<%= config.bin %> <%= command.id %> --class-names MyClassTest --class-names MyOtherClassTest --result-format human",
+        "Run the specified Apex test suites in your default org and include code coverage results and additional details:\n<%= config.bin %> <%= command.id %> --suite-names MySuite --suite-names MyOtherSuite --code-coverage --detailed-coverage",
+        "Run the specified Apex tests in your default org and display results in human-readable output:\n<%= config.bin %> <%= command.id %> --tests MyClassTest.testCoolFeature --tests MyClassTest.testAwesomeFeature --tests AnotherClassTest --tests 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:\n<%= config.bin %> <%= command.id %> --test-level RunLocalTests --output-dir <path to outputdir> --target-org me@my.org",
+        "Run all tests in the org asynchronously:\n<%= config.bin %> <%= command.id %> --target-org myscratch",
+        "Run all tests synchronously; the command waits to display the test results until all tests finish:\n<%= config.bin %> <%= command.id %> --synchronous",
+        "Run specific tests using the --test-level flag:\n<%= config.bin %> <%= command.id %> --test-level RunLocalTests",
+        "Run Apex tests on all the methods in the specified class; output results in Test Anything Protocol (TAP) format and request code coverage results:\n<%= config.bin %> <%= command.id %> --class-names TestA --class-names TestB --result-format tap --code-coverage",
+        "Run Apex tests on methods specified using the standard Class.method notation; if you specify a test class without a method, the command runs all methods in the class:\n<%= config.bin %> <%= command.id %> --tests TestA.excitingMethod --tests TestA.boringMethod --tests TestB",
+        "Run Apex tests on methods specified using the standard Class.method notation with a namespace:\n<%= config.bin %> <%= command.id %> --tests ns.TestA.excitingMethod --tests ns.TestA.boringMethod --tests ns.TestB"
       ],
       "flags": {
         "json": {
@@ -323,19 +294,6 @@
           "multiple": false,
           "type": "option"
         },
-        "test-run-id": {
-          "aliases": [
-            "testrunid"
-          ],
-          "char": "i",
-          "deprecateAliases": true,
-          "name": "test-run-id",
-          "required": true,
-          "summary": "ID of the test run.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "code-coverage": {
           "aliases": [
             "codecoverage"
@@ -347,15 +305,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "detailed-coverage": {
-          "dependsOn": [
-            "code-coverage"
-          ],
-          "name": "detailed-coverage",
-          "summary": "Display detailed code coverage per test.",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "output-dir": {
           "aliases": [
             "outputdir",
@@ -364,9 +313,45 @@
           "char": "d",
           "deprecateAliases": true,
           "name": "output-dir",
-          "summary": "Directory in which to store test result files.",
+          "summary": "Directory in which to store test run files.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "test-level": {
+          "aliases": [
+            "testlevel"
+          ],
+          "char": "l",
+          "deprecateAliases": true,
+          "description": "Here's what the levels mean:\n\n- RunSpecifiedTests — Only the tests that you specify in the runTests option are run. Code coverage requirements differ from the default coverage requirements when using this test level. The executed tests must cover each class and trigger in the deployment package for a minimum of 75% code coverage. This coverage is computed for each class and triggers individually, and is different than the overall coverage percentage.\n- RunLocalTests — All local tests in your org, including tests that originate from no-namespaced unlocked packages, are run. The tests that originate from installed managed packages and namespaced unlocked packages aren't run. This test level is the default for production deployments that include Apex classes or triggers.\n- RunAllTestsInOrg — All tests are run. The tests include all tests in your org.",
+          "name": "test-level",
+          "summary": "Level of tests to run; default is RunLocalTests.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "RunLocalTests",
+            "RunAllTestsInOrg",
+            "RunSpecifiedTests"
+          ],
+          "type": "option"
+        },
+        "class-names": {
+          "aliases": [
+            "classnames"
+          ],
+          "char": "n",
+          "deprecateAliases": true,
+          "description": "If you select --class-names, you can't specify --suite-names or --tests.\nFor multiple classes, repeat the flag for each.\n--class-names Class1 --class-names Class2",
+          "exclusive": [
+            "suite-names",
+            "tests"
+          ],
+          "name": "class-names",
+          "summary": "Apex test class names to run; default is all classes.",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
           "type": "option"
         },
         "result-format": {
@@ -388,6 +373,67 @@
           ],
           "type": "option"
         },
+        "suite-names": {
+          "aliases": [
+            "suitenames"
+          ],
+          "char": "s",
+          "deprecateAliases": true,
+          "description": "If you select --suite-names, you can't specify --class-names or --tests.\nFor multiple suites, repeat the flag for each.\n--suite-names Suite1 --suite-names Suite2",
+          "exclusive": [
+            "class-names",
+            "tests"
+          ],
+          "name": "suite-names",
+          "summary": "Apex test suite names to run.",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tests": {
+          "char": "t",
+          "description": "If you specify --tests, you can't specify --class-names or --suite-names\nFor multiple tests, repeat the flag for each.\n--tests Test1 --tests Test2",
+          "exclusive": [
+            "class-names",
+            "suite-names"
+          ],
+          "name": "tests",
+          "summary": "Apex test class names or IDs and, if applicable, test methods to run; default is all tests.",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "wait": {
+          "char": "w",
+          "name": "wait",
+          "summary": "Sets the streaming client socket timeout in minutes; specify a longer wait time if timeouts occur frequently.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "synchronous": {
+          "char": "y",
+          "name": "synchronous",
+          "summary": "Runs test methods from a single Apex class synchronously; if not specified, tests are run asynchronously.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "detailed-coverage": {
+          "aliases": [
+            "detailedcoverage"
+          ],
+          "char": "v",
+          "dependsOn": [
+            "code-coverage"
+          ],
+          "deprecateAliases": true,
+          "name": "detailed-coverage",
+          "summary": "Display detailed code coverage per test.",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "concise": {
           "name": "concise",
           "summary": "Display only failed test results; works with human-readable output only.",
@@ -397,75 +443,68 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "apex:get:test",
+      "id": "apex:run:test",
       "pluginAlias": "@salesforce/plugin-apex",
       "pluginName": "@salesforce/plugin-apex",
       "pluginType": "core",
       "strict": true,
-      "summary": "Display test results for a specific asynchronous test run.",
+      "summary": "Invoke Apex tests in an org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "apex",
-        "get",
+        "run",
         "test.js"
       ],
       "aliasPermutations": [
-        "force:apex:test:report",
-        "apex:force:test:report",
-        "apex:test:force:report",
-        "apex:test:report:force",
-        "force:test:apex:report",
-        "test:force:apex:report",
-        "test:apex:force:report",
-        "test:apex:report:force",
-        "force:test:report:apex",
-        "test:force:report:apex",
-        "test:report:force:apex",
-        "test:report:apex:force",
-        "force:apex:report:test",
-        "apex:force:report:test",
-        "apex:report:force:test",
-        "apex:report:test:force",
-        "force:report:apex:test",
-        "report:force:apex:test",
-        "report:apex:force:test",
-        "report:apex:test:force",
-        "force:report:test:apex",
-        "report:force:test:apex",
-        "report:test:force:apex",
-        "report:test:apex:force"
+        "force:apex:test:run",
+        "apex:force:test:run",
+        "apex:test:force:run",
+        "apex:test:run:force",
+        "force:test:apex:run",
+        "test:force:apex:run",
+        "test:apex:force:run",
+        "test:apex:run:force",
+        "force:test:run:apex",
+        "test:force:run:apex",
+        "test:run:force:apex",
+        "test:run:apex:force",
+        "force:apex:run:test",
+        "apex:force:run:test",
+        "apex:run:force:test",
+        "apex:run:test:force",
+        "force:run:apex:test",
+        "run:force:apex:test",
+        "run:apex:force:test",
+        "run:apex:test:force",
+        "force:run:test:apex",
+        "run:force:test:apex",
+        "run:test:force:apex",
+        "run:test:apex:force"
       ],
       "permutations": [
-        "apex:get:test",
-        "get:apex:test",
-        "get:test:apex",
-        "apex:test:get",
-        "test:apex:get",
-        "test:get:apex"
+        "apex:run:test",
+        "run:apex:test",
+        "run:test:apex",
+        "apex:test:run",
+        "test:apex:run",
+        "test:run:apex"
       ]
     },
-    "apex:run:test": {
+    "apex:get:log": {
       "aliases": [
-        "force:apex:test:run"
+        "force:apex:log:get"
       ],
       "args": {},
       "deprecateAliases": true,
-      "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.\n\nTo 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.\n\nBy default, Apex tests run asynchronously and immediately return a test run ID. You can use the --wait flag to specify the number of minutes to wait; if the tests finish in that timeframe, the command displays the results. If the tests haven't finished by the end of the wait time, the command displays a test run ID. Use the \"<%= config.bin %> apex get test --test-run-id\" command to get the results.\n\nYou must have the \"View All Data\" system permission to use this command. The permission is disabled by default and can be enabled only by a system administrator.\n\nNOTE: 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.",
+      "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": [
-        "Run all Apex tests and suites in your default org:\n<%= config.bin %> <%= command.id %>",
-        "Run the specified Apex test classes in your default org and display results in human-readable form:\n<%= config.bin %> <%= command.id %> --class-names MyClassTest --class-names MyOtherClassTest --result-format human",
-        "Run the specified Apex test suites in your default org and include code coverage results and additional details:\n<%= config.bin %> <%= command.id %> --suite-names MySuite --suite-names MyOtherSuite --code-coverage --detailed-coverage",
-        "Run the specified Apex tests in your default org and display results in human-readable output:\n<%= config.bin %> <%= command.id %> --tests MyClassTest.testCoolFeature --tests MyClassTest.testAwesomeFeature --tests AnotherClassTest --tests 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:\n<%= config.bin %> <%= command.id %> --test-level RunLocalTests --output-dir <path to outputdir> --target-org me@my.org",
-        "Run all tests in the org asynchronously:\n<%= config.bin %> <%= command.id %> --target-org myscratch",
-        "Run all tests synchronously; the command waits to display the test results until all tests finish:\n<%= config.bin %> <%= command.id %> --synchronous",
-        "Run specific tests using the --test-level flag:\n<%= config.bin %> <%= command.id %> --test-level RunLocalTests",
-        "Run Apex tests on all the methods in the specified class; output results in Test Anything Protocol (TAP) format and request code coverage results:\n<%= config.bin %> <%= command.id %> --class-names TestA --class-names TestB --result-format tap --code-coverage",
-        "Run Apex tests on methods specified using the standard Class.method notation; if you specify a test class without a method, the command runs all methods in the class:\n<%= config.bin %> <%= command.id %> --tests TestA.excitingMethod --tests TestA.boringMethod --tests TestB",
-        "Run Apex tests on methods specified using the standard Class.method notation with a namespace:\n<%= config.bin %> <%= command.id %> --tests ns.TestA.excitingMethod --tests ns.TestA.boringMethod --tests ns.TestB"
+        "Fetch the log in your default org using an ID:\n<%= config.bin %> <%= command.id %> --log-id <log id>",
+        "Fetch the log in the org with the specified username using an ID:\n<%= config.bin %> <%= command.id %> --log-id <log id> --target-org me@my.org",
+        "Fetch the two most recent logs in your default org:\n<%= config.bin %> <%= command.id %> --number 2",
+        "Similar to previous example, but save the two log files in the specified directory:\n<%= config.bin %> <%= command.id %> --output-dir /Users/sfdxUser/logs --number 2"
       ],
       "flags": {
         "json": {
@@ -519,215 +558,105 @@
           "multiple": false,
           "type": "option"
         },
-        "code-coverage": {
-          "aliases": [
-            "codecoverage"
-          ],
-          "char": "c",
-          "deprecateAliases": true,
-          "name": "code-coverage",
-          "summary": "Retrieve code coverage results.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "output-dir": {
-          "aliases": [
-            "outputdir",
-            "output-directory"
-          ],
-          "char": "d",
-          "deprecateAliases": true,
-          "name": "output-dir",
-          "summary": "Directory in which to store test run files.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "test-level": {
+        "log-id": {
           "aliases": [
-            "testlevel"
+            "logid"
           ],
-          "char": "l",
+          "char": "i",
           "deprecateAliases": true,
-          "description": "Here's what the levels mean:\n\n- RunSpecifiedTests — Only the tests that you specify in the runTests option are run. Code coverage requirements differ from the default coverage requirements when using this test level. The executed tests must cover each class and trigger in the deployment package for a minimum of 75% code coverage. This coverage is computed for each class and triggers individually, and is different than the overall coverage percentage.\n- RunLocalTests — All local tests in your org, including tests that originate from no-namespaced unlocked packages, are run. The tests that originate from installed managed packages and namespaced unlocked packages aren't run. This test level is the default for production deployments that include Apex classes or triggers.\n- RunAllTestsInOrg — All tests are run. The tests include all tests in your org.",
-          "name": "test-level",
-          "summary": "Level of tests to run; default is RunLocalTests.",
+          "name": "log-id",
+          "summary": "ID of the specific log to display.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "RunLocalTests",
-            "RunAllTestsInOrg",
-            "RunSpecifiedTests"
-          ],
           "type": "option"
         },
-        "class-names": {
-          "aliases": [
-            "classnames"
-          ],
+        "number": {
           "char": "n",
-          "deprecateAliases": true,
-          "description": "If you select --class-names, you can't specify --suite-names or --tests.\nFor multiple classes, repeat the flag for each.\n--class-names Class1 --class-names Class2",
-          "exclusive": [
-            "suite-names",
-            "tests"
-          ],
-          "name": "class-names",
-          "summary": "Apex test class names to run; default is all classes.",
-          "delimiter": ",",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "result-format": {
-          "aliases": [
-            "resultformat"
-          ],
-          "char": "r",
-          "deprecateAliases": true,
-          "name": "result-format",
-          "summary": "Format of the test results.",
-          "default": "human",
+          "name": "number",
+          "summary": "Number of the most recent logs to display.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "human",
-            "tap",
-            "junit",
-            "json"
-          ],
           "type": "option"
         },
-        "suite-names": {
+        "output-dir": {
           "aliases": [
-            "suitenames"
+            "outputdir",
+            "output-directory"
           ],
-          "char": "s",
+          "char": "d",
           "deprecateAliases": true,
-          "description": "If you select --suite-names, you can't specify --class-names or --tests.\nFor multiple suites, repeat the flag for each.\n--suite-names Suite1 --suite-names Suite2",
-          "exclusive": [
-            "class-names",
-            "tests"
-          ],
-          "name": "suite-names",
-          "summary": "Apex test suite names to run.",
-          "delimiter": ",",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "tests": {
-          "char": "t",
-          "description": "If you specify --tests, you can't specify --class-names or --suite-names\nFor multiple tests, repeat the flag for each.\n--tests Test1 --tests Test2",
-          "exclusive": [
-            "class-names",
-            "suite-names"
-          ],
-          "name": "tests",
-          "summary": "Apex test class names or IDs and, if applicable, test methods to run; default is all tests.",
-          "delimiter": ",",
+          "description": "The location can be an absolute path or relative to the current working directory. The default is the current directory.",
+          "name": "output-dir",
+          "summary": "Directory for saving the log files.",
           "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "wait": {
-          "char": "w",
-          "name": "wait",
-          "summary": "Sets the streaming client socket timeout in minutes; specify a longer wait time if timeouts occur frequently.",
-          "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        },
-        "synchronous": {
-          "char": "y",
-          "name": "synchronous",
-          "summary": "Runs test methods from a single Apex class synchronously; if not specified, tests are run asynchronously.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "detailed-coverage": {
-          "aliases": [
-            "detailedcoverage"
-          ],
-          "char": "v",
-          "dependsOn": [
-            "code-coverage"
-          ],
-          "deprecateAliases": true,
-          "name": "detailed-coverage",
-          "summary": "Display detailed code coverage per test.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "concise": {
-          "name": "concise",
-          "summary": "Display only failed test results; works with human-readable output only.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "apex:run:test",
+      "id": "apex:get:log",
       "pluginAlias": "@salesforce/plugin-apex",
       "pluginName": "@salesforce/plugin-apex",
       "pluginType": "core",
       "strict": true,
-      "summary": "Invoke Apex tests in an org.",
+      "summary": "Fetch the specified log or given number of most recent logs from the org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "apex",
-        "run",
-        "test.js"
+        "get",
+        "log.js"
       ],
       "aliasPermutations": [
-        "force:apex:test:run",
-        "apex:force:test:run",
-        "apex:test:force:run",
-        "apex:test:run:force",
-        "force:test:apex:run",
-        "test:force:apex:run",
-        "test:apex:force:run",
-        "test:apex:run:force",
-        "force:test:run:apex",
-        "test:force:run:apex",
-        "test:run:force:apex",
-        "test:run:apex:force",
-        "force:apex:run:test",
-        "apex:force:run:test",
-        "apex:run:force:test",
-        "apex:run:test:force",
-        "force:run:apex:test",
-        "run:force:apex:test",
-        "run:apex:force:test",
-        "run:apex:test:force",
-        "force:run:test:apex",
-        "run:force:test:apex",
-        "run:test:force:apex",
-        "run:test:apex:force"
+        "force:apex:log:get",
+        "apex:force:log:get",
+        "apex:log:force:get",
+        "apex:log:get:force",
+        "force:log:apex:get",
+        "log:force:apex:get",
+        "log:apex:force:get",
+        "log:apex:get:force",
+        "force:log:get:apex",
+        "log:force:get:apex",
+        "log:get:force:apex",
+        "log:get:apex:force",
+        "force:apex:get:log",
+        "apex:force:get:log",
+        "apex:get:force:log",
+        "apex:get:log:force",
+        "force:get:apex:log",
+        "get:force:apex:log",
+        "get:apex:force:log",
+        "get:apex:log:force",
+        "force:get:log:apex",
+        "get:force:log:apex",
+        "get:log:force:apex",
+        "get:log:apex:force"
       ],
       "permutations": [
-        "apex:run:test",
-        "run:apex:test",
-        "run:test:apex",
-        "apex:test:run",
-        "test:apex:run",
-        "test:run:apex"
+        "apex:get:log",
+        "get:apex:log",
+        "get:log:apex",
+        "apex:log:get",
+        "log:apex:get",
+        "log:get:apex"
       ]
     },
-    "apex:list:log": {
+    "apex:get:test": {
       "aliases": [
-        "force:apex:log:list"
+        "force:apex:test:report"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "Run this command in a project to list the IDs and general information for all debug logs in your default org.\n\nTo fetch a specific log from your org, obtain the ID from this command's output, then run the “<%= config.bin %> apex log get” command.",
+      "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.\n\nTo 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.",
       "examples": [
-        "List the IDs and information about the debug logs in your default org:\n<%= config.bin %> <%= command.id %>",
-        "Similar to previous example, but use the org with the specified username:\n<%= config.bin %> <%= command.id %> --target-org me@my.org"
+        "Display test results for your default org using a test run ID:\n<%= config.bin %> <%= command.id %> --test-run-id <test run id>",
+        "Similar to previous example, but output the result in JUnit format:\n<%= config.bin %> <%= command.id %> --test-run-id <test run id> --result-format junit",
+        "Also retrieve code coverage results and output in JSON format:\n<%= 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):\n<%= config.bin %> <%= command.id %> --test-run-id <test run id> --code-coverage --output-dir <path to outputdir> --target-org me@myorg'"
       ],
       "flags": {
         "json": {
@@ -780,58 +709,129 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "test-run-id": {
+          "aliases": [
+            "testrunid"
+          ],
+          "char": "i",
+          "deprecateAliases": true,
+          "name": "test-run-id",
+          "required": true,
+          "summary": "ID of the test run.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "code-coverage": {
+          "aliases": [
+            "codecoverage"
+          ],
+          "char": "c",
+          "deprecateAliases": true,
+          "name": "code-coverage",
+          "summary": "Retrieve code coverage results.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "detailed-coverage": {
+          "dependsOn": [
+            "code-coverage"
+          ],
+          "name": "detailed-coverage",
+          "summary": "Display detailed code coverage per test.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output-dir": {
+          "aliases": [
+            "outputdir",
+            "output-directory"
+          ],
+          "char": "d",
+          "deprecateAliases": true,
+          "name": "output-dir",
+          "summary": "Directory in which to store test result files.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "result-format": {
+          "aliases": [
+            "resultformat"
+          ],
+          "char": "r",
+          "deprecateAliases": true,
+          "name": "result-format",
+          "summary": "Format of the test results.",
+          "default": "human",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "human",
+            "tap",
+            "junit",
+            "json"
+          ],
+          "type": "option"
+        },
+        "concise": {
+          "name": "concise",
+          "summary": "Display only failed test results; works with human-readable output only.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "apex:list:log",
+      "id": "apex:get:test",
       "pluginAlias": "@salesforce/plugin-apex",
       "pluginName": "@salesforce/plugin-apex",
       "pluginType": "core",
       "strict": true,
-      "summary": "Display a list of IDs and general information about debug logs.",
+      "summary": "Display test results for a specific asynchronous test run.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "apex",
-        "list",
-        "log.js"
+        "get",
+        "test.js"
       ],
       "aliasPermutations": [
-        "force:apex:log:list",
-        "apex:force:log:list",
-        "apex:log:force:list",
-        "apex:log:list:force",
-        "force:log:apex:list",
-        "log:force:apex:list",
-        "log:apex:force:list",
-        "log:apex:list:force",
-        "force:log:list:apex",
-        "log:force:list:apex",
-        "log:list:force:apex",
-        "log:list:apex:force",
-        "force:apex:list:log",
-        "apex:force:list:log",
-        "apex:list:force:log",
-        "apex:list:log:force",
-        "force:list:apex:log",
-        "list:force:apex:log",
-        "list:apex:force:log",
-        "list:apex:log:force",
-        "force:list:log:apex",
-        "list:force:log:apex",
-        "list:log:force:apex",
-        "list:log:apex:force"
+        "force:apex:test:report",
+        "apex:force:test:report",
+        "apex:test:force:report",
+        "apex:test:report:force",
+        "force:test:apex:report",
+        "test:force:apex:report",
+        "test:apex:force:report",
+        "test:apex:report:force",
+        "force:test:report:apex",
+        "test:force:report:apex",
+        "test:report:force:apex",
+        "test:report:apex:force",
+        "force:apex:report:test",
+        "apex:force:report:test",
+        "apex:report:force:test",
+        "apex:report:test:force",
+        "force:report:apex:test",
+        "report:force:apex:test",
+        "report:apex:force:test",
+        "report:apex:test:force",
+        "force:report:test:apex",
+        "report:force:test:apex",
+        "report:test:force:apex",
+        "report:test:apex:force"
       ],
       "permutations": [
-        "apex:list:log",
-        "list:apex:log",
-        "list:log:apex",
-        "apex:log:list",
-        "log:apex:list",
-        "log:list:apex"
+        "apex:get:test",
+        "get:apex:test",
+        "get:test:apex",
+        "apex:test:get",
+        "test:apex:get",
+        "test:get:apex"
       ]
     },
     "apex:tail:log": {
@@ -978,5 +978,5 @@
       ]
     }
   },
-  "version": "3.6.15"
+  "version": "3.6.17"
 }

package/package.json CHANGED Viewed

@@ -1,12 +1,12 @@
 {
     "name": "@salesforce/plugin-apex",
     "description": "Apex commands",
-    "version": "3.6.15",
+    "version": "3.6.17",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
-        "@salesforce/apex-node": "^8.1.22",
-        "@salesforce/core": "^8.10.0",
+        "@salesforce/apex-node": "^8.1.25",
+        "@salesforce/core": "^8.10.1",
         "@salesforce/kit": "^3.2.3",
         "@salesforce/sf-plugins-core": "^12.2.1",
         "ansis": "^3.3.1"
@@ -16,7 +16,7 @@
         "@oclif/plugin-command-snapshot": "^5.2.37",
         "@salesforce/cli-plugins-testkit": "^5.3.39",
         "@salesforce/dev-scripts": "^10.2.11",
-        "@salesforce/plugin-command-reference": "^3.1.49",
+        "@salesforce/plugin-command-reference": "^3.1.51",
         "eslint-plugin-sf-plugin": "^1.20.19",
         "oclif": "^4.17.46",
         "ts-node": "^10.9.2",
@@ -217,7 +217,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-apex/3.6.15.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-apex/3.6.15.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-apex/3.6.17.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-apex/3.6.17.sig"
     }
 }