Merging several forks and unbonding template from bank slip.

Gemfile

@@ -8,4 +8,5 @@ gem "rake"
 group :test do
   gem "rspec",      :require => false
   gem "ruby-debug", :require => false, :platform => :ruby_18
-end
+  gem "ruby-debug19", :require => false, :platform => :ruby_19
+end

Gemfile.lock

@@ -3,26 +3,33 @@ PATH
   specs:
     brcobranca (3.0.0)
       activemodel (>= 3.0.0)
+      barby (>= 0.5.0)
       parseline (>= 1.0.3)
       rghost (>= 0.8.7)
       rghost_barcode (>= 0.8)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    activemodel (3.0.6)
-      activesupport (= 3.0.6)
-      builder (~> 2.1.2)
-      i18n (~> 0.5.0)
-    activesupport (3.0.6)
-    builder (2.1.2)
+    activemodel (3.2.1)
+      activesupport (= 3.2.1)
+      builder (~> 3.0.0)
+    activesupport (3.2.1)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    archive-tar-minitar (0.5.2)
+    barby (0.5.0)
+    builder (3.0.0)
     columnize (0.3.2)
     diff-lcs (1.1.2)
-    i18n (0.5.0)
+    i18n (0.6.0)
     linecache (0.43)
+    linecache19 (0.5.12)
+      ruby_core_source (>= 0.1.4)
+    multi_json (1.1.0)
     parseline (1.0.3)
     rake (0.8.7)
-    rghost (0.8.7.5)
+    rghost (0.8.7.6)
     rghost_barcode (0.9)
     rspec (2.5.0)
       rspec-core (~> 2.5.0)
@@ -37,12 +44,24 @@ GEM
       ruby-debug-base (~> 0.10.4.0)
     ruby-debug-base (0.10.4)
       linecache (>= 0.3)
+    ruby-debug-base19 (0.11.25)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby_core_source (>= 0.1.4)
+    ruby-debug19 (0.11.6)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby-debug-base19 (>= 0.11.19)
+    ruby_core_source (0.1.5)
+      archive-tar-minitar (>= 0.5.2)
 
 PLATFORMS
   ruby
+  x86-mingw32
 
 DEPENDENCIES
   brcobranca!
   rake
   rspec
   ruby-debug
+  ruby-debug19

README.rdoc

@@ -13,9 +13,6 @@ Gem para emissão de bloquetos de cobrança para bancos brasileiros
 
 == Bancos Disponíveis
 
-* Banco Banespa
-  * COB
-
 * Banco do Brasil
   * TODAS AS CARTEIRAS PRESENTES NA DOCUMENTAÇÃO
 
@@ -39,6 +36,10 @@ Gem para emissão de bloquetos de cobrança para bancos brasileiros
 * Banco Caixa
   * Sem registro (SR)  by Túlio Ornelas - https://github.com/tulios
 
+* Banco Santader
+
+* Banco Sincredi
+
 == Está perdido?
 
 Veja a documentação da versão atual em http://rubydoc.info/gems/brcobranca e da versão de desenvolvimento em http://rubydoc.info/github/kivanio/brcobranca/master/frames
@@ -76,4 +77,4 @@ BSD
 
 De brasileiro para brasileiros.
 
-Copyleft 2009 Kivanio Barbosa
+Copyleft 2009 Kivanio Barbosa

app/views/brcobranca/_boleto.html.erb

@@ -0,0 +1,2 @@
+Hi i'll be your <%= image_tag boleto.logotipo %> slip soon! yay!
+

brcobranca.gemspec

@@ -31,4 +31,4 @@ Gem::Specification.new do |s|
     Visite http://www.boletorails.com.br para ver exemplos!
     ===========================================================================
   ]
-end
+end

lib/brcobranca.rb

@@ -53,10 +53,6 @@ def initialize(boleto)
   #
   # Ou colocar em um arquivo na pasta initializer do rails.
   class Configuration
-    # Gerador de arquivo de boleto.
-    # @return [Symbol]
-    # @param  [Symbol] (Padrão: :rghost)
-    attr_accessor :gerador
     # Formato do arquivo de boleto a ser gerado.
     # @return [Symbol]
     # @param  [Symbol] (Padrão: :pdf)
@@ -77,9 +73,9 @@ class Configuration
 
     # Atribui valores padrões de configuração
     def initialize
-      self.gerador = :rghost
       self.formato = :pdf
       self.resolucao = 150
+      self.external_encoding = 'ascii-8bit' if  RUBY_VERSION =~ /^1\.9/
     end
   end
 
@@ -103,12 +99,13 @@ module Boleto
     autoload :Bradesco,      'brcobranca/boleto/bradesco'
     autoload :Unibanco,      'brcobranca/boleto/unibanco'
     autoload :Caixa,         'brcobranca/boleto/caixa'
-    autoload :Sicredi,         'brcobranca/boleto/sicredi'
+    autoload :Santander,     'brcobranca/boleto/santander'
+    autoload :Sicredi,       'brcobranca/boleto/sicredi'
 
     # Módulos para classes de template
     module Template
-      autoload :Base,   'brcobranca/boleto/template/base'
       autoload :Rghost, 'brcobranca/boleto/template/rghost'
+      autoload :Html,   'brcobranca/boleto/template/html'
     end
   end
 

lib/brcobranca/boleto/base.rb

@@ -4,12 +4,6 @@ module Brcobranca
   module Boleto
     # Classe base para todas as classes de boletos
     class Base
-      extend Template::Base
-
-      # Configura gerador de arquivo de boleto e código de barras.
-      extend define_template(Brcobranca.configuration.gerador)
-      include define_template(Brcobranca.configuration.gerador)
-
       # Validações do Rails 3
       include ActiveModel::Validations
 
@@ -71,6 +65,8 @@ class Base
       attr_accessor :sacado_endereco
       # <b>REQUERIDO</b>: Documento da pessoa que receberá o boleto
       attr_accessor :sacado_documento
+      # <b>OPTIONAL</b>: Personalized logo to bank slip
+      attr_writer :logotipo
 
       # Validações
       validates_presence_of :agencia, :conta_corrente, :moeda, :especie_documento, :especie, :aceite, :numero_documento, :message => "não pode estar em branco."
@@ -79,6 +75,7 @@ class Base
       # Nova instancia da classe Base
       # @param [Hash] campos
       def initialize(campos={})
+
         padrao = {
           :moeda => "9", :data_documento => Date.today, :dias_vencimento => 1, :quantidade => 1,
           :especie_documento => "DM", :especie => "R$", :aceite => "S", :valor => 0.0,
@@ -93,10 +90,47 @@ def initialize(campos={})
         yield self if block_given?
       end
 
+      # Gera o boleto em usando o formato desejado [:pdf, :jpg, :tif, :png, :ps, :laserjet, ... etc]
+      #
+      # @return [Stream]
+      # @see http://wiki.github.com/shairontoledo/rghost/supported-devices-drivers-and-formats Veja mais formatos na documentação do rghost.
+      # @see Rghost#modelo_generico Recebe os mesmos parâmetros do Rghost#modelo_generico.
+      def to(formato, options={})
+        template.generate(self, options.merge(:formato => formato))
+      end
+
+      # Gera o boleto em usando o formato desejado [:pdf, :jpg, :tif, :png, :ps, :laserjet, ... etc]
+      #
+      # @return [Stream]
+      # @see http://wiki.github.com/shairontoledo/rghost/supported-devices-drivers-and-formats Veja mais formatos na documentação do rghost.
+      # @see Rghost#modelo_generico Recebe os mesmos parâmetros do Rghost#modelo_generico.
+      def lote(boletos, options={})
+        template.generate(boletos, options)
+      end
+
+      def self.lote(boletos, options={}, template=default_template)
+        template.generate(boletos, options)
+      end
+
+      #  Cria o métodos dinâmicos (to_pdf, to_gif e etc) com todos os fomátos válidos.
+      #
+      # @return [Stream]
+      # @see Rghost#modelo_generico Recebe os mesmos parâmetros do Rghost#modelo_generico.
+      # @example
+      #  @boleto.to_pdf #=> boleto gerado no formato pdf
+      def method_missing(m, *args)
+        method = m.to_s
+        if method.start_with?("to_")
+          template.generate(self, (args.first || {}).merge!({:formato => method[3..-1]}))
+        else
+          super
+        end
+      end
+
       # Logotipo do banco
       # @return [Path] Caminho para o arquivo de logotipo do banco.
       def logotipo
-        File.join(File.dirname(__FILE__),'..','arquivos','logos',"#{class_name}.jpg")
+        @logotipo ||= File.join(File.dirname(__FILE__),'..','arquivos','logos',"#{class_name}.jpg")
       end
 
       # Dígito verificador do banco
@@ -200,6 +234,19 @@ def codigo_barras_segunda_parte
         raise Brcobranca::NaoImplementado.new("Sobreescreva este método na classe referente ao banco que você esta criando")
       end
 
+      def template
+        @template ||= self.class.default_template
+      end
+
+      # <b>OPTIONAL</b>: Select a different template for generating the bank slip
+      def template=(template)
+        @template = Brcobranca::Boleto::Template.const_get(template.capitalize)
+      end
+
+      def self.default_template
+        Brcobranca::Boleto::Template::Rghost
+      end
+
       private
 
       # Monta a primeira parte do código de barras, que é a mesma para todos bancos.
@@ -219,7 +266,6 @@ def valor_documento_formatado
       def class_name
         self.class.to_s.split("::").last.downcase
       end
-
     end
   end
 end

lib/brcobranca/boleto/caixa.rb

@@ -56,7 +56,7 @@ def nosso_numero_boleto
       # Utiliza-se o [-1..-1] para retornar o último caracter
       # @return [String]
       def nosso_numero_dv
-        "#{carteira}#{numero_documento}".modulo11_9to2.to_s[-1..-1]
+        "#{carteira}#{numero_documento}".modulo11_2to9_caixa.to_s
       end
 
       # Número da agência/código cedente do cliente para exibir no boleto.
@@ -70,7 +70,7 @@ def agencia_conta_boleto
       # Dígito verificador do convênio ou código do cedente
       # @return [String]
       def convenio_dv
-        "#{convenio.modulo11_2to9}"
+        "#{convenio.modulo11_2to9_caixa}"
       end
 
       # Monta a segunda parte do código de barras.
@@ -92,7 +92,7 @@ def codigo_barras_segunda_parte
         "#{nosso_numero_boleto[1..1]}" <<
         "#{nosso_numero_boleto[8..16]}"
 
-        "#{campo_livre}#{campo_livre.modulo11_2to9}"
+        "#{campo_livre}#{campo_livre.modulo11_2to9_caixa}"
       end
 
     end

lib/brcobranca/boleto/santander.rb

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+module Brcobranca
+  module Boleto
+    class Santander < Base
+
+      validates_length_of :agencia, :maximum => 4, :message => "deve ser menor ou igual a 4 dígitos."
+      validates_length_of :convenio, :maximum => 11, :message => "deve ser menor ou igual a 11 dígitos."
+      validates_length_of :numero_documento, :maximum => 7, :message => "deve ser menor ou igual a 7 dígitos."
+
+      # Nova instancia do Banespa
+      # @param (see Brcobranca::Boleto::Base#initialize)
+      def initialize(campos={})
+        padrao = {:carteira => "102", :banco => "033"}
+        campos = padrao.merge!(campos)
+        super(campos)
+      end
+
+      # @abstract Deverá ser sobreescrito para cada banco.
+      def nosso_numero_boleto
+        "#{self.numero_documento}-#{self.nosso_numero_dv}"
+      end
+
+      # @abstract Deverá ser sobreescrito para cada banco.
+      def agencia_conta_boleto
+        "#{self.agencia}-#{self.agencia_dv}/#{self.conta_corrente}-#{self.conta_corrente_dv}"
+      end
+
+      # Monta a segunda parte do código de barras, que é específico para cada banco.
+      #
+      # @abstract Deverá ser sobreescrito para cada banco.
+      def codigo_barras_segunda_parte
+          "9" * 25
+      end
+
+    end
+  end
+end

lib/brcobranca/boleto/template/html.rb

@@ -0,0 +1,40 @@
+#encoding: utf-8
+
+begin
+  require 'rghost_barcode'
+rescue LoadError
+  require 'rubygems' unless ENV['NO_RUBYGEMS']
+  gem 'rghost_barcode'
+  require 'rghost_barcode'
+end
+
+module Brcobranca
+  module Boleto
+    module Template
+      # Templates para usar com HTML
+      module Html
+        extend self
+        include RGhost unless self.include?(RGhost)
+        RGhost::Config::GS[:external_encoding] = Brcobranca.configuration.external_encoding
+
+        def generate(boleto, options)
+          if boleto.is_a? Array
+            modelo_generico_multipage(boleto, options)
+          else
+            modelo_generico(boleto, options)
+          end
+        end
+
+        private
+
+        def modelo_generico(boleto, options={})
+          #TODO: Render bank slip
+        end
+
+        def modelo_generico_multipage(boletos, options={})
+          #TODO: Render multiples bank slips
+        end
+      end
+    end
+  end
+end