king_dtaus 1.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+nbproject/*
+coverage/*
+rdoc/*
+pkg/*

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 [Georg Leciejewski SalesKing GmbH]
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,32 @@
+= Dtaus
+
+DTAUS is a format for german bank transfers and is short for 
+"Datenträgeraustausch". The format itself totally sucks because it was 
+established in the last century, to be used on floppy disks. Still almost 
+all german banks use it(they only seem innovative at robbing), and it is 
+therefore supported in common banking programs too.
+
+This gem saves you all the trouble when generating dtaus-text. 
+
+== Install
+
+gem install king_dtaus
+
+== Features
+
+
+
+== Example 
+
+TODO - read the specs
+
+
+== Credits
+
+This gem used https://rubygems.org/gems/DTAUS as a starting point. 
+It was disected, turned into a real class structure, bugs where fixed and 
+of course a full test suite ensures its functionality.
+
+Copyright (c) 2009-2010 Georg Leciejewski, 
+Bugfixes and enhancements by Georg Ledermann 
+released under the MIT license

data/Rakefile

@@ -0,0 +1,46 @@
+require 'rake'
+require 'rake/rdoctask'
+require 'spec/rake/spectask'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+spec_files = Rake::FileList["spec/**/*_spec.rb"]
+
+desc "Run specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = spec_files
+  t.spec_opts = ["-c"]
+end
+
+desc "Generate code coverage"
+Spec::Rake::SpecTask.new(:coverage) do |t|
+  t.spec_files = spec_files
+  t.rcov = true
+  t.rcov_opts = ['--exclude', 'spec,/var/lib/gems']
+end
+
+desc 'Generate documentation'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'dtaus'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "king_dtaus"
+    gem.summary = %Q{Generate DTAUS strings and files}
+    gem.description = %Q{DTAUS is a text-based format, to create bank transfers for german banks. This gem helps with the creation of those transfer files.}
+    gem.email = "gl@salesking.eu"
+    gem.homepage = "http://github.com/salesking/king_dtaus"
+    gem.authors = ["Georg Leciejewski", "Georg Ledermann"]
+    # 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

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/init.rb

@@ -0,0 +1 @@
+require "#{File.dirname(__FILE__)}/lib/king_dtaus"

data/lib/king_dta/account.rb

@@ -0,0 +1,18 @@
+module KingDta
+	#Kontodaten verwalten mit Name des Inhabers und Bank, Bankleitzahl und Kontonummer.
+	class Account
+    include KingDta::Helper
+		# dta~ jeweilige Feld in DTAUS-Norm
+		attr_reader	:bank_account_number, :bank_number, :owner, :kunnr, :dtakunnr
+		def initialize( ban, bank_number, owner, kunnr="" )
+			@bank_account_number = ban.kind_of?( Integer ) ? ban : ban.gsub(/\s/, '').to_i
+			@bank_number  = bank_number.kind_of?( Integer ) ? bank_number :  bank_number.gsub(/\s/, '').to_i
+			@owner= convert_text( owner )
+			@kunnr	= kunnr.gsub(/\s/, '').to_i
+			raise "Invalid bank account number #{ban}"	if @bank_account_number	== 0
+			raise "BLZnummer #{bank_number} ungültig"		if @bank_number	== 0
+			raise "Invalid account owner #{owner}"	unless @owner.kind_of?(String)
+#			@dtakunnr	= convert_text( @kunnr )
+		end		
+	end		
+end

data/lib/king_dta/booking.rb

@@ -0,0 +1,47 @@
+module KingDta
+	class Booking
+    include KingDta::Helper
+    
+    # Die am häufigsten benötigten Textschlüssel
+    LASTSCHRIFT_ABBUCHUNG            = '04000'
+    LASTSCHRIFT_EINZUGSERMAECHTIGUNG = '05000'
+    UEBERWEISUNG_GUTSCHRIFT          = '51000'
+
+    attr_reader :value, :account, :text, :schluessel
+		#Eine Buchung ist definiert durch:
+		#- Konto (siehe Klasse Konto
+		#- Betrag
+		#	Der Betrag kann , oder . als Dezimaltrenner enthalten.
+		#- optional Buchungstext
+		def initialize( account, value, text=nil, schluessel=nil )
+      raise "Hey, a booking should have an Account" unless account.kind_of?( Account )
+			@account = account
+			@text  = text ? convert_text( text ) : text
+			@schluessel = schluessel
+			if value.is_a?(String)
+				value = BigDecimal.new value.sub(',', '.')
+			elsif value.is_a?(Numeric)
+			  value = BigDecimal.new value.to_s
+			else
+				raise "Übergabefehler: Betrag ist kein String/Numeric"
+			end
+			value = ( value * 100 ).to_i	#€-Cent
+			if value == 0
+				raise "Booking Value is 0"
+			elsif value > 0
+				@value	= value
+				@pos	= true
+			else
+				@value	= - value
+				@pos	= false
+			end
+		end
+    
+    def text=(text)
+       @text = convert_text( text )
+    end
+
+		def pos?; @pos end
+
+	end	#class Buchung
+end	#module dtaus

data/lib/king_dta/dtaus.rb

@@ -0,0 +1,308 @@
+#Erstelle eine DTAUS-Datei.
+#Typ ist 'LK' (Lastschrift Kunde) oder 'GK' (Gutschrift Kunde)
+#
+#Infos zu DTAUS: http://www.infodrom.org/projects/dtaus/dtaus.php3
+#
+#Die Methoden müssen in der Reihenfolge:
+#- account	(definieren des eigenen Kontos)
+#- bookings
+#- dtaDatei/begleitblatt
+#abgearbeitet werden.
+#
+#Kontodaten verwalten mit Name des Inhabers und Bank, Bankleitzahl und Kontonummer.
+module KingDta
+  class Dtaus
+    include KingDta::Helper
+    attr_reader :sum_bank_account_numbers, :sum_bank_numbers, :sumBetrag, :default_text
+
+    #Zieldatei und Datum der Datei werden definiert
+    # ==== Parameter
+    def initialize( typ, datum=Date.today )
+      raise "Wrong date format. Make it a Time or Date object with yyyy-mm-dd" unless datum.respond_to?(:strftime)
+      raise "Unknown order type: #{typ}. Allowed Values are LK, GK" unless ['LK','GK'].include?(typ)
+      @datum 		= datum
+      @typ		= typ
+      @value_pos	= true	#alle Beträge sind positiv. Variable wird mit erstem Eintrag geändert      
+      @closed		= false
+      @default_text = '' # default verwendungzweck
+    end
+    
+    #	Übergabe der eigenen Kontodaten als Objekt der Klasse Konto
+    def account=( account )
+      raise "Come on i need an Account object" unless account.kind_of?( Account )
+      @account = account
+    end
+
+    # The dtaus format as string. all data is appended to it during creation
+    def dta_string
+      @dta_string ||= ''
+    end
+    def bookings
+      @bookings ||= []
+    end
+    # default text used on all bookings with emtpy text
+    def default_text=(text='')
+      @default_text = convert_text( text )
+    end
+
+    #Eine Buchung hinzufügen. Es wird geprüft, ob das Vorzeichen identisch mit den bisherigen Vorzeichen ist.
+    def add ( booking )
+      raise "The file has alreay been closed, cannot add new booking" if @closed
+      #Die erste Buchung bestimmt, ob alle Beträge positiv oder negativ sind.
+      #alle Beträge sind positiv. Variable wird mit erstem Eintrag geändert
+      @value_pos	= booking.pos?	if bookings.empty? == []
+      raise "The prefix within bookings changed from #{@value_pos} to #{booking.pos?}" if @value_pos != booking.pos?
+      bookings << booking
+    end
+
+    # Creates the whole dta string(in the right order) and returns it
+    def create
+      raise "Cannot create DTAUS without bookings" if bookings.empty?
+      @closed = true
+      # cleanup before we start
+      @dta_string = dta_string.empty? ? dta_string : ''
+      set_checksums
+      add_a
+      bookings.each{ |b| add_c( b) }
+      add_e
+      dta_string
+    end
+
+    def set_checksums
+      @sum_bank_account_numbers, @sum_bank_numbers, @sumBetrag	= 0,0,0 
+      bookings.each do |b|
+        @sum_bank_account_numbers	+= b.account.bank_account_number
+        @sum_bank_numbers   += b.account.bank_number
+        @sumBetrag+= b.value
+      end
+    end
+
+    #Create a DTA-File
+    def create_file(filename ='DTAUS0.TXT')
+      file = open( filename, 'w')
+      file	<< create
+      file.close()
+      print "#{filename} erstellt , #{@bookings.size} Einträge\n"
+    end
+
+
+    #Erstellen A-Segment der DTAUS-Datei
+    #Aufbau des Segments:
+    # Nr.	Start	Länge 		Beschreibung
+    # 1 	0  		4 Zeichen  	Länge des Datensatzes, immer 128 Bytes, also immer "0128"
+    # 2 	4  		1 Zeichen  	Datensatz-Typ, immer 'A'
+    # 3 	5  		2 Zeichen  	Art der Transaktionen
+    #						"LB" für Lastschriften Bankseitig
+    #						"LK" für Lastschriften Kundenseitig
+    #						"GB" für Gutschriften Bankseitig
+    #						"GK" für Gutschriften Kundenseitig
+    # 4 	7  		8 Zeichen  	Bankleitzahl des Auftraggebers
+    # 5 	15  	8 Zeichen  	CST, "00000000", nur belegt, wenn Diskettenabsender Kreditinstitut
+    # 6 	23  	27 Zeichen  Name des Auftraggebers
+    # 7 	50  	6 Zeichen  	aktuelles Datum im Format DDMMJJ
+    # 8 	56  	4 Zeichen  	CST, "    " (Blanks)
+    # 9 	60  	10 Zeichen  Kontonummer des Auftraggebers
+    # 10 	70  	10 Zeichen  Optionale Referenznummer
+    # 11a 80  	15 Zeichen  Reserviert, 15 Blanks
+    # 11b 95  	8 Zeichen  	Ausführungsdatum im Format DDMMJJJJ. Nicht jünger als Erstellungsdatum (A7), jedoch höchstens 15 Kalendertage später. Sonst Blanks.
+    # 11c 103  	24 Zeichen  Reserviert, 24 Blanks
+    # 12 	127  	1 Zeichen  	Währungskennzeichen
+    #						" " = DM
+    #						"1" = Euro
+    #    Insgesamt 128 Zeichen
+    def add_a
+      data = '0128'
+      data += 'A'				#Segment
+      data += @typ				#Lastschriften Kunde
+      data += '%8i' % @account.bank_number #.rjust(8)	#bank_number
+      data += '%08i' % 0                 #belegt, wenn Bank
+      data += '%-27.27s' % @account.owner
+      data += @datum.strftime("%d%m%y")	#aktuelles Datum im Format DDMMJJ
+      data += ' ' * 4  #bankinternes Feld
+      data += '%010i' % @account.bank_account_number
+      data += '%010i' % 0 #Referenznummer
+      data += ' '  * 15  #Reserve
+      data += '%8s' % @datum.strftime("%d%m%Y")	   #Ausführungsdatum (ja hier 8 Stellen, Erzeugungsdat. hat 6 Stellen)
+      data += ' ' * 24   #Reserve
+      data += '1'   #Kennzeichen Euro
+      raise "DTAUS: Längenfehler A (#{data.size} <> 128)\n" if data.size != 128
+      dta_string << data
+    end #dataA
+
+    #Erstellen C-Segmente (Buchungen mit Texten) der DTAUS-Datei
+    #Aufbau:
+    #	Nr.	St	Länge		Beschreibung
+    #	1 	0  	4 Zeichen  	Länge des Datensatzes, 187 + x * 29 (x..Anzahl Erweiterungsteile)
+    #	2 	4  	1 Zeichen  	Datensatz-Typ, immer 'C'
+    #	3 	5  	8 Zeichen  	Bankleitzahl des Auftraggebers (optional)
+    #	4 	13  8 Zeichen  	Bankleitzahl des Kunden
+    #	5 	21  10 Zeichen  Kontonummer des Kunden
+    #	6 	31  13 Zeichen  Verschiedenes
+    #			1. Zeichen: "0"
+    #			2. - 12. Zeichen: interne Kundennummer oder Nullen
+    #			13. Zeichen: "0"
+    #			Die interne Nummer wird vom erstbeauftragten Institut zum endbegünstigten Institut weitergeleitet. Die Weitergabe der internenen Nummer an den Überweisungsempfänger ist der Zahlstelle freigestellt.
+    #	7 	44  5 Zeichen  Art der Transaktion (7a: 2 Zeichen, 7b: 3 Zeichen)
+    #			"04000" Lastschrift des Abbuchungsauftragsverfahren
+    #			"05000" Lastschrift des Einzugsermächtigungsverfahren
+    #			"05005" Lastschrift aus Verfügung im elektronischen Cash-System
+    #			"05006" Wie 05005 mit ausländischen Karten
+    #			"51000" Überweisungs-Gutschrift
+    #			"53000" Überweisung Lohn/Gehalt/Rente
+    #			"5400J" Vermögenswirksame Leistung (VL) ohne Sparzulage
+    #			"5400J" Vermögenswirksame Leistung (VL) mit Sparzulage
+    #			"56000" Überweisung öffentlicher Kassen
+    #			Die im Textschlüssel mit J bezeichnete Stelle, wird bei Übernahme in eine Zahlung automatisch mit der jeweils aktuellen Jahresendziffer (7, wenn 97) ersetzt.
+    #	8 	49  1 Zeichen  Reserviert, " " (Blank)
+    #	9 	50  11 Zeichen  Betrag in DM
+    #	10 	61  8 Zeichen  Bankleitzahl des Auftraggebers
+    #	11 	69  10 Zeichen  Kontonummer des Auftraggebers
+    #	12 	79  11 Zeichen  Betrag in Euro einschließlich Nachkommastellen, nur belegt, wenn Euro als Währung angegeben wurde (A12, C17a), sonst Nullen
+    #	13 	90  3 Zeichen  Reserviert, 3 Blanks
+    #	14a 93  27 Zeichen  Name des Kunden
+    #	14b 120  8 Zeichen  Reserviert, 8 Blanks
+    #    Insgesamt 128 Zeichen
+    #
+    #	15 128  27 Zeichen  Name des Auftraggebers
+    #	16 155  27 Zeichen  Verwendungszweck
+    #	17a 182  1 Zeichen  Währungskennzeichen
+    #			" " = DM
+    #			"1" = Euro
+    #	17b 183  2 Zeichen  Reserviert, 2 Blanks
+    #	18 185  2 Zeichen  Anzahl der Erweiterungsdatensätze, "00" bis "15"
+    #	19 187  2 Zeichen  Typ (1. Erweiterungsdatensatz)
+    #			"01" Name des Kunden
+    #			"02" Verwendungszweck
+    #			"03" Name des Auftraggebers
+    #	20 189  27 Zeichen  Beschreibung gemäß Typ
+    #	21 216  2 Zeichen  wie C19, oder Blanks (2. Erweiterungsdatensatz)
+    #	22 218  27 Zeichen  wie C20, oder Blanks
+    #	23 245  11 Zeichen  11 Blanks
+    #	Insgesamt 256 Zeichen, kann wiederholt werden (max 3 mal)
+    # ==== Parameter
+    # booking<Object>::Booking object to be written to c-sektion
+    # ==== Returns
+    # <String>:: The current dta_string
+    def add_c( booking)
+      zahlungsart = if @typ == 'LK'
+                      booking.schluessel || Booking::LASTSCHRIFT_EINZUGSERMAECHTIGUNG
+                    elsif @typ == 'GK'
+                      booking.schluessel || Booking::UEBERWEISUNG_GUTSCHRIFT
+                    else
+                      raise 'Wrong booking type'
+                    end
+      #Extended segments Long name & booking texts
+      exts = []  #('xx', 'inhalt') xx: 01=Name 02=Verwendung 03=Name
+      # 1. Satzabschnitt
+      #data1 = '%4i' % ?? #Satzlänge kommt später
+      data1 = 'C'
+      data1 +=  '%08i' % 0  #freigestellt
+      data1 +=  '%08i' % booking.account.bank_number
+      data1 +=  '%010i' % booking.account.bank_account_number
+      data1 +=  '0%011i0' % booking.account.kunnr   #interne Kundennummer
+      data1 +=  zahlungsart
+      data1 +=  ' ' #bankintern
+      data1 +=  '0' * 11   #Reserve
+      data1 +=  '%08i' % @account.bank_number
+      data1 +=  '%010i' % @account.bank_account_number
+      data1 +=  '%011i' % booking.value #Betrag in Euro einschl. Nachkomma
+      data1 +=  ' ' * 3
+      data1 +=  '%-27.27s' % booking.account.owner #Name Begünstigter/Zahlungspflichtiger
+      exts << ['01', booking.account.owner[27..999] ] if booking.account.owner.size > 27
+      data1 +=  ' ' * 8
+      #Einfügen erst möglich, wenn Satzlänge bekannt
+
+      # 2. Satzabschnitt
+      data2 = "%27.27s" % @account.owner
+      zweck = booking.text || default_text
+      #Erste 27 Zeichen
+      #Wenn text < 26 Zeichen, dann mit spaces auffüllen.
+      data2 +=  zweck[0..26].ljust(27)
+      zweck = zweck[27..999]
+      # cur text into 27 long pieces
+      while zweck && zweck.size > 0 && exts.size < 13
+        exts << ['02', zweck.ljust(27) ]
+        zweck = zweck[27..999]
+      end
+      exts << ['03', @account.owner[27..999] ] if @account.owner.size > 27
+
+      data2 +=  '1'     #Währungskennzeichen
+      data2 +=  ' ' * 2
+      # Gesamte Satzlänge ermitteln ( data1(+4) + data2 + Erweiterungen )
+      data1 = "%04i#{data1}" % ( data1.size + 4 + data2.size+ 2 + exts.size * 29 )
+      raise "DTAUS: Längenfehler C/1 #{data1.size}, #{booking.account.name}" unless data1.size == 128
+      dta_string << data1
+      #Anzahl Erweiterungen anfügen
+      data2 +=  '%02i' % exts.size  #Anzahl Erweiterungsteile
+      #Die ersten zwei Erweiterungen gehen in data2,
+      #Satz 3/4/5 à 4 Erweiterungen  -> max. 14 Erweiterungen (ich ignoriere möglichen Satz 6)
+      exts  += [ ['00', "" ]  ] * (14 - exts.size)
+      #Die ersten zwei Erweiterungen gehen in data2,  wenn leer nur mit blanks als füllung
+      exts[0..1].each{|e| data2 +=  "%2.2s%-27.27s" % format_ext(e[0], e[1]) }
+      data2 +=  ' ' * 11
+      # add the final piece of the second C section
+      raise "DTAUS: Längenfehler C/2 #{data2.size}, #{booking.account.name}" if data2.size != 128
+      dta_string << data2
+      #Erstellen der Texterweiterungen à vier Stück
+      add_ext( exts[2..5] )
+      add_ext( exts[6..9] )
+      add_ext( exts[10..13] )
+      dta_string
+    end	#dataC
+
+    # Format an extension so it can be used in string substitution
+    # ==== Returns
+    # Array[String, String]::[Extesnsion type(01 02 03), 'text content ..']
+    def format_ext(type, content)
+      ext = ( type == '00' ) ? [' ', ' '] : [ type, convert_text(content) ]
+      ext
+    end
+
+    # Add a section-C extension, always containing the section type followed by
+    # 4 segments with 27 chars and an ending seperator of 12 blanks
+    # Only adds the segement if something is in there
+    # ==== Parameter
+    # <Array[Array[String,String]]>:: two dim. ary containing: [extension type(01 02 03),string content]
+    def add_ext( ext)
+      raise "Nur #{ext.size} Erweiterungstexte, 4 benötigt" if ext.size != 4
+      str =	"%2.2s%-27.27s" % format_ext(ext[0][0], ext[0][1] )
+      str +=	"%2.2s%-27.27s" % format_ext( ext[1][0], ext[1][1] )
+      str +=	"%2.2s%-27.27s" % format_ext( ext[2][0], ext[2][1] )
+      str +=	"%2.2s%-27.27s" % format_ext( ext[3][0], ext[3][1] )
+      # Trennzeichen 12 blanks
+      str += ' ' * 12
+      unless  str !~ /\S/ # only add if something is in there .. only whitespace => same as str.blank?
+        raise "DTAUS: Längenfehler C/3 #{str.size} " if str.size != 128
+        dta_string << str
+      end
+    end	#dataC
+
+    #Erstellen E-Segment (Prüfsummen) der DTAUS-Datei
+    #Aufbau:
+    #	Nr.	Start Länge 	Beschreibung
+    #	1 	0  	4 Zeichen  	Länge des Datensatzes, immer 128 Bytes, also immer "0128"
+    #	2 	4  	1 Zeichen  	Datensatz-Typ, immer 'E'
+    #	3 	5  	5 Zeichen  	"     " (Blanks)
+    #	4 	10  7 Zeichen  	Anzahl der Datensätze vom Typ C
+    #	5 	17  13 Zeichen  Kontrollsumme Beträge
+    #	6 	30  17 Zeichen  Kontrollsumme Kontonummern
+    #	7 	47  17 Zeichen  Kontrollsumme Bankleitzahlen
+    #	8 	64  13 Zeichen  Kontrollsumme Euro, nur belegt, wenn Euro als Währung angegeben wurde (A12, C17a)
+    #	9 	77  51 Zeichen  51 Blanks
+    #	Insgesamt 128 Zeichen
+    def add_e
+      str = '0128'
+      str += 'E'
+      str += ' ' * 5
+      str += '%07i' % @bookings.size
+      str += '0' * 13 #Reserve
+      str += '%017i' % @sum_bank_account_numbers
+      str += '%017i' % @sum_bank_numbers
+      str += '%013i' % @sumBetrag
+      str += ' '  * 51 #Abgrenzung Datensatz
+      raise "DTAUS: Längenfehler E #{str.size} <> 128" if str.size != 128
+      dta_string << str
+    end
+#    private	:dataA, :dataC, :dataE
+  end	#class dtaus
+end	

data/lib/king_dta/helper.rb

@@ -0,0 +1,33 @@
+module KingDta
+  module Helper
+    #Zeichen umsetzen gemäss DTA-Norm
+    def convert_text( text)
+      text = text.to_s
+      return text if text.empty?
+      raise "Text kein String >#{text}< (#{text.class})" unless text.kind_of?( String )
+      text.gsub!('Ä', 'AE')
+      text.gsub!('Ü', 'UE')
+      text.gsub!('Ö', 'OE')
+      text.gsub!('ä', 'AE')
+      text.gsub!('ü', 'UE')
+      text.gsub!('ö', 'OE')
+      text.gsub!('ß', 'SS')
+      
+      text.gsub! /[^a-zA-Z0-9\ \.\,\&\-\/\+\*\$\%]/, '' # Remove all invalid chars
+      
+      text = text.upcase.strip
+      text
+#		text = text.to_s()
+#		puts "Text kein String >#{text}< (#{text.class})" if ! text.kind_of?( String )
+#		text = text.upcase()
+#		text = text.gsub('Ä', 'AE')
+#		text = text.gsub('Ü', 'UE')
+#		text = text.gsub('Ö', 'OE')
+#		text = text.gsub('ä', 'AE')
+#		text = text.gsub('ü', 'UE')
+#		text = text.gsub('ö', 'OE')
+#		text = text.gsub('ß', 'SS')
+#		return text = text.strip
+    end
+  end
+end

data/lib/king_dtaus.rb

@@ -0,0 +1,5 @@
+require "bigdecimal"
+require "#{File.dirname(__FILE__)}/king_dta/helper"
+require "#{File.dirname(__FILE__)}/king_dta/account"
+require "#{File.dirname(__FILE__)}/king_dta/booking"
+require "#{File.dirname(__FILE__)}/king_dta/dtaus"

data/spec/booking_spec.rb

@@ -0,0 +1,20 @@
+require "#{File.dirname(__FILE__)}/spec_helper"
+
+describe KingDta::Booking do
+
+  before :each do
+    kto1 = test_kto1
+    kto2 = test_kto2
+    @account = KingDta::Account.new( kto2.nr, kto2.blz, kto2.name, kto2.bank )
+  end
+
+  it "should have no rounding error for string" do
+    booking = KingDta::Booking.new(@account, "159.73")
+    booking.value.should == 15973
+  end
+  
+  it "should have no rounding error for float" do
+    booking = KingDta::Booking.new(@account, 159.73)
+    booking.value.should == 15973
+  end
+end

data/spec/dtaus_spec.rb

@@ -0,0 +1,106 @@
+require "#{File.dirname(__FILE__)}/spec_helper"
+
+# All Test DTA output strings are validated with sFirm => lokal Sparkassen Software
+describe KingDta::Dtaus do
+
+  before :each do
+    @dtaus = KingDta::Dtaus.new('LK', Date.today)
+    @kto1 = test_kto1
+    @kto2 = test_kto2
+    @dtaus.account = KingDta::Account.new( @kto1.nr, @kto1.blz, @kto1.name, @kto1.bank )
+    @booking = KingDta::Booking.new(
+                KingDta::Account.new( @kto2.nr, @kto2.blz, @kto2.name, @kto2.bank ),
+                220.25 )
+  end
+
+  it "should not init without values" do
+    lambda{ KingDta::Dtaus.new }.should raise_error(ArgumentError)
+  end
+  it "should init with valid values" do
+    lambda{ KingDta::Dtaus.new('LK', Date.today) }.should_not raise_error(ArgumentError)
+  end
+
+  it "should create header" do
+    str = @dtaus.add_a
+    str.length.should == 128
+    out = "0128ALK3704004400000000GIMME YOUR MONEY AG        #{Date.today.strftime("%d%m%y")}    00028800370000000000               #{Date.today.strftime("%d%m%Y")}                        1"
+    str.should == out
+    #60-70 kontonummer mit nullen aufgefüllt
+    str[60...70].should == "000#{test_kto1.nr}"
+    str.should include(test_kto1.blz)
+  end
+
+  it "should create checksums" do
+    @dtaus.add(@booking)
+    @dtaus.set_checksums
+    @dtaus.sum_bank_account_numbers.should == 2787777
+    @dtaus.sum_bank_numbers.should == 37040044
+    @dtaus.sumBetrag.should == 22025
+  end
+
+  it "should create c-sektion with booking text at 19" do
+    @dtaus.add(@booking)
+		@dtaus.bookings.first.text = 'SalesKing Monatsbeitrag 08/10 Freelancer Version'
+    @dtaus.add_c(@booking)
+    str = @dtaus.dta_string
+    str.length.should == 256
+    str.should include(@kto2.name.upcase)
+    out = "0216C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGSALESKING MONATSBEITRAG 08/1  010210 FREELANCER VERSION                                              "
+    str.should == out
+  end
+
+  it "should create c-sektion with default booking text" do
+		@dtaus.default_text = 'Default verwendungszweck'
+    @dtaus.add_c(@booking)
+    str = @dtaus.dta_string
+    str.length.should == 256
+    str.should include(@kto2.name.upcase)
+    out = "0187C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGDEFAULT VERWENDUNGSZWECK   1  00                                                                     "
+    str.should == out
+  end
+
+  it "should create the whole dta string with a single booking" do
+		@dtaus.default_text = 'Default verwendungszweck'
+    @dtaus.add(@booking)
+    str = @dtaus.create
+    str.length.should == 512
+    str.should include(@kto1.name.upcase)
+    str.should include(@kto2.name.upcase)
+    str.should include(@dtaus.default_text.upcase)
+    out = "0128ALK3704004400000000GIMME YOUR MONEY AG        #{Date.today.strftime("%d%m%y")}    00028800370000000000               #{Date.today.strftime("%d%m%Y")}                        1"+
+          "0187C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGDEFAULT VERWENDUNGSZWECK   1  00                                                                     "+
+          "0128E     0000001000000000000000000000002787777000000000370400440000000022025                                                   "
+    str.should == out
+  end
+
+  it "should create whole dta string with long booking text in extension" do
+    @dtaus.add(@booking)
+		@dtaus.bookings.first.text = 'Rgn R-3456-0102220 Monatsbeitrag 08/10 Freelancer Version Vielen Dank Ihre SalesKing GmbH'
+    str = @dtaus.create
+    str.length.should == 640
+    str.should include(@kto2.name.upcase)
+    out = "0128ALK3704004400000000GIMME YOUR MONEY AG        #{Date.today.strftime("%d%m%y")}    00028800370000000000               #{Date.today.strftime("%d%m%Y")}                        1"+
+          "0274C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGRGN R-3456-0102220 MONATSBE1  0302ITRAG 08/10 FREELANCER VERS02ION VIELEN DANK IHRE SALESK           02ING GMBH                                                                                                                      "+
+          "0128E     0000001000000000000000000000002787777000000000370400440000000022025                                                   "
+    str.should == out
+  end
+
+  it "should create the whole dta string with a lot of bookings" do
+		@dtaus.default_text = 'Default Verwendungszweck'
+		6.times { @dtaus.add(@booking) }
+    str = @dtaus.create
+    str.length.should == 1792
+    str.should include(@kto1.name.upcase)
+    str.should include(@kto2.name.upcase)
+    str.should include(@dtaus.default_text.upcase)
+    out = "0128ALK3704004400000000GIMME YOUR MONEY AG        #{Date.today.strftime("%d%m%y")}    00028800370000000000               #{Date.today.strftime("%d%m%Y")}                        1"+
+          "0187C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGDEFAULT VERWENDUNGSZWECK   1  00                                                                     "+
+          "0187C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGDEFAULT VERWENDUNGSZWECK   1  00                                                                     "+
+          "0187C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGDEFAULT VERWENDUNGSZWECK   1  00                                                                     "+
+          "0187C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGDEFAULT VERWENDUNGSZWECK   1  00                                                                     "+
+          "0187C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGDEFAULT VERWENDUNGSZWECK   1  00                                                                     "+
+          "0187C00000000370400440002787777000000000000005000 0000000000037040044000288003700000022025   PETER & MAY GMBH                           GIMME YOUR MONEY AGDEFAULT VERWENDUNGSZWECK   1  00                                                                     "+
+          "0128E     0000006000000000000000000000016726662000000002222402640000000132150                                                   "
+    str.should == out
+  end
+end

data/spec/helper_spec.rb

@@ -0,0 +1,21 @@
+require "#{File.dirname(__FILE__)}/spec_helper"
+
+describe KingDta::Helper do
+  include KingDta::Helper
+
+  it "should convert to upper case" do
+    convert_text('2&2 GmbH & Co. KG').should == '2&2 GMBH & CO. KG'
+  end
+
+  it "should remove invalid chars" do
+    convert_text('@()"=<>!§').should == ''
+  end
+  
+  it "should leave valid chars" do
+    convert_text('abc-ABC-0123- .,&/+*$%').should == 'ABC-ABC-0123- .,&/+*$%'
+  end
+  
+  it "should convert umlaute" do
+    convert_text('üöäÜÖÄß').should == 'UEOEAEUEOEAESS'
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,43 @@
+require 'rubygems'
+require 'spec'
+require 'ostruct'
+require 'date'
+require "#{File.dirname(__FILE__)}/../lib/king_dtaus"
+
+#Filename der eigenen Kontodaten
+#		Beispiel:
+#			typ:LK
+#			blz:99988811
+#			konto:123456
+#			bank:Nord-Ostschwaebische Sandbank
+#
+#			name:Jodelverein Holladrioe 1863 e.V.
+#			zweck:Mitgliedsbeitrag 2003
+#		Der Typ ist LK oder GK. Siehe Option -t
+#		zweck ist ein optionaler Default-Text, der verwendet wird,
+#		falls eine Buchung keinen Text hat.
+#		Die Adressdaten der Bank sind optional und werdezum erzeugen
+#		des Begleitblatts verwendet
+#     bankstrasse:Kieselweg 3
+#			bankplz:0815
+#			bankort:Felsblock
+def test_kto1
+  opts = { :nr => '2880037', :blz => '37040044', :name =>'Gimme your Money AG',
+            :bank => 'Commerzbank Köln', :zweck => 'Monatsbeitrag' }
+  TestKonto.new(opts)
+end
+
+def test_kto2
+  opts = { :nr => '2787777', :blz => '37040044', :name =>'Peter & May GmbH',
+          :bank => 'Commerzbank Köln', :zweck => 'Monatsbeitrag' }
+  TestKonto.new(opts)
+end
+
+def test_kto3
+  opts = { :nr => '2787777', :blz => '37040044', :name =>'Andrew Müller',
+          :bank => 'Commerzbank Köln', :zweck => 'Monatsbeitrag' }
+  TestKonto.new(opts)
+end
+
+# the test account responds to everything
+class TestKonto < OpenStruct; end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: king_dtaus
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Georg Leciejewski
+- Georg Ledermann
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-14 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: DTAUS is a text-based format, to create bank transfers for german banks. This gem helps with the creation of those transfer files.
+email: gl@salesking.eu
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- init.rb
+- lib/king_dta/account.rb
+- lib/king_dta/booking.rb
+- lib/king_dta/dtaus.rb
+- lib/king_dta/helper.rb
+- lib/king_dtaus.rb
+- spec/booking_spec.rb
+- spec/dtaus_spec.rb
+- spec/helper_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/salesking/king_dtaus
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Generate DTAUS strings and files
+test_files: 
+- spec/spec_helper.rb
+- spec/booking_spec.rb
+- spec/helper_spec.rb
+- spec/dtaus_spec.rb