vividboarder/abuse-the-force
2
0
Fork 0
mirror of https://github.com/ViViDboarder/abuse-the-force.git synced 2024-11-21 17:16:38 +00:00
Code Issues Releases Wiki Activity
Command Line SFDC Deploy Tool
29 Commits 1 Branch 0 Tags 76 KiB
Ruby 99.7%
Makefile 0.3%
3e21b34664
Go to file
ViViDboarder 3e21b34664 Fix message displayed when running tests 
Used to show Deploy FAILURE for successful test runs
Small bump of version too
2013-08-21 16:28:46 -07:00
bin Initial commit 2013-04-18 09:16:22 -07:00
examples Update git-changed to better recognize single commits 2013-07-03 11:19:23 -07:00
lib Fix message displayed when running tests 2013-08-21 16:28:46 -07:00
test Initial commit 2013-04-18 09:16:22 -07:00
.gitignore Change name of Yaml Settings file 2013-04-18 10:45:59 -07:00
abusetheforce.gemspec Update of Zipping and Temp Dir process 2013-05-09 14:45:28 -07:00
Rakefile Initial commit 2013-04-18 09:16:22 -07:00
README.md Update README.md 2013-08-08 15:53:29 -07:00

README.md

Abuse the Force

A tool expanding upon Metaforce for deploying to multiple orgs as well as simpler setup for use as a pseudo compiler

Features

  • Store orgs config file for easy switching between deploy targets
  • Familiar command sub-command interface (think git)
  • Deploy single files without deploying the entire project
  • Execute test class
  • Deploy a list of specific files to deploy
  • Vim plugin
  • Sublime plugin

Usage

Much like git, you initialize your project directory by adding your deploy targets first. Once you have one set you can view the active target with atf target. If you want to deploy from there you just execute one of the deploy commands.

Simple Setup Example

# Add production
atf target add production vividboarder@mycompany.com MY_SECURITY_TOKEN
# Deploy to production
atf deploy project
# Add a sandbox
atf target add sandbox vividboarder@mycompany.com.sandbox MY_SECURITY_TOKEN --sandbox
# Switch active targets
atf target activate sandbox
# Deploy to sandbox
atf deploy project
# Deploy a single file
atf deploy file src/classes/MyClass.cls
# Run a test class
atf deploy test src/classes/MyClassTest.cls
# Retrieve a single file
atf retrieve file src/objects/Opportunity.object

More advanced documentation can be found by running any of the help commands.

atf help
atf deploy help
atf retrieve help
atf target help

Deploy List

Deploy list gives you an easy way to only deploy files that have changed. This works really well if you are using some kind of version control.

It takes a file of the format:

src/classes/MyClass.cls
src/triggers/MyTrigger.trigger

You can generate a file like this using git diff --no-commit-id --name-only or the script included in the examples directory.

Why This Over Metaforce?

  • Vim and Sublime plugins
  • Command line configuration management
  • Options for deploying or retrieving a single file
  • Encrypted Passwords coming soon

Installation

Must have ruby 1.9 and gem installed

git clone git://github.com/ViViDboarder/abuse-the-force.git
cd abuse-the-force
gem build abusetheforce.gemspec
gem install abusetheforce-X.X.X.gem # make sure the proper version is present

Todo

  • See Issues tab