ige_isb_api 1.0.0

data/lib/ige_isb_api/request.rb

@@ -0,0 +1,164 @@
+#!/user/bin/env ruby
+#coding: utf-8
+
+require "net/http"
+require "uri"
+require "ige_isb_api"
+require "ige_isb_api/constants"
+require "ige_isb_api/validation"
+
+module IGE_ISB_API
+  class Request
+    attr_accessor :params, :request
+
+    DEFAULT_PARAMS = {
+      'secretkey' => IGE_ISB_API::Constants::SECRET_KEY
+    }
+
+    COMMON_FIELDS = {
+      'command' => {:required => true, :type => 'string', :length => 32},
+      'idrequest' => {:required => true, :type => 'string', :length => 32},
+      'secretkey' => {:required => true, :type => 'string', :length => 128},
+      'username' => {:required => true, :type => 'username', :length => 32},
+      'password' => {:required => true, :type => 'password', :length => 32},  # this differs from the docs but testing shows it's true.
+      'txid' => {:required => true, :type => 'int'}
+    }
+
+    COMMANDS = {
+      'registration' => {
+        'email' => {:required => true, :type => 'email', :length => 140},
+        'name' => {:required => true, :type => 'name', :length => 140},
+        'firstname' => {:required => true, :type => 'name', :length => 140},
+        'zip' => {:required => true, :type => 'string', :length => 10},
+        'city' => {:required => true, :type => 'string', :length => 140},
+        'phone' => {:required => true, :type => 'phone', :length => 32},
+        'dob' =>  {:required => true, :type => 'datestring', :length => 10},
+        'country' => {:required => true, :type => 'country'},
+        'ip' =>  {:required => true, :type => 'ip4', :length => 32},
+        'cur' => {:required => true, :type => 'currency_code', :length => 3},
+        'status' => {:required => true, :type => 'int', values: [0, 1, 2]},
+        'carte' => {:required => true, :type => 'string', :length => 32},
+        'lang' => {:required => true, :type => 'string', :length => 2},
+        'gender' => {:required => true, :type => 'int', values: [0, 1]},
+        'idaffiliation' => {:required => true, :type => 'int'}
+        },
+      'login' => {
+        'carte' => {:required => true, :type => 'string', :length => 32}
+        },
+      'deposit' => {
+        'amount' => {:required => true, :type => 'int'},
+        'reference' => {:required => true, :type => 'string', :length => 32},
+        'cur' => {:required => true, :type => 'string', :length => 3},
+        'wallet' => {:required => true, :type => 'string', :length => 32}
+        },
+      'withdrawal' => {
+        'amount' => {:required => true, :type => 'int'},
+        'reference' => {:required => true, :type => 'string', :length => 32},
+        'cur' => {:required => true, :type => 'currency_code', :length => 3},
+        'wallet' => {:required => true, :type => 'string', :length => 32}
+        },
+      'limits' => {
+        'limitationtype' => {:required => true, :type => 'limit'},
+        'amount' => {:required => true, :type => 'int'},
+        'frequency' => {:required => true, :type => 'timespan'},
+        'until' => {:required => true, :type => 'string', :length => 32}
+        },
+      'userstatus' => {
+        'flag' => {:required => true, :type => 'int'}
+        },
+      'pass' => {
+        'newpassword' => {:required => true, :type => 'string', :length => 32}
+        },
+      'get_vip_points' => {
+        # nothing special
+        },
+      'save_friend_email' => {
+        'invitedname' => {:required => true, :type => 'string', :length => 32},
+        'invitedemail' => {:required => true, :type => 'string', :length => 140}
+      }
+    }
+
+    def initialize(params = {})
+      self.params = self.class::DEFAULT_PARAMS.merge(self.convert_symbols_to_strings(params))
+      self.validate_parameters
+      # a bunch of stuff
+      
+      self.construct_request
+    end
+
+    def send
+      uri = URI.parse(IGE_ISB_API::Constants::API_SERVER)
+      http = Net::HTTP.new(uri.host, uri.port)
+      # see http://www.rubyinside.com/nethttp-cheat-sheet-2940.html
+#       http.use_ssl = true
+#       http.cert = OpenSSL::X509::Certificate.new(pem)
+#       http.key = OpenSSL::PKey::RSA.new(pem)
+#       http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+      return http.request(self.request)
+    end
+
+    protected
+
+    def convert_symbols_to_strings(a_hash = {})
+      return {} if a_hash.empty?
+      result = {}
+      a_hash.each {|key, value| result[key.to_s] = value }
+      return result
+    end
+
+    def validate_parameters
+      command = params['command']
+      raise ValidationException, "No command in params #{params.inspect}." if command.nil? || command.empty?
+      comfields = self.class::COMMANDS[command]
+      raise ValidationException, "Invalid command #{command}." if comfields.nil?
+      fields = self.class::COMMON_FIELDS.merge(comfields)
+      self.validate_fields(fields)
+      self.validate_no_extra_fields(fields)
+    end
+
+    def validate_fields(against)
+      against.each do |name, meta|
+        required = (meta[:required] === true)
+        # Check that all required parameters are present
+        if required && !self.params.keys.include?(name)
+          raise ValidationException, "Parameter #{name} is required, but missing from #{self.params.keys}"
+        end
+        if self.params.keys.include? name
+          p = self.params[name]
+          if p != nil
+            case meta[:type]
+            when 'timestamp'
+              self.params[name] = p = p.to_time.utc.to_i if p.is_a? Date
+              self.params[name] = p = p.utc.to_i if p.is_a?(Time)
+              self.params[name] = p = p.to_i if p.is_a?(String)
+            when 'currency'
+              p = p.to_f if p.is_a? String
+              if (p.is_a?(Float) || p.is_a?(Integer)) && p > 0
+                self.params[name] = p = "%.2f" % p 
+              end
+            end
+            opts = {}
+            opts[:length] = meta[:length] if meta[:length]
+            opts[:values] = meta[:values] if meta[:values]
+            IGE_ISB_API::Validation.test name, self.params[name], meta[:type], opts
+          end
+        end
+      end
+    end
+
+    def validate_no_extra_fields(against)
+      allowed_fields = against.keys
+      self.params.each do |key, value|
+        raise InternalException, "Field #{key} is not supported" if !allowed_fields.include?(key)
+      end
+    end
+
+    def construct_request
+      uri = URI.parse(IGE_ISB_API::Constants::API_SERVER)
+      # http = Net::HTTP.new(uri.host, uri.port)
+      self.request = Net::HTTP::Post.new(uri)
+      self.request.set_form_data(self.params)
+    end
+
+  end
+end

data/lib/ige_isb_api/user_api.rb

@@ -0,0 +1,251 @@
+#!/user/bin/env ruby
+#coding: utf-8
+
+module IGE_ISB_API
+  class UserAPI
+
+    # the following options *must* be passed in.
+    #     username: "some_username specific to iSoftBet",
+    #     password: "should be specific to iSoftBet",
+    # The following options may be passed in and are presented here with their defaults.
+    #     cur: IGE_ISB_API::Constants::DEFAULT_CURRENCY_CODE,
+    #     carte: IGE_ISB_API::Constants::CASINO,
+    #     lang: IGE_ISB_API::Constants::DEFAULT_LANGUAGE,
+    def initialize(player_status = IGE_ISB_API::Constants::TEST, opts = {})
+      raise ArgumentError, "Missing options." if opts.empty?
+      @options = {
+        cur: IGE_ISB_API::Constants::DEFAULT_CURRENCY_CODE,
+        carte: IGE_ISB_API::Constants::CASINO,
+        lang: IGE_ISB_API::Constants::DEFAULT_LANGUAGE,
+        status: player_status
+      }.merge(opts)
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    # the following options *must* be passed in.
+    #     email: "the user's email address",
+    #     name: "the user's surname",
+    #     firstname: "the user's first name",,
+    #     zip: "the user's postcode",
+    #     city: "the user's city",
+    #     phone: "the user's phone number",
+    #     dob: "in 2011-11-21 format",
+    #     country: "the ISO country code for the user",
+    #     ip: request.ip
+    #
+    # The following may be passed in and are presented here with their defaults.
+    #     cur: IGE_ISB_API::Constants::DEFAULT_CURRENCY_CODE,
+    #     status: IGE_ISB_API::Constants::TEST,
+    #     carte: IGE_ISB_API::Constants::CASINO,
+    #     lang: 'en',
+    #     gender: IGE_ISB_API::Constants::MALE,
+    def register(label = '', txid = 0, opts = {})
+      validate_params!(label, txid)
+      raise ArgumentError, "Missing options." if opts.empty?
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  status: @options[:status],
+                  cur: @options[:cur],
+                  lang: @options[:lang],
+                  carte: @options[:carte],
+                  gender: IGE_ISB_API::Constants::MALE,
+                  txid: txid}.merge(opts).merge({ command: 'registration', idaffiliation: IGE_ISB_API::Constants::LICENSEE_ID })
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    # The following may be passed in and is presented here with its default.
+    #     carte: defaults to IGE_ISB_API::Constants::CASINO can can be overridden if user is logging in from
+    #            a different casino under the control of the same licensee.
+    def login(label = '', txid = 0, opts = {})
+      validate_params!(label, txid)
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  carte: @options[:carte],
+                  txid: txid}.merge(opts).merge({ command: 'login' })
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    # the following options *must* be passed in.
+    #     wallet: "the name of the payment processor being used",
+    #     amount: a positive floating point number,
+    #     reference: "for logging purposes",
+    #
+    # The following may be passed in and are presented here with their defaults.
+    #     cur: defaults to IGE_ISB_API::Constants::DEFAULT_CURRENCY_CODE
+    def deposit(label = '', txid = 0, opts = {})
+      validate_params!(label, txid)
+      raise ArgumentError, "Missing options." if opts.empty?
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  cur: @options[:cur],
+                  txid: txid}.merge(opts).merge({ command: 'deposit' })
+      reference = "#{@params[:wallet]}:#{@params[:reference]}#{@params[:cur]}"
+      @params.merge!(reference: reference)
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    # the following options *must* be passed in.
+    #     wallet: "the name of the payment processor being used",
+    #     amount: a positive floating point number,
+    #     reference: "for logging purposes",
+    #
+    # The following may be passed in and are presented here with their defaults.
+    #     cur: defaults to IGE_ISB_API::Constants::DEFAULT_CURRENCY_CODE
+    def withdrawal(label = '', txid = 0, opts = {})
+      validate_params!(label, txid)
+      raise ArgumentError, "Missing options." if opts.empty?
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  cur: @options[:cur],
+                  txid: txid}.merge(opts).merge({ command: 'withdrawal' })
+      reference = "#{@params[:reference]}#{@params[:cur]}"
+      @params.merge!(reference: reference)
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    # the following options *must* be passed in.
+    #     limitationtype: 'DEPOSIT', 'DEPOSIT_EXTRA', 'BET', 'LOSS', 'TIME', 'EXCLUSION'
+    #     amount: a positive floating point number,
+    #     frequency: "WEEKLY", DAILY, MONTHLY, 1..n days - for exclusion
+    #     until: "YYYY-MM-DD" or -1 for unlimited.
+    #
+    # The following may be passed in and are presented here with their defaults.
+    #     cur: defaults to IGE_ISB_API::Constants::DEFAULT_CURRENCY_CODE
+    def limits(label = '', txid = 0, opts = {})
+      validate_params!(label, txid)
+      raise ArgumentError, "Missing options." if opts.empty?
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  txid: txid}.merge(opts).merge({ command: 'limits' })
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    def deactivate(label = '', txid = 0)
+      validate_params!(label, txid)
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  txid: txid}.merge({ command: 'userstatus', flag: IGE_ISB_API::Constants::USER_INACTIVE })
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    def activate(label = '', txid = 0)
+      validate_params!(label, txid)
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  txid: txid}.merge({ command: 'userstatus', flag: IGE_ISB_API::Constants::USER_ACTIVE })
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    def ban(label = '', txid = 0)
+      validate_params!(label, txid)
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  txid: txid}.merge({ command: 'userstatus', flag: IGE_ISB_API::Constants::USER_BANNED })
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    # the following option *must* be passed in.
+    #     newpassword: 'some new password',
+    def change_password(label = '', txid = 0, opts = {})
+      validate_params!(label, txid)
+      raise ArgumentError, "Missing options." if opts.empty?
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  txid: txid}.merge(opts).merge({ command: 'pass'})
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    def get_vip_points(label = '', txid = 0)
+      validate_params!(label, txid)
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  txid: txid}.merge({ command: 'get_vip_points' })
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    # Each command has a label which is used by the casino to tag a group of interactions with ISB
+    # Additionally each transaction must include a unique transaction ID.
+    # the following options *must* be passed in.
+    #     invitedname: 'some new password',
+    #     invitedemail: 'some new password',
+    def save_friend_email(label = '', txid = 0, opts = {})
+      validate_params!(label, txid)
+      raise ArgumentError, "Missing options." if opts.empty?
+      @params = { idrequest: label,
+                  username: @options[:username],
+                  password: @options[:password],
+                  txid: txid}.merge(opts).merge({ command: 'save_friend_email'})
+      request = IGE_ISB_API.request(@params)
+      resp = request.send
+      response = JSON.parse(resp.body)
+      return response
+    end
+
+    private
+    
+    def validate_params!(label, txid)
+      raise ArgumentError, "Missing a valid label." if label.empty?
+      raise ArgumentError, "Missing a valid transaction ID." if txid <= 0
+    end
+
+  end
+end

data/lib/ige_isb_api/validation.rb

@@ -0,0 +1,130 @@
+#!/user/bin/env ruby
+#coding: utf-8
+
+require 'ige_isb_api'
+require 'ige_isb_api/constants'
+
+module IGE_ISB_API
+  class Validation
+
+    def self.is_valid_username?(a_username)
+      # Username must be alphanumeric
+      return false if a_username.size > 32
+      return !a_username.match(/^[[:alpha:]|[0-9]|\-_]+$/).nil?
+    end
+
+    def self.is_valid_password?(a_password)
+      # Password must be over 6 and less than 20 characters long; Password must be alphanumeric
+      return false unless a_password.size.between?(6,20)
+      return !a_password.match(/^[[:alpha:]|[0-9]]+$/).nil?
+    end
+
+    def self.is_valid_email?(an_email)
+      # see http://stackoverflow.com/questions/703060/valid-email-address-regular-expression
+      return false if an_email.empty?
+      email_regex = /(?:(?:\r\n)?[ \t])*(?:(?:(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*))*@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*|(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)*\<(?:(?:\r\n)?[ \t])*(?:@(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*(?:,@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*)*:(?:(?:\r\n)?[ \t])*)?(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*))*@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*\>(?:(?:\r\n)?[ \t])*)|(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)*:(?:(?:\r\n)?[ \t])*(?:(?:(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*))*@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*|(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)*\<(?:(?:\r\n)?[ \t])*(?:@(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*(?:,@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*)*:(?:(?:\r\n)?[ \t])*)?(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*))*@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*\>(?:(?:\r\n)?[ \t])*)(?:,\s*(?:(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*))*@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*|(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)*\<(?:(?:\r\n)?[ \t])*(?:@(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*(?:,@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*)*:(?:(?:\r\n)?[ \t])*)?(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|"(?:[^\"\r\\]|\\.|(?:(?:\r\n)?[ \t]))*"(?:(?:\r\n)?[ \t])*))*@(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*)(?:\.(?:(?:\r\n)?[ \t])*(?:[^()<>@,;:\\".\[\] \000-\031]+(?:(?:(?:\r\n)?[ \t])+|\Z|(?=[\["()<>@,;:\\".\[\]]))|\[([^\[\]\r\\]|\\.)*\](?:(?:\r\n)?[ \t])*))*\>(?:(?:\r\n)?[ \t])*))*)?;\s*)/
+      return !an_email.match(email_regex).nil?
+    end
+
+    def self.is_valid_name?(a_name)
+      "0123456789!@#$%^&*()[]\\/+=?<>~;:{}".split('').each do |ch|
+        return false if a_name.include?(ch)
+      end
+      return true
+    end
+
+    def self.is_valid_phonenumber?(a_phonenumber)
+      # phone can start with +
+      # TODO: Awaiting feedback from ISB
+      numb_regex = /^\+?[0-9\(\s\)-]{5,21}$/
+      return !a_phonenumber.match(numb_regex).nil?
+    end
+
+    def self.is_valid_ip4?(an_ip)
+      # valid IP4 address
+      vip = an_ip.match /^([0-9]{1,3})\.([0-9]{1,3})\.([0-9]{1,3})\.([0-9]{1,3})$/
+      return false if vip.nil?
+      return false unless $1.to_i.between?(0,255) && $2.to_i.between?(0,255) && $3.to_i.between?(0,255)
+      return true
+    end
+
+    def self.is_valid_datestring?(a_datestring)
+      dm = a_datestring.match  /^((19|20)[0-9][0-9])-([0-9]{2})-([0-9]{2})\.([0-9]{2}):([0-9]{2}):([0-9]{2})$/
+      if dm.nil?
+        dm = a_datestring.match /^((19|20)[0-9][0-9])-([0-9]{2})-([0-9]{2})$/ 
+        return false if dm.nil?
+      else
+        return false unless $5.to_i.between?(0,23)
+        return false unless $6.to_i.between?(0,59)
+        return false unless $7.to_i.between?(0,59)
+      end
+      return false unless $1.to_i.between?(1900,2099)
+      return false unless $3.to_i.between?(1,12)
+      return false unless $4.to_i.between?(1,31)
+      return false if [9, 4, 6, 11].include?($3.to_i) && !$4.to_i.between?(1,30)
+      return false if $3.to_i == 2 && $1.to_i % 4 == 0 && !$4.to_i.between?(1,29) # leap year
+      return false if $3.to_i == 2 && !$4.to_i.between?(1,28) # non leap year
+      return true
+    end
+
+    def self.is_valid_currency?(an_amount)
+      vc = an_amount.match /^[1-9][0-9]*\.[0-9][0-9]$/
+      return !vc.nil?
+    end
+
+    def self.test(a_fieldname, a_value, a_type, opts = {})
+      correct_type = true
+      begin
+        case a_type
+        when 'username'
+          correct_type = a_value.is_a?(String) && is_valid_username?(a_value)
+        when 'password'
+          correct_type = a_value.is_a?(String) && is_valid_password?(a_value)
+        when 'boolstring'
+          correct_type = a_value.is_a?(String) && ['True', 'False'].include?(a_value)
+        when 'country'
+          correct_type = a_value.is_a?(String) && !IGE_ISB_API::Constants::ALLOWED_COUNTRY_CODES[a_value.to_sym].nil?
+        when 'limit'
+          correct_type = a_value.is_a?(String) && IGE_ISB_API::Constants::ALLOWED_LIMITATIONS.include?(a_value)
+        when 'timespan'                
+          correct_type = a_value.is_a?(String) && IGE_ISB_API::Constants::ALLOWED_FREQUENCIES.include?(a_value)
+        when 'string'
+          correct_type = a_value.is_a? String
+          raise ValidationException, sprintf("Value '%s' in field '%s' is too long.", a_value, a_fieldname) if opts[:length] && a_value.size > opts[:length]
+          raise ValidationException, "#{a_value} is invalid for #{a_fieldname}" if opts[:values] && !opts[:values].include?(a_value)
+        when 'currency_code'
+          correct_type = a_value.is_a?(String) && IGE_ISB_API::Constants::ALLOWED_CURRENCIES.include?(a_value)
+        when 'currency'
+          correct_type = is_valid_currency?(a_value)
+        when 'percent'
+          correct_type = a_value.is_a?(Float) || a_value.is_a?(Integer)
+          raise ValidationException, "#{a_fieldname} must be positive" if a_value < 0
+        when 'int'
+          correct_type = a_value.is_a? Integer
+          raise ValidationException, "#{a_fieldname} only allows positive integers" if a_value < 0
+          raise ValidationException, "#{a_value} is invalid for #{a_fieldname}" if opts[:values] && !opts[:values].include?(a_value)
+        when 'boolint'
+          correct_type = a_value.is_a?(Integer) && [0, 1].include?(a_value)
+        when 'datestring'
+          correct_type = a_value.is_a? String
+          raise ValidationException, "#{a_value} is not a valid date string." unless is_valid_datestring?(a_value)
+        when 'timestamp'
+          correct_type = a_value.is_a? Integer
+          raise ValidationException, "#{a_value} is not a valid timestamp." unless a_value > 0
+        when 'phone'
+          correct_type = a_value.is_a?(String) && is_valid_phonenumber?(a_value)
+        when 'ip4'
+          correct_type = a_value.is_a?(String) && is_valid_ip4?(a_value)
+        when 'email'
+          correct_type = a_value.is_a?(String) && is_valid_email?(a_value)
+        end
+      rescue ArgumentError => ae
+        raise ValidationException, sprintf("Value '%s' in field '%s' is not of expected type '%s' Error: %s", a_value, a_fieldname, a_type, ae.message)
+      end
+
+      raise ValidationException, sprintf("Value '%s' in field '%s' is not of expected type '%s'", a_value, a_fieldname, a_type) unless correct_type
+
+    end
+
+  end
+end