Vertigo¶ ↑
(This repository is archived and no longer maintained.)
Is the VerticalResponse API making you dizzy?
Vertigo is a simple Ruby wrapper that makes working with the VerticalResponse SOAP API much more Ruby-like. It manages your session_id, as well as letting you write methods as launch_email_campaign rather than launchEmailCampaign, and use symbols as keys rather than strings.
Author: Benjamin Oakes <hello@benjaminoakes.com>, @benjaminoakes
Installation¶ ↑
Simply add Vertigo to your Gemfile:
gem 'vertigo'
If you are unlucky enough not to be using Bundler:
gem install vertigo
Usage¶ ↑
Basic example:
require 'vertigo' client = Vertigo::Client.new('username', 'password', :duration_minutes => 5) # Launch a campaign whose ID you already know: client.launch_email_campaign(:campaign_id => 123456)
For more info, please see Vertigo::Client.
Compatibility¶ ↑
-
Requires Ruby 1.8.7 (because of dependency on soap4r)
-
Written against the 2011.08.10 deploy of the VerticalResponse API “v1.0”. More information: developers.verticalresponse.com/api/soap/developers-reference/articles/verticalresponse-api-update-for-august-2011/
Contributing¶ ↑
Wow, you want to contribute? That’s awesome! Thanks!
To set up your development environment, please run:
bash dev-setup.sh
Among other things, that command makes sure you have run ‘git flow init` (which makes managing contributions easier). Please develop on the develop
branch. When you have something you’d like to share, send a pull request to @benjaminoakes.
Notes on Gems¶ ↑
-
This is a Ruby Gem, built using Bundler. For a walkthrough of how that works, see railscasts.com/episodes/245-new-gem-with-bundler
-
You get some rake tasks for free (see ‘rake –tasks`) to help with building and installing
Misc.¶ ↑
When writing documentation, this is handy:
bundle exec yard server --reload
Thanks¶ ↑
-
Forrest Chang (@fkchang2000) for the name