abuse-the-force/README.md

85 lines
2.6 KiB
Markdown
Raw Normal View History

2013-04-24 21:24:51 +00:00
Abuse the Force
2013-04-18 16:09:05 +00:00
===============
A tool expanding upon [Metaforce](https://github.com/ejholmes/metaforce) for deploying to
multiple orgs as well as simpler setup for use as a pseudo compiler
Features
2013-04-18 17:55:25 +00:00
--------
2013-04-24 21:24:51 +00:00
* 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
2013-04-24 21:24:51 +00:00
* [Vim plugin](https://github.com/ViViDboarder/vim-abuse-the-force)
2013-07-03 18:16:56 +00:00
* [Sublime plugin](https://github.com/ViViDboarder/sublime-abuse-the-force)
2013-04-18 16:09:05 +00:00
2013-04-18 17:45:59 +00:00
Usage
2013-04-18 17:55:25 +00:00
-----
2013-04-24 21:24:51 +00:00
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
2013-08-08 22:53:29 +00:00
# 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
2013-04-24 21:24:51 +00:00
More advanced documentation can be found by running any of the `help` commands.
atf help
atf deploy help
atf retrieve help
atf target help
2013-04-18 17:45:59 +00:00
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
2013-08-08 22:53:29 +00:00
You can generate a file like this using `git diff --no-commit-id --name-only` or the script included
in the `examples` directory.
2013-04-18 17:45:59 +00:00
Why This Over Metaforce?
2013-04-18 17:55:25 +00:00
------------------------
2013-07-03 18:16:56 +00:00
* Vim and Sublime plugins
2013-04-18 16:09:05 +00:00
* Command line configuration management
2013-04-24 21:24:51 +00:00
* Options for deploying or retrieving a single file
2013-04-18 16:09:05 +00:00
* Encrypted Passwords coming soon
2013-04-18 17:45:59 +00:00
Installation
2013-04-18 17:55:25 +00:00
------------
2013-04-18 17:45:59 +00:00
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
2013-08-28 17:18:57 +00:00
[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/ViViDboarder/abuse-the-force/trend.png)](https://bitdeli.com/free "Bitdeli Badge")