exrates 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c1659bbbd2fdd7cf649093aeaeb875ba389436b8e5926cdbde378ebd23f924a0
+  data.tar.gz: d860447e7df0c895a351feb98cc83382ae3c83d4e6ad76ed5e0ff467c1ac5d85
+SHA512:
+  metadata.gz: 160d2d7914a35d091578f70ef4fd06fc72888666e8e48d2046bb1cfb32197bf4cf53fd93157c86beed0003a7170570b6f18ea143deab51896ba11b086920488c
+  data.tar.gz: 30ec35240a144bac726dc597f634d7d4857de9aec6608f193b1f9f89d4e543e24b4d7c50f6fadd65cb4e9ebfedbf63fa3f412c40306ba9abd29a2ae8ebfe3225

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,9 @@
+ruby '2.7.6'
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in exrates.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem 'rspec', '~> 3.0'

data/Gemfile.lock

@@ -0,0 +1,40 @@
+PATH
+  remote: .
+  specs:
+    exrates (0.1.0)
+      money (~> 6)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    concurrent-ruby (1.1.10)
+    diff-lcs (1.5.0)
+    i18n (1.12.0)
+      concurrent-ruby (~> 1.0)
+    money (6.16.0)
+      i18n (>= 0.6.4, <= 2)
+    rake (12.3.3)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  exrates!
+  rake (~> 12.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -0,0 +1,58 @@
+# ExRates
+
+ExRates is a Ruby gem, that fethes exchange rates from National Bank of Ukraine (bank.gov.ua) and perform currency conversion. With the help of this gem, you can easily find out the exchange rate for a certain date in relation to the hryvnia and convert one currency to another. This gem also uses another gem, called 'Money'. The documentation for this gem you can read [here](https://github.com/RubyMoney/money).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'exrates'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install exrates
+
+## Usage
+
+**Find out the exchange rate in relation to the hryvnia for a certain currency:**
+
+currency = ExRate.new
+
+puts currency.rate('USD')
+
+
+**Find out the exchange rate for a specific date:**
+
+currency = ExRate.new('22.02.2022')
+
+puts currency.rate('USD')
+
+
+**Convertion currency to hryvna:**
+
+usd = Money.new('1_00', 'USD')
+
+result = ExRates.new.exchange(usd, 'UAH')
+
+puts "1.00 USD -> UAH: #{result.format}"
+
+
+**Convertion one currency to another:**
+
+usd = Money.new('1_50', 'USD')
+
+result = ExRates.new.exchange(usd, 'CAD')
+
+puts "1.50 USD -> CAD: #{result.format}"
+
+*See the 'Money' gem's [documentation](https://github.com/RubyMoney/money) for how to handle the Money object.*
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/mashk4/exrates.

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "exrates"
+
+# 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(__FILE__)

data/bin/setup

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

data/examples/usd_to_cad.rb

@@ -0,0 +1,7 @@
+require_relative '../lib/exrates'
+
+cad = Money.new('1_50', 'CAD')
+
+result = ExRates.new.exchange(cad, 'USD')
+
+puts "1.5 USD -> CAD: #{result.format}"

data/exrates.gemspec

@@ -0,0 +1,28 @@
+require_relative 'lib/exrates/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "exrates"
+  spec.version       = ExRates::VERSION
+  spec.authors       = ["Maria Slashchilina"]
+  spec.email         = ["fppl0101@gmail.com"]
+
+  spec.summary       = 'Fetches currency rates from bank.gov.ua'
+  spec.description   = 'This gem allows you to fetch exchange rates from National Bank of Ukraine (bank.gov.ua) and perform currency conversion.'
+  spec.homepage      = 'https://github.com/mashk4/exrates'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+
+  spec.add_dependency 'money', '~> 6'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

data/lib/exrates/version.rb

@@ -0,0 +1,3 @@
+class ExRates
+  VERSION = "0.1.1"
+end

data/lib/exrates.rb

@@ -0,0 +1,47 @@
+require_relative 'exrates/version'
+require 'open-uri'
+require 'json'
+require 'money'
+
+Money.rounding_mode = BigDecimal::ROUND_HALF_EVEN
+Money.locale_backend = :currency
+
+class ExRates
+  attr_reader :refreshed_at
+
+  def initialize(date = Date.today)
+    @refreshed_at = Time.now
+    
+    parse!(date)
+  end
+
+  def rate(currency_code)
+    @rates[currency_code.upcase]
+  end
+
+  def exchange(money, currency_to)
+    currency_from = money.currency.iso_code
+
+    money.with_currency(currency_to) * rate(currency_from) / rate(currency_to)
+  end
+
+  private
+
+  def parse!(date)
+    date = (date.is_a? Date) ? date : Date.parse(date)
+
+    date_string = date.strftime('%d%m%Y')
+    url = "https://bank.gov.ua/NBU_Exchange/exchange?date=#{date_string}&json"
+    response = URI.open(url).read
+    json_doc = JSON.parse(response)
+    
+    result = json_doc.map do |node| 
+        [ node['CurrencyCodeL'], node['Amount'] ]
+    end
+
+    result.push(['UAH', 1])
+     
+    @rates = result.to_h
+  end
+
+end

data/rspec/exrates_spec.rb

@@ -0,0 +1,33 @@
+require_relative '../lib/exrates'
+require 'money'
+
+RSpec.describe ExRates do
+  let (:rates) do
+    date = '21/07/2022'
+    ExRates.new(date)
+  end
+
+  describe '#rate' do
+      it "returns currency's rate for certain date" do
+          expect(rates.rate('USD')).to eq 36.5686
+      end
+  end
+  
+  describe '#exchange' do
+      it 'converts other currency into hryvnia' do
+      usd = Money.new('1_00', 'USD')
+
+      result = rates.exchange(usd, 'UAH')
+
+      expect(result).to eq Money.new(36_57, 'UAH')
+      end
+
+      it 'converts one currency to another currency' do
+      aud = Money.new('1_50', 'AUD')
+
+      result = rates.exchange(aud, 'USD')
+        
+      expect(result).to eq Money.new(83, 'USD')
+      end
+  end
+end

data/rspec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'bundler/setup'
+
+RSpec.configure do |config|
+  config.example_status_persistence_file_path = ".rspec_status"
+  
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: exrates
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Maria Slashchilina
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2022-07-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: money
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+description: This gem allows you to fetch exchange rates from National Bank of Ukraine
+  (bank.gov.ua) and perform currency conversion.
+email:
+- fppl0101@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- examples/usd_to_cad.rb
+- exrates.gemspec
+- lib/.DS_Store
+- lib/exrates.rb
+- lib/exrates/version.rb
+- rspec/exrates_spec.rb
+- rspec/spec_helper.rb
+homepage: https://github.com/mashk4/exrates
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/mashk4/exrates
+  source_code_uri: https://github.com/mashk4/exrates
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.18
+signing_key: 
+specification_version: 4
+summary: Fetches currency rates from bank.gov.ua
+test_files: []