hbci 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 10048414b4db622a1759e8d9c0535e5d1d71d8f705ce7887c17dc1710a7123a6
+  data.tar.gz: 6aa5448aa56599bc95f83c43b65693680c1432dd2603b7669b3d02fbac02ca45
+SHA512:
+  metadata.gz: 8b968e2b272d8820dcd6ad9a9770a99fdc76b9d6e610919d61135ef8a54685fec03395283f207fa70a6f93967ed0ef1eccb0cdec9223313dc875628a021a09ad
+  data.tar.gz: 6912d3aec1751fd9334a91b99de8d4b4ebe45059454efc8a95fd0fa23dd7a48ca2952c2bafaa16a40da1bb2559588750e4c5433a6354802dc010ffd7df2d2a27

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.idea
+.byebug_history
+*.gem
+test.sh

data/.rubocop.yml

@@ -0,0 +1,26 @@
+inherit_from: .rubocop_todo.yml
+Style/Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*
+
+Metrics/ModuleLength:
+  Exclude:
+    - lib/hbci/element_groups/generated_element_groups.rb
+
+Metrics/LineLength:
+  Exclude:
+    - spec/support/message_stubs.rb
+    - spec/support/request_stubs.rb
+
+Metrics/AbcSize:
+  Exclude: 
+    - spec/support/message_stubs.rb
+
+Metrics/ParameterLists:
+  Exclude:
+    - spec/support/message_stubs.rb
+    - spec/support/request_stubs.rb
+

data/.rubocop_todo.yml

@@ -0,0 +1,26 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2018-07-02 12:32:29 +0200 using RuboCop version 0.57.2.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 7
+Metrics/AbcSize:
+  Max: 42
+
+# Offense count: 1
+Metrics/CyclomaticComplexity:
+  Max: 9
+
+# Offense count: 11
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 77
+
+# Offense count: 55
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# URISchemes: http, https
+Metrics/LineLength:
+  Max: 117

data/.ruby-version

@@ -0,0 +1 @@
+2.5.1

data/.travis.yml

@@ -0,0 +1 @@
+language: ruby

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Roman Lehnert
+
+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.md

@@ -0,0 +1,107 @@
+# Hbci
+
+A pure ruby HBCI client for talking with german banks
+
+[![Gem Version](https://badge.fury.io/rb/hbci.svg)](https://badge.fury.io/rb/hbci)
+[![Build Status](https://travis-ci.org/fintastic/hbci.svg?branch=master)](https://travis-ci.org/fintastic/hbci)
+[![Depfu](https://badges.depfu.com/badges/9be5e8286939565cd257add25432b1a8/count.svg)](https://depfu.com/github/fintastic/hbci?project=Bundler)
+
+
+## Preface
+
+This gem is considered experimental.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'hbci'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install hbci
+
+## Usage
+
+First, setup your credentials in a `BankCredentials::Hbci` instance:
+```ruby
+credentials = BankCredentials::Hbci.new({
+  url:        'url',
+  bank_code:  'bank_code',
+  user_id:    'user_id',
+  pin:        'pin'
+})
+```
+
+Now, you can receive your balances, accounts and transactions:
+
+### Receiving the transactions
+
+```ruby
+iban = 'DE05740900000011111111'
+start_date = 3.day.ago
+end_date = Time.now
+
+Hbci::Dialog.open(credentials) do |dialog|
+  transactions = Hbci::Services::TransactionsReceiver.new(dialog, iban).perform(start_date, end_date)
+  transactions.each do |transaction|
+    puts transaction
+  end
+end
+```
+
+### Receiving a balance
+
+```ruby
+iban = 'DE05740900000011111111'
+
+Hbci::Dialog.open(credentials) do |dialog|
+  puts Hbci::Services::BalanceReceiver.new(dialog, iban).perform
+end
+```
+
+### Receiving the accounts
+
+```ruby
+Hbci::Dialog.open(credentials) do |dialog|
+  accounts = Hbci::Services::AccountsReceiver.new(dialog).perform
+  accounts.each do |account|
+    puts account
+  end
+end
+```
+## Banks tested 
+
+| Bank            | Tested  | HBCI URL                                      |
+| --------------- |:-------:| ----------------------------------------------|
+| VR Bank         | DONE    | https://hbci11.fiducia.de/cgi-bin/hbciservlet |
+| Postbank        | DONE    | https://hbci.postbank.de/banking/hbci.do      |
+| Consorsbank     | DONE    | https://brokerage-hbci.consorsbank.de/hbci    |
+| Hypovereinsbank | OPEN    | -                                             |
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/fintastic/hbci
+
+
+## Hbci Documentation
+
+* [FinTS 3.0 Formals](http://www.hbci-zka.de/dokumente/spezifikation_deutsch/fintsv3/FinTS_3.0_Formals_2017-10-06_final_version.pdf)
+* [FinTS 3.0 Messages](https://www.hbci-zka.de/dokumente/spezifikation_deutsch/fintsv3/FinTS_3.0_Messages_Geschaeftsvorfaelle_2015-08-07_final_version.pdf)
+* [FinTS 3.0 Sicherheitsverfahren](https://www.hbci-zka.de/dokumente/spezifikation_deutsch/fintsv3/FinTS_3.0_Security_Sicherheitsverfahren_HBCI_Rel_20130718_final_version.pdf)
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'hbci'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/examples/credentials.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require 'active_support'
+require 'active_support/core_ext'
+
+@options = {
+  url: nil,
+  hbci_version: nil,
+  bank_code: nil,
+  user_id: nil,
+  pin: nil,
+  system_id: 0
+}
+
+OptionParser.new do |opts|
+  opts.banner = 'Usage: example.rb iban [options]'
+
+  opts.on '-url', '--url=URL', 'URL' do |arg|
+    @options[:url] = arg
+  end
+
+  opts.on '-v', '--hbci_version=VERSION', 'Version' do |arg|
+    @options[:hbci_version] = arg
+  end
+
+  opts.on '-b', '--bank_code=BANK_CODE', 'Bank code' do |arg|
+    @options[:bank_code] = arg
+  end
+
+  opts.on '-u', '--user_id=USER_ID', 'User id' do |arg|
+    @options[:user_id] = arg
+  end
+
+  opts.on '-p', '--pin=PIN', 'PIN' do |arg|
+    @options[:pin] = arg
+  end
+
+  opts.on '-s', '--system_id=SYSTEM_ID', 'SYSTEM_ID' do |arg|
+    @options[:system_id] = arg
+  end
+
+  opts.on('-h', '--help', 'Prints this help') do
+    puts opts
+    exit
+  end
+end.parse!
+
+@iban = ARGV.at(0)
+raise 'missing iban' unless @iban
+
+@hbci_version = @options[:hbci_version] ? @options[:hbci_version].to_i : nil
+@credentials = BankCredentials::Hbci.new(
+  url: @options[:url],
+  bank_code: @options[:bank_code],
+  user_id: @options[:user_id],
+  pin: @options[:pin]
+)
+
+connector = Hbci::Connector.instance
+connector.credentials = @credentials
+

data/examples/get_accounts.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative '../lib/hbci'
+require_relative 'credentials'
+
+Hbci::Dialog.open(system_id: @options[:system_id]) do |dialog|
+  accounts = Hbci::Services::AccountsReceiver.new(dialog).perform
+  accounts.each do |account|
+    puts account
+  end
+end

data/examples/get_balance.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative '../lib/hbci'
+require_relative 'credentials'
+
+Hbci::Dialog.open(system_id: @options[:system_id]) do |dialog|
+  puts Hbci::Services::BalanceReceiver.new(dialog, @iban).perform
+end

data/examples/get_system_id.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require_relative '../lib/hbci'
+require_relative 'credentials'
+
+puts Hbci::Services::SystemIdReceiver.new.perform

data/examples/get_transactions.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative '../lib/hbci'
+require_relative 'credentials'
+
+start_date = 3.day.ago
+end_date = Time.now
+
+Hbci::Dialog.open(system_id: @options[:system_id]) do |dialog|
+  transactions = Hbci::Services::TransactionsReceiver.new(dialog, @iban, @hbci_version).perform(start_date, end_date)
+  transactions.each do |transaction|
+    puts transaction
+  end
+end
+

data/hbci.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hbci/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'hbci'
+  spec.version       = Hbci::VERSION
+  spec.authors       = ['Roman Lehnert', 'Alexander Klaiber']
+  spec.email         = ['roman.lehnert@googlemail.com']
+
+  spec.summary       = 'A Ruby hbci client'
+  spec.description   = 'A pure ruby hbci banking client'
+  spec.homepage      = 'https://github.com/fintastic/hbci'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'bank_credentials', '~> 0.1'
+  spec.add_runtime_dependency 'cmxl', '~> 1.1'
+  spec.add_runtime_dependency 'httparty', '~> 0.16'
+  spec.add_runtime_dependency 'ibanizator', '~> 0.3'
+  spec.add_runtime_dependency 'monetize', ['>=1.8', '<2.0.0']
+  spec.add_runtime_dependency 'money', ['>=6.11', '<7.0.0']
+
+  spec.add_development_dependency 'activesupport', '~> 5.2'
+  spec.add_development_dependency 'bundler', '~> 1.10'
+  spec.add_development_dependency 'byebug', '~> 10.0'
+  spec.add_development_dependency 'rake', '~> 12.3'
+  spec.add_development_dependency 'rspec',  '~> 3.7'
+  spec.add_development_dependency 'rubocop', '~> 0.57'
+  spec.add_development_dependency 'timecop', '~> 0.9'
+  spec.add_development_dependency 'webmock', '~> 3.4'
+end

data/lib/development_profiler.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'ruby-prof'
+class DevelopmentProfiler
+  def self.prof(file_name)
+    RubyProf.start
+    yield
+    results = RubyProf.stop
+
+    base_path = 'tmp'
+
+    # Print a flat profile to text
+    File.open "#{base_path}/#{file_name}-graph.html", 'w' do |file|
+      RubyProf::GraphHtmlPrinter.new(results).print(file)
+    end
+
+    File.open "#{base_path}/#{file_name}-flat.txt", 'w' do |file|
+      # RubyProf::FlatPrinter.new(results).print(file)
+      RubyProf::FlatPrinterWithLineNumbers.new(results).print(file)
+    end
+
+    File.open "#{base_path}/#{file_name}-stack.html", 'w' do |file|
+      RubyProf::CallStackPrinter.new(results).print(file)
+    end
+  end
+end

data/lib/hbci.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# External gems
+require 'httparty'
+require 'money'
+require 'monetize'
+require 'cmxl'
+require 'ibanizator'
+
+require 'bank_credentials'
+
+# Internal logic
+require 'hbci/version'
+require 'hbci/parser'
+require 'hbci/segment_factory'
+require 'hbci/dialog'
+require 'hbci/message'
+require 'hbci/request'
+require 'hbci/response'
+require 'hbci/element_unparser'
+require 'hbci/connector'
+require 'hbci/message_factory'
+
+# Element groups
+require 'hbci/element_group'
+require 'hbci/element_groups/segment_head'
+require 'hbci/element_groups/unknown'
+require 'hbci/element_groups/generated_element_groups'
+
+# Segments
+require 'hbci/segment'
+require 'hbci/segments/hnshk'
+require 'hbci/segments/hnsha'
+require 'hbci/segments/hnhbk'
+require 'hbci/segments/hnvsk'
+require 'hbci/segments/hnhbs'
+require 'hbci/segments/hnvsd'
+require 'hbci/segments/hkidn'
+require 'hbci/segments/hkvvb'
+require 'hbci/segments/hksal'
+require 'hbci/segments/hkkaz'
+require 'hbci/segments/hikaz'
+require 'hbci/segments/hisal'
+require 'hbci/segments/hirms'
+require 'hbci/segments/hiupa'
+require 'hbci/segments/hiupd'
+require 'hbci/segments/hikaz'
+require 'hbci/segments/hkend'
+require 'hbci/segments/hikazs'
+require 'hbci/segments/hisals'
+require 'hbci/segments/hirmg'
+require 'hbci/segments/hksyn'
+require 'hbci/segments/hisyn'
+require 'hbci/segments/unknown'
+
+# Services
+require 'hbci/services/base_receiver'
+require 'hbci/services/transactions_receiver'
+require 'hbci/services/balance_receiver'
+require 'hbci/services/accounts_receiver'
+require 'hbci/services/system_id_receiver'
+
+I18n.enforce_available_locales = false if I18n.available_locales.none?
+
+module Hbci
+end