EGP_Rates 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 226e463d104ebab0ea975d16d7c26ed424e32bd8
+  data.tar.gz: cb8050bc07da0baaaf33eae5d72beac437eb3265
+SHA512:
+  metadata.gz: 85c46b4e3f81dcb391025a11c385cbf7b6d4d43e41183e35c8dca094d9ab3c3a605bf1abca1660ee6c7272603d286b90dd0633fe1cb2985d9e265cdfb2d652c7
+  data.tar.gz: 08e538c1e7f2daf8f9f82353a84da28aee54245a78a01dd9454407619ba358e3bb2db14688364866cb0ed58a8a5d2f5b46ff00900454f4cb61fbc91b4f07b57a

data/lib/egp_rates/bank.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+module EGPRates
+  # Class Representing the bank to get the data from
+  class Bank
+    attr_reader :sym
+
+    # Abstract method
+    # Subclasses banks define the logic to get the exchange rates hash
+    # it should return [Hash] sell: { SYM: rate, ... } , buy: { SYM: rate, ... }
+    #   for the available currencies (represented by :SYM) on the bank pages
+    def exchange_rates
+      raise NotImplementedError
+    end
+  end
+end

data/lib/egp_rates/cbe.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+module EGPRates
+  # Central Bank of Egypt
+  class CBE < EGPRates::Bank
+    def initialize
+      @sym = :CBE
+      @uri = URI.parse('http://www.cbe.org.eg/en/EconomicResearch/Statistics/Pages/ExchangeRatesListing.aspx')
+    end
+
+    # @return [Hash] of exchange rates for selling and buying
+    #   {
+    #     { sell: { SYM: rate }, { SYM: rate }, ... },
+    #     { buy:  { SYM: rate }, { SYM: rate }, ... }
+    #   }
+    def exchange_rates
+      @exchange_rates ||= parse(raw_exchange_rates)
+    end
+
+    private
+
+    # Send the request to the URL and retrun raw data of the response
+    # @return [Enumerator::Lazy] with the table row in HTML that evaluates to
+    #   [
+    #     "US Dollar \r\n  ", "15.7297", "16.3929",
+    #     "Euro \r\n,      ", "17.5308", "18.1938",
+    #     ...
+    #   ]
+    #
+    def raw_exchange_rates
+      response = Net::HTTP.get_response(@uri)
+      fail ResponseError, response.code unless response.is_a? Net::HTTPSuccess
+      table_rows = Oga.parse_html(response.body).css('tbody').last&.children
+      # CBE porvide 9 currencies on the home page
+      fail ResponseError, 'Unknown HTML' unless table_rows&.size == 9
+      table_rows.lazy.map(&:children).map { |cell| cell.map(&:text) }
+    end
+
+    # Convert currency string to ISO symbol
+    # @param currency [String] "US Dollar"
+    # @return [Symbol] :USD ISO currency name
+    # rubocop:disable Metrics/CyclomaticComplexity
+    # rubocop:disable Metrics/MethodLength
+    def currency_symbol(currency)
+      case currency
+      when /US/        then :USD
+      when /Euro/      then :EUR
+      when /Sterling/  then :GBP
+      when /Swiss/     then :CHF
+      when /Japanese/  then :JPY
+      when /Saudi/     then :SAR
+      when /Kuwait/    then :KWD
+      when /UAE/       then :AED
+      when /Chinese/   then :CNY
+      else fail ResponseError, "Unknown currency #{currency}"
+      end
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity
+    # rubocop:enable Metrics/MethodLength
+
+    # Parse the #raw_exchange_rates returned in response
+    # @return [Hash] of exchange rates for selling and buying
+    #   {
+    #     { sell: { SYM: rate }, { SYM: rate }, ... },
+    #     { buy:  { SYM: rate }, { SYM: rate }, ... }
+    #   }
+    def parse(raw_data)
+      raw_data.each_with_object(sell: {}, buy: {}) do |row, result|
+        sell_rate = row[2].to_f
+        buy_rate  = row[1].to_f
+        currency  = currency_symbol(row[0])
+
+        result[:sell][currency] = sell_rate
+        result[:buy][currency]  = buy_rate
+      end
+    end
+  end
+end

data/lib/egp_rates/nbe.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+module EGPRates
+  # National Bank of Egypt
+  class NBE < EGPRates::Bank
+    def initialize
+      @sym = :NBE
+      @uri = URI.parse('http://www.nbe.com.eg/en/ExchangeRate.aspx')
+    end
+
+    # @return [Hash] of exchange rates for selling and buying
+    #   {
+    #     { sell: { SYM: rate }, { SYM: rate }, ... },
+    #     { buy:  { SYM: rate }, { SYM: rate }, ... }
+    #   }
+    def exchange_rates
+      @exchange_rates ||= parse(raw_exchange_rates)
+    end
+
+    private
+
+    # Send the request to the URL and retrun raw data of the response
+    # @return [Enumerator::Lazy] with the table row in HTML that evaluates to
+    #   [
+    #     "\r\n\t\t",
+    #     "US DOLLAR",
+    #     "USD       ",
+    #     "\r\n\t\t\t\t\t\t\t\t\t15.9\r\n\t\t\t\t\t\t\t\t",
+    #     "\r\n\t\t\t\t\t\t\t\t\t16.05\r\n\t\t\t\t\t\t\t\t",
+    #     "\r\n\t\t\t\t\t\t\t\t\t15.9\r\n\t\t\t\t\t\t\t\t",
+    #     "\r\n\t\t\t\t\t\t\t\t\t16.05\r\n\t\t\t\t\t\t\t\t",
+    #     "\r\n\t"
+    #   ], [
+    #     "\r\n\t\t",
+    #     "EURO",
+    #     "EUR       ",
+    #     "\r\n\t\t\t\t\t\t\t\t\t17.2213\r\n\t\t\t\t\t\t\t\t",
+    #     "\r\n\t\t\t\t\t\t\t\t\t17.5314\r\n\t\t\t\t\t\t\t\t",
+    #     "\r\n\t\t\t\t\t\t\t\t\t17.2213\r\n\t\t\t\t\t\t\t\t",
+    #     "\r\n\t\t\t\t\t\t\t\t\t17.5314\r\n\t\t\t\t\t\t\t\t",
+    #     "\r\n\t"
+    #   ], [
+    #     ...
+    #   ]
+    def raw_exchange_rates
+      response = Net::HTTP.get_response(@uri)
+      fail ResponseError, response.code unless response.is_a? Net::HTTPSuccess
+      table_rows = Oga.parse_html(response.body).css('#idts_content tr')
+      # NBE provide 17 currencies only
+      fail ResponseError, 'Unknown HTML' unless table_rows&.size == 18
+      # Drop 1 remove the table headers
+      table_rows.lazy.drop(1).map(&:children).map { |cell| cell.map(&:text) }
+    end
+
+    # Parse the #raw_exchange_rates returned in response
+    # @return [Hash] of exchange rates for selling and buying
+    #   {
+    #     { sell: { SYM: rate }, { SYM: rate }, ... },
+    #     { buy:  { SYM: rate }, { SYM: rate }, ... }
+    #   }
+    def parse(raw_data)
+      raw_data.each_with_object(sell: {}, buy: {}) do |row, result|
+        sell_rate = row[4].strip.to_f
+        buy_rate  = row[3].strip.to_f
+        currency  = row[2].strip.to_sym
+
+        result[:sell][currency] = sell_rate
+        result[:buy][currency]  = buy_rate
+      end
+    end
+  end
+end

data/lib/egp_rates.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'oga'
+require 'egp_rates/bank'
+require 'egp_rates/cbe'
+require 'egp_rates/nbe'
+
+# Base Module
+module EGPRates
+  # Class Idicating HTTPResponseErrors when unexpected behaviour encountered
+  # while scraping the [Bank] data
+  class ResponseError < StandardError
+  end
+end