rbktoblzcheck 0.1.0

data/LICENSE

@@ -0,0 +1,38 @@
+ 
+  (c) Copyright 2004, Sascha Loetz (sloetz (a t) web.de). All rights reserved.
+
+
+  Redistribution and use in source and binary forms of this software, with
+  or without modification, are permitted provided that the following
+  conditions are met:
+  
+  1. Redistributions of source code must retain any existing copyright
+     notice, and this entire permission notice in its entirety,
+     including the disclaimer of warranties.
+  
+  2. Redistributions in binary form must reproduce all prior and current
+     copyright notices, this list of conditions, and the following
+     disclaimer in the documentation and/or other materials provided
+     with the distribution.
+  
+  3. The name of any author may not be used to endorse or promote
+     products derived from this software without their specific prior
+     written permission.
+  
+  ALTERNATIVELY, this product may be distributed under the terms of the
+  GNU General Public License, in which case the provisions of the GNU
+  GPL are required INSTEAD OF the above restrictions.  (This clause is
+  necessary due to a potential conflict between the GNU GPL and the
+  restrictions contained in a BSD-style copyright.)
+  
+  THIS SOFTWARE IS PROVIDED AS IS'' AND ANY EXPRESS OR IMPLIED
+  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+  IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT, INDIRECT,
+  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
+  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+  DAMAGE.

data/README

@@ -0,0 +1,172 @@
+Ruby KtoBlzCheck
+================
+
+rbKtoBlzCheck is a small Ruby extension for Linux (written in C) that provides
+an interface for libktoblzcheck, a library to check German account numbers and
+bank codes. See http://ktoblzcheck.sourceforge.net for details.
+
+Install instructions
+--------------------
+
+Just install the gem with the following command:
+
+  $ gem install ktoblzcheck
+
+
+Common errors:
+--------------
+
+* ruby extconf.rb fails with 
+  "Couldn't find header file..." or
+  "Couldn't find link library..."
+
+  => Make sure the ktoblzcheck library and header files are correctly installed.
+  => Consult the file mkmf.log for details of build time checks
+  => Hint: If you've build and installed the ktoblzcheck library from source, make sure
+     the install locations of the library files are listed in /etc/ld.so.conf and you've run 
+     `ldconfig`
+
+* compile errors
+
+  Nothing to mention here: the code compiles without warning on Linux 2.6.7,
+  glibc-2.3.2, gcc version 3.3.4 (Debian 1:3.3.4-7) with ruby 1.8.2
+  (2004-07-29) [i386-linux].
+  
+
+Dependencies:
+-------------
+
+- Ruby >= 1.8
+- libktoblzcheck (obviously :)
+
+The ktoblzcheck package can be downloaded from
+http://ktoblzcheck.sourceforge.net/ as source distribution tar-ball or RPM.
+
+Debian has a package named 'libktoblzcheck1-dev' available in testing and
+unstable, simply apt-get install it.
+
+
+
+Other platforms:
+----------------
+
+As I have no suitable non-Linux systems to mess around with, I have no idea
+whether this Ruby extension compiles and/or runs correctly on other platforms.
+
+I guess, there should be no problems on BSDish systems. While the C-code should
+be quiet portable, I'm not sure if linking works correctly on Microsoft (R)
+Windows (R).
+
+Comments on problems with OSes other than Linux are always welcome.
+
+License:
+--------
+
+BSD-style, see LICENSE
+
+This project is based on the work of Sascha Loetz (blog.cadego.de, info@cadego(dot)de).
+
+Ruby Interface:
+===============
+
+Example:
+-----------------------------------------------------------------------
+require 'ktoblzcheck'
+
+$bc="20030700"
+$an="0"
+
+puts "Testing Bank Code: #{$bc} / Account No. #{$an}"
+
+KtoBlzCheck.new do |kbc|
+  name,location=kbc.find($bc)
+  if name
+    puts "Bank found! #{name} located in #{location}"
+  else
+    puts "Bank not found!"
+  end
+  case kbc.check($bc,$an)
+    when KtoBlzCheck::ERROR
+      puts "Failed, bank code and account number don't match"
+    when KtoBlzCheck::OK
+      puts "Success, valid combination of bank code and account number"
+    when KtoBlzCheck::UNKNOWN
+      puts "Unknown."
+    when KtoBlzCheck::BANK_NOT_KNOWN
+      puts "Unknown bank code"
+    else
+      puts "Never reached :)"
+  end
+end
+-----------------------------------------------------------------------
+
+For more code examples refer to the rbkbc program and the test-*.rb files
+provided with this distribution.
+
+
+Interface documentation:
+========================
+
+-----------------------------------------------------------------------
+KtoBlzCheck.new [ |block| ] -> obj
+KtoBlzCheck.new(datafilepath) [ |block| ] -> obj
+-----------------------------------------------------------------------
+
+Constructs a new KtoBlzCheck object, returns it or passes it to an 
+optional code block. If no block is provided, the user must call 
+KtoBlzCheck#close to ensure that all resources are freed
+after usage.
+
+If a parameter is passed to new it is interpreted as the path to the
+data file to be used by libktoblzcheck. When the parameter is omitted,
+the default file of libktoblzcheck is used 
+(usually /usr/[local/]share/[lib]ktoblzcheck[*]/bankdata.txt).
+
+A nil value passed as parameter is ignored.
+-----------------------------------------------------------------------
+
+
+-----------------------------------------------------------------------
+KtoBlzCheck#close
+-----------------------------------------------------------------------
+Closes the KtoBlzCheck object's handle for libktoblzcheck. Must be 
+called to prevent resource leaks if KtoBlzCheck#new is not used with 
+block syntax.
+-----------------------------------------------------------------------
+
+
+-----------------------------------------------------------------------
+KtoBlzCheck#num_records -> aFixnum
+-----------------------------------------------------------------------
+Returns the number of entries in the currently used data file for
+libktoblzcheck.
+-----------------------------------------------------------------------
+
+
+-----------------------------------------------------------------------
+KtoBlzCheck#check(bank_code, account_no) -> aFixnum
+-----------------------------------------------------------------------
+Checks if bank_code and account_no form a valid combination. The 
+returned Fixnum indicates the result. The following constants can be
+used test the result:
+
+KtoBlzCheck::OK -> valid combination of bank code and account number
+KtoBlzCheck::ERROR -> !OK
+KtoBlzCheck::UNKNOWN -> no verification possible for unknown reason
+KtoBlzCheck::BANK_NOT_KNOWN -> bank code not known
+
+If bank_code and account_no are not of type String a TypeError is
+raised.
+-----------------------------------------------------------------------
+
+
+-----------------------------------------------------------------------
+KtoBlzCheck#find(bank_code) -> anArray
+-----------------------------------------------------------------------
+Looks up bank name and bank location (city) for the bank identified
+by bank_code.
+
+Returns an array with the bank's name (index 0) and the bank's location 
+(index 1). The returned array is empty if no bank is found for the given 
+bank code.
+-----------------------------------------------------------------------

data/Rakefile

@@ -0,0 +1,19 @@
+# encoding: UTF-8
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "rbktoblzcheck"
+    gem.summary = "rbktoblzcheck is an interface for libktoblzcheck, a library to check German account numbers and
+bank codes. See http://ktoblzcheck.sourceforge.net for details."
+    gem.email = "kim.rudolph@web.de"
+    gem.homepage = "http://github.com/krudolph/rbktoblzcheck"
+    gem.authors = ["Sascha Loetz", "Kim Rudolph"]
+    gem.require_paths = ["lib", "ext"]
+    gem.extra_rdoc_files = `git ls-files *.rdoc`.split("\n")
+    gem.files = `git ls-files`.split("\n")
+    gem.extensions = ["ext/extconf.rb"]
+    gem.files.include %w(lib/jeweler/templates/.document lib/jeweler/templates/.gitignore)
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION.yml

@@ -0,0 +1,4 @@
+---
+:minor: 1
+:patch: 0
+:major: 0

data/bin/kbc-ruby

@@ -0,0 +1,156 @@
+#!/usr/bin/env ruby
+#
+# Sample program for rbktoblzcheck
+#
+# Mimics the functions of the ktoblzcheck tool
+# which is part of the ktoblzcheck distribution
+#
+# (c) 2004 Sascha Loetz (sloetz (a t) web.de)
+#
+# See LICENSE for the BSD-style license for this code
+#
+# This program is part of the rbktoblzcheck package
+# available at http://www.vdp-software.com/Rbktoblzcheck.html
+#
+# $Id: rbkbc,v 1.1 2004/10/28 19:10:19 vdpsoftware Exp $
+
+require 'getoptlong'
+require 'ktoblzcheck'
+
+# modes of operation
+FIND=1
+CHECK=2
+
+$bc=nil   # bank code
+$an=nil   # account number
+$ec=0     # exit code
+$df=nil   # data file
+$verbose=false
+$prg=File.basename($0)
+
+def print_help
+  puts "Usage: #{$prg} [OPTIONS]"
+  puts "--verbose, -v\t\t\treport --check results as text and return code"
+  puts "--find, -f\t\t\tfind mode: lookup details for a bank code (-b required)"
+  puts "--check,-c\t\t\tcheck mode: validate bank code and account number\n\t\t\t\t(-b and -a required)"
+  puts "--bank-code, -b bank code\tspecify bank code for --find or --check"
+  puts "--account-no, -a account number\tspecify account number for --check"
+  puts "--data-file,-d path\t\tuse a different data file"
+  puts
+  puts "Return codes:"
+  puts "0 OK"
+  puts "1 Failed"
+  puts "2 Unknown Error"
+  puts "3 Unknown Bank Code"
+  puts "4 Option Error"
+  puts
+  puts "Examples:"
+  puts "#{$prg} --verbose --check --bank-code 20030700 --account-no 0"
+  puts "#{$prg} -f -b 20030700"
+end
+
+begin # options
+
+  opts = GetoptLong.new(
+    [ "--verbose",   "-v",  GetoptLong::NO_ARGUMENT],
+    [ "--data-file", "-d",   GetoptLong::REQUIRED_ARGUMENT],
+    [ "--find",   "-f",     GetoptLong::NO_ARGUMENT],
+    [ "--check",  "-c",     GetoptLong::NO_ARGUMENT],
+    [ "--account-no", "-a",    GetoptLong::REQUIRED_ARGUMENT],
+    [ "--bank-code", "-b", GetoptLong::REQUIRED_ARGUMENT],
+    [ "--help",   "-h",    GetoptLong::NO_ARGUMENT ]  )
+
+  opts.quiet=true
+
+  # process the parsed options
+
+  opts.each do |opt, arg|
+    case opt
+      when "--account-no"
+        $an=arg.to_s
+      when "--bank-code"
+        $bc=arg.to_s
+      when "--data-file"
+        $df=arg.to_s
+      when "--check"
+        $mode=CHECK
+      when "--find"
+        $mode=FIND
+      when "--verbose"
+        $verbose=true
+      when "--help"
+        print_help
+        exit 0
+    end
+  end
+
+rescue => se
+  STDERR.print "#{$prg}: ",se.message,"\n"
+  exit 1
+end # rescue options
+
+#
+# option checking
+#
+case $mode
+  when FIND
+    if $bc.nil?
+      STDERR.puts "--find without --bank-code, not an easy task -- aborted"
+      exit 4
+    end
+  when CHECK
+    if $bc.nil?
+      STDERR.puts "--check without --bank-code, not an easy task -- aborted"
+      exit 4
+    end
+    if $an.nil?
+      STDERR.puts "--check without --account-no, not an easy task -- aborted"
+      exit 4
+    end
+  else
+    print_help
+    exit 4
+end
+
+#
+#
+# the "program"
+#
+#
+begin
+
+  KtoBlzCheck.new($df) do |kbc|
+    case $mode
+      when FIND
+        name,location=kbc.find($bc)
+        if name
+          puts "Found #{name} located in #{location}"
+        else
+          puts "No bank found for bank code #{$bc}"
+        end
+      when CHECK
+        case kbc.check($bc,$an)
+          when KtoBlzCheck::OK
+            puts "Valid bank code / account number combination" if $verbose
+          when KtoBlzCheck::ERROR
+            puts "Failed bank code / account number combination not valid" if $verbose
+            $ec=1
+          when KtoBlzCheck::UNKNOWN
+            puts "Couldn't check input for unknown reasons (shit happens)" if $verbose
+            $ec=2
+          when KtoBlzCheck::BANK_NOT_KNOWN
+            puts "Unknown bank for bank code #{bc}" if $verbose
+            $ec=3
+          else
+            puts "Funny, that you see this message. Something went terribly wrong." if $verbose
+            $ec=2
+        end # case kbc.check
+    end # case
+  end # new do
+
+rescue => se
+  STDERR.puts "#{$prg} error: "+se.message
+  exit 2
+end
+
+exit $ec

data/ext/extconf.rb

@@ -0,0 +1,13 @@
+require 'mkmf'
+if !have_header('ktoblzcheck.h')
+  STDERR.puts "Couldn't find header file ktoblzcheck.h. Install library files and try again\n"
+  STDERR.puts "Hint: visit http://ktoblzcheck.sourceforge.net to obtain a source distribution tar-ball or check the package archives of your distribution (e.g. for Debian `apt-get install libktoblzcheck1-dev`)"
+  exit 1
+end
+if !have_library('ktoblzcheck')
+  STDERR.puts "Couldn't find link library libktoblzcheck. Install library files and try again\n"
+  STDERR.puts "Hint: visit http://ktoblzcheck.sourceforge.net to obtain a source distribution tar-ball or check the package archives of your distribution (e.g. for Debian `apt-get install libktoblzcheck1-dev`)"
+  exit 1
+end
+dir_config('ktoblzcheck_ext')
+create_makefile('ktoblzcheck_ext')

data/ext/ktoblzcheck.c

@@ -0,0 +1,208 @@
+/***************************************************************************
+* 
+*  (c) 2004 Sascha Loetz (sloetz ( a t ) web.de). All rights reserved.
+*
+*
+*  Redistribution and use in source and binary forms of this software, with
+*  or without modification, are permitted provided that the following
+*  conditions are met:
+*  
+*  1. Redistributions of source code must retain any existing copyright
+*     notice, and this entire permission notice in its entirety,
+*     including the disclaimer of warranties.
+*  
+*  2. Redistributions in binary form must reproduce all prior and current
+*     copyright notices, this list of conditions, and the following
+*     disclaimer in the documentation and/or other materials provided
+*     with the distribution.
+*  
+*  3. The name of any author may not be used to endorse or promote
+*     products derived from this software without their specific prior
+*     written permission.
+*  
+*  ALTERNATIVELY, this product may be distributed under the terms of the
+*  GNU General Public License, in which case the provisions of the GNU
+*  GPL are required INSTEAD OF the above restrictions.  (This clause is
+*  necessary due to a potential conflict between the GNU GPL and the
+*  restrictions contained in a BSD-style copyright.)
+*  
+*  THIS SOFTWARE IS PROVIDED AS IS'' AND ANY EXPRESS OR IMPLIED
+*  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+*  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+*  IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT, INDIRECT,
+*  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+*  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+*  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+*  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+*  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
+*  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+*  DAMAGE.
+*************************************************************************
+* 
+* This file is part of the rbktoblzcheck package available as a gem
+* 
+* $Id: ktoblzcheck.c,v 1.1 2004/10/28 19:10:19 vdpsoftware Exp $
+*  
+*************************************************************************/
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <ruby.h>
+#include <ktoblzcheck.h>
+
+static VALUE g_error;
+static VALUE g_ktoblzcheck;
+static AccountNumberCheck* g_anc=NULL;
+
+#ifndef RUBY_19
+#ifndef RSTRING_PTR
+#define RSTRING_PTR(v) (RSTRING(v)->ptr)
+#endif
+#endif
+
+/*
+ * KtoBlzCheck#close 
+ */
+static VALUE close_anc(VALUE self)
+{
+	if (NULL!=g_anc) {
+		AccountNumberCheck_delete(g_anc);
+	} else {
+		rb_raise(g_error, "Already closed" ); 
+	}
+
+	return self;
+}
+
+/*
+ * KtoBlzCheck.new [ |block| ]
+ * KtoBlzCheck.new(datapath) [ |block| ]
+ */
+static VALUE init(int argc, VALUE *argv, VALUE self)
+{
+	VALUE dp=Qnil;
+	
+	rb_scan_args(argc,argv,"01",&dp);
+
+	
+	if (Qnil==dp) { /* no parameter given */
+		
+		g_anc=AccountNumberCheck_new();  
+		
+	} else { /* a path to a different data path was passed to method */
+		
+		Check_Type(dp,T_STRING);
+		
+		/*
+		 * The libktoblzcheck constructor writes an error
+		 * message to stderr if the given data filen can not
+		 * be accessed :( Additionally, we don't get a proper
+		 * return value which could be used to test for success
+		 * (it's a C++ constructor that we are calling). Even a
+		 * successful intialization (i.e. we get a pointer != NULL
+		 * from AccountNumberCheck_new_file doesn't mean that the
+		 * opened file is a valid data file).
+		 *
+		 * We do basic access checking ourselves and hope for the best :)
+		 */
+
+		if (0!=access(RSTRING_PTR(dp),R_OK)) {
+			rb_raise(g_error,"Can't access file %s",RSTRING_PTR(dp));
+		}
+		g_anc=AccountNumberCheck_new_file(RSTRING_PTR(dp));
+	}
+
+	/*
+	 * did we successfully obtain an AccountNumberCheck handle?
+	 */
+
+	if (NULL==g_anc) {
+		rb_raise(g_error,"Couldn't initialize libktoblzcheck");
+		return Qnil;
+	}
+
+	/*
+	 * block syntax
+	 *
+	 * KtoBlzCheck.new do |kbc| ... end
+	 */
+
+	if (rb_block_given_p()) {
+		return rb_ensure(rb_yield, self, close_anc, self);
+	} else {
+	 	return self;
+	}
+}
+
+/*
+ * 
+ * KtoBlzCheck#check(bank_code,account_no)
+ *
+ */
+static VALUE check(VALUE self, VALUE blz, VALUE account)
+{
+	AccountNumberCheck_Result res;
+
+	Check_Type(blz,T_STRING);
+	Check_Type(account,T_STRING);
+
+	/*
+	 * OK = 0,
+	 * UNKNOWN = 1,
+	 * ERROR = 2,
+	 * BANK_NOT_KNOWN = 3
+	 */ 
+
+	res=AccountNumberCheck_check(g_anc,RSTRING_PTR(blz),RSTRING_PTR(account));
+
+	return INT2FIX(res);
+
+}
+
+/*
+ *
+ * KtoBlzCheck.num_records
+ *
+ */
+static VALUE num_records(VALUE self)
+{
+	return INT2FIX(AccountNumberCheck_bankCount(g_anc));
+}
+
+/*
+ *
+ * KtoBlzCheck.find(bank_code)
+ *
+ */
+static VALUE find_info(VALUE self, VALUE blz)
+{
+	VALUE ret=rb_ary_new2(2);
+	Check_Type(blz, T_STRING);
+	
+	const AccountNumberCheck_Record* cr=AccountNumberCheck_findBank(g_anc,RSTRING_PTR(blz));
+
+	if (NULL!=cr) {
+		rb_ary_push(ret,rb_str_new2(AccountNumberCheck_Record_bankName(cr)));
+		rb_ary_push(ret,rb_str_new2(AccountNumberCheck_Record_location(cr)));
+	}
+	
+	return ret;
+}
+
+/*
+ * Ruby extension stuff
+ */
+void Init_ktoblzcheck_ext()
+{
+	g_ktoblzcheck = rb_define_module("KtoBlzCheck");
+	g_error = rb_define_class_under(g_ktoblzcheck, "Error", rb_eStandardError);
+	rb_define_method(g_ktoblzcheck, "initialize", init, -1);
+	rb_define_method(g_ktoblzcheck, "check", check, 2 );
+	rb_define_method(g_ktoblzcheck, "num_records", num_records, 0 );
+	rb_define_method(g_ktoblzcheck, "close", close_anc, 0);
+	rb_define_method(g_ktoblzcheck, "find", find_info, 1 );
+	rb_define_const(g_ktoblzcheck, "OK", INT2FIX(0));
+	rb_define_const(g_ktoblzcheck, "UNKNOWN", INT2FIX(1));
+	rb_define_const(g_ktoblzcheck, "ERROR", INT2FIX(2));
+	rb_define_const(g_ktoblzcheck, "BANK_NOT_KNOWN", INT2FIX(3));
+}

data/lib/ktoblzcheck.rb

@@ -0,0 +1,5 @@
+require 'ktoblzcheck_ext'
+
+module KtoBlzCheck
+  extend self
+end

data/rbktoblzcheck.gemspec

@@ -0,0 +1,51 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rbktoblzcheck}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Sascha Loetz", "Kim Rudolph"]
+  s.date = %q{2010-07-20}
+  s.default_executable = %q{kbc-ruby}
+  s.email = %q{kim.rudolph@web.de}
+  s.executables = ["kbc-ruby"]
+  s.extensions = ["ext/extconf.rb"]
+  s.files = [
+    "LICENSE",
+     "README",
+     "Rakefile",
+     "VERSION.yml",
+     "bin/kbc-ruby",
+     "ext/extconf.rb",
+     "ext/ktoblzcheck.c",
+     "lib/ktoblzcheck.rb",
+     "rbktoblzcheck.gemspec",
+     "test/test-bankdata.txt",
+     "test/test-ktoblzcheck-all.rb",
+     "test/test-ktoblzcheck.rb"
+  ]
+  s.homepage = %q{http://github.com/krudolph/rbktoblzcheck}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib", "ext"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{rbktoblzcheck is an interface for libktoblzcheck, a library to check German account numbers and bank codes. See http://ktoblzcheck.sourceforge.net for details.}
+  s.test_files = [
+    "test/test-ktoblzcheck-all.rb",
+     "test/test-ktoblzcheck.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/test/test-bankdata.txt

@@ -0,0 +1,158 @@
+10000000	09	Bundesbank	Berlin
+10010010	24	Postbank	Berlin
+10010111	13	SEB	Berlin
+10010222	10	ABN AMRO Bank Ndl Deutschland	Berlin
+10010424	09	Aareal Bank	Berlin
+10020000	69	Berliner Bank Ndl d Landesbank Berlin	Berlin
+10020100	09	Riggs Bank Europe	Berlin
+10020200	60	ING BHF-BANK	Berlin
+10020500	09	Sozialbank	Berlin
+10020890	99	Bayer Hypo- und Vereinsbank	Berlin
+10022200	69	Bankgesellschaft Berlin	Berlin
+10030200	09	Berlin-Hannoversche Hypothekenbank	Berlin
+10030400	09	ABK-Kreditbank	Berlin
+10030500	09	Bankhaus L�bbecke Ndl Berlin, Fasanenstra�e	Berlin
+10030600	09	Bankhaus Oswald Kruber	Berlin
+10030700	16	Gries & Heissel - Bankiers	Berlin
+10040000	13	Commerzbank Berlin (West)	Berlin
+10045050	13	Commerzbank Service-BZ	Berlin
+10050000	20	Landesbank Berlin -Gz- zgl Berliner Sparkasse	Berlin
+10050001	20	Landesbank Berlin -Girozentrale-	Berlin
+10050005	09	Landesbank Berlin -Girozentrale- E 1	Berlin
+10050006	09	Landesbank Berlin -Girozentrale- E 2	Berlin
+10050500	09	LBS Ost Berlin	Berlin
+10050600	08	WestLB Berlin	Berlin
+10050999	09	DekaBank Berlin	Berlin
+10060198	06	Pax-Bank	Berlin
+10060237	33	Evangelische Darlehnsgenossenschaft	Berlin
+10070000	63	Deutsche Bank Fil Berlin	Berlin
+10070024	63	Deutsche Bank Privat und Gesch�ftskunden F 700	Berlin
+10070989	63	Eurohypo Ndl DB	Berlin
+10080000	76	Dresdner Bank zgl f Bank f Handel u Industrie	Berlin
+10080005	76	Dresdner Bank Zw A	Berlin
+10080006	76	Dresdner Bank Zw B	Berlin
+10080088	76	Dresdner Bank Berlin Bs 88	Berlin
+10080090	76	Dresdner Bank Gf Berlin	Berlin
+10080900	76	Dresdner Bank Otto Scheurmann	Berlin
+10089260	09	Dresdner Bank ITGK	Berlin
+10090000	06	Berliner Volksbank	Berlin
+10090300	09	Bank f�r Schiffahrt (BFS) Fil d Ostfr VB Leer	Berlin
+10090400	09	Deutsche Genossenschafts-Hypothekenbank	Berlin
+10090603	14	Deutsche Apotheker- und �rztebank	Berlin
+20000000	09	Bundesbank	Hamburg
+20010020	24	Postbank (Giro)	Hamburg
+20010111	13	SEB	Hamburg
+20010200	09	HSH Nordbank Hypo	Hamburg
+20010424	09	Aareal Bank	Hamburg
+20010800	09	Hanseatische i-Bank	Hamburg
+20020200	09	SEB Merchant Bank Hamburg	Hamburg
+20020500	09	Jyske Bank Fil Hamburg	Hamburg
+20020860	70	Bayer Hypo- und Vereinsbank(ehem. Hypo)	Hamburg
+20020900	09	Signal Iduna Bauspar	Hamburg
+20030000	68	Vereins- und Westbank	Hamburg
+20030300	06	Donner Bank, C.H.	Hamburg
+20030400	00	Marcard, Stein & Co Bankiers	Hamburg
+20030500	06	Yapi Kredi Bank Deutschland	Hamburg
+20030600	09	Sydbank Fil Hamburg	Hamburg
+20030700	10	Merck Finck & Co	Hamburg
+20030900	06	Bankhaus W�lbern & Co	Hamburg
+20040000	13	Commerzbank	Hamburg
+30000000	09	Bundesbank	D�sseldorf
+30010111	13	SEB	D�sseldorf
+30010200	09	AEGON Bank	D�sseldorf
+30010400	09	IKB Deutsche Industriebank	D�sseldorf
+30010700	09	Bank of Tokyo-Mitsubishi, The -	D�sseldorf
+30010900	09	Nationalbank von Griechenland Fil D�sseldorf	D�sseldorf
+30020000	32	Westfalenbank	D�sseldorf
+30020300	10	Comfort Card Services	Ratingen
+30020400	00	Falke Bank	D�sseldorf
+30020500	60	ING BHF-BANK	D�sseldorf
+30020700	09	Mizuho Corporate Bank Ltd Fil D�sseldorf	D�sseldorf
+30020800	06	Commercial Bank of Greece (Germany)	D�sseldorf
+30020900	57	Citibank Privatkunden	D�sseldorf
+30020941	57	Citibank Privatkunden Region M�nchen	M�nchen
+30020944	57	Citibank Privatkunden Region Duisburg	Duisburg
+30020945	57	Citibank Privatkunden Region Hannover	Hannover
+30020946	57	Citibank Privatkunden Region Mannheim	Mannheim
+30020947	57	Citibank Privatkunden Region Gelsenkirchen	Gelsenkirchen
+30020948	57	Citibank Privatkunden Region Hamburg	Hamburg
+30020949	57	Citibank Privatkunden Region K�ln	K�ln
+30030100	56	SBroker	Wiesbaden
+30030880	56	HSBC Trinkaus & Burkhardt	D�sseldorf
+30030900	00	Merck Finck & Co	D�sseldorf
+30040000	13	Commerzbank	D�sseldorf
+30050000	08	WestLB D�sseldorf	D�sseldorf
+30050110	00	Stadtsparkasse D�sseldorf	D�sseldorf
+30052525	08	Landesbank NRW D�sseldorf	D�sseldorf
+30055500	09	dwpbank	D�sseldorf
+30060010	44	Westdeutsche Genossenschafts-Zentralbank	D�sseldorf
+30060601	14	Deutsche Apotheker- und �rztebank Ndl	D�sseldorf
+30060992	91	PSD Bank Rhein-Ruhr	D�sseldorf
+30070010	63	Deutsche Bank	D�sseldorf
+30070024	63	Deutsche Bank Privat und Gesch�ftskunden	D�sseldorf
+30070989	63	Eurohypo Ndl DB	D�sseldorf
+30080000	76	Dresdner Bank	D�sseldorf
+30080005	76	Dresdner Bank Zw 05	D�sseldorf
+30080022	76	Dresdner Bank Ztv 22	D�sseldorf
+30080038	76	Dresdner Bank Zw 38	D�sseldorf
+40000000	09	Bundesbank	M�nster, Westf
+40010111	13	SEB	M�nster, Westf
+40030000	61	M�nsterl�ndische Bank Thie & Co	M�nster, Westf
+40040028	13	Commerzbank	M�nster, Westf
+40050000	08	WestLB M�nster	M�nster, Westf
+40050150	00	Sparkasse M�nsterland Ost	M�nster, Westf
+40051475	00	Sparkasse Warendorf -alt-	Warendorf
+40052525	08	Landesbank NRW M�nster	M�nster, Westf
+40060000	44	Westdeutsche Genossenschafts-Zentralbank	M�nster, Westf
+40060104	34	DGM Ev Darlehns-Genossenschaft -alt-	M�nster, Westf
+40060265	34	DKM Darlehnskasse M�nster	M�nster, Westf
+40060300	09	Westf�lische Landschaft Bodenkreditbank	M�nster, Westf
+50000000	09	Bundesbank	Frankfurt am Main
+50010060	24	Postbank	Frankfurt am Main
+50010111	13	SEB	Frankfurt am Main
+50010200	09	Akbank T.A.S. Ndl Deutschland	Frankfurt am Main
+50010424	09	Aareal Bank	Frankfurt am Main
+50010517	09	Allgemeine Deutsche Direktbank	Frankfurt am Main
+50010700	09	Degussa Bank	Frankfurt am Main
+50010800	09	DEPFA Deutsche Pfandbriefbank	Frankfurt am Main
+50010900	09	Bank of America	Frankfurt am Main
+50012800	09	Alte Leipziger Bauspar	Bad Homburg v d H�he
+50020160	70	Bayer Hypo- und Vereinsbank Ndl 427	Aschheim
+50020200	60	ING BHF-BANK	Frankfurt am Main
+60000000	09	Bundesbank	Stuttgart
+60010070	24	Postbank	Stuttgart
+60010111	13	SEB	Stuttgart
+60010424	09	Aareal Bank	Stuttgart
+60010500	09	W�rttembergische Hypothekenbank	Stuttgart
+60010600	09	Nationalbank von Griechenland Fil Stuttgart	Stuttgart
+60010700	09	Landeskreditbank Baden-W�rttemberg F�rderbank	Stuttgart
+60020030	65	Baden-W�rttembergische Bank	Stuttgart
+60020100	09	Schw�bische Bank	Stuttgart
+60020290	99	Bayer Hypo- und Vereinsbank	Stuttgart
+60020300	09	VON ESSEN Bankgesellschaft	Stuttgart
+60020400	09	GE Bank	K�ln
+70000000	09	Bundesbank	M�nchen
+70010080	24	Postbank (Giro)	M�nchen
+70010111	13	SEB	M�nchen
+70010424	09	Aareal Bank	M�nchen
+70010500	09	Hypo Real Estate Bank M�nchen	M�nchen
+70011000	09	HSH Nordbank Hypo	Hamburg
+70011200	09	Bank Vontobel �sterreich	M�nchen
+80000000	09	Bundesbank	Halle (Saale)
+80020086	99	Bayer Hypo- und Vereinsbank	Halle (Saale)
+80020087	99	Bayer Hypo- und Vereinsbank	Dessau, Anh
+80020130	65	Baden-W�rttembergische Bank	Halle (Saale)
+80040000	13	Commerzbank	Halle (Saale)
+80050500	20	Kreissparkasse Merseburg-Querfurt	Merseburg
+80053000	20	Sparkasse Burgenlandkreis	Zeitz, Elster
+80053502	52	Kreissparkasse Quedlinburg	Quedlinburg
+80053522	52	Kreissparkasse Aschersleben	Aschersleben, Sachs-Anh
+80053552	52	Kreissparkasse Sangerhausen	Sangerhausen
+87080000	76	Dresdner Bank	Chemnitz, Sachs
+87095824	06	Volksbank Vogtland	Plauen, Vogtl
+87095934	06	Volksbank Zwickau	Zwickau
+87095974	06	Volksbank-Raiffeisenbank Glauchau	Glauchau
+87096034	06	Volksbank Erzgebirge	Annaberg-Buchholz
+87096074	06	Freiberger Bank	Freiberg, Sachs
+87096124	06	Volksbank	Mittweida
+87096214	06	Volksbank Chemnitz	Chemnitz, Sachs

data/test/test-ktoblzcheck-all.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+#
+# Test program for rbktoblzcheck Ruby extension:
+#
+# Reads all bank codes from an ktoblzcheck data file
+# and checks them against the same file using the Ruby
+# bindings for libktoblzecheck.
+#
+# Path to data file must be given as command line parameter.
+#
+# (c) 2004 Sascha Loetz (sloetz ( a t ) web.de)
+#
+# See LICENSE for the BSD-style license for this code.
+#
+# This file is part of the rbktoblzcheck package
+# available at http://www.vdp-software.com/Rbktoblzcheck.html
+#
+# $Id: test-ktoblzcheck-all.rb,v 1.1 2004/10/28 19:10:19 vdpsoftware Exp $
+
+
+require 'ktoblzcheck'
+
+$failed=0
+$ok=0
+
+if ARGV[0].nil?
+  STDERR.puts "Usage: #{File.basename($0)} /path/to/bankdata.file"
+  exit(2)
+end
+
+KtoBlzCheck.new(ARGV[0]) do |kbc|
+  File.open(ARGV[0],"r") do |df|
+    while line=df.gets
+      blz,algo,name,location=line.chomp.split("\t");
+      res=kbc.find(blz.to_s)
+      print "File: #{blz} / #{name} / #{location} => KtoBlzCheck name: #{res[0]} location: #{res[1]} ==> "
+      if res[0]==name and res[1]==location
+        print "OK\n"
+        $ok+=1
+      else
+        print "FAILED\n"
+        $failed+=1
+      end
+    end # while
+  end # File.open
+end # new
+
+print "\n\nResult:\nLines checked: #{$ok+$failed}\nOK: #{$ok}\nFailure: #{$failed}\n"
+
+exit(1) if $failed>0

data/test/test-ktoblzcheck.rb

@@ -0,0 +1,65 @@
+#!/usr/bin/env ruby
+#
+# Test program for rbktoblzcheck Ruby extension:
+#
+# Checks some bank codes with both initialisation modes
+# for KtoBlzCheck.
+#
+# (c) 2004 Sascha Loetz (sloetz ( a t ) web.de)
+#
+# See LICENSE for the BSD-style license for this code.
+#
+# This file is part of the rbktoblzcheck package
+# available at http://www.vdp-software.com/Rbktoblzcheck.html
+#
+# $Id: test-ktoblzcheck.rb,v 1.1 2004/10/28 19:10:19 vdpsoftware Exp $
+
+require 'ktoblzcheck'
+
+# file with testdata
+$df='test-bankdata.txt'
+# some bank codes to ck, all listed in the test data file
+$find=[20040000,30020947,40050150,50012800,60020300,70010500,80053552,87096124]
+
+# exit code
+$ec=0
+
+#
+# Use block syntax
+#
+print "\nUsing block syntax...\n"
+KtoBlzCheck.new($df) do |kbc|
+  print "\nCurrently #{kbc.num_records} records available in the database\n"
+  $find.each do |bc|
+    res=kbc.find(bc.to_s)
+    if nil==res[0]
+      print "Couldn't find bank code #{bc}\n"
+      $ec=1
+    else
+      print "Bank code #{bc} => bank name: #{res[0]} / location (city): #{res[1]}\n"
+    end
+  end # each
+end # do
+
+#
+# Use "normal" syntax
+#
+# IMPORTANT: you must call #close when your finished,
+#            otherwise resource leaks may occur.
+#
+print "\nUsing 'normal' syntax...\n"
+$kbc=KtoBlzCheck.new($df)
+print "\nCurrently #{$kbc.num_records} records available in the database\n"
+$find.each do |bc|
+    res=$kbc.find(bc.to_s)
+    if nil==res[0]
+      print "Couldn't find bank code #{bc}\n"
+      $ec=1
+    else
+      print "Bank code: #{bc} => name: #{res[0]} / location (city): #{res[1]}\n"
+    end
+end # do
+
+$kbc.close
+
+exit $ec

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: rbktoblzcheck
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Sascha Loetz
+- Kim Rudolph
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-20 00:00:00 +02:00
+default_executable: kbc-ruby
+dependencies: []
+
+description: 
+email: kim.rudolph@web.de
+executables: 
+- kbc-ruby
+extensions: 
+- ext/extconf.rb
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- README
+- Rakefile
+- VERSION.yml
+- bin/kbc-ruby
+- ext/extconf.rb
+- ext/ktoblzcheck.c
+- lib/ktoblzcheck.rb
+- rbktoblzcheck.gemspec
+- test/test-bankdata.txt
+- test/test-ktoblzcheck-all.rb
+- test/test-ktoblzcheck.rb
+has_rdoc: true
+homepage: http://github.com/krudolph/rbktoblzcheck
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+- ext
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: rbktoblzcheck is an interface for libktoblzcheck, a library to check German account numbers and bank codes. See http://ktoblzcheck.sourceforge.net for details.
+test_files: 
+- test/test-ktoblzcheck-all.rb
+- test/test-ktoblzcheck.rb