kontocheck 0.0.6

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/CHANGES

@@ -0,0 +1,16 @@
+important changes in version 0.0.3:
+
+   - Function konto_check: the order of parameters changed:
+     konto_check(blz,kto) instead of konto_check(kto,blz)
+
+   - The function load_bank_data will go away; instead a new function
+     konto_check::init() is provided which reads directly a lut file.
+     This function is much faster (about 7..25 times, depending on the
+     blocks to load) and has some more advantages.
+
+   - This version can be compiled for Ruby 1.8 and 1.9
+
+   - some new functions give access to all fields of the bank file:
+     bank_{name|name_kurz|plz|ort|pan|bic|nr|pz|aenderung|loeschung|nachfolge_blz}()
+
+   - for documentation, RTFS. Later some more documentation will be added ;-)

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2010 Provideal Systems GmbH
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+ACKNOWLEDGEMENT
+
+This software is entirely based on the C library konto_check
+http://www.informatik.hs-mannheim.de/konto_check/
+http://sourceforge.net/projects/kontocheck/
+by Michael Plugge.

data/README.textile

@@ -0,0 +1,61 @@
+h1. KontoCheck
+
+Check whether a certain bic/account-no-combination can possibly be valid for a German bank.
+
+It uses the C library konto_check (see http://sourceforge.net/projects/kontocheck/) by
+Michael Plugge.
+
+h2. Example
+
+An example tends to tell more than a 1000 words:
+
+<pre>
+>> require "konto_check"
+true
+
+>> KontoCheck::init("./blz.lut")
+true
+
+# konto_check?(blz, ktno) => true/false (valid/invalid)
+>> KontoCheck::konto_check?("52250030", "52001")
+true
+
+>> KontoCheck::konto_check?("52250030", "52002")
+false
+
+# ISO-8859-1 encoded name of bank
+>> KontoCheck::bank_name("10010010")
+"Postbank"
+
+# there is more, RTFS or wait for/help creating more examples...
+</pre>
+
+h2. Short 'Documentation'
+
+h3. <tt>KontoCheck::konto_check?(&lt;blz&gt;, &lt;kto&gt;)</tt>
+
+check whether the given account number <tt>kto</tt> can possibly be
+a valid number of the bank with the bic <tt>blz</tt>.
+
+h3. <tt>KontoCheck::init(&lt;lut_file&gt;)</tt>
+
+initialize the underlying C library konto_check with bank
+information from the LUT file <tt>lut_file</tt>.
+The LUT file can be created from the plain text file
+found at: http://www.bundesbank.de/zahlungsverkehr/zahlungsverkehr_bankleitzahlen_download.php
+This file is updated every three months, so be sure to
+replace (and regenerate) it regularly.
+
+There will be a rake task to update the LUT file soon.
+
+h3. <tt>KontoCheck::bank_name(&lt;blz&gt;)</tt>
+
+returns the name of the bank as a (ISO-8859-1 encoded)
+string or raises a runtime error with a short error message
+if an error occurred (invalid blz, blz too short, etc.).
+This may be changed in the future to simply return nil (should be discussed).
+
+h2. License
+
+Since the original http://www.informatik.hs-mannheim.de/konto_check/ is
+licensed under LGPL, so is this module.

data/Rakefile

@@ -0,0 +1,72 @@
+# Copyright (c) 2010 Provideal Systems GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require 'rubygems'
+require 'rake'
+require 'rake/extensiontask'
+
+Rake::ExtensionTask.new('kontocheck')
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "kontocheck"
+    gem.summary = %Q{Checking german BICs/Bank account numbers}
+    gem.description = %Q{Check whether a certain bic/account-no-combination can possibly be valid. It uses the C library konto_check (see http://sourceforge.net/projects/kontocheck/) by Michael Plugge.}
+    gem.email = "jan@general-scripting.com"
+    gem.homepage = "http://github.com/jeanmartin/konto_check"
+    gem.authors = ["Provideal Systems GmbH","Michael Plugge","Jan Schwenzien"]
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    #gem.files.exclude "ext"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "konto_check #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION.yml

@@ -0,0 +1,5 @@
+--
+:major: 0
+:minor: 0
+:patch: 6
+

data/ext/konto_check_raw/extconf.rb

@@ -0,0 +1,32 @@
+# Copyright (c) 2010 Provideal Systems GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+# Loads mkmf which is used to make makefiles for Ruby extensions
+require 'mkmf'
+
+# Give it a name
+extension_name = 'konto_check_raw'
+
+if have_library("z", "uncompress")
+  # The destination
+  dir_config(extension_name)
+
+  # Do the work
+  create_makefile(extension_name)
+else
+  puts("Sadly, I can't find zlib. But I need it to compile. :(")
+end
+