README.md in recurly-0.1.4 vs README.md in recurly-0.2.0
- old
+ new
@@ -14,42 +14,88 @@
Installation
------------
This library can be installed as a gem or a plugin. Your choice.
-**Gem Installation:**
+**Rails3 Bundle Integration:**
- gem install recurly --source=http://gemcutter.org
-
-**Plugin Installation:**
+ gem "recurly", :git => "http://github.com/railsjedi/recurly-client-ruby.git"
- script/plugin install git@github.com:recurly/recurly-client-ruby.git
+**Plugin Installation (not recommended):**
+ script/plugin install http://github.com/railsjedi/recurly-client-ruby.git
+
+
Authentication
--------------
The Recurly Ruby Client requires a username and password to connect. We recommend creating a user just for your API. Please see the [Authentication](http://support.recurly.com/faqs/api/authentication) documentation for more information.
Create a file in your Rails app at __/config/initializers/recurly_config.rb__ with contents like:
Recurly.configure do |c|
c.username = 'api@yourcompany.com'
c.password = 'super_secret_password'
+ c.site = 'https://my-recurly-site.recurly.com'
end
Demo Application
----------------
[Recurly Ruby Demo App](http://github.com/recurly/recurly-client-ruby-demo)
+
Examples
--------
-All the functionality is demonstrated by the unit tests in the __test__ directory.
+All the functionality is demonstrated by the tests in the __spec__ directory.
+Running the Specs
+------------------
+
+Recurly gem uses RSpec2 for testing. It also uses VCR / Webmock to handle fast and repeatable full integration tests with the API.
+
+The way this works is when each spec is first run, it will save each HTTP request generated within the spec/vcr folder. Subsequent http requests will be mocked using the data contained in these YML files.
+
+The first thing to do is install bundler if you don't already have it:
+
+ gem install bundler
+
+The next thing is to setup all the spec dependencies
+
+ bundle
+
+When first running the specs, you'll need to setup a recurly test account. Use the provided rake task to walk you through creating spec/spec_settings.yml with all the authentication info.
+
+ rake recurly:setup
+
+Now when you run `rake` it will hit recurly's api to run all the specs. Subsequent calls will no longer hit the API (and be run locally).
+
+
+Something go Wrong?
+------------------
+
+You can view the full http interactions with Recurly at spec/vcr. Please attached these to any bug reports so we can replicate.
+
+
+Clearing Test Data
+------------------
+
+You can delete the spec/vcr folder at any time, and it will regenerate the requests to recurly's apis. However if you do this, you'll also need to clear the test data on your recurly account. Here's how (manually):
+
+* Login to Recurly
+* Click "Configuration"" on the top right menu
+* Select "Clear Test Data"
+
+This is also automated via a rake task. It will delete the spec/vcr files, and clear the data for you on the server (using your spec_settings.yml authentication info).
+
+ rake recurly:clear
+
+
+
API Documentation
-----------------
-Please see the [Recurly API](http://support.recurly.com/faqs/api/) for more information.
+Please see the [Recurly API](http://docs.recurly.com/api/basics) for more information.
\ No newline at end of file