king_dtaus 2.0.0.pre → 2.0.0

data/.travis.yml

@@ -0,0 +1,3 @@
+rvm:
+  - 1.8.7
+  - 1.9.2

data/Gemfile

@@ -1,3 +1,7 @@
 source :rubygems
 
-gemspec
+gemspec
+
+group :test do
+  gem "rcov"
+end

data/README.markdown

@@ -0,0 +1,128 @@
+# DTAUS & DTAZV always comes together
+
+[![Build Status](https://secure.travis-ci.org/salesking/king_dtaus.png)](http://travis-ci.org/salesking/king_dtaus)
+
+DTAUS & DTAZV are formats 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- or DTAZV-text.
+
+We love building payment applications.
+
+## Install
+
+    gem install king_dtaus
+
+## Features
+
+* Create DTAUS debit transfer (Lastschrift)
+* Create DTAUS credit transfer (Gutschrift)
+* Create DTAZV debit transfer
+* 100% test coverage to ensure software quality
+* works with ruby 1.8 & 1.9.2
+
+## Version Info
+
+Version 2 has breaking changes!
+
+* account attributes now passed in as hash
+* renamed account.client_xy => owner_xy
+* renamed account.account_number => bank_account_number
+* added iban/bic to account
+* DTAZV added
+
+If you want to stay with v1 just pin it in your Gemfile:
+    
+    gem "king_dtaus", "<2"
+
+## TODOs
+
+* some more edge-case tests needed, we need your feedback here!
+
+## Resources
+
+* SalesKing: http://salesking.eu
+* DTAZV-Viewer: http://www.meta-evolutions.de/pages/artikel-20070630-dtazv-datei-betrachter.html
+* DTA/DTAZV PHP Pear: http://pear.php.net/package/Payment_DTA
+* Windata ZV-Tools: http://www.windata.de/Site/2Produkte2/ZVTools.aspx
+* The Swift Codes: http://www.theswiftcodes.com/
+* StarMoney: http://www.starmoney.de/index.php?id=starmoneybusiness_testen
+
+## Examples
+
+Here are some examples how to create a DTA- or DTAZV-File. Also check out the spec/dtazv_test.rb to have a running example of an export.
+
+### DTA
+
+    # create a new dtaus object
+    dta = KingDta::Dtaus.new('LK')
+  
+    # set sender account
+    dta.account = KingDta::Account.new(
+                    :bank_account_number => "123456789",
+                    :bank_number => "69069096",
+                    :owner_name => "Return to Sender",
+                    :bank_name => "Money Burner Bank")
+  
+    # following should be done in a loop to add multiple bookings
+    # create receiving account
+    receiver = KingDta::Account.new(
+                    :bank_account_number => "987456123",
+                    :bank_number => "99099096",
+                    :owner_name => "Gimme More Lt.",
+                    :bank_name => "Banking Bandits")
+    # create booking
+    booking = KingDta::Booking.new(receiver, 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
+
+### DTAZV
+
+    @dtazv = KingDta::Dtazv.new()
+
+    # sender account
+    @dtazv.account = KingDta::Account.new(
+      :bank_account_number => "123456789",
+      :bank_number => "40050100",
+      :bank_name => "Greedy Fuckers Bank",
+      :owner_name => "Sender name"
+    )
+
+    # receiver account
+    receiver = KingDta::Account.new(
+      :bank_account_number => "987654321",
+      :bank_iban => "PLsome-long-Iban",
+      :bank_bic => "BicCode",
+      :owner_name => "receivers name"
+    )
+    # add bookings, probably in a loop
+    booking = KingDta::Booking.new(receiver, 220.25)
+    @dtazv.add(booking)
+
+    # get output as string
+    @dtazv.create
+
+also make sure to read the code and the specs
+
+## Credits
+
+Bugfixes and enhancements by
+
+* Georg Ledermann - https://github.com/ledermann
+* Kim Rudolph - https://github.com/krudolph
+* Thorsten Böttger - https://github.com/alto
+* Jan Kus - https://github.com/koos
+* used https://rubygems.org/gems/DTAUS as a starting point
+
+Copyright (c) 2009-2011 Georg Leciejewski (SalesKing), Jan Kus (Railslove), released under the MIT license

data/Rakefile

@@ -1,5 +1,4 @@
 require 'rake'
-require 'rdoc/task'
 require 'rspec/core/rake_task'
 
 desc "Run specs"
@@ -7,6 +6,12 @@ RSpec::Core::RakeTask.new
 
 task :default => :spec
 
+RSpec::Core::RakeTask.new(:coverage) do |t|
+  t.rcov = true
+  t.rcov_opts =  %q[--exclude "spec"]
+  t.verbose = true
+end
+
 Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }
 
 begin
@@ -17,7 +22,7 @@ begin
     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.authors = ["Georg Leciejewski", "Georg Ledermann", "Jan Kus"]
     # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
   Jeweler::GemcutterTasks.new

data/VERSION

@@ -1 +1 @@
-2.0.0.pre
+2.0.0

data/king_dtaus.gemspec

@@ -5,28 +5,26 @@
 
 Gem::Specification.new do |s|
   s.name = %q{king_dtaus}
-  s.version = "2.0.0.pre"
+  s.version = "2.0.0"
 
-  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Georg Leciejewski", "Georg Ledermann"]
-  s.date = %q{2011-06-15}
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Georg Leciejewski", "Georg Ledermann", "Jan Kus"]
+  s.date = %q{2011-11-15}
   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"
+    "README.markdown"
   ]
   s.files = [
-    ".rvmrc",
-    "DTAUS0.TXT",
+    ".travis.yml",
     "Gemfile",
-    "Gemfile.lock",
     "MIT-LICENSE",
-    "README.rdoc",
+    "README.markdown",
     "Rakefile",
     "VERSION",
     "docs/dtazv.pdf",
     "docs/dtazv_bank_bbk.pdf",
-    "example.output",
+    "docs/example.output",
     "king_dtaus.gemspec",
     "lib/king_dta/account.rb",
     "lib/king_dta/booking.rb",
@@ -40,17 +38,15 @@ Gem::Specification.new do |s|
     "spec/booking_spec.rb",
     "spec/dtaus_spec.rb",
     "spec/dtazv_spec.rb",
-    "spec/dtazv_test.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.3.7}
+  s.rubygems_version = %q{1.6.2}
   s.summary = %q{Generate DTAUS strings and files}
 
   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
@@ -59,12 +55,14 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<jeweler>, [">= 0"])
       s.add_development_dependency(%q<simplecov>, [">= 0"])
       s.add_development_dependency(%q<mocha>, [">= 0"])
+      s.add_development_dependency(%q<i18n>, [">= 0"])
     else
       s.add_dependency(%q<king_dtaus>, [">= 0"])
       s.add_dependency(%q<rspec>, [">= 0"])
       s.add_dependency(%q<jeweler>, [">= 0"])
       s.add_dependency(%q<simplecov>, [">= 0"])
       s.add_dependency(%q<mocha>, [">= 0"])
+      s.add_dependency(%q<i18n>, [">= 0"])
     end
   else
     s.add_dependency(%q<king_dtaus>, [">= 0"])
@@ -72,6 +70,7 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<jeweler>, [">= 0"])
     s.add_dependency(%q<simplecov>, [">= 0"])
     s.add_dependency(%q<mocha>, [">= 0"])
+    s.add_dependency(%q<i18n>, [">= 0"])
   end
 end
 

data/lib/king_dta/account.rb

@@ -1,11 +1,15 @@
 # encoding: utf-8
 module KingDta
-  #Kontodaten verwalten mit Name des Inhabers und Bank, Bankleitzahl und Kontonummer.
+  # A bank account with name of the account owner,
+  # Kontodaten verwalten mit Name des Inhabers und Bank, Bankleitzahl und Kontonummer.
   class Account
     include KingDta::Helper
-    # dta~ jeweilige Feld in DTAUS-Norm
-    attr_accessor :account_number, :bank_number, :client_number, :bank_street, :bank_city, :bank_zip_code, :bank_name,
-:client_name, :client_street, :client_city, :client_zip_code, :bank_country_code, :client_country_code
+    
+    attr_accessor :bank_account_number, :bank_number, :bank_street, :bank_city,
+                  :bank_zip, :bank_name, :bank_country_code, :bank_iban,
+                  :bank_bic,
+                  :owner_name, :owner_number, :owner_street, :owner_city,
+                  :owner_zip_code, :owner_country_code
 
     # TODO test
     def initialize(args={})
@@ -13,44 +17,40 @@ module KingDta
       @bank_street = convert_text(args.delete(:bank_street))
       @bank_city = convert_text(args.delete(:bank_city))
       @bank_name = convert_text(args.delete(:bank_name))
-      @client_name = convert_text(args.delete(:client_name))
-      @client_street = convert_text(args.delete(:client_street))
-      @client_city = convert_text(args.delete(:client_city))
+      @owner_name = convert_text(args.delete(:owner_name))
+      @owner_street = convert_text(args.delete(:owner_street))
+      @owner_city = convert_text(args.delete(:owner_city))
 
       args.each do |key,value|
         self.send("#{key}=",value)
       end
 
-      raise ArgumentError.new('Account number too long, max 35 allowed') if @account_number && "#{@account_number}".length > 35
-      raise ArgumentError.new('Bank number too long, max 11 allowed') if @bank_number && "#{@bank_number}".length > 11
-      raise ArgumentError.new('Client number too long, max 10 allowed') if @client_number && "#{@client_number}".length > 10
-      raise ArgumentError.new("Bank account number cannot be 0")  if @account_number && @account_number == 0
-      raise ArgumentError.new("Bank number cannot be 0")   if @bank_number && @bank_number == 0
-      raise ArgumentError.new("Street and/or Zip Code too long, max 35 allowed") if @bank_street && @bank_zip_code && "#{@bank_street} #{@bank_zip_code}".length > 35
-      raise ArgumentError.new("City too long, max 35 allowed") if @bank_city && @bank_city.length > 35
-      raise ArgumentError.new("Bank Name too long, max 35 allowed") if @bank_name && @bank_name.length > 35
-      raise ArgumentError.new("Client Street and/or Zip Code too long, max 35 allowed") if @client_street && @client_zip_code && "#{@client_street} #{@client_zip_code}".length > 35
-      raise ArgumentError.new("Client City too long, max 35 allowed") if @client_city && @client_city.length > 35
-      raise ArgumentError.new("Bank Country code too long, max 2 allowed") if @bank_country_code && @bank_country_code.length > 2
-      raise ArgumentError.new("Client Country code too long, max 2 allowed") if @client_country_code && @client_country_code.length > 2
+      raise ArgumentError.new('Owner number too long, max 10 allowed') if @owner_number && "#{@owner_number}".length > 10
+      raise ArgumentError.new("Owner street too long, max 35 allowed") if @owner_street && @owner_street.length > 35
+      raise ArgumentError.new("Owner city too long, max 35 allowed") if @owner_city && @owner_city.length > 35
+      raise ArgumentError.new("Owner country code too long, max 2 allowed") if @owner_country_code && @owner_country_code.length > 2
 
-    end
+      raise ArgumentError.new('Bank account number too long, max 10 allowed') if @bank_account_number && "#{@bank_account_number}".length > 10
+      raise ArgumentError.new("Bank account number cannot be 0")  if @bank_account_number && @bank_account_number == 0
+      raise ArgumentError.new("Bank iban wrong length: #{@bank_iban.length}, must be between 15-34") if @bank_iban && !@bank_iban.length.between?(15,34)
+      raise ArgumentError.new("Bank bic wrong length: #{@bank_bic.length} must be between 8-11") if @bank_bic && !@bank_bic.length.between?(8,11)
+      raise ArgumentError.new('Bank number too long, max 8 allowed') if @bank_number && "#{@bank_number}".length > 8
+      raise ArgumentError.new("Bank number cannot be 0")   if @bank_number && @bank_number == 0
+      raise ArgumentError.new("Bank street too long, max 35 allowed") if @bank_street && @bank_street.length > 35
+      raise ArgumentError.new("Bank city too long, max 35 allowed") if @bank_city && @bank_city.length > 35
+      raise ArgumentError.new("Bank name too long, max 35 allowed") if @bank_name && @bank_name.length > 35
+      raise ArgumentError.new("Bank country code too long, max 2 allowed") if @bank_country_code && @bank_country_code.length > 2
 
-    # TODO test
-    def client_firstname
-      @client_name.split(' ')[0]
-    end
+      @owner_country_code = @bank_iban[0..1 ] if @bank_iban && !@owner_country_code
 
-    def client_surname
-      @client_name.split(' ')[1]
     end
 
-    def zip_city
-      "#{@bank_zip_code} #{@bank_city}"
+    def bank_zip_city
+      "#{@bank_zip} #{@bank_city}"
     end
 
-    def client_zip_city
-      "#{@client_zip_code} #{@client_city}"
+    def owner_zip_city
+      "#{@owner_zip_code} #{@owner_city}"
     end
 
   end

data/lib/king_dta/dta.rb

@@ -4,6 +4,16 @@ module KingDta
     include KingDta::Helper
     attr_reader :default_text
 
+    # Create a new dta string.
+    # === Parameter    # 
+    # typ<Date>:: date when the the transfer is to be created
+    def initialize(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)
+      @date         = date
+      @value_pos    = true  #values are positive by default changed by first booking
+      @closed       = false
+      @default_text = ''
+    end
     #  Set the sending account(you own)
     # === Parameter
     # account<Account>:: the sending account, must be an instance of class