@salesforce/plugin-deploy-retrieve 1.0.5 → 1.1.1

package/CHANGELOG.md

@@ -2,168 +2,169 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### [1.0.5](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.0.4...v1.0.5) (2021-10-14)
+### [1.1.1](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.1.0...v1.1.1) (2022-03-01)
+
+### Bug Fixes
+
+- use deprecate fs from sfdx-core ([ba2cb57](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/ba2cb57a3748e52c090fcbd8fb19047cbc481159))
+- use deprecate fs from sfdx-core ([b45ebbe](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/b45ebbe7eccbe5b4f0e181a8516a84df4bf1e975))
+
+## [1.1.0](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.0.6...v1.1.0) (2022-02-24)
 
+### Features
+
+- merge deploy-retrieve-metadata commands ([#212](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/212)) ([74a9eb9](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/74a9eb90eac99b83a27330ad80d20afa40449776))
 
 ### Bug Fixes
 
-* bump command snapshot ([#153](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/153)) ([d4aa1fc](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/d4aa1fc7859f14626fcab137e6c762ce5842b5dd))
+- regenerate yarn.lock ([777245c](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/777245ccec5973f07b7fac6af652ad184ddb2a0a))
+
+### [1.0.6](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.0.5...v1.0.6) (2022-01-06)
+
+### Bug Fixes
+
+- add main to package.json ([#192](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/192)) ([6f0bc54](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/6f0bc54cb5003b29dce9980c063375a4d31a3eb6))
+
+### [1.0.5](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.0.4...v1.0.5) (2021-10-14)
+
+### Bug Fixes
+
+- bump command snapshot ([#153](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/153)) ([d4aa1fc](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/d4aa1fc7859f14626fcab137e6c762ce5842b5dd))
 
 ### [1.0.4](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.0.3...v1.0.4) (2021-10-12)
 
 ### [1.0.3](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.0.2...v1.0.3) (2021-10-05)
 
-
 ### Bug Fixes
 
-* filter deployers when executing non-interactive deploy ([#152](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/152)) ([cfc9f7b](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/cfc9f7b77015cb98cf1e21f122fb062624271bba))
+- filter deployers when executing non-interactive deploy ([#152](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/152)) ([cfc9f7b](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/cfc9f7b77015cb98cf1e21f122fb062624271bba))
 
 ### [1.0.2](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.0.1...v1.0.2) (2021-09-30)
 
-
 ### Bug Fixes
 
-* bump plugins to 1.0.2 [skip-validate-pr] ([#145](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/145)) ([002dbc4](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/002dbc438d70413d2a920d62f98f9c49732c347d))
+- bump plugins to 1.0.2 [skip-validate-pr] ([#145](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/145)) ([002dbc4](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/002dbc438d70413d2a920d62f98f9c49732c347d))
 
 ### [1.0.1](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v1.0.0...v1.0.1) (2021-09-30)
 
-
 ### Bug Fixes
 
-* bump functions to 1.0.0 ([#144](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/144)) ([0658dac](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/0658dac9b3c7a48c56af15d49a50a6e9b1edd56e))
+- bump functions to 1.0.0 ([#144](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/144)) ([0658dac](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/0658dac9b3c7a48c56af15d49a50a6e9b1edd56e))
 
 ## [1.0.0](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.23...v1.0.0) (2021-09-30)
 
-
 ### Bug Fixes
 
-* bump version to v1 [skip-validate-pr] ([#143](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/143)) ([dd2999c](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/dd2999c127c53d3ccf3091f675ae83991d952f1f))
+- bump version to v1 [skip-validate-pr] ([#143](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/143)) ([dd2999c](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/dd2999c127c53d3ccf3091f675ae83991d952f1f))
 
 ### [0.0.23](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.22...v0.0.23) (2021-09-16)
 
-
 ### Bug Fixes
 
-* bump to latest sf-plugins-core ([#138](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/138)) ([df49943](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/df4994302baf28518317ec0763115423fe74145b))
+- bump to latest sf-plugins-core ([#138](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/138)) ([df49943](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/df4994302baf28518317ec0763115423fe74145b))
 
 ### [0.0.22](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.21...v0.0.22) (2021-09-15)
 
-
 ### Bug Fixes
 
-* bump sf-plugins-core and consume sfcommand ([#137](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/137)) ([83ff118](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/83ff1181cf7ae87bc109815137c41258af2d776d))
+- bump sf-plugins-core and consume sfcommand ([#137](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/137)) ([83ff118](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/83ff1181cf7ae87bc109815137c41258af2d776d))
 
 ### [0.0.21](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.20...v0.0.21) (2021-09-13)
 
-
 ### Bug Fixes
 
-* use sfcommand as base class ([#134](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/134)) ([6822bda](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/6822bda65df3ee4a212207f2d213336dac442578))
+- use sfcommand as base class ([#134](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/134)) ([6822bda](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/6822bda65df3ee4a212207f2d213336dac442578))
 
 ### [0.0.20](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.19...v0.0.20) (2021-09-08)
 
-
 ### Features
 
-* add deploy-options.json to .gitignore when functions exist ([#131](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/131)) ([5ae94f9](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/5ae94f98c03445f09cfe86a52b29d3b7344e937b))
+- add deploy-options.json to .gitignore when functions exist ([#131](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/131)) ([5ae94f9](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/5ae94f98c03445f09cfe86a52b29d3b7344e937b))
 
 ### [0.0.19](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.18...v0.0.19) (2021-09-02)
 
-
 ### Features
 
-* use sf-plugins-core ([#116](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/116)) ([bf81d08](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/bf81d08dcb5e16e665ffc21e05399ff65b849a42))
+- use sf-plugins-core ([#116](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/116)) ([bf81d08](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/bf81d08dcb5e16e665ffc21e05399ff65b849a42))
 
 ### [0.0.18](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.17...v0.0.18) (2021-08-18)
 
-
 ### Bug Fixes
 
-* bump oclif/core and @salesforce/core ([#115](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/115)) ([bf62690](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/bf6269064ba90cf316eb99686ed0019bb84e580b))
+- bump oclif/core and @salesforce/core ([#115](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/115)) ([bf62690](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/bf6269064ba90cf316eb99686ed0019bb84e580b))
 
 ### [0.0.17](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.16...v0.0.17) (2021-08-17)
 
-
 ### Bug Fixes
 
-* add a bit more info to --help about list of connected orgs ([#114](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/114)) ([792abd3](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/792abd3b1ed0ca5116ef488ee1fa83e0f9cee2d9))
+- add a bit more info to --help about list of connected orgs ([#114](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/114)) ([792abd3](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/792abd3b1ed0ca5116ef488ee1fa83e0f9cee2d9))
 
 ### [0.0.16](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.15...v0.0.16) (2021-08-12)
 
-
 ### Bug Fixes
 
-* bump @salesforce/core to 3.4.1 ([#110](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/110)) ([3e710c4](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/3e710c41ecee82aaec7ff213d53ecfc6ce4c8b3b))
+- bump @salesforce/core to 3.4.1 ([#110](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/110)) ([3e710c4](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/3e710c41ecee82aaec7ff213d53ecfc6ce4c8b3b))
 
 ### [0.0.15](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.14...v0.0.15) (2021-08-03)
 
-
 ### Bug Fixes
 
-* update topic descriptions in pacakge.json ([#109](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/109)) ([f6c699c](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/f6c699c39e8342d7c7a5d01cc5403241bc010bdb))
+- update topic descriptions in pacakge.json ([#109](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/109)) ([f6c699c](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/f6c699c39e8342d7c7a5d01cc5403241bc010bdb))
 
 ### [0.0.14](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.13...v0.0.14) (2021-07-30)
 
-
 ### Features
 
-* **hooks:** setup for linking functions plugin hooks ([#95](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/95)) ([e16e7e9](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/e16e7e90f6cfe9d28cf3a1b5dd2126965eb2e680))
+- **hooks:** setup for linking functions plugin hooks ([#95](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/95)) ([e16e7e9](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/e16e7e90f6cfe9d28cf3a1b5dd2126965eb2e680))
 
 ### [0.0.13](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.12...v0.0.13) (2021-07-28)
 
-
 ### Bug Fixes
 
-* add name of file that stores responses ([#94](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/94)) ([020de23](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/020de230486d49381d77b89dd4a055c17e798236))
+- add name of file that stores responses ([#94](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/94)) ([020de23](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/020de230486d49381d77b89dd4a055c17e798236))
 
 ### [0.0.12](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.11...v0.0.12) (2021-07-28)
 
-
 ### Bug Fixes
 
-* pin to @salesforce/core@3.3.5 ([2ef20a8](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/2ef20a8af58f6ed06d3f3022ad980ea83da16f14))
+- pin to @salesforce/core@3.3.5 ([2ef20a8](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/2ef20a8af58f6ed06d3f3022ad980ea83da16f14))
 
 ### [0.0.11](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.10...v0.0.11) (2021-07-27)
 
 ### [0.0.10](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.9...v0.0.10) (2021-07-22)
 
-
 ### Bug Fixes
 
-* remove reference to project topic ([995e643](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/995e643bc81fa7cbc05dcacdffac7ec04d1b6234))
+- remove reference to project topic ([995e643](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/995e643bc81fa7cbc05dcacdffac7ec04d1b6234))
 
 ### [0.0.9](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.8...v0.0.9) (2021-07-19)
 
-
 ### Bug Fixes
 
-* minor updates to the --help ([#85](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/85)) ([a7cf8bd](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/a7cf8bd77b9bc35f72c20b11010ae3855203f9b2))
+- minor updates to the --help ([#85](https://github.com/salesforcecli/plugin-deploy-retrieve/issues/85)) ([a7cf8bd](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/a7cf8bd77b9bc35f72c20b11010ae3855203f9b2))
 
 ### [0.0.8](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.7...v0.0.8) (2021-07-15)
 
-
 ### Bug Fixes
 
-* update deps ([ebc35d9](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/ebc35d9bbec5386ab51f4bba7b46330da7cdc486))
+- update deps ([ebc35d9](https://github.com/salesforcecli/plugin-deploy-retrieve/commit/ebc35d9bbec5386ab51f4bba7b46330da7cdc486))
 
 ### [0.0.7](https://github.com/salesforcecli/plugin-deploy-retrieve/compare/v0.0.6...v0.0.7) (2021-07-15)
 
 ### [0.0.6](https://github.com/salesforcecli/plugin-project/compare/v0.0.5...v0.0.6) (2021-07-11)
 
-
 ### Bug Fixes
 
-* bump oclif ([9d78c50](https://github.com/salesforcecli/plugin-project/commit/9d78c50afb3dd7ec70e7f591b33a034baad447b9))
-* bump oclif/core ([6507231](https://github.com/salesforcecli/plugin-project/commit/6507231e9b29ee172a707e6632b71b4539bd730d))
+- bump oclif ([9d78c50](https://github.com/salesforcecli/plugin-project/commit/9d78c50afb3dd7ec70e7f591b33a034baad447b9))
+- bump oclif/core ([6507231](https://github.com/salesforcecli/plugin-project/commit/6507231e9b29ee172a707e6632b71b4539bd730d))
 
 ### [0.0.5](https://github.com/salesforcecli/plugin-project/compare/v0.0.4...v0.0.5) (2021-07-06)
 
 ### [0.0.4](https://github.com/salesforcecli/plugin-project/compare/v0.0.3...v0.0.4) (2021-06-30)
 
-
 ### Features
 
-* run deploy hooks ([#54](https://github.com/salesforcecli/plugin-project/issues/54)) ([4b09997](https://github.com/salesforcecli/plugin-project/commit/4b0999759266ff3a86fd39a3a9ae3a71e216045a))
+- run deploy hooks ([#54](https://github.com/salesforcecli/plugin-project/issues/54)) ([4b09997](https://github.com/salesforcecli/plugin-project/commit/4b0999759266ff3a86fd39a3a9ae3a71e216045a))
 
 ### [0.0.3](https://github.com/salesforcecli/plugin-project/compare/v0.0.2...v0.0.3) (2021-06-08)
 
@@ -171,7 +172,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### 0.0.1 (2021-06-07)
 
-
 ### Bug Fixes
 
-* publish schemas ([87622d8](https://github.com/salesforcecli/plugin-project/commit/87622d835d45fccb877759805642be0bdb201e31))
+- publish schemas ([87622d8](https://github.com/salesforcecli/plugin-project/commit/87622d835d45fccb877759805642be0bdb201e31))

package/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2018, Salesforce.com, Inc.
+Copyright (c) 2022, Salesforce.com, Inc.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

package/README.md

@@ -61,7 +61,10 @@ sf plugins
 ## Commands
 
 <!-- commands -->
-* [`sf deploy`](#sf-deploy)
+
+- [`sf deploy`](#sf-deploy)
+- [`sf deploy metadata`](#sf-deploy-metadata)
+- [`sf retrieve metadata`](#sf-retrieve-metadata)
 
 ## `sf deploy`
 
@@ -105,5 +108,214 @@ EXAMPLES
     $ sf deploy --interactive
 ```
 
-_See code: [src/commands/deploy.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/v1.0.4/src/commands/deploy.ts)_
+_See code: [src/commands/deploy.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/v1.1.0/src/commands/deploy.ts)_
+
+## `sf deploy metadata`
+
+Deploy metadata in source format to an org from your local project.
+
+```
+USAGE
+  $ sf deploy metadata [--json] [-m <value> | -x <value> | -d <value>] [-o <value>] [-l
+    NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [-w <value>]
+
+FLAGS
+  -d, --source-dir=<value>...  Path to the local source files to deploy.
+  -l, --test-level=<option>    [default: NoTestRun] Deployment Apex testing level.
+                               <options: NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg>
+  -m, --metadata=<value>...    Metadata component names to deploy.
+  -o, --target-org=<value>     Login username or alias for the target org.
+  -w, --wait=<value>           [default: 33] Number of minutes to wait for command to complete and display results.
+  -x, --manifest=<value>       Full file path for manifest (package.xml) of components to deploy.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Deploy metadata in source format to an org from your local project.
+
+  You must run this command from within a project.
+
+  This command doesn't support source-tracking. The source you deploy overwrites the corresponding metadata in your org.
+  This command doesn’t attempt to merge your source with the versions in your org.
+
+  To run the command asynchronously, set --wait to 0, which immediately returns the job ID. This way, you can continue
+  to use the CLI.
+
+  To deploy multiple metadata components, either set multiple --metadata <name> flags or a single --metadata flag with
+  multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax
+  applies to --manifest and --source-dir.
+
+EXAMPLES
+  Deploy the source files in a directory:
+
+    $ sf deploy metadata  --source-dir path/to/source
+
+  Deploy a specific Apex class and the objects whose source is in a directory (both examples are equivalent):
+
+    $ sf deploy metadata --source-dir path/to/apex/classes/MyClass.cls path/to/source/objects
+    $ sf deploy metadata --source-dir path/to/apex/classes/MyClass.cls --source-dir path/to/source/objects
+
+  Deploy all Apex classes:
+
+    $ sf deploy metadata --metadata ApexClass
+
+  Deploy a specific Apex class:
+
+    $ sf deploy metadata --metadata ApexClass:MyApexClass
+
+  Deploy all custom objects and Apex classes (both examples are equivalent):
+
+    $ sf deploy metadata --metadata CustomObject ApexClass
+    $ sf deploy metadata --metadata CustomObject --metadata ApexClass
+
+  Deploy all Apex classes and a profile that has a space in its name:
+
+    $ sf deploy metadata --metadata ApexClass --metadata "Profile:My Profile"
+
+  Deploy all components listed in a manifest:
+
+    $ sf deploy metadata --manifest path/to/package.xml
+
+  Run the tests that aren’t in any managed packages as part of a deployment:
+
+    $ sf deploy metadata --metadata ApexClass --test-level RunLocalTests
+
+FLAG DESCRIPTIONS
+  -d, --source-dir=<value>...  Path to the local source files to deploy.
+
+    The supplied path can be to a single file (in which case the operation is applied to only one file) or to a folder
+    (in which case the operation is applied to all metadata types in the directory and its subdirectories).
+
+    If you specify this flag, don’t specify --metadata or --manifest.
+
+  -l, --test-level=NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg  Deployment Apex testing level.
+
+    Valid values are:
+
+    - NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as
+    sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.
+
+    - RunSpecifiedTests — Runs only the tests that you specify with the --run-tests flag. Code coverage requirements
+    differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of
+    75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and
+    trigger individually and is different than the overall coverage percentage.
+
+    - RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked
+    packages. This test level is the default for production deployments that include Apex classes or triggers.
+
+    - RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.
+
+    If you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more
+    information, see [Running Tests in a
+    Deployment](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)
+    in the "Metadata API Developer Guide".
+
+  -o, --target-org=<value>  Login username or alias for the target org.
+
+    Overrides your default org.
+
+  -w, --wait=<value>  Number of minutes to wait for command to complete and display results.
+
+    If the command continues to run after the wait period, the CLI returns control of the terminal window to you.
+
+  -x, --manifest=<value>  Full file path for manifest (package.xml) of components to deploy.
+
+    All child components are included. If you specify this flag, don’t specify --metadata or --source-dir.
+```
+
+## `sf retrieve metadata`
+
+Retrieve metadata in source format from an org to your local project.
+
+```
+USAGE
+  $ sf retrieve metadata [--json] [-a <value>] [-x <value> | -m <value> | -d <value>] [-n <value>] [-o <value>] [-w
+    <value>]
+
+FLAGS
+  -a, --api-version=<value>      Target API version for the retrieve.
+  -d, --source-dir=<value>...    File paths for source to retrieve from the org.
+  -m, --metadata=<value>...      Metadata component names to retrieve.
+  -n, --package-name=<value>...  Package names to retrieve.
+  -o, --target-org=<value>       Login username or alias for the target org.
+  -w, --wait=<value>             [default: 33] Number of minutes to wait for the command to complete and display results
+                                 to the terminal window.
+  -x, --manifest=<value>         File path for the manifest (package.xml) that specifies the components to retrieve.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Retrieve metadata in source format from an org to your local project.
+
+  You must run this command from within a project.
+
+  This command doesn't support source-tracking. The source you retrieve overwrites the corresponding source files in
+  your local project. This command doesn’t attempt to merge the source from your org with your local source files.
+
+  To retrieve multiple metadata components, either use multiple --metadata <name> flags or use a single --metadata flag
+  with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same
+  syntax applies to --manifest and --source-dir.
+
+EXAMPLES
+  Retrieve the source files in a directory:
+
+    $ sf retrieve metadata --source-dir path/to/source
+
+  Retrieve a specific Apex class and the objects whose source is in a directory (both examples are equivalent):
+
+    $ sf retrieve metadata --source-dir path/to/apex/classes/MyClass.cls path/to/source/objects
+    $ sf retrieve metadata --source-dir path/to/apex/classes/MyClass.cls --source-dir path/to/source/objects
+
+  Retrieve all Apex classes:
+
+    $ sf retrieve metadata --metadata ApexClass
+
+  Retrieve a specific Apex class:
+
+    $ sf retrieve metadata --metadata ApexClass:MyApexClass
+
+  Retrieve all custom objects and Apex classes (both examples are equivalent):
+
+    $ sf retrieve metadata --metadata CustomObject ApexClass
+    $ sf retrieve metadata --metadata CustomObject --metadata ApexClass
+
+  Retrieve all metadata components listed in a manifest:
+
+    $ sf retrieve metadata --manifest path/to/package.xml
+
+  Retrieve metadata from a package:
+
+    $ sf retrieve metadata --package-name MyPackageName
+
+  Retrieve metadata from multiple packages, one of which has a space in its name (both examples are equivalent):
+
+    $ sf retrieve metadata --package-name Package1 "PackageName With Spaces" Package3
+    $ sf retrieve metadata --package-name Package1 --package-name "PackageName With Spaces" --package-name Package3
+
+FLAG DESCRIPTIONS
+  -a, --api-version=<value>  Target API version for the retrieve.
+
+    Use this flag to override the default API version, which is the latest version supported the CLI, with the API
+    version in your package.xml file.
+
+  -d, --source-dir=<value>...  File paths for source to retrieve from the org.
+
+    The supplied paths can be to a single file (in which case the operation is applied to only one file) or to a folder
+    (in which case the operation is applied to all source files in the directory and its subdirectories).
+
+  -o, --target-org=<value>  Login username or alias for the target org.
+
+    Overrides your default org.
+
+  -w, --wait=<value>  Number of minutes to wait for the command to complete and display results to the terminal window.
+
+    If the command continues to run after the wait period, the CLI returns control of the terminal window to you.
+
+  -x, --manifest=<value>  File path for the manifest (package.xml) that specifies the components to retrieve.
+
+    If you specify this parameter, don’t specify --metadata or --source-dir.
+```
+
 <!-- commandsstop -->

package/lib/commands/deploy/metadata.d.ts

@@ -0,0 +1,36 @@
+import { FileResponse } from '@sf/sdr';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export declare type TestResults = {
+    passing: number;
+    failing: number;
+    total: number;
+    time?: number;
+};
+export declare type DeployMetadataResult = {
+    files: FileResponse[];
+    tests?: TestResults;
+};
+export default class DeployMetadata extends SfCommand<DeployMetadataResult> {
+    static readonly description: string;
+    static readonly summary: string;
+    static readonly examples: string[];
+    static flags: {
+        metadata: import("@oclif/core/lib/interfaces").OptionFlag<string[]>;
+        manifest: import("@oclif/core/lib/interfaces").OptionFlag<string>;
+        'source-dir': import("@oclif/core/lib/interfaces").OptionFlag<string[]>;
+        'target-org': import("@oclif/core/lib/interfaces").OptionFlag<string>;
+        'test-level': import("@oclif/core/lib/interfaces").OptionFlag<string>;
+        wait: import("@oclif/core/lib/interfaces").OptionFlag<number>;
+    };
+    static configurationVariablesSection: {
+        header: string;
+        body: string | [string, string][] | import("@oclif/core").HelpSectionKeyValueTable;
+    };
+    static envVariablesSection: {
+        header: string;
+        body: string | [string, string][] | import("@oclif/core").HelpSectionKeyValueTable;
+    };
+    run(): Promise<DeployMetadataResult>;
+    private setExitCode;
+    private getTestResults;
+}

package/lib/commands/deploy/metadata.js

@@ -0,0 +1,123 @@
+"use strict";
+/*
+ * Copyright (c) 2021, 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const os_1 = require("os");
+const core_1 = require("@oclif/core");
+const core_2 = require("@salesforce/core");
+const kit_1 = require("@salesforce/kit");
+const ts_types_1 = require("@salesforce/ts-types");
+const types_1 = require("@sf/sdr/lib/src/client/types");
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const orgs_1 = require("../../utils/orgs");
+const componentSetBuilder_1 = require("../../utils/componentSetBuilder");
+const output_1 = require("../../utils/output");
+const testLevel_1 = require("../../utils/testLevel");
+const progressBar_1 = require("../../utils/progressBar");
+const config_1 = require("../../utils/config");
+const requiredFlagValidator_1 = require("../../utils/requiredFlagValidator");
+core_2.Messages.importMessagesDirectory(__dirname);
+const messages = core_2.Messages.loadMessages('@salesforce/plugin-deploy-retrieve', 'deploy.metadata');
+// One of these flags must be specified for a valid deploy.
+const requiredFlags = ['manifest', 'metadata', 'source-dir'];
+class DeployMetadata extends sf_plugins_core_1.SfCommand {
+    async run() {
+        const flags = (await this.parse(DeployMetadata)).flags;
+        const testLevel = flags['test-level'];
+        (0, requiredFlagValidator_1.validateOneOfCommandFlags)(requiredFlags, flags);
+        const componentSet = await componentSetBuilder_1.ComponentSetBuilder.build({
+            sourceapiversion: await (0, orgs_1.getSourceApiVersion)(),
+            sourcepath: flags['source-dir'],
+            manifest: (flags.manifest && {
+                manifestPath: flags.manifest,
+                directoryPaths: await (0, orgs_1.getPackageDirs)(),
+            }),
+            metadata: flags.metadata && {
+                metadataEntries: flags.metadata,
+                directoryPaths: await (0, orgs_1.getPackageDirs)(),
+            },
+        });
+        const targetOrg = await (0, orgs_1.resolveTargetOrg)(flags['target-org']);
+        this.log(`${os_1.EOL}${messages.getMessage('deploy.metadata.api', [targetOrg, (0, config_1.resolveRestDeploy)()])}${os_1.EOL}`);
+        const deploy = await componentSet.deploy({
+            usernameOrConnection: targetOrg,
+            apiOptions: { testLevel },
+        });
+        new progressBar_1.DeployProgress(deploy, this.jsonEnabled()).start();
+        const result = await deploy.pollStatus(500, kit_1.Duration.minutes(flags.wait).seconds);
+        this.setExitCode(result);
+        if (!this.jsonEnabled()) {
+            (0, output_1.displaySuccesses)(result);
+            (0, output_1.displayFailures)(result);
+            (0, output_1.displayTestResults)(result, testLevel);
+        }
+        return {
+            files: (0, output_1.asRelativePaths)((result === null || result === void 0 ? void 0 : result.getFileResponses()) || []),
+            tests: this.getTestResults(result),
+        };
+    }
+    setExitCode(result) {
+        const status = (0, ts_types_1.getString)(result, 'response.status');
+        if (status !== types_1.RequestStatus.Succeeded) {
+            process.exitCode = 1;
+        }
+    }
+    getTestResults(result) {
+        const passing = (0, ts_types_1.get)(result, 'response.numberTestsCompleted', 0);
+        const failing = (0, ts_types_1.get)(result, 'response.numberTestErrors', 0);
+        const total = (0, ts_types_1.get)(result, 'response.numberTestsTotal', 0);
+        const testResults = { passing, failing, total };
+        const time = (0, ts_types_1.get)(result, 'response.details.runTestResult.totalTime', 0);
+        return time ? { ...testResults, time } : testResults;
+    }
+}
+exports.default = DeployMetadata;
+DeployMetadata.description = messages.getMessage('description');
+DeployMetadata.summary = messages.getMessage('summary');
+DeployMetadata.examples = messages.getMessages('examples');
+DeployMetadata.flags = {
+    metadata: core_1.Flags.string({
+        char: 'm',
+        summary: messages.getMessage('flags.metadata.summary'),
+        multiple: true,
+        exclusive: ['manifest', 'source-dir'],
+    }),
+    manifest: core_1.Flags.string({
+        char: 'x',
+        description: messages.getMessage('flags.manifest.description'),
+        summary: messages.getMessage('flags.manifest.summary'),
+        exclusive: ['metadata', 'source-dir'],
+    }),
+    'source-dir': core_1.Flags.string({
+        char: 'd',
+        description: messages.getMessage('flags.source-dir.description'),
+        summary: messages.getMessage('flags.source-dir.summary'),
+        multiple: true,
+        exclusive: ['manifest', 'metadata'],
+    }),
+    'target-org': core_1.Flags.string({
+        char: 'o',
+        description: messages.getMessage('flags.target-org.description'),
+        summary: messages.getMessage('flags.target-org.summary'),
+    }),
+    'test-level': core_1.Flags.string({
+        char: 'l',
+        description: messages.getMessage('flags.test-level.description'),
+        summary: messages.getMessage('flags.test-level.summary'),
+        options: Object.values(testLevel_1.TestLevel),
+        default: testLevel_1.TestLevel.NoTestRun,
+    }),
+    wait: core_1.Flags.integer({
+        char: 'w',
+        summary: messages.getMessage('flags.wait.summary'),
+        description: messages.getMessage('flags.wait.description'),
+        default: 33,
+    }),
+};
+DeployMetadata.configurationVariablesSection = (0, sf_plugins_core_1.toHelpSection)('CONFIGURATION VARIABLES', core_2.OrgConfigProperties.TARGET_ORG, core_2.SfdxPropertyKeys.API_VERSION);
+DeployMetadata.envVariablesSection = (0, sf_plugins_core_1.toHelpSection)('ENVIRONMENT VARIABLES', core_2.EnvironmentVariable.SF_TARGET_ORG, core_2.EnvironmentVariable.SFDX_DEFAULTUSERNAME, core_2.EnvironmentVariable.SFDX_USE_PROGRESS_BAR);
+//# sourceMappingURL=metadata.js.map

package/lib/commands/deploy/metadata.js.map

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