Wechselkurse

Wechselkurse is a Ruby wrapper and CLI for some APIs of currency exchange rates.

Add this line to your application's Gemfile:

gem 'wechselkurse'

And then execute:

$ bundle

Or install it yourself as:

$ gem install wechselkurse

Create/update your docker images:

$ docker build -t wechselkurse .

Run your containers:

$ docker run -e CURRENCYLAYER_ACCESS_KEY=access_key -e SLACK_WEBHOOK_URL=some_url -e SLACK_CHANNEL=channel -e SLACK_USERNAME=username wechselkurse

require 'wechselkurse'

# List the exchange rates
Wechselkurse::Currencylayer.exchange_rates(source: 'USD', currencies: ['EUR', 'BRL'], date: Date.today)

# Calculate exchange rate
Wechselkurse::Currencylayer.exchange_rate(source: 'USD', currencies: ['EUR', 'BRL'], value: 100, date: Date.today)

# Get the highest exchange rate in the last seven days
Wechselkurse::Currencylayer.highest_exchange_rate(source: 'USD', target: 'EUR')

Access application container:

$ docker run -e CURRENCYLAYER_ACCESS_KEY=access_key -e SLACK_WEBHOOK_URL=some_url -e SLACK_CHANNEL=channel -e SLACK_USERNAME=username wechselkurse bash

Running tests cases:

$ docker run -e CURRENCYLAYER_ACCESS_KEY=access_key wechselkurse bundle exec rspec

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/icaroseara/wechselkurse.