# Dolarblue

[![Gem Version][GV img]][Gem Version]
[![Build Status][BS img]][Build Status]
[![Dependency Status][DS img]][Dependency Status]
[![Code Climate][CC img]][Code Climate]
[![Coverage Status][CS img]][Coverage Status]

## Description

Query Argentine Peso vs US$ exchange values with particular interest in official vs. ilegal (blue) reference prices.

[dolarblue][RubyGems] is a command-line tool to query AR$ vs US$ exchange values.

The term [blue][] denotes an important difference between the [real value][] of Argentine local currency (the argentine peso) versus the official value currently unreacheable to the general public.

## Installation

`$ gem install dolarblue` or add to your [Gemfile][] this line: `gem 'dolarblue'` then run [bundle install][]

## Usage (command-line)

Query latest values

    $ dolarblue

Sample result:

    Obtaining latest AR$ vs US$ exchange values...Done.

    - Official: 5.01 / 5.06  (Updated 48 minutes and 43 seconds ago)
    - Blue....: 7.74 / 7.82  (Updated 4 hours and 27 minutes ago)
    - Gap.....: 55%

    Information sources:
    Official: https://twitter.com/cotizacionhoyar/status/309381355450560512
    Blue....: https://twitter.com/DolarBlue/status/309326405148233731

## Contributing

1. Fork it.
2. Make your feature addition or bug fix and create your feature branch.
3. Update the [Change Log][].
3. Add specs/tests for it. This is important so I don't break it in a future version unintentionally.
4. Commit, create a new Pull Request.
5. Check that your pull request passes the [build][travis pull requests].

## License

Released under the MIT License. See the [LICENSE][] file for further details.

## Links

[RubyGems][] | [Documentation][] | [Source][] | [Bugtracker][] | [Build Status][] | [Dependency Status][] | [Code Climate][]


[bundle install]: http://gembundler.com/man/bundle-install.1.html
[Gemfile]: http://gembundler.com/man/gemfile.5.html
[LICENSE]: LICENSE.md
[Change Log]: CHANGELOG.md

[RubyGems]: https://rubygems.org/gems/dolarblue
[Documentation]: http://rubydoc.info/gems/dolarblue
[Source]: https://github.com/elgalu/dolarblue
[Bugtracker]: https://github.com/elgalu/dolarblue/issues

[travis pull requests]: https://travis-ci.org/elgalu/dolarblue/pull_requests

[Gem Version]: https://rubygems.org/gems/dolarblue
[Build Status]: https://travis-ci.org/elgalu/dolarblue
[Dependency Status]: https://gemnasium.com/elgalu/dolarblue
[Code Climate]: https://codeclimate.com/github/elgalu/dolarblue
[Coverage Status]: https://coveralls.io/r/elgalu/dolarblue

[GV img]: https://badge.fury.io/rb/dolarblue.png
[BS img]: https://travis-ci.org/elgalu/dolarblue.png
[DS img]: https://gemnasium.com/elgalu/dolarblue.png
[CC img]: https://codeclimate.com/github/elgalu/dolarblue.png
[CS img]: https://coveralls.io/repos/elgalu/dolarblue/badge.png?branch=master

[blue]:       http://latino.foxnews.com/latino/news/2012/05/19/argentina-currency-black-market-expands/
[real value]: http://www.buenosairesherald.com/tags/dollar