force-cli
v39.14.0
Published
The Force.com CLI allows you to work with Force.com data directly from the command line. You can browse and create Force.com objects, view, edit, create, and delete records, execute APEX code and SOQL queries, and more.
Downloads
5
Maintainers
Readme
Introduction
This package is a Node.js implementation of the force-cli. It integrates with the Heroku Toolbelt.
Installing the Latest Stable Version
- Install the heroku toolbelt:
https://toolbelt.heroku.com/
- Run
heroku plugins:install force-cli-dev
(confirm success withheroku plugins
)
Getting Started as a Dev
- Install Node.js. If you are on the mac, please use Homebrew and execute
brew install node
. Ensure that you have version > 6.2.0. - Install typescript and gulp by doing
npm install -g gulp-cli
- Check out this repository using
git clone [email protected]:DevTools/force-cli.git
- Change to the directory where you checked out the code
- If you want to resolve the salesforce-alm-dev module from a local path execute
npm link ../<path-to-force-com-toolbelt>
- Execute
npm install
- To build, execute
gulp test
- To install the plugin to Toolbelt, execute
heroku plugins:link .
Running Tests
- Unit tests:
gulp test
- Integration tests:
gulp test -i --instance=<instance> --username=<username> --password=<password>
- Specific tests:
gulp test --grep=<test name pattern> [-i] [--instance=<instance> --username=<username> --password=<password>]
- All tests:
gulp test --instance=<instance> --username=<username> --password=<password>
Notes
- To debug integration tests, you have to pass in the login credentials as environment variables like so: FORCE_CLI_TEST_INTEGRATION=true FORCE_CLI_TEST_INSTANCE= FORCE_CLI_TEST_USERNAME= FORCE_CLI_TEST_PASSWORD= mocha --debug-brk dist/test/integration/integrationTest.js