jpbalarini/uruguayan_exchange_rates

View on GitHub
README.md

Summary

Maintainability
Test Coverage
# Uruguayan Exchange Rates

[![Code Climate](https://codeclimate.com/github/jpbalarini/uruguayan_exchange_rates/badges/gpa.svg)](https://codeclimate.com/github/jpbalarini/uruguayan_exchange_rates)
[![Build Status](https://travis-ci.org/jpbalarini/uruguayan_exchange_rates.svg?branch=master)](https://travis-ci.org/jpbalarini/uruguayan_exchange_rates)

With this gem you can get the official Uruguayan exchange rates (buy and sell values) for multiple currencies. Data is taken from Banco República.
This gem was designed for a project where I needed to update the price of some elements daily, using the official Uruguayan exchange rates.

## Installation

Add this line to your application's Gemfile:

    gem 'uruguayan_exchange_rates'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install uruguayan_exchange_rates

## Usage

Usage is simple, just call the exchange_rates method with a valid key:
  
    UruguayanExchangeRates.exchange_rates(:UYU_USD)

It should return a hash with two elements, buy and sell values respectively:
  
    {:buy=>28.0, :sell=>28.8} 

Supported keys are:
  
    {
      :UYU_USD => 'Dólar',
      :UYU_EUR => 'Euro',
      :UYU_ARS => 'Peso Argentino',
      :UYU_BRL => 'Real',
      :USD_GPD => 'Dólares USA por Libra esterlina',
      :CHF_USD => 'Francos suizos por Dólar',
      :JPY_USD => 'Yens por Dólar',
      :USD_EUR => 'Dólares USA por Euro',
      :ARS_USD => 'Pesos Argentinos por Dólar',
      :BRL_USD => 'Reales por Dólar',
      :PYG_USD => 'Guaraníes por Dólar',
      :UYU_UI => 'Unidad Indexada',
      :USD_ONZATROY => 'Onza Troy de Oro'
    }

## Contributing

1. Fork it ( https://github.com/jpbalarini/uruguayan_exchange_rates/fork )
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