king_dtaus 1.0.0 → 1.0.1

data/README.rdoc

@@ -1,24 +1,44 @@
 = Dtaus
 
-DTAUS is a format for german bank transfers and is short for 
+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 
+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
+  gem install king_dtaus
 
 == Features
-
-
-
-== Example 
-
-TODO - read the specs
+ 
+* create lastschrift
+* create gutschrift
+
+
+== Example
+  
+  #create a new dtaus object
+  dta = KingDta::Dtaus.new('LK')
+  # set sender account
+  dta.account = KingDta::Account.new( "bank_account_number", "bank_number", "bank_owner")
+  # the following should be done in a loop to add multiple bookings
+  # create receiving account
+  rec_acnt = KingDta::Account.new( "bank_account_number", "bank_number", "bank_owner" )
+  # create booking
+  booking = KingDta::Booking.new(rec_acnt, 100.00 )
+  # set booking text if you want to
+  booking.text = "Thanks for your purchase"
+  # add booking
+  dta.add( booking )
+  # end loop
+
+  # create datausstring and do with it whatever fits your workflow
+  my_str = dta.create
+
+also make sure to read the specs
 
 
 == Credits

data/VERSION

@@ -1 +1 @@
-1.0.0
+1.0.1

data/king_dtaus.gemspec

@@ -0,0 +1,57 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{king_dtaus}
+  s.version = "1.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Georg Leciejewski", "Georg Ledermann"]
+  s.date = %q{2011-02-09}
+  s.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.}
+  s.email = %q{gl@salesking.eu}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    "MIT-LICENSE",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "king_dtaus.gemspec",
+    "lib/king_dta/account.rb",
+    "lib/king_dta/booking.rb",
+    "lib/king_dta/dtaus.rb",
+    "lib/king_dta/exception.rb",
+    "lib/king_dta/helper.rb",
+    "lib/king_dtaus.rb",
+    "spec/account_spec.rb",
+    "spec/booking_spec.rb",
+    "spec/dtaus_spec.rb",
+    "spec/helper_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/salesking/king_dtaus}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.4.1}
+  s.summary = %q{Generate DTAUS strings and files}
+  s.test_files = [
+    "spec/account_spec.rb",
+    "spec/booking_spec.rb",
+    "spec/dtaus_spec.rb",
+    "spec/helper_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/lib/king_dta/account.rb

@@ -1,18 +1,22 @@
+# encoding: utf-8
 module KingDta
-	#Kontodaten verwalten mit Name des Inhabers und Bank, Bankleitzahl und Kontonummer.
-	class Account
+  #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
+    # 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 Exception.new("Invalid bank account number #{ban}")  if @bank_account_number == 0
+      raise Exception.new("BLZnummer #{bank_number} ungültig")   if @bank_number == 0
+      raise Exception.new("Invalid account owner #{owner}")      unless @owner.kind_of?(String) # not possible
+      # @dtakunnr  = convert_text( @kunnr )
+    end
+    
+  end
+end

data/lib/king_dta/booking.rb

@@ -1,47 +1,48 @@
+# encoding: utf-8
 module KingDta
-	class Booking
+  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
+    #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 Exception.new("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 Exception.new("Gimme a value as a String or Numeric. You gave me a #{value.class}")
+      end
+      value = ( value * 100 ).to_i  #€-Cent
+      if value == 0
+        raise Exception.new("A booking of 0.00 € makes no sence")
+      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
+    def pos?; @pos end
 
-	end	#class Buchung
-end	#module dtaus
+  end  #class Buchung
+end  #module dtaus

data/lib/king_dta/dtaus.rb

@@ -1,42 +1,42 @@
+# encoding: utf-8
 #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
+    attr_reader :sum_bank_account_numbers, :sum_bank_numbers, :sum_values, :default_text
 
-    #Zieldatei und Datum der Datei werden definiert
+    # Create a new dtaus file/string.
     # ==== 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
+    # typ<String>:: valid strings are 'LK' (Lastschrift Kunde) and 'GK' (Gutschrift Kunde)
+    # typ<Date>:: date when the the transfer is to be created
+    def initialize( typ, date=Date.today )
+      raise ArgumentError.new("Wrong date format. Make it a Time or Date object with yyyy-mm-dd") unless date.respond_to?(:strftime)
+      raise ArgumentError.new("Unknown order type: #{typ}. Allowed Values are LK, GK") unless ['LK','GK'].include?(typ)
+      @date = date
+      @typ  = typ
+      @value_pos  = true  #all values are positive by default. Variable changes with first booking entry
+      @closed     = false
       @default_text = '' # default verwendungzweck
     end
-    
-    #	Übergabe der eigenen Kontodaten als Objekt der Klasse Konto
+
+    #  Set the sending account(you own)
+    # === Parameter
+    # account<Account>:: the sending account, must be an instance of class
+    # KingDta::Account
     def account=( account )
-      raise "Come on i need an Account object" unless account.kind_of?( Account )
+      raise Exception.new("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
+    # The dtaus format as string. All data is appended to it during creation
     def dta_string
       @dta_string ||= ''
     end
+    # Array of bookings
     def bookings
       @bookings ||= []
     end
@@ -45,19 +45,25 @@ module KingDta
       @default_text = convert_text( text )
     end
 
-    #Eine Buchung hinzufügen. Es wird geprüft, ob das Vorzeichen identisch mit den bisherigen Vorzeichen ist.
+    # Add a booking. The prefix (pos/neg) is beeing checked if it is identical
+    # with the last one
+    # === Parameter
+    # booking<Booking>:: KingDta::Booking object
+    # === Raises
+    # error if the prefix within the bookings has changed
     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?
+      raise Exception.new("The file has alreay been closed, cannot add new booking") if @closed
+      #the first booking decides wether all values are po or negative
+      @value_pos = booking.pos?  if bookings.empty?
+      raise Exception.new("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
+    # === Raises
+    # error if there are no bookings
     def create
-      raise "Cannot create DTAUS without bookings" if bookings.empty?
+      raise Exception.new("Cannot create DTAUS without bookings") if bookings.empty?
       @closed = true
       # cleanup before we start
       @dta_string = dta_string.empty? ? dta_string : ''
@@ -69,60 +75,62 @@ module KingDta
     end
 
     def set_checksums
-      @sum_bank_account_numbers, @sum_bank_numbers, @sumBetrag	= 0,0,0 
+      @sum_bank_account_numbers, @sum_bank_numbers, @sum_values  = 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
+        @sum_bank_account_numbers  += b.account.bank_account_number
+        @sum_bank_numbers += b.account.bank_number
+        @sum_values += b.value
       end
     end
 
-    #Create a DTA-File
+    # Create a DTA-File, from current dta information
+    # === Parameter
+    # filename<String>:: defaults to DTAUS0.TXT
     def create_file(filename ='DTAUS0.TXT')
       file = open( filename, 'w')
-      file	<< create
+      file  << create
       file.close()
-      print "#{filename} erstellt , #{@bookings.size} Einträge\n"
+      print "#{filename} created containing #{@bookings.size} bookings\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
+    # 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 += '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 += @date.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 += '%8s' % @date.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
@@ -131,59 +139,59 @@ module KingDta
 
     #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
+    #  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)
+    #  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)
+    def add_c( booking )
       zahlungsart = if @typ == 'LK'
                       booking.schluessel || Booking::LASTSCHRIFT_EINZUGSERMAECHTIGUNG
                     elsif @typ == 'GK'
@@ -248,7 +256,7 @@ module KingDta
       add_ext( exts[6..9] )
       add_ext( exts[10..13] )
       dta_string
-    end	#dataC
+    end  #dataC
 
     # Format an extension so it can be used in string substitution
     # ==== Returns
@@ -265,31 +273,31 @@ module KingDta
     # <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 =  "%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] )
+      # devider 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
+    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
+    #  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'
@@ -298,11 +306,11 @@ module KingDta
       str += '0' * 13 #Reserve
       str += '%017i' % @sum_bank_account_numbers
       str += '%017i' % @sum_bank_numbers
-      str += '%013i' % @sumBetrag
+      str += '%013i' % @sum_values
       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	
+    
+  end  #class dtaus
+end

data/lib/king_dta/exception.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+module KingDta
+  class Exception < ::Exception
+  end
+end

data/lib/king_dta/helper.rb

@@ -1,10 +1,11 @@
+# encoding: utf-8
 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 )
+      raise "Text kein String >#{text}< (#{text.class})" unless text.kind_of?( String ) # not possible
       text.gsub!('Ä', 'AE')
       text.gsub!('Ü', 'UE')
       text.gsub!('Ö', 'OE')
@@ -14,20 +15,7 @@ module KingDta
       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
+      text.upcase.strip
     end
   end
-end
+end

data/lib/king_dtaus.rb

@@ -3,3 +3,4 @@ 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"
+require "#{File.dirname(__FILE__)}/king_dta/exception"

data/spec/account_spec.rb

@@ -0,0 +1,21 @@
+require "#{File.dirname(__FILE__)}/spec_helper"
+
+describe KingDta::Account do
+
+  before :each do
+    @bank_account = test_kto2
+  end
+
+  it "should initialize a new account" do
+    lambda{ KingDta::Account.new(@bank_account.nr, @bank_account.blz, @bank_account.name, @bank_account.bank) }.should_not raise_error
+  end
+
+  it "should fail if bank account number is invalid" do
+    lambda{ KingDta::Account.new(0, @bank_account.blz, @bank_account.name, @bank_account.bank) }.should raise_error(KingDta::Exception)
+  end
+
+  it "should fail if bank number is invalid" do
+    lambda{ KingDta::Account.new(@bank_account.nr, 0, @bank_account.name, @bank_account.bank) }.should raise_error(KingDta::Exception)
+  end
+  
+end

data/spec/booking_spec.rb

@@ -12,6 +12,25 @@ describe KingDta::Booking do
     booking = KingDta::Booking.new(@account, "159.73")
     booking.value.should == 15973
   end
+
+  it "should raise if initialized without an account" do
+    lambda{ KingDta::Booking.new("account", Date.today) }.should raise_error(KingDta::Exception)
+  end
+
+  it "should raise if initialized with wrong value type" do
+    lambda{ KingDta::Booking.new(@account, Date.today) }.should raise_error(KingDta::Exception)
+  end
+
+  it "should raise if initialized with 0 value" do
+    lambda{ KingDta::Booking.new(@account, 0) }.should raise_error(KingDta::Exception)
+    lambda{ KingDta::Booking.new(@account, 0.00) }.should raise_error(KingDta::Exception)
+  end
+
+  it "should set pos to false with negative value" do
+    b = KingDta::Booking.new(@account, -1)
+    b.value.should == 100
+    b.should_not be_pos
+  end
   
   it "should have no rounding error for float" do
     booking = KingDta::Booking.new(@account, 159.73)

data/spec/dtaus_spec.rb

@@ -16,9 +16,38 @@ describe KingDta::Dtaus do
   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 not init with an unknown type" do
+    lambda{ KingDta::Dtaus.new('UNKNOWN', "date") }.should raise_error(ArgumentError)
+  end
+
+  it "should not init with an invalid date" do
+    lambda{ KingDta::Dtaus.new('LK', "date") }.should raise_error(ArgumentError)
+  end
+  
+  it "should deny invalid accounts" do
+    lambda{ @dtaus.account = "account" }.should raise_error(KingDta::Exception)
+  end
+  
+  it "should not add a booking if closed" do
+    @dtaus.add(@booking)
+    @dtaus.create
+    lambda{ @dtaus.add(@booking) }.should raise_error(KingDta::Exception)
+  end
+
+  it "should not add a booking if closed" do
+    @dtaus.add(@booking)
+    negative_booking = KingDta::Booking.new(KingDta::Account.new( @kto2.nr, @kto2.blz, @kto2.name, @kto2.bank ), -120.25 )
+    lambda{ @dtaus.add(negative_booking) }.should raise_error(KingDta::Exception)
+  end
+  
+  it "should not create if there are no bookings" do
+    lambda{ @dtaus.create}.should raise_error(KingDta::Exception)
+  end
 
   it "should create header" do
     str = @dtaus.add_a
@@ -35,12 +64,12 @@ describe KingDta::Dtaus do
     @dtaus.set_checksums
     @dtaus.sum_bank_account_numbers.should == 2787777
     @dtaus.sum_bank_numbers.should == 37040044
-    @dtaus.sumBetrag.should == 22025
+    @dtaus.sum_values.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.bookings.first.text = 'SalesKing Monatsbeitrag 08/10 Freelancer Version'
     @dtaus.add_c(@booking)
     str = @dtaus.dta_string
     str.length.should == 256
@@ -50,7 +79,7 @@ describe KingDta::Dtaus do
   end
 
   it "should create c-sektion with default booking text" do
-		@dtaus.default_text = 'Default verwendungszweck'
+    @dtaus.default_text = 'Default verwendungszweck'
     @dtaus.add_c(@booking)
     str = @dtaus.dta_string
     str.length.should == 256
@@ -60,7 +89,7 @@ describe KingDta::Dtaus do
   end
 
   it "should create the whole dta string with a single booking" do
-		@dtaus.default_text = 'Default verwendungszweck'
+    @dtaus.default_text = 'Default verwendungszweck'
     @dtaus.add(@booking)
     str = @dtaus.create
     str.length.should == 512
@@ -75,7 +104,7 @@ describe KingDta::Dtaus do
 
   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'
+    @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)
@@ -86,8 +115,8 @@ describe KingDta::Dtaus do
   end
 
   it "should create the whole dta string with a lot of bookings" do
-		@dtaus.default_text = 'Default Verwendungszweck'
-		6.times { @dtaus.add(@booking) }
+    @dtaus.default_text = 'Default Verwendungszweck'
+    6.times { @dtaus.add(@booking) }
     str = @dtaus.create
     str.length.should == 1792
     str.should include(@kto1.name.upcase)
@@ -103,4 +132,11 @@ describe KingDta::Dtaus do
           "0128E     0000006000000000000000000000016726662000000002222402640000000132150                                                   "
     str.should == out
   end
-end
+
+  xit "should create file" do
+    @dtaus.default_text = 'Default Verwendungszweck'
+    6.times { @dtaus.add(@booking) }
+    file = @dtaus.create_file
+  end
+
+end

data/spec/helper_spec.rb

@@ -1,3 +1,5 @@
+# encoding: utf-8
+
 require "#{File.dirname(__FILE__)}/spec_helper"
 
 describe KingDta::Helper do
@@ -18,4 +20,4 @@ describe KingDta::Helper do
   it "should convert umlaute" do
     convert_text('üöäÜÖÄß').should == 'UEOEAEUEOEAESS'
   end
-end
+end

data/spec/spec_helper.rb

@@ -1,26 +1,26 @@
+# encoding: utf-8
 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
+#    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
+#      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
+#      bankplz:0815
+#      bankort:Felsblock
 def test_kto1
   opts = { :nr => '2880037', :blz => '37040044', :name =>'Gimme your Money AG',
             :bank => 'Commerzbank Köln', :zweck => 'Monatsbeitrag' }
@@ -40,4 +40,4 @@ def test_kto3
 end
 
 # the test account responds to everything
-class TestKonto < OpenStruct; end
+class TestKonto < OpenStruct; end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: king_dtaus
 version: !ruby/object:Gem::Version 
-  hash: 23
-  prerelease: false
+  hash: 21
+  prerelease: 
   segments: 
   - 1
   - 0
-  - 0
-  version: 1.0.0
+  - 1
+  version: 1.0.1
 platform: ruby
 authors: 
 - Georg Leciejewski
@@ -16,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-14 00:00:00 +02:00
+date: 2011-02-09 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
@@ -29,17 +29,18 @@ extensions: []
 extra_rdoc_files: 
 - README.rdoc
 files: 
-- .gitignore
 - MIT-LICENSE
 - README.rdoc
 - Rakefile
 - VERSION
-- init.rb
+- king_dtaus.gemspec
 - lib/king_dta/account.rb
 - lib/king_dta/booking.rb
 - lib/king_dta/dtaus.rb
+- lib/king_dta/exception.rb
 - lib/king_dta/helper.rb
 - lib/king_dtaus.rb
+- spec/account_spec.rb
 - spec/booking_spec.rb
 - spec/dtaus_spec.rb
 - spec/helper_spec.rb
@@ -49,8 +50,8 @@ homepage: http://github.com/salesking/king_dtaus
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -74,12 +75,13 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.4.1
 signing_key: 
 specification_version: 3
 summary: Generate DTAUS strings and files
 test_files: 
-- spec/spec_helper.rb
+- spec/account_spec.rb
 - spec/booking_spec.rb
-- spec/helper_spec.rb
 - spec/dtaus_spec.rb
+- spec/helper_spec.rb
+- spec/spec_helper.rb

data/.gitignore

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

data/init.rb

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