sfdx

Performs Salesforce DX operations with ease! Life is good.

  • sfdx

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
sfdx
1191.4.24 years ago5 years agoMinified + gzip package size for sfdx in KB

Readme

sfdx
!NPM versionnpm-version-imagenpm-version-url !NPM versionnpm-downloads-imagenpm-downloads-url
sfdx is a node module used to interact with Salesforce DX commands, hopefully in a more intuitive way than with the DX CLI itself. sfdx is meant to take some of the nuances of using Salesforce DX and make common operations easier.
If you find this useful, please consider donating to my Patreon to help me develop!

<img src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" width="160">

Help / Documentation

Installation

Make sure you have the Salesforce DX CLI installed first! This module will let you know if you don't, but it will leave it up to you to actually install it.
npm i sfdx --save

Examples

(Sample project here.)
Here is a function that one might use to spin up an org and push code into it:
````javascript const sfdx = require('sfdx')
// options - all options to use for the relevant commands // (see sfdx config documentation) function spinup(options) { // Create a new scratch org sfdx.create(options) // Push local code into the newly-created scratch org sfdx.push(options) // Open the newly-created scratch org in a browser window sfdx.open(options) } ````
As another example, here is a function that pulls code from a scratch org, converts the local Salesforce DX code into Metadata API format, and deploys the converted code into a production (i.e. non-scratch) org.
````javascript const sfdx = require('sfdx')
// options - all options to use for the relevant commands // (see sfdx config documentation) function toproduction(options) { // Pull code from the scratch org sfdx.pull(options) // Convert local Salesforce DX code into Metadata API format sfdx.convert(options) // Deploy the formatted code into a non-scratch org // 'deployto' specifies to deploy to the org named 'MySandbox' sfdx.deploy({
deployto: 'MySandbox'
}) } ````

To import all commands to be used in a CLI

> All of the commands have a relevant terminal command (including shortcuts!), thanks to yargs. To import all of them, simply use the .yargs property of each to create the relevant command.
For example, to import all of the commands, do the following (ensure you have yargs installed):
````javascript
!/usr/bin/env node
const sfdx = require('sfdx') const yargs = require('yargs')
// Import all commands for (let command of Object.keys(sfdx)) { yargs.command(sfdxcommand.yargs) }
// Initialize yargs commands yargs.argv ````
Then, if you save that file as "cli.js" and you add something like the following to your package.json and then run "npm link", the command "dx l" will list all connected orgs (for example)!
````json ... "bin": {
"dx": "cli.js"
}, ... ````
For help with the terminal commands, which includes seeing a command's shortcuts, use --help (or -h) on any command. To see help for ALL commands, use --help (or -h) on the root command (for example dx -h)!

Further Help / Documentation