oanda_ruby_client 1.0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8b6a110cfa0b814c238cb2091a87bde5e44a445d
+  data.tar.gz: e4ae890af891f40ac95f4b00d6a1d0432282f2c5
+SHA512:
+  metadata.gz: 1f18a1c04037ba10094f202cd3e4b4e0a0218ac0d7dfefe65ea3074606e46f4dca42f049573348b7c3c544ffb3562a09b9f8ae8af93389490e2ff1ff822e82cf
+  data.tar.gz: 481e65dc821d0625895d38ad06fbfc5a56820231511e18e9ae613de917088066c18c09ad1b2c805cedbbb251283875aac56a810a383fb343afaa2951a3ef61f6

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in oanda_ruby_client.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,57 @@
+PATH
+  remote: .
+  specs:
+    oanda_ruby_client (1.0.0.0)
+      addressable (~> 2.3.7)
+      httparty
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.7)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    httparty (0.13.3)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    json (1.8.2)
+    multi_json (1.10.1)
+    multi_xml (0.5.5)
+    rake (10.4.2)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.0)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.1)
+    safe_yaml (1.0.4)
+    simplecov (0.9.1)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    vcr (2.9.3)
+    webmock (1.20.4)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.8)
+  oanda_ruby_client!
+  rake (~> 10.0)
+  rspec
+  simplecov (~> 0.9.1)
+  vcr (~> 2.9.3)
+  webmock (~> 1.20.4)

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Frontera Consulting, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,99 @@
+# Oanda Ruby Client
+
+The Oanda Ruby Client provides a simple client class to retrieve exchange rates from Oanda using the Exchange Rate API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'oanda_ruby_client'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install oanda_ruby_client
+
+## Usage
+
+### Getting Started
+
+Initialize the client as follows:
+
+```ruby
+require 'oanda_ruby_client'
+
+client = OandaRubyClient::ExchangeRatesClient.new('MY_API_KEY') # Provide your API Key as the parameter
+```
+
+If you store the API key in an environment variable named `OANDA_RUBY_CLIENT_API_KEY`, you can omit the parameter:
+
+```ruby
+client = OandaRubyClient::ExchangeRatesClient.new
+```
+
+### Get Rates
+
+Create a request specifying the base currency as the first parameter, and any optional paramters as a hash. The keys of the optional paramters are the same as those for the [Exchange Rate API](http://developer.oanda.com/exchange-rates-api/v1/rates/#input-query-parameters):
+
+For example, to specify a base currency of USD, a quote currency of GBP, and a date of February 11, 2015:
+
+```ruby
+rates_request = OandaRubyClient::RatesRequest.new('USD', quote: 'GBP', date: '2015-02-11')
+```
+
+Date parameters can be specified using a string in the format of `YYYY-MM-DD` or by using an instance of `Date`:
+
+```ruby
+require 'date'
+
+rates_request = OandaRubyClient::RatesRequest.new('USD', quote: 'GBP', date: Date.new(2015, 2, 11))
+```
+
+Multi-value parameters (e.g., quote currency) can be specified using arrays:
+
+```ruby
+rates_request = OandaRubyClient::RatesRequest.new('USD', quote: [ 'GBP', 'EUR' ], date: '2015-02-11')
+```
+
+Pass the rates request as a parameter into the `rates` method of the client:
+
+```ruby
+rates_result = client.rates(rates_request)
+```
+
+The returning object will be an `OpenStruct` with the attributes `base_currency` (String), `meta` (Hash), `quotes` (Hash).
+
+### Get Currencies
+
+To obtain the collection of supported currencies, use the `currencies` method:
+
+```ruby
+currencies_result = client.currencies
+```
+
+The returning object will be a hash of currency codes to descriptions.
+
+### Get Remaining Quotes
+
+For plans that have a limited number of quotes, use the `remaining_quotes` method to return the number of remaining quotes:
+
+```ruby
+remaining_quotes_result = client.remaining_quotes
+```
+
+### Additional Resources
+
+* http://developer.oanda.com/exchange-rates-api/
+
+## Contributing
+
+1. Fork it 
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+
+task :console do
+  require 'irb'
+  require 'irb/completion'
+  require 'oanda_ruby_client'
+  ARGV.clear
+  IRB.start
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "oanda_ruby_client"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/fixtures/vcr_cassettes/oanda/currencies.yml

@@ -0,0 +1,138 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://www.oanda.com/rates/api/v1/currencies.json
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - Bearer {OANDA_API_KEY}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 12 Feb 2015 23:41:21 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '9394'
+      Connection:
+      - keep-alive
+      Server:
+      - nginx
+      Vary:
+      - Accept-Encoding
+      X-Oanda-Exchange-Rates-Api-Version:
+      - 1.0.2
+      Set-Cookie:
+      - opc_id=A5E39DDE-B310-11E4-A953-BAED8E3C4C4D; path=/; Expires=Sun, 09-Feb-2025
+        23:41:21 GMT
+    body:
+      encoding: UTF-8
+      string: '{"currencies":[{"code":"ADF","description":"Andorran Franc"},{"code":"ADP","description":"Andorran
+        Peseta"},{"code":"AED","description":"Utd. Arab Emir. Dirham"},{"code":"AFA","description":"Afghanistan
+        Old Afghani"},{"code":"AFN","description":"Afghan Afghani"},{"code":"ALL","description":"Albanian
+        Lek"},{"code":"AMD","description":"Armenian Dram"},{"code":"ANG","description":"NL
+        Antillian Guilder"},{"code":"AOA","description":"Angolan Kwanza"},{"code":"AON","description":"Angolan
+        Old Kwanza"},{"code":"ARS","description":"Argentine Peso"},{"code":"ATS","description":"Austrian
+        Schilling"},{"code":"AUD","description":"Australian Dollar"},{"code":"AWG","description":"Aruban
+        Florin"},{"code":"AZM","description":"Azerbaijan Old Manat"},{"code":"AZN","description":"Azerbaijan
+        New Manat"},{"code":"BAM","description":"Bosnian Mark"},{"code":"BBD","description":"Barbados
+        Dollar"},{"code":"BDT","description":"Bangladeshi Taka"},{"code":"BEF","description":"Belgian
+        Franc"},{"code":"BGL","description":"Bulgarian Old Lev"},{"code":"BGN","description":"Bulgarian
+        Lev"},{"code":"BHD","description":"Bahraini Dinar"},{"code":"BIF","description":"Burundi
+        Franc"},{"code":"BMD","description":"Bermudian Dollar"},{"code":"BND","description":"Brunei
+        Dollar"},{"code":"BOB","description":"Bolivian Boliviano"},{"code":"BRL","description":"Brazilian
+        Real"},{"code":"BSD","description":"Bahamian Dollar"},{"code":"BTC","description":"Bitcoin"},{"code":"BTN","description":"Bhutan
+        Ngultrum"},{"code":"BWP","description":"Botswana Pula"},{"code":"BYR","description":"Belarusian
+        Ruble"},{"code":"BZD","description":"Belize Dollar"},{"code":"CAD","description":"Canadian
+        Dollar"},{"code":"CDF","description":"Congolese Franc"},{"code":"CHF","description":"Swiss
+        Franc"},{"code":"CLP","description":"Chilean Peso"},{"code":"CNY","description":"Chinese
+        Yuan Renminbi"},{"code":"COP","description":"Colombian Peso"},{"code":"CRC","description":"Costa
+        Rican Colon"},{"code":"CUC","description":"Cuban Convertible Peso"},{"code":"CUP","description":"Cuban
+        Peso"},{"code":"CVE","description":"Cape Verde Escudo"},{"code":"CYP","description":"Cypriot
+        Pound"},{"code":"CZK","description":"Czech Koruna"},{"code":"DEM","description":"German
+        Mark"},{"code":"DJF","description":"Djibouti Franc"},{"code":"DKK","description":"Danish
+        Krone"},{"code":"DOP","description":"Dominican Peso"},{"code":"DZD","description":"Algerian
+        Dinar"},{"code":"ECS","description":"Ecuador Sucre"},{"code":"EEK","description":"Estonian
+        Kroon"},{"code":"EGP","description":"Egyptian Pound"},{"code":"ERN","description":"Eritrean
+        Nakfa"},{"code":"ESP","description":"Spanish Peseta"},{"code":"ETB","description":"Ethiopian
+        Birr"},{"code":"EUR","description":"Euro"},{"code":"FIM","description":"Finnish
+        Markka"},{"code":"FJD","description":"Fiji Dollar"},{"code":"FKP","description":"Falkland
+        Islands Pound"},{"code":"FRF","description":"French Franc"},{"code":"GBP","description":"United
+        Kingdom Pound"},{"code":"GEL","description":"Georgian Lari"},{"code":"GHC","description":"Ghanian
+        Old Cedi"},{"code":"GHS","description":"Ghanaian New Cedi"},{"code":"GIP","description":"Gibraltar
+        Pound"},{"code":"GMD","description":"Gambian Dalasi"},{"code":"GNF","description":"Guinea
+        Franc"},{"code":"GRD","description":"Greek Drachma"},{"code":"GTQ","description":"Guatemalan
+        Quetzal"},{"code":"GYD","description":"Guyanan Dollar"},{"code":"HKD","description":"Hong
+        Kong Dollar"},{"code":"HNL","description":"Honduran Lempira"},{"code":"HRK","description":"Croatian
+        Kuna"},{"code":"HTG","description":"Haitian Gourde"},{"code":"HUF","description":"Hungarian
+        Forint"},{"code":"IDR","description":"Indonesian Rupiah"},{"code":"IEP","description":"Irish
+        Punt"},{"code":"ILS","description":"Israeli New Shekel"},{"code":"INR","description":"Indian
+        Rupee"},{"code":"IQD","description":"Iraqi Dinar"},{"code":"IRR","description":"Iranian
+        Rial"},{"code":"ISK","description":"Iceland Krona"},{"code":"ITL","description":"Italian
+        Lira"},{"code":"JMD","description":"Jamaican Dollar"},{"code":"JOD","description":"Jordanian
+        Dinar"},{"code":"JPY","description":"Japanese Yen"},{"code":"KES","description":"Kenyan
+        Shilling"},{"code":"KGS","description":"Kyrgyzstanian Som"},{"code":"KHR","description":"Cambodian
+        Riel"},{"code":"KMF","description":"Comoros Franc"},{"code":"KPW","description":"North
+        Korean Won"},{"code":"KRW","description":"Korean Won"},{"code":"KWD","description":"Kuwaiti
+        Dinar"},{"code":"KYD","description":"Cayman Islands Dollar"},{"code":"KZT","description":"Kazakhstan
+        Tenge"},{"code":"LAK","description":"Lao Kip"},{"code":"LBP","description":"Lebanese
+        Pound"},{"code":"LKR","description":"Sri Lanka Rupee"},{"code":"LRD","description":"Liberian
+        Dollar"},{"code":"LSL","description":"Lesotho Loti"},{"code":"LTL","description":"Lithuanian
+        Litas"},{"code":"LUF","description":"Luxembourg Franc"},{"code":"LVL","description":"Latvian
+        Lats"},{"code":"LYD","description":"Libyan Dinar"},{"code":"MAD","description":"Moroccan
+        Dirham"},{"code":"MDL","description":"Moldovan Leu"},{"code":"MGA","description":"Malagasy
+        Ariary"},{"code":"MGF","description":"Malagasy Old Franc"},{"code":"MKD","description":"Macedonian
+        Denar"},{"code":"MMK","description":"Myanmar Kyat"},{"code":"MNT","description":"Mongolian
+        Tugrik"},{"code":"MOP","description":"Macau Pataca"},{"code":"MRO","description":"Mauritanian
+        Ouguiya"},{"code":"MTL","description":"Maltese Lira"},{"code":"MUR","description":"Mauritius
+        Rupee"},{"code":"MVR","description":"Maldive Rufiyaa"},{"code":"MWK","description":"Malawi
+        Kwacha"},{"code":"MXN","description":"Mexican Peso"},{"code":"MYR","description":"Malaysian
+        Ringgit"},{"code":"MZM","description":"Mozambique Old Metical"},{"code":"MZN","description":"Mozambique
+        New Metical"},{"code":"NAD","description":"Namibia Dollar"},{"code":"NGN","description":"Nigerian
+        Naira"},{"code":"NIO","description":"Nicaraguan Cordoba Oro"},{"code":"NLG","description":"Dutch
+        Guilder"},{"code":"NOK","description":"Norwegian Kroner"},{"code":"NPR","description":"Nepalese
+        Rupee"},{"code":"NZD","description":"New Zealand Dollar"},{"code":"OMR","description":"Omani
+        Rial"},{"code":"PAB","description":"Panamanian Balboa"},{"code":"PEN","description":"Peruvian
+        Nuevo Sol"},{"code":"PGK","description":"Papua New Guinea Kina"},{"code":"PHP","description":"Philippine
+        Peso"},{"code":"PKR","description":"Pakistan Rupee"},{"code":"PLN","description":"Polish
+        Zloty"},{"code":"PTE","description":"Portuguese Escudo"},{"code":"PYG","description":"Paraguay
+        Guarani"},{"code":"QAR","description":"Qatari Rial"},{"code":"ROL","description":"Romanian
+        Old Leu"},{"code":"RON","description":"Romanian New Leu"},{"code":"RSD","description":"Serbian
+        Dinar"},{"code":"RUB","description":"Russian Rouble"},{"code":"RWF","description":"Rwandan
+        Franc"},{"code":"SAR","description":"Saudi Riyal"},{"code":"SBD","description":"Solomon
+        Islands Dollar"},{"code":"SCR","description":"Seychelles Rupee"},{"code":"SDD","description":"Sudanese
+        Old Dinar"},{"code":"SDG","description":"Sudanese Pound"},{"code":"SDP","description":"Sudanese
+        Old Pound"},{"code":"SEK","description":"Swedish Krona"},{"code":"SGD","description":"Singapore
+        Dollar"},{"code":"SHP","description":"St. Helena Pound"},{"code":"SIT","description":"Slovenian
+        Tolar"},{"code":"SKK","description":"Slovak Koruna"},{"code":"SLL","description":"Sierra
+        Leone Leone"},{"code":"SOS","description":"Somali Shilling"},{"code":"SRD","description":"Suriname
+        Dollar"},{"code":"SRG","description":"Suriname Old Guilder"},{"code":"STD","description":"Sao
+        Tome/Principe Dobra"},{"code":"SVC","description":"El Salvador Colon"},{"code":"SYP","description":"Syrian
+        Pound"},{"code":"SZL","description":"Swaziland Lilangeni"},{"code":"THB","description":"Thai
+        Baht"},{"code":"TJS","description":"Tajikistan Somoni"},{"code":"TMM","description":"Turkmenistan
+        Old Manat"},{"code":"TMT","description":"Turkmenistan New Manat"},{"code":"TND","description":"Tunisian
+        Dinar"},{"code":"TOP","description":"Tongan Pa''anga"},{"code":"TRL","description":"Turkish
+        Old Lira"},{"code":"TRY","description":"Turkish Lira"},{"code":"TTD","description":"Trinidad/Tobago
+        Dollar"},{"code":"TWD","description":"Taiwan Dollar"},{"code":"TZS","description":"Tanzanian
+        Shilling"},{"code":"UAH","description":"Ukraine Hryvnia"},{"code":"UGX","description":"Uganda
+        Shilling"},{"code":"USD","description":"US Dollar"},{"code":"UYU","description":"Uruguayan
+        Peso"},{"code":"UZS","description":"Uzbekistan Som"},{"code":"VEB","description":"Venezuelan
+        Bolivar"},{"code":"VEF","description":"Venezuelan Bolivar Fuerte"},{"code":"VND","description":"Vietnamese
+        Dong"},{"code":"VUV","description":"Vanuatu Vatu"},{"code":"WST","description":"Samoan
+        Tala"},{"code":"XAF","description":"CFA Franc BEAC"},{"code":"XAG","description":"Silver
+        (oz.)"},{"code":"XAU","description":"Gold (oz.)"},{"code":"XCD","description":"East
+        Carribean Dollar"},{"code":"XEU","description":"ECU"},{"code":"XOF","description":"CFA
+        Franc BCEAO"},{"code":"XPD","description":"Palladium (oz.)"},{"code":"XPF","description":"CFP
+        Franc"},{"code":"XPT","description":"Platinum (oz.)"},{"code":"YER","description":"Yemen
+        Rial"},{"code":"YUN","description":"Yugoslavian Old Dinar"},{"code":"ZAR","description":"South
+        African Rand"},{"code":"ZMK","description":"Zambian Kwacha"},{"code":"ZMW","description":"Zambian
+        Kwacha"},{"code":"ZWD","description":"Zimbabwe Dollar"}]}'
+    http_version: 
+  recorded_at: Thu, 12 Feb 2015 23:41:21 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/oanda/missing_api_key.yml

@@ -0,0 +1,35 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://www.oanda.com/rates/api/v1/remaining_quotes.json
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - Bearer
+  response:
+    status:
+      code: 400
+      message: Bad Request
+    headers:
+      Date:
+      - Thu, 12 Feb 2015 23:41:21 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '77'
+      Connection:
+      - keep-alive
+      Server:
+      - nginx
+      X-Oanda-Exchange-Rates-Api-Version:
+      - 1.0.2
+    body:
+      encoding: UTF-8
+      string: '{"code":8,"message":"Malformed Authorization header or invalid access
+        token"}'
+    http_version: 
+  recorded_at: Thu, 12 Feb 2015 23:41:21 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/oanda/rates.yml

@@ -0,0 +1,41 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://www.oanda.com/rates/api/v1/rates/USD.json?date=2015-02-11&quote=GBP
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - Bearer {OANDA_API_KEY}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 12 Feb 2015 23:41:20 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '311'
+      Connection:
+      - keep-alive
+      Server:
+      - nginx
+      Vary:
+      - Accept-Encoding
+      X-Oanda-Exchange-Rates-Api-Version:
+      - 1.0.2
+      X-Rate-Limit-Remaining:
+      - '99992'
+      Set-Cookie:
+      - opc_id=A5A76274-B310-11E4-8347-B169D88622F7; path=/; Expires=Sun, 09-Feb-2025
+        23:41:20 GMT
+    body:
+      encoding: UTF-8
+      string: '{"base_currency":"USD","meta":{"effective_params":{"data_set":"oanda","date":"2015-02-11","decimal_places":5,"fields":["averages"],"quote_currencies":["GBP"]},"request_time":"2015-02-12T23:41:20+0000","skipped_currencies":[]},"quotes":{"GBP":{"ask":"0.65542","bid":"0.65533","date":"2015-02-11T21:00:00+0000"}}}'
+    http_version: 
+  recorded_at: Thu, 12 Feb 2015 23:41:20 GMT
+recorded_with: VCR 2.9.3

data/fixtures/vcr_cassettes/oanda/remaining_quotes.yml

@@ -0,0 +1,39 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://www.oanda.com/rates/api/v1/remaining_quotes.json
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - Bearer {OANDA_API_KEY}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 12 Feb 2015 23:41:21 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '26'
+      Connection:
+      - keep-alive
+      Server:
+      - nginx
+      Vary:
+      - Accept-Encoding
+      X-Oanda-Exchange-Rates-Api-Version:
+      - 1.0.2
+      Set-Cookie:
+      - opc_id=A61A0FCC-B310-11E4-9820-ED2700000000; path=/; Expires=Sun, 09-Feb-2025
+        23:41:21 GMT
+    body:
+      encoding: UTF-8
+      string: '{"remaining_quotes":99992}'
+    http_version: 
+  recorded_at: Thu, 12 Feb 2015 23:41:21 GMT
+recorded_with: VCR 2.9.3

data/lib/oanda_ruby_client.rb

@@ -0,0 +1,6 @@
+require "oanda_ruby_client/version"
+require "oanda_ruby_client/exchange_rates_client"
+require "oanda_ruby_client/rates_request"
+
+module OandaRubyClient
+end

data/lib/oanda_ruby_client/exchange_rates_client.rb

@@ -0,0 +1,80 @@
+require 'httparty'
+require 'ostruct'
+
+module OandaRubyClient
+
+  class ExchangeRatesClient
+    
+    # @param api_key [String] The API key for the Excange Rates API.
+    # @param use_ssl [Boolean] If +true+, sets the URL endpoint scheme to +https+. If
+    #                +false+, sets the scheme to +http+.
+    def initialize(api_key = ENV['OANDA_RUBY_CLIENT_API_KEY'], use_ssl = true)
+      @api_key, @use_ssl = api_key, use_ssl
+    end
+    
+    # @return [Hash<String, String>] a hash of the supported currency codes to their descriptions
+    def currencies
+      currencies_response = HTTParty.get("#{oanda_endpoint}#{CURRENCIES_PATH}", headers: oanda_headers)
+      handle_response(currencies_response.response)
+      result = {}
+      currencies_response.parsed_response['currencies'].each do |currency|
+        result[currency['code']] = currency['description']
+      end
+      result
+    end
+    
+    # Returns the exchanges rates based on the specified request
+    #
+    # @param rates_request [OandaRubyClient::RatesRequest] Request criteria
+    # @return [OpenStruct] An object structured similarly to the response from the Exchange Rate API
+    def rates(rates_request)
+      rates_uri = "#{oanda_endpoint}#{RATES_BASE_PATH}#{rates_request.base_currency}.json?#{rates_request.query_string}"
+      rates_response = HTTParty.get(rates_uri, headers: oanda_headers)
+      handle_response(rates_response.response)
+      OpenStruct.new(rates_response.parsed_response)
+    end
+    
+    # Returns the number of remaining quote requests
+    #
+    # @return [Fixnum, 'unlimited'] Number of remaining quote requests
+    def remaining_quotes
+      remaining_quotes_response = HTTParty.get("#{oanda_endpoint}#{REMAINING_QUOTES_PATH}", headers: oanda_headers)
+      handle_response(remaining_quotes_response.response)
+      remaining_quotes_response.parsed_response['remaining_quotes']
+    end
+    
+  private
+    
+    OANDA_ENDPOINT = '//www.oanda.com/rates/api/v1/' #:nodoc:
+
+    RATES_BASE_PATH = 'rates/' #:nodoc:
+    CURRENCIES_PATH = 'currencies.json' #:nodoc:
+    REMAINING_QUOTES_PATH = 'remaining_quotes.json' #:nodoc:
+
+    attr_accessor :api_key, :use_ssl
+    
+    def handle_response(response)
+      if response.code_type != Net::HTTPOK
+        if response.body
+          raise JSON.parse(response.body)['message']
+        else 
+          raise response
+        end
+      end
+    end
+
+    def oanda_headers
+      { 'Authorization' => "Bearer #{@api_key}"}
+    end
+    
+    def oanda_endpoint
+      "#{scheme}#{OANDA_ENDPOINT}"
+    end
+    
+    def scheme
+      @use_ssl ? 'https:' : 'http:'
+    end
+        
+  end
+  
+end

data/lib/oanda_ruby_client/rates_request.rb

@@ -0,0 +1,30 @@
+require 'date'
+require 'addressable/uri'
+
+module OandaRubyClient
+  
+  class RatesRequest
+  
+    attr_accessor :base_currency, :query_params
+        
+    # @param base_currency [String] Currency code for the base currency
+    # @param query_params [Hash] Optional query parameters
+    def initialize(base_currency, query_params = {})
+      @base_currency, @query_params = base_currency.to_s.upcase, query_params
+    end
+    
+    # @return [String] the query string that will be passed to the API
+    def query_string
+      [ :date, :start, :end ].each do |date_key|
+        if query_params[date_key] && query_params[date_key].is_a?(Date)
+          query_params[date_key] = query_params[date_key].iso8601
+        end
+      end
+      uri = Addressable::URI.new
+      uri.query_values = query_params
+      uri.query
+    end
+    
+  end
+  
+end

data/lib/oanda_ruby_client/version.rb

@@ -0,0 +1,3 @@
+module OandaRubyClient
+  VERSION = "1.0.0.0"
+end

data/oanda_ruby_client.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'oanda_ruby_client/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "oanda_ruby_client"
+  spec.version       = OandaRubyClient::VERSION
+  spec.authors       = ["David Massad"]
+  spec.email         = ["david.massad@fronteraconsulting.net"]
+
+  spec.summary       = "Oanda Ruby Client"
+  spec.description   = 'Provides a client for the Oanda Exchange Rate API'
+  spec.homepage      = "https://github.com/FronteraConsulting/oanda_ruby_client"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'httparty'
+  spec.add_dependency 'addressable', '~> 2.3.7'
+  
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'vcr', '~> 2.9.3'
+  spec.add_development_dependency 'webmock', '~> 1.20.4'
+  spec.add_development_dependency 'simplecov', '~> 0.9.1'
+  
+end

metadata

@@ -0,0 +1,177 @@
+--- !ruby/object:Gem::Specification
+name: oanda_ruby_client
+version: !ruby/object:Gem::Version
+  version: 1.0.0.0
+platform: ruby
+authors:
+- David Massad
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.7
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.3
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.20.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.20.4
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+description: Provides a client for the Oanda Exchange Rate API
+email:
+- david.massad@fronteraconsulting.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- fixtures/vcr_cassettes/oanda/currencies.yml
+- fixtures/vcr_cassettes/oanda/missing_api_key.yml
+- fixtures/vcr_cassettes/oanda/rates.yml
+- fixtures/vcr_cassettes/oanda/remaining_quotes.yml
+- lib/oanda_ruby_client.rb
+- lib/oanda_ruby_client/exchange_rates_client.rb
+- lib/oanda_ruby_client/rates_request.rb
+- lib/oanda_ruby_client/version.rb
+- oanda_ruby_client.gemspec
+homepage: https://github.com/FronteraConsulting/oanda_ruby_client
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Oanda Ruby Client
+test_files: []
+has_rdoc: