iso-iban 0.0.4 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8dab7b32e738763d4edd921bb3a9f32555105f51
-  data.tar.gz: 8d98494b70cb198d78130acf0dc259cb5b9c3a4e
+  metadata.gz: 72a53aeb4de7eb495706e51a08f34c861e706c03
+  data.tar.gz: e3af74706241ab8bff72986d8ed79aa34d1b2231
 SHA512:
-  metadata.gz: da2844427c7e2766c23f510604495ac90d9700b43874c45e91df9bce081aac5eb3e179f5c5a52880f85d655a9df36204c284b39906d0f6f889104760101abe54
-  data.tar.gz: 607166d6cb2757c9ca185460e7842c28eaa655a70b8cc2a5af45f29d100a74c6cfb449859f44826ebd467eaa154375d86125ef0d8ba8f0adfce7dc1e231324df
+  metadata.gz: cb22f4ea028de0f22100dfefba44860e0dcaec1cb3619b64659b0b22562a8aba3c3570577944363e22d4331123609d93b6c6a38f747874303adb0a15ecc4675f
+  data.tar.gz: 495fa573e6734141cc389101ed4bb83048e5619064bfe62b33548b230f01f649bb9898833c07a5e5a3a428e84ff77a5db1a442b7d67dee7964ccfd1380f87b22

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2012, Stefan Rusterholz <stefan.rusterholz@gmail.com>
+Copyright (c) 2012-2014, Stefan Rusterholz <stefan.rusterholz@gmail.com>
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

data/README.markdown

@@ -4,22 +4,36 @@ README
 
 Summary
 -------
-ISO::IBAN implements IBAN (International Bank Account Number) specification as per ISO 13616-1.
+
+ISO::IBAN implements the IBAN (International Bank Account Number) specification as per ISO 13616-1.
 It provides methods to generate valid IBAN numbers from components, or to validate a given IBAN.
 
 
 Installation
 ------------
-`gem install iso-iban`
+
+### Via rubygems
+
+    gem install iso-iban
+
+### From github
+
+    git clone https://github.com/apeiros/iso-iban.git
+    cd iso-iban
+    rm -r *.gem
+    gem build *.gemspec
+    gem install *.gem
 
 
 Usage
 -----
 
-    ISO::IBAN.valid?('CH35 1234 5987 6543 2109 A')     # => true
-    ISO::IBAN.validate('CH37 1234 5987 6543 2109 A')   # => [:invalid_checksum]
-    ISO::IBAN.generate('CH', '12345', '987')           # => #<ISO::IBAN CH76 1234 5000 0000 0098 7>
-    iban = ISO::IBAN.new('CH35 1234 5987 6543 2109 A') # => #<ISO::IBAN CH35 1234 5987 6543 2109 A>
+    require 'iso/iban'
+    ISO::IBAN.valid?('CH35 1234 5987 6543 2109 A')       # => true
+    ISO::IBAN.validate('CH37 1234 5987 6543 2109 A')     # => [:invalid_checksum]
+    ISO::IBAN.generate('CH', '12345', '987')             # => #<ISO::IBAN CH76 1234 5000 0000 0098 7>
+    iban = ISO::IBAN.parse('CH35 1234 5987 6543 2109 A') # => #<ISO::IBAN CH35 1234 5987 6543 2109 A>
+    iban = ISO::IBAN.new('CH351234598765432109A')        # => #<ISO::IBAN CH35 1234 5987 6543 2109 A>
     iban.formatted       # => "CH35 1234 5987 6543 2109 A"
     iban.compact         # => "CH351234598765432109A"
     iban.country         # => "CH"
@@ -29,6 +43,18 @@ Usage
     iban.valid?          # => true
     iban.validate        # => []
 
+**Note:** iso/iban automatically loads the IBAN specifications delivered with the gem. If you do not wish
+those to be loaded, `require 'iso/iban/no_autoload'` instead.
+
+
+ENV
+---
+
+ISO::IBAN.load_specifications (which is automatically called when you require 'iso/iban') uses the
+ENV variable `IBAN_SPECIFICATIONS` to determine where to look for IBAN specifications. If that
+variable is not set, it will default to the datafile delivered with the gem.
+
+
 Links
 -----
 
@@ -42,4 +68,4 @@ License
 -------
 
 You can use this code under the {file:LICENSE.txt BSD-2-Clause License}, free of charge.
-If you need a different license, please ask the author.
+If you need a different license, please ask the author.

data/iso-iban.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name                      = "iso-iban"
-  s.version                   = "0.0.4"
+  s.version                   = "0.1.0"
   s.authors                   = "Stefan Rusterholz"
   s.email                     = "stefan.rusterholz@gmail.com"
   s.homepage                  = "https://github.com/apeiros/iso-iban"
@@ -16,6 +16,18 @@ Gem::Specification.new do |s|
     Utilities for International Bank Account Numbers (IBAN) as per ISO 13616-1.
   SUMMARY
 
+  s.post_install_message      = <<-POST_INSTALL_MESSAGE.gsub(/^    /, '').chomp
+    IMPORTANT!
+
+    As of 0.1.0, there are 2 backward incompatible changes:
+
+    * `require 'iso/iban/autoload'` is deprecated. Please use plain `require 'iso/iban'`.
+      To load ISO::IBAN without loading the specifications, please use
+      `require 'iso/iban/no_autoload'`.
+    * ISO::IBAN.new no longer accepts formatted input.
+      Use ISO::IBAN.parse if your input is potentially not in the compact format.
+  POST_INSTALL_MESSAGE
+
   s.files                     =
     Dir['bin/**/*'] +
     Dir['data/**/*'] +

data/lib/iso/iban.rb

@@ -1,373 +1,6 @@
 # encoding: utf-8
 
-require 'iso/iban/specification'
-require 'iso/iban/version'
-require 'yaml'
+# Actual implementation is in iso/iban/no_autoload.rb
+require 'iso/iban/no_autoload'
 
-module ISO
-
-  # IBAN - ISO 13616-1
-  #
-  # General IBAN Information
-  # ========================
-  #
-  # * What is an IBAN?
-  #   IBAN stands for International Bank Account Number. It is the ISO 13616
-  #   international standard for numbering bank accounts. In 2006, the
-  #   International Organization for Standardization (ISO) designated SWIFT as
-  #   the Registration Authority for ISO 13616.
-  #
-  # * Use
-  #   The IBAN facilitates the communication and processing of cross-border
-  #   transactions. It allows exchanging account identification details in a
-  #   machine-readable form.
-  #
-  #
-  # The ISO 13616 IBAN Standard
-  # ===========================
-  #
-  # * Structure
-  #   The IBAN structure is defined in ISO 13616-1 and consists of a two-letter
-  #   ISO 3166-1 country code, followed by two check digits and up to thirty
-  #   alphanumeric characters for a BBAN (Basic Bank Account Number) which has a
-  #   fixed length per country and, included within it, a bank identifier with a
-  #   fixed position and a fixed length per country. The check digits are
-  #   calculated based on the scheme defined in ISO/IEC 7064 (MOD97-10).
-  #
-  # * Terms and definitions
-  #   Bank identifier: The identifier that uniquely identifies the financial
-  #   institution and, when appropriate, the branch of that financial institution
-  #   servicing an account
-  #
-  #   `In this registry, the branch identifier format is shown specifically, when
-  #   present.`
-  #
-  #   *BBAN*: basic bank account number: The identifier that uniquely identifies
-  #   an individual account, at a specific financial institution, in a particular
-  #   country. The BBAN includes a bank identifier of the financial institution
-  #   servicing that account.
-  #   *IBAN*: international bank account number: The expanded version of the
-  #   basic bank account number (BBAN), intended for use internationally. The
-  #   IBAN uniquely identifies an individual account, at a specific financial
-  #   institution, in a particular country.
-  #
-  # * Submitters
-  #   Nationally-agreed, ISO13616-compliant IBAN formats are submitted to the
-  #   registration authority exclusively by the National Standards Body or the
-  #   National Central Bank of the country.
-  class IBAN
-    include Comparable
-
-    # Character code translation used to convert an IBAN into its numeric
-    # (digits-only) form
-    CharacterCodes  = Hash[('0'..'9').zip('0'..'9')+('a'..'z').zip(10..35)+('A'..'Z').zip(10..35)]
-
-    # All uppercase letters
-    UpperAlpha   = [*'A'..'Z']
-
-    # All lowercase letters
-    LowerAlpha   = [*'a'..'z']
-
-    # All digits
-    Digits       = [*'0'..'9']
-
-    # All uppercase letters, lowercase letters and digits
-    AlphaNumeric = [*'A'..'Z', *'a'..'z', *'0'..'9']
-
-    # All specifications, see ISO::IBAN::Specification
-    @specifications = nil
-
-    # Load the IBAN specifications file, which determines how the IBAN
-    # for any given country looks like.
-    #
-    # It will use the following sources in this order (first one which exists wins)
-    #
-    # * Path passed as spec_file parameter
-    # * Path provided by the env variable IBAN_SPECIFICATIONS
-    # * The file ../data/iso-iban/specs.yaml relative to the lib dir
-    # * The Gem datadir path
-    #
-    # @param [String] spec_file
-    #   Override the default specifications file path.
-    #
-    # @return [self]
-    def self.load_specifications(spec_file=nil)
-      if spec_file then
-        # do nothing
-      elsif ENV['IBAN_SPECIFICATIONS'] then
-        spec_file = ENV['IBAN_SPECIFICATIONS']
-      else
-        spec_file = File.expand_path('../../../data/iso-iban/specs.yaml', __FILE__)
-        if !File.file?(spec_file) && defined?(Gem) && Gem.datadir('iso-iban')
-          spec_file = Gem.datadir('iso-iban')+'/specs.yaml'
-        end
-      end
-
-      if spec_file && File.file?(spec_file)
-        @specifications = ISO::IBAN::Specification.load_yaml(spec_file)
-      else
-        raise "Could not load IBAN specifications, no specs file found."
-      end
-
-      self
-    end
-
-    # @return [Hash<String => ISO::IBAN::Specification>]
-    #   A hash with the country (ISO3166 2-letter) as key and the specification for that country as value
-    def self.specifications
-      @specifications || raise("No specifications have been loaded yet.")
-    end
-
-    # @param [String] a2_country_code
-    #   The country (ISO3166 2-letter), e.g. 'CH' or 'DE'.
-    #
-    # @return [ISO::IBAN::Specification]
-    #   The specification for the given country
-    def self.specification(a2_country_code, *default, &default_block)
-      specifications.fetch(a2_country_code, *default, &default_block)
-    end
-
-    # @param [String] iban
-    #   An IBAN number, either in compact or human format.
-    #
-    # @return [true, false]
-    #   Whether the IBAN is valid.
-    #   See {#validate} for details.
-    def self.valid?(iban)
-      new(iban).valid?
-    end
-
-    # @param [String] iban
-    #   An IBAN number, either in compact or human format.
-    #
-    # @return [Array<Symbol>]
-    #   An array with a code of all validation errors, empty if valid.
-    #   See {#validate} for details.
-    def self.validate(iban)
-      new(iban).validate
-    end
-
-    # @param [String] iban
-    #   The IBAN in either compact or human readable form.
-    #
-    # @return [String]
-    #   The IBAN in compact form.
-    def self.strip(iban)
-      iban.tr(' -', '')
-    end
-
-    # Generate an IBAN from country code and components, automatically filling in the checksum.
-    #
-    # @example Generate an IBAN for UBS Switzerland with account number '12345'
-    #     ISO::IBAN.generate('CH', '216', '12345') # => #<ISO::IBAN CH92 0021 6000 0000 1234 5>
-    #
-    # @param [String] country
-    #   The ISO-3166 2-letter country code.
-    #
-    def self.generate(country, *components)
-      spec      = specification(country)
-      justified = spec.component_lengths.zip(components).map { |length, component| component.rjust(length, "0") }
-      iban      = new(country+'??'+justified.join(''))
-      iban.update_checksum!
-
-      iban
-    end
-
-    # @param [String] countries
-    #   A list of 2 letter country codes. If empty, all countries in
-    #   ISO::IBAN::specifications are used.
-    #
-    # @return [ISO::IBAN] A random, valid IBAN
-    def self.random(*countries)
-      countries = specifications.keys if countries.empty?
-      country   = countries.sample
-      account   = specification(country).iban_structure.scan(/([A-Z]+)|(\d+)(!?)([nac])/).map { |exact, length, fixed, code|
-        if exact
-          exact
-        elsif code == 'a'
-          Array.new(length.to_i) { UpperAlpha.sample }.join('')
-        elsif code == 'c'
-          Array.new(length.to_i) { AlphaNumeric.sample }.join('')
-        elsif code == 'e'
-          ' '*length.to_i
-        elsif code == 'n'
-          Array.new(length.to_i) { Digits.sample }.join('')
-        end
-      }.join('')
-      account[2,2] = '??'
-      iban = new(account)
-      iban.update_checksum!
-
-      iban
-    end
-
-    # Converts a String into its digits-only form, i.e. all characters a-z are replaced with their corresponding
-    # digit sequences, according to the IBAN specification.
-    #
-    # @param [String] string
-    #   The string to convert into its numeric form.
-    #
-    # @return [String] The string in its numeric, digits-only form.
-    def self.numerify(string)
-      string.downcase.gsub(/\D/) { |char|
-        CharacterCodes.fetch(char) {
-          raise ArgumentError, "The string contains an invalid character #{char.inspect}"
-        }
-      }.to_i
-    end
-
-    # @return [String] The standard form of the IBAN for machine communication, without spaces.
-    attr_reader :compact
-
-    # @return [String] The ISO-3166 2-letter country code.
-    attr_reader :country
-
-    # @return [ISO::IBAN::Specification] The specification for this IBAN (determined by its country).
-    attr_reader :specification
-
-    # @param [String] iban
-    #   The IBAN number, either in formatted, human readable or in compact form.
-    def initialize(iban)
-      raise ArgumentError, "String expected for iban, but got #{iban.class}" unless iban.is_a?(String)
-
-      @compact       = self.class.strip(iban)
-      @country       = iban[0,2]
-      @specification = self.class.specification(@country, nil)
-    end
-
-    # @example Formatted IBAN
-    #
-    #     ISO::IBAN.new('CH')
-    #
-    # @return [String] The IBAN in its formatted form, which is more human readable than the compact form.
-    def formatted
-      @_formatted ||= @compact.gsub(/.{4}(?=.)/, '\0 ')
-    end
-
-    # @return [String]
-    #   IBAN in its numeric form, i.e. all characters a-z are replaced with their corresponding
-    #   digit sequences.
-    def numeric
-      @compact.size < 5 ? nil : self.class.numerify(@compact[4..-1]+@compact[0,4])
-    end
-
-    # @return [true, false]
-    #   Whether the IBAN is valid.
-    #   See {#validate} for details.
-    def valid?
-      validate.empty?
-    end
-
-    # Validation error codes:
-    #
-    # * :invalid_country
-    # * :invalid_checksum
-    # * :invalid_length
-    # * :invalid_format
-    #
-    # Invalid country means the country is unknown (char 1 & 2 in the IBAN).
-    # Invalid checksum means the two check digits (char 3 & 4 in the IBAN).
-    # Invalid length means the IBAN does not comply with the length specified for the country of that IBAN.
-    # Invalid format means the IBAN does not comply with the format specified for the country of that IBAN.
-    #
-    # @return [Array<Symbol>] An array with a code of all validation errors, empty if valid.
-    def validate
-      errors   = []
-      errors << :invalid_country  unless valid_country?
-      errors << :invalid_checksum unless valid_checksum?
-      errors << :invalid_length   unless valid_length?
-      errors << :invalid_format   unless valid_format?
-
-      errors
-    end
-
-    # @return [String] The checksum digits in the IBAN.
-    def checksum_digits
-      @compact[2,2]
-    end
-
-    # @return [String] The BBAN of the IBAN.
-    def bban
-      @compact[4..-1]
-    end
-
-    # @return [String, nil] The bank code part of the IBAN, nil if not applicable.
-    def bank_code
-      if @specification && @specification.bank_position_from && @specification.bank_position_to
-        @compact[@specification.bank_position_from..@specification.bank_position_to]
-      else
-        nil
-      end
-    end
-
-    # @return [String, nil] The branch code part of the IBAN, nil if not applicable.
-    def branch_code
-      if @specification && @specification.branch_position_from && @specification.branch_position_to
-        @compact[@specification.branch_position_from..@specification.branch_position_to]
-      else
-        nil
-      end
-    end
-
-    # @return [String] The account code part of the IBAN.
-    def account_code
-      @compact[((@specification.branch_position_to || @specification.bank_position_to || 3)+1)..-1]
-    end
-
-    # @return [true, false] Whether the country of the IBAN is valid.
-    def valid_country?
-      @specification ? true : false
-    end
-
-    # @return [true, false] Whether the format of the IBAN is valid.
-    def valid_format?
-      specification && specification.iban_regex =~ @compact ? true : false
-    end
-
-    # @return [true, false] Whether the length of the IBAN is valid.
-    def valid_length?
-      specification && @compact.size == specification.iban_length ? true : false
-    end
-
-    # @return [true, false] Whether the checksum of the IBAN is valid.
-    def valid_checksum?
-      numerified = numeric()
-
-      numerified && (numerified % 97 == 1)
-    end
-
-    # See Object#<=>
-    #
-    # @return [-1, 0, 1, nil]
-    def <=>(other)
-      other.respond_to?(:compact) ? @compact <=> other.compact : nil
-    end
-
-    # Requires that the checksum digits were left as '??', replaces them with
-    # the proper checksum.
-    #
-    # @return [self]
-    def update_checksum!
-      raise "Checksum digit placeholders missing" unless @compact[2,2] == '??'
-
-      @compact[2,2] = calculated_check_digits
-
-      self
-    end
-
-    # @return [String] The check-digits as calculated from the IBAN.
-    def calculated_check_digits
-      "%02d" % (98-(self.class.numerify(bban+@country)*100)%97)
-    end
-
-    # See Object#inspect
-    def inspect
-      sprintf "#<%p %s>", self.class, formatted
-    end
-
-    # @return [String] The compact form of the IBAN as a String.
-    def to_s
-      @compact.dup
-    end
-  end
-end
+ISO::IBAN.load_specifications

data/lib/iso/iban/autoload.rb

@@ -1,5 +1,9 @@
-# This file automatically loads all specifications. It's recommended that you require this file instead of iso/iban.
+# encoding: utf-8
 
-require 'iso/iban'
+# This file used automatically load all specifications.
+# Now this is the default behavior of require 'iso/iban', and this file only
+# exists to inform about the move.
+# The file will be removed (at the earlier of) either when reaching 1.0 or in
+# february 2015 (1 year from now).
 
-ISO::IBAN.load_specifications
+raise "Deprecated - use just `require 'iso/iban'` instead.\nIf you wish to suppress autoloading, use `require 'iso/iban/no_autoload'`."

data/lib/iso/iban/backports.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+# Port some newer ruby methods back
+unless String.method_defined?(:b)
+
+  # Backports from ruby 2.0 used in ISO::IBAN
+  class String
+
+    # @example
+    #     str.b   -> str
+    #
+    # Returns a copied string whose encoding is ASCII-8BIT.
+    def b
+      dup.force_encoding(Encoding::BINARY)
+    end
+  end
+end

data/lib/iso/iban/invalid.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+
+module ISO
+  class IBAN
+
+    # Raised by ISO::IBAN::parse!
+    class Invalid < ArgumentError
+
+      # @return [Array<Symbol>] The errors in the IBAN.
+      # @see ISO::IBAN#validate
+      attr_reader :errors
+
+      # @return [ISO::IBAN] The faulty IBAN.
+      attr_reader :iban
+
+      # @param [ISO::IBAN] iban
+      #    The faulty IBAN.
+      def initialize(iban)
+        @iban   = iban
+        @errors = iban.validate
+        super("The IBAN #{@iban.formatted} is invalid (#{@errors.join(', ')})")
+      end
+    end
+  end
+end

data/lib/iso/iban/no_autoload.rb

@@ -0,0 +1,481 @@
+# encoding: utf-8
+
+require 'iso/iban/backports'
+require 'iso/iban/invalid'
+require 'iso/iban/specification'
+require 'iso/iban/version'
+require 'yaml'
+
+# Container for classes which implement ISO standards.
+module ISO
+
+  # IBAN - ISO 13616-1
+  #
+  # Usage
+  # =====
+  #
+  #     require 'iso/iban'
+  #     ISO::IBAN.valid?('CH35 1234 5987 6543 2109 A')       # => true
+  #     ISO::IBAN.validate('CH37 1234 5987 6543 2109 A')     # => [:invalid_checksum]
+  #     ISO::IBAN.generate('CH', '12345', '987')             # => #<ISO::IBAN CH76 1234 5000 0000 0098 7>
+  #     iban = ISO::IBAN.parse('CH35 1234 5987 6543 2109 A') # => #<ISO::IBAN CH35 1234 5987 6543 2109 A>
+  #     iban = ISO::IBAN.new('CH351234598765432109A')        # => #<ISO::IBAN CH35 1234 5987 6543 2109 A>
+  #     iban.formatted       # => "CH35 1234 5987 6543 2109 A"
+  #     iban.compact         # => "CH351234598765432109A"
+  #     iban.country         # => "CH"
+  #     iban.checksum_digits # => "35"
+  #     iban.bank_code       # => "12345"
+  #     iban.account_code    # => "98765432109A"
+  #     iban.valid?          # => true
+  #     iban.validate        # => []
+  #
+  # General IBAN Information
+  # ========================
+  #
+  # * **What is an IBAN?**  
+  #   IBAN stands for International Bank Account Number. It is the ISO 13616
+  #   international standard for numbering bank accounts. In 2006, the
+  #   International Organization for Standardization (ISO) designated SWIFT as
+  #   the Registration Authority for ISO 13616.
+  #
+  # * **Use**  
+  #   The IBAN facilitates the communication and processing of cross-border
+  #   transactions. It allows exchanging account identification details in a
+  #   machine-readable form.
+  #
+  #
+  # The ISO 13616 IBAN Standard
+  # ===========================
+  #
+  # * **Structure**  
+  #   The IBAN structure is defined in ISO 13616-1 and consists of a two-letter
+  #   ISO 3166-1 country code, followed by two check digits and up to thirty
+  #   alphanumeric characters for a BBAN (Basic Bank Account Number) which has a
+  #   fixed length per country and, included within it, a bank identifier with a
+  #   fixed position and a fixed length per country. The check digits are
+  #   calculated based on the scheme defined in ISO/IEC 7064 (MOD97-10).
+  #
+  # * **Terms and definitions**  
+  #     * *Bank identifier:* The identifier that uniquely identifies the financial
+  #       institution and, when appropriate, the branch of that financial institution
+  #       servicing an account.  
+  #     * *BBAN:* basic bank account number: The identifier that uniquely identifies
+  #       an individual account, at a specific financial institution, in a particular
+  #       country. The BBAN includes a bank identifier of the financial institution
+  #       servicing that account.  
+  #     * *IBAN:* international bank account number: The expanded version of the
+  #       basic bank account number (BBAN), intended for use internationally. The
+  #       IBAN uniquely identifies an individual account, at a specific financial
+  #       institution, in a particular country.
+  #
+  # * **Submitters**  
+  #   Nationally-agreed, ISO13616-compliant IBAN formats are submitted to the
+  #   registration authority exclusively by the National Standards Body or the
+  #   National Central Bank of the country.
+  class IBAN
+    include Comparable
+
+    # Character code translation used to convert an IBAN into its numeric
+    # (digits-only) form
+    CharacterCodes  = Hash[('0'..'9').zip('0'..'9')+('a'..'z').zip(10..35)+('A'..'Z').zip(10..35)]
+
+    # All uppercase letters
+    UpperAlpha   = [*'A'..'Z']
+
+    # All lowercase letters
+    LowerAlpha   = [*'a'..'z']
+
+    # All digits
+    Digits       = [*'0'..'9']
+
+    # All uppercase letters, lowercase letters and digits
+    AlphaNumeric = [*'A'..'Z', *'a'..'z', *'0'..'9']
+
+    # All specifications, see ISO::IBAN::Specification
+    @specifications = nil
+
+    # @note
+    #   Using `require 'iso/iban'` will automatically invoke this method.
+    #   If you do not wish this behavior, `require 'iso/iban/no_autoload'` instead.
+    #
+    # Load the IBAN specifications file, which determines how the IBAN
+    # for any given country looks.
+    #
+    # It will use the following sources in this order (first one which exists wins)
+    #
+    # * Path passed as `spec_file` parameter
+    # * Path provided by the env variable `IBAN_SPECIFICATIONS`
+    # * The file `../data/iso-iban/specs.yaml` relative to the lib dir
+    # * The Gem datadir path
+    #
+    # @param [String] spec_file
+    #   Override the default specifications file path.
+    #
+    # @return [self]
+    def self.load_specifications(spec_file=nil)
+      if spec_file then
+        # do nothing
+      elsif ENV['IBAN_SPECIFICATIONS'] then
+        spec_file = ENV['IBAN_SPECIFICATIONS']
+      else
+        spec_file = File.expand_path('../../../../data/iso-iban/specs.yaml', __FILE__)
+        if !File.file?(spec_file) && defined?(Gem) && Gem.datadir('iso-iban')
+          spec_file = Gem.datadir('iso-iban')+'/specs.yaml'
+        end
+      end
+
+      if spec_file && File.file?(spec_file)
+        @specifications = ISO::IBAN::Specification.load_yaml(spec_file)
+      elsif spec_file
+        raise "Could not load IBAN specifications, specs file #{spec_file.inspect} does not exist or can't be read."
+      else
+        raise "Could not load IBAN specifications, no specs file found."
+      end
+
+      self
+    end
+
+    # @return [Hash<String => ISO::IBAN::Specification>]
+    #   A hash with the country (ISO3166 2-letter) as key and the specification for that country as value.
+    def self.specifications
+      @specifications || raise("No specifications have been loaded yet - Check the docs for ISO::IBAN::load_specifications.")
+    end
+
+    # @param [String] a2_country_code
+    #   The country (ISO3166 2-letter), e.g. 'CH' or 'DE'.
+    #
+    # @return [ISO::IBAN::Specification]
+    #   The specification for the given country.
+    def self.specification(a2_country_code, *default, &default_block)
+      specifications.fetch(a2_country_code, *default, &default_block)
+    end
+
+    # @param [String] iban
+    #   An IBAN number, either in compact or human format.
+    #
+    # @return [true, false]
+    #   Whether the IBAN is valid.  
+    #   See {#validate} for details.
+    def self.valid?(iban)
+      parse(iban).valid?
+    end
+
+    # @param [String] iban
+    #   An IBAN number, either in compact or human format.
+    #
+    # @return [Array<Symbol>]
+    #   An array with a code of all validation errors, empty if valid.  
+    #   See {#validate} for details.
+    def self.validate(iban)
+      parse(iban).validate
+    end
+
+    # @param [String] iban
+    #   The IBAN in either compact or human readable form.
+    #
+    # @return [String]
+    #   The IBAN in compact form, all whitespace and dashes stripped.
+    def self.strip(iban)
+      iban.delete("\n\r\t -")
+    end
+
+    # Like ISO::IBAN.parse, but raises an ISO::IBAN::Invalid exception if the IBAN is invalid.
+    #
+    # @param [String] iban_number
+    #   The IBAN in either compact or human readable form.
+    #
+    # @return [ISO::IBAN]
+    #   An IBAN instance representing the passed IBAN number.
+    def self.parse!(iban_number)
+      iban   = parse(iban_number)
+      raise Invalid.new(iban) unless iban.valid?
+
+      iban
+    end
+
+    # @param [String] iban_number
+    #   The IBAN in either compact or human readable form.
+    #
+    # @return [ISO::IBAN]
+    #   An IBAN instance representing the passed IBAN number.
+    def self.parse(iban_number)
+      new(strip(iban_number))
+    end
+
+    # Generate an IBAN from country code and components, automatically filling in the checksum.
+    #
+    # @note
+    #   `generate` will pad all segments with zeros, which means it will generate invalid
+    #   IBANs if you provide too short segments which are alphabetic only.  
+    #   For example, `ISO::IBAN.generate('BG', 'A', '2', 'C')` generates an invalid IBAN.
+    #
+    # @example Generate an IBAN for UBS Switzerland with account number '12345'
+    #     ISO::IBAN.generate('CH', '216', '12345') # => #<ISO::IBAN CH92 0021 6000 0000 1234 5>
+    #
+    # @param [String] country
+    #   The ISO-3166 2-letter country code.
+    #
+    def self.generate(country, *components)
+      spec      = specification(country)
+      justified = spec.component_lengths.zip(components).map { |length, component| component.rjust(length, "0") }
+      iban      = new(country+'??'+justified.join(''))
+      iban.update_checksum!
+
+      iban
+    end
+
+    # @param [String] countries
+    #   A list of 2 letter country codes. If empty, all countries in ISO::IBAN::specifications are used.
+    #
+    # @return [ISO::IBAN] A random, valid IBAN.
+    def self.random(*countries)
+      countries = specifications.keys if countries.empty?
+      country   = countries.sample
+      account   = specification(country).iban_structure.scan(/([A-Z]+)|(\d+)(!?)([nac])/).map { |exact, length, fixed, code|
+        if exact
+          exact
+        elsif code == 'a'
+          Array.new(length.to_i) { UpperAlpha.sample }.join('')
+        elsif code == 'c'
+          Array.new(length.to_i) { AlphaNumeric.sample }.join('')
+        elsif code == 'e'
+          ' '*length.to_i
+        elsif code == 'n'
+          Array.new(length.to_i) { Digits.sample }.join('')
+        end
+      }.join('')
+      account[2,2] = '??'
+      iban = new(account)
+      iban.update_checksum!
+
+      iban
+    end
+
+    # Converts a String into its digits-only form, i.e. all characters a-z are replaced with their corresponding
+    # digit sequences, according to the IBAN specification.
+    #
+    # @param [String] string
+    #   The string to convert into its numeric form.
+    #
+    # @return [String] The string in its numeric, digits-only form.
+    def self.numerify(string)
+      string.downcase.gsub(/\D/) { |char|
+        CharacterCodes.fetch(char) {
+          raise ArgumentError, "The string contains an invalid character #{char.inspect}"
+        }
+      }.to_i
+    end
+
+    # @return [String] The standard form of the IBAN for machine communication, without spaces, encoded in Encoding::BINARY.
+    attr_reader :compact
+
+    # @return [String] The ISO-3166 2-letter country code (first and second character).
+    attr_reader :country
+
+    # @return [ISO::IBAN::Specification] The specification for this IBAN (determined by its country).
+    attr_reader :specification
+
+    # @param [String] iban
+    #   The IBAN number, must be in compact form. Use ISO::IBAN::parse for formatted IBANs.
+    def initialize(iban)
+      raise ArgumentError, "String expected for iban, but got #{iban.class}" unless iban.is_a?(String)
+
+      @compact       = iban.b
+      @country       = iban[0,2]
+      @specification = self.class.specification(@country, nil)
+    end
+
+    # @example Formatted IBAN
+    #
+    #     ISO::IBAN.new('CH')
+    #
+    # @return [String] The IBAN in its formatted form, which is more human readable than the compact form.
+    def formatted
+      @_formatted ||= @compact.gsub(/.{4}(?=.)/, '\0 ')
+    end
+
+    # @return [Integer, nil]
+    #   IBAN in its numeric form, i.e. all characters a-z are replaced with their corresponding
+    #   digit sequences.  
+    #   Will return nil if the IBAN is shorter than 5 characters (which makes it invalid).
+    def numeric
+      @compact.size < 5 ? nil : self.class.numerify(@compact[4..-1]+@compact[0,4])
+    end
+
+    # @return [true, false]
+    #   Whether the IBAN is valid.
+    #   See {#validate} for details.
+    def valid?
+      valid_country? && valid_checksum? && valid_length? && valid_format?
+    end
+
+    # @note
+    #   The class method {ISO::IBAN.validate} uses {ISO::IBAN.parse}, which means it will strip whitespace and
+    #   dashes from the IBAN.  
+    #   {ISO::IBAN#initialize} on the other hand expects the IBAN in compact format and will not strip
+    #   those characters.
+    #
+    # Error codes:
+    #
+    # * :invalid_characters
+    # * :invalid_country
+    # * :invalid_checksum
+    # * :invalid_length
+    # * :invalid_format
+    #
+    # Invalid characters means that the IBAN contains characters which are not in the set of A-Za-z0-9. See {#invalid_characters}.  
+    # Invalid country means the country is unknown (character 1 & 2 in the IBAN).  
+    # Invalid checksum means the two check digits (character 3 & 4 in the IBAN).  
+    # Invalid length means the IBAN does not comply with the length specified for the country of that IBAN.  
+    # Invalid format means the IBAN does not comply with the format specified for the country of that IBAN.  
+    #
+    # @return [Array<Symbol>] An array with a code of all validation errors, empty if valid.
+    def validate
+      errors   = []
+      errors << :invalid_characters unless valid_characters?
+      errors << :invalid_country    unless valid_country?
+      errors << :invalid_checksum   unless valid_characters? && valid_checksum?
+      errors << :invalid_length     unless valid_length?
+      errors << :invalid_format     unless valid_format?
+
+      errors
+    end
+
+    # @return [String] The checksum digits in the IBAN (character 3 & 4).
+    def checksum_digits
+      @compact[2,2]
+    end
+
+    # @return [String] The BBAN of the IBAN (everything except the country code and check digits).
+    def bban
+      @compact[4..-1]
+    end
+
+    # @return [String, nil] The bank code part of the IBAN, nil if not applicable.
+    def bank_code
+      if @specification && @specification.bank_position_from && @specification.bank_position_to
+        @compact[@specification.bank_position_from..@specification.bank_position_to]
+      else
+        nil
+      end
+    end
+
+    # @return [String, nil] The branch code part of the IBAN, nil if not applicable.
+    def branch_code
+      if @specification && @specification.branch_position_from && @specification.branch_position_to
+        @compact[@specification.branch_position_from..@specification.branch_position_to]
+      else
+        nil
+      end
+    end
+
+    # @return [String] The account code part of the IBAN.
+    def account_code
+      @compact[((@specification.branch_position_to || @specification.bank_position_to || 3)+1)..-1]
+    end
+
+    # @example
+    #     invalid = "hägar"
+    #     invalid.encoding # => #<Encoding:UTF-8>
+    #     ISO::IBAN.new(invalid).invalid_characters          # => ["\xC3", "\xA4"]
+    #     ISO::IBAN.new(invalid).invalid_characters('utf-8') # => ["ä"]
+    #
+    # @param [String, Encoding, nil] input_encoding
+    #   ISO::IBAN::new interprets the passed IBAN as binary.
+    #   If you got the IBAN from a source which is not binary, you should provide that encoding.
+    #   Otherwise an invalid character may be split into multiple bytes.
+    #
+    # @return [Array] An Array with all invalid characters.
+    def invalid_characters(input_encoding=nil)
+      iban = input_encoding ? @compact.dup.force_encoding(input_encoding) : @compact
+
+      iban.gsub(/[A-Z0-9?]*/i, '').chars.to_a.uniq # to_a is for ruby <= 2.0 where String#chars returns an Enumerator
+    end
+
+    # @return [true, false] Whether IBAN consists only of valid characters.
+    def valid_characters?
+      @compact =~ /\A[A-Z]{2}(?:\d\d|\?\?)[A-Z0-9]*\z/in ? true : false
+    end
+
+    # @return [true, false] Whether the country of the IBAN is valid.
+    def valid_country?
+      @specification ? true : false
+    end
+
+    # @return [true, false] Whether the format of the IBAN is valid.
+    def valid_format?
+      @specification && @specification.iban_regex =~ @compact ? true : false
+    end
+
+    # @return [true, false] Whether the length of the IBAN is valid.
+    def valid_length?
+      @specification && @compact.size == @specification.iban_length ? true : false
+    end
+
+    # @return [true, false] Whether the checksum of the IBAN is valid.
+    def valid_checksum?
+      numerified = numeric()
+
+      numerified && (numerified % 97 == 1)
+    end
+
+    # See Object#<=>
+    #
+    # @return [-1, 0, 1, nil]
+    def <=>(other)
+      other.respond_to?(:compact) ? @compact <=> other.compact : nil
+    end
+
+    # Requires that the checksum digits were left as '??', replaces them with
+    # the proper checksum.
+    #
+    # @return [self]
+    def update_checksum!
+      raise "Checksum digit placeholders missing" unless @compact[2,2] == '??'
+
+      @compact[2,2] = calculated_check_digits
+
+      self
+    end
+
+    # @return [String] The check-digits as calculated from the IBAN.
+    def calculated_check_digits
+      "%02d" % (98-(self.class.numerify(bban+@country)*100)%97)
+    end
+
+    # @return [true, false]
+    #   Whether two ISO::IBANs are equal.
+    #   Comparison is based on class and IBAN number
+    def eql?(other)
+      self.class.equal?(other.class) && self == other
+    end
+
+    # @return [Integer]
+    #   A hash value, see Object#hash
+    def hash
+      [self.class, @compact].hash
+    end
+
+    # See Object#inspect
+    def inspect
+      sprintf "#<%p %s>", self.class, formatted
+    end
+
+    # @return [String] The compact form of the IBAN as a String.
+    def to_s
+      @compact.dup
+    end
+
+    # @note
+    #   This method is experimental. It might change or be removed in future versions!
+    #
+    # @return [Array]
+    #   The individual IBAN components as defined by the SWIFT specification.
+    #   An empty array if this IBAN does not have a specification.
+    def to_a
+      @_components ||= @specification ? @compact.match(@specification.iban_regex).captures : []
+
+      @_components.dup
+    end
+  end
+end

data/lib/iso/iban/specification.rb

@@ -68,9 +68,9 @@ module ISO
           else
             StructureCodes[code]+(fixed ? "{#{length}}" : "{,#{length}}")
           end
-        }.join('')
+        }.join(')(')
 
-        anchored ? /\A#{source}\z/ : /#{source}/
+        anchored ? /\A(#{source})\z/ : /(#{source})/n
       end
 
       attr_reader :country_name,
@@ -99,7 +99,7 @@ module ISO
 
       # @return [Regexp] A regex to verify the structure of the IBAN.
       def iban_regex
-        @iban_regex ||= self.class.structure_regex(@iban_structure)
+        @_iban_regex ||= self.class.structure_regex(@iban_structure)
       end
 
       # @return [Regexp] A regex to identify the structure of the IBAN, without anchors.
@@ -109,7 +109,7 @@ module ISO
 
       # @return [Array<Integer>] An array with the lengths of all components.
       def component_lengths
-        [bank_code_length, branch_code_length, account_code_lenght].tap { |lengths| lengths.delete(0) }
+        [bank_code_length, branch_code_length, account_code_length].tap { |lengths| lengths.delete(0) }
       end
 
       # @return [Fixnum]
@@ -126,7 +126,7 @@ module ISO
 
       # @return [Fixnum]
       #   The length of the account code in the IBAN.
-      def account_code_lenght
+      def account_code_length
         bban_length-bank_code_length-branch_code_length
       end
 

data/lib/iso/iban/version.rb

@@ -13,6 +13,6 @@ module ISO
     # @note
     #   require 'iso/iban' loads the version.
     #
-    Version = Gem::Version.new("0.0.4")
+    Version = Gem::Version.new("0.1.0")
   end
 end

data/test/unit/lib/iso/iban.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
 
-require 'iso/iban'
+require 'iso/iban/no_autoload'
 
 suite "ISO::IBAN" do
   setup do
@@ -28,7 +28,7 @@ suite "ISO::IBAN" do
     end
   end
 
-  test 'ISO::IBAN::generate problem, TODO' do
+  test 'ISO::IBAN::generate problem, TODO (this test is expected to fail at the moment)' do
     ISO::IBAN.instance_variable_set(:@specifications, {'BG' => ISO::IBAN::Specification.new("Bulgaria", "BG", "BG2!n4!a4!n2!n8!c", 22, "4!a4!n2!n8!c", 18, 4, 7, 8, 11)})
     assert ISO::IBAN.generate('BG', 'AAAA', '2', 'C').valid? # this works now
     assert ISO::IBAN.generate('BG', 'A', '2', 'C').valid? # this still fails, because ISO::IBAN::generate can't pad 'a' format fields
@@ -73,73 +73,89 @@ suite "ISO::IBAN" do
     assert_equal [:invalid_length, :invalid_format], ISO::IBAN.validate('CH83 X234 5987 6543 2109 AB')
     assert_equal [:invalid_checksum, :invalid_length, :invalid_format], ISO::IBAN.validate('CH99 X234 5987 6543 2109 AB')
     assert_equal [:invalid_country, :invalid_checksum, :invalid_length, :invalid_format], ISO::IBAN.validate('XX35 1234 5987 6543 2109 A')
+    assert_equal [:invalid_characters, :invalid_checksum, :invalid_length, :invalid_format], ISO::IBAN.validate('CH35 1234 5987 6543 2109 Ä')
+    assert_equal [:invalid_characters, :invalid_country, :invalid_checksum, :invalid_length, :invalid_format], ISO::IBAN.validate('XX35 1234 5987 6543 2109 Ä')
+  end
+
+  test "ISO::IBAN::parse" do
+    assert_kind_of ISO::IBAN, ISO::IBAN.parse('CH35 1234 5987 6543 2109 A')
+    assert_equal 'CH351234598765432109A', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').compact
   end
 
   test "ISO::IBAN::new" do
-    assert_kind_of ISO::IBAN, ISO::IBAN.new('CH35 1234 5987 6543 2109 A')
     assert_kind_of ISO::IBAN, ISO::IBAN.new('CH351234598765432109A')
   end
 
   test "ISO::IBAN#formatted" do
-    assert_equal 'CH35 1234 5987 6543 2109 A', ISO::IBAN.new('CH35 1234 5987 6543 2109 A').formatted
-    assert_equal 'CH35 1234 5987 6543 2109 A', ISO::IBAN.new('CH351234598765432109A').formatted
+    assert_equal 'CH35 1234 5987 6543 2109 A', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').formatted
+    assert_equal 'CH35 1234 5987 6543 2109 A', ISO::IBAN.parse('CH351234598765432109A').formatted
   end
 
   test "ISO::IBAN#compact" do
-    assert_equal 'CH351234598765432109A', ISO::IBAN.new('CH35 1234 5987 6543 2109 A').compact
-    assert_equal 'CH351234598765432109A', ISO::IBAN.new('CH351234598765432109A').compact
+    assert_equal 'CH351234598765432109A', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').compact
+    assert_equal 'CH351234598765432109A', ISO::IBAN.parse('CH351234598765432109A').compact
   end
 
   test "ISO::IBAN#to_s" do
-    assert_equal 'CH351234598765432109A', ISO::IBAN.new('CH35 1234 5987 6543 2109 A').to_s
-    assert_equal 'CH351234598765432109A', ISO::IBAN.new('CH351234598765432109A').to_s
+    assert_equal 'CH351234598765432109A', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').to_s
+    assert_equal 'CH351234598765432109A', ISO::IBAN.parse('CH351234598765432109A').to_s
   end
 
   test "ISO::IBAN#country" do
-    assert_equal 'CH', ISO::IBAN.new('CH35 1234 5987 6543 2109 A').country
+    assert_equal 'CH', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').country
   end
 
   test "ISO::IBAN#checksum_digits" do
-    assert_equal '35', ISO::IBAN.new('CH35 1234 5987 6543 2109 A').checksum_digits
+    assert_equal '35', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').checksum_digits
   end
 
   test "ISO::IBAN#bban" do
-    assert_equal '1234598765432109A', ISO::IBAN.new('CH35 1234 5987 6543 2109 A').bban
+    assert_equal '1234598765432109A', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').bban
   end
 
   test "ISO::IBAN#bank_code" do
-    assert_equal '12345', ISO::IBAN.new('CH35 1234 5987 6543 2109 A').bank_code
+    assert_equal '12345', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').bank_code
   end
 
   test "ISO::IBAN#branch_code" do
     ISO::IBAN.instance_variable_set(:@specifications, {'BG' => ISO::IBAN::Specification.new("Bulgaria", "BG", "BG2!n4!a4!n2!n8!c", 22, "4!a4!n2!n8!c", 18, 4, 7, 8, 11)})
-    assert_equal "0002", ISO::IBAN.new('BG69 0001 0002 0300 0000 04').branch_code
+    assert_equal "0002", ISO::IBAN.parse('BG69 0001 0002 0300 0000 04').branch_code
   end
 
   test "ISO::IBAN#account_code" do
-    assert_equal '98765432109A', ISO::IBAN.new('CH35 1234 5987 6543 2109 A').account_code
+    assert_equal '98765432109A', ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').account_code
   end
 
   test "ISO::IBAN#valid?" do
-    assert_equal true,  ISO::IBAN.new('CH35 1234 5987 6543 2109 A').valid?
-    assert_equal false, ISO::IBAN.new('CH99 1234 5987 6543 2109 A').valid?
+    assert_equal true,  ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').valid?
+    assert_equal false, ISO::IBAN.parse('CH99 1234 5987 6543 2109 A').valid?
   end
 
   test "ISO::IBAN#validate" do
-    assert_equal [], ISO::IBAN.new('CH35 1234 5987 6543 2109 A').validate
+    assert_equal [], ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').validate
+  end
+
+  test 'ISO::IBAN#invalid_characters' do
+    assert_equal ["\xC3".b, "\x84".b], ISO::IBAN.parse('Ä').invalid_characters
+    assert_equal ['Ä'],                ISO::IBAN.parse('Ä').invalid_characters('utf-8')
   end
 
   test "ISO::IBAN#<=>" do
     iban0 = ISO::IBAN.generate('CH', '0', '0')
     iban1 = ISO::IBAN.generate('CH', '0', '97') # 97 to have the same checksum
-    assert_equal  -1, iban0 <=> iban1
-    assert_equal   0, iban0 <=> iban0
-    assert_equal   1, iban1 <=> iban0
-    assert_equal nil, iban0 <=> "incomparable"
-    assert_equal nil, "incomparable" <=> iban0
+    assert_equal( -1, iban0 <=> iban1         )
+    assert_equal(  0, iban0 <=> iban0         )
+    assert_equal(  1, iban1 <=> iban0         )
+    assert_equal(nil, iban0 <=> "incomparable")
+    assert_equal(nil, "incomparable" <=> iban0)
+  end
+
+  test "ISO::IBAN#to_a" do
+    assert_equal %w[CH 35 12345 98765432109A], ISO::IBAN.parse("CH351234598765432109A").to_a
+    assert_equal [], ISO::IBAN.parse("XX351234598765432109A").to_a # no specification
   end
 
   test "ISO::IBAN#inspect" do
-    assert_equal "#<ISO::IBAN CH35 1234 5987 6543 2109 A>", ISO::IBAN.new('CH35 1234 5987 6543 2109 A').inspect
+    assert_equal "#<ISO::IBAN CH35 1234 5987 6543 2109 A>", ISO::IBAN.parse('CH35 1234 5987 6543 2109 A').inspect
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iso-iban
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.1.0
 platform: ruby
 authors:
 - Stefan Rusterholz
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-23 00:00:00.000000000 Z
+date: 2014-02-25 00:00:00.000000000 Z
 dependencies: []
 description: |-
   ISO::IBAN implements IBAN (International Bank Account Number) specification as per ISO 13616-1.
@@ -18,42 +18,54 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".yardopts"
+- LICENSE.txt
+- README.markdown
+- Rakefile
 - data/iso-iban/specs.yaml
+- iso-iban.gemspec
+- lib/iso/iban.rb
 - lib/iso/iban/autoload.rb
+- lib/iso/iban/backports.rb
+- lib/iso/iban/invalid.rb
+- lib/iso/iban/no_autoload.rb
 - lib/iso/iban/specification.rb
 - lib/iso/iban/version.rb
-- lib/iso/iban.rb
 - test/data/test_spec.yaml
 - test/lib/helper.rb
 - test/runner.rb
 - test/tmp/test_spec.yaml
 - test/unit/lib/iso/iban.rb
-- iso-iban.gemspec
-- .yardopts
-- LICENSE.txt
-- Rakefile
-- README.markdown
 homepage: https://github.com/apeiros/iso-iban
 licenses:
 - BSD 2-Clause
 metadata: {}
-post_install_message: 
+post_install_message: |-
+  IMPORTANT!
+
+  As of 0.1.0, there are 2 backward incompatible changes:
+
+  * `require 'iso/iban/autoload'` is deprecated. Please use plain `require 'iso/iban'`.
+    To load ISO::IBAN without loading the specifications, please use
+    `require 'iso/iban/no_autoload'`.
+  * ISO::IBAN.new no longer accepts formatted input.
+    Use ISO::IBAN.parse if your input is potentially not in the compact format.
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 1.9.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>'
+  - - ">"
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.5
+rubygems_version: 2.2.1
 signing_key: 
 specification_version: 3
 summary: Utilities for International Bank Account Numbers (IBAN) as per ISO 13616-1.