correios-frete 1.4.0 → 1.5.0

data/CHANGELOG.rdoc

@@ -1,3 +1,7 @@
+== Versão 1.5.0
+- Novo: {Issue #3: Cálculo de frete para múltiplos itens}[https://github.com/prodis/correios-frete/issues/3] utilizando pacotes.
+- Correção: Formatação de separador de casas decimais com vírgula na requisição do Web Service dos Correios.
+
 == Versão 1.4.0
 - Novo: Suporte para cálculo de e-SEDEX Prioritário e e-SEDEX Express.
 

data/README.rdoc

@@ -1,10 +1,5 @@
 = correios-frete
 
----
-Esta documentação é das <b>versões >= 1.0.0</b>.
-Para a versão 0.3.0, por favor veja {README_v0.3.0.rdoc}[https://github.com/prodis/correios-frete/blob/master/README_v0.3.0.rdoc]
----
-
 Cálculo de frete utilizando o Web Service dos Correios (http://www.correios.com.br/webservices).
 
 Os serviços de frete suportados são <b>PAC</b>, <b>SEDEX</b>, <b>SEDEX a Cobrar</b> (necessário informar o valor declarado), <b>SEDEX 10</b>, <b>SEDEX Hoje</b> e <b>e-SEDEX</b>. Para os serviços com contrato é necessário informar código de empresa e senha.
@@ -78,7 +73,7 @@ Verificação de sucesso e erro:
   servico = frete.calcular_sedex
   servico.sucesso? # => false
   servico.erro?    # => true
-  servico.msg_erro # => "A altura nao pode ser maior que 90 cm."
+  servico.msg_erro # => "A altura nao pode ser maior que o comprimento."
 
 Usando a interface pública em inglês:
 
@@ -88,13 +83,73 @@ Usando a interface pública em inglês:
   servico.success? # => true
   servico.error?   # => false
 
+
+=== Usando pacotes
+
+Você pode "montar" um pacote com vários itens. Com o cálculo do volume dos itens adicionados, o pacote único será gerado em formato de cubo.
+
+  item1 = Correios::Frete::PacoteItem.new :peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2
+  item2 = Correios::Frete::PacoteItem.new :peso => 0.7, :comprimento => 70, :largura => 25, :altura => 3
+
+  pacote = Correios::Frete::Pacote.new
+  pacote.adicionar_item(item1)
+  pacote.adicionar_item(item2)
+
+  pacote.peso        # => 1.0
+  pacote.comprimento # => 18.32138799447962
+  pacote.largura     # => 18.32138799447962
+  pacote.altura      # => 18.32138799447962
+  pacote.volume      # => 6150.0
+  pacote.formato     # => :caixa_pacote
+  pacote.itens.size  # => 2
+
+Caso alguma dimensão do pacote montado seja menor que o tamanho mínimo exigido pelos Correios, o valor mínimo será atribuído à dimensão.
+
+  item1 = Correios::Frete::PacoteItem.new :peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2
+  item2 = Correios::Frete::PacoteItem.new :peso => 0.7, :comprimento => 40, :largura => 10, :altura => 3
+
+  pacote = Correios::Frete::Pacote.new
+  pacote.adicionar_item(item1)
+  pacote.adicionar_item(item2)
+
+  pacote.comprimento # => 16.0
+  pacote.largura     # => 12.80579164987494
+  pacote.altura      # => 12.80579164987494
+
+Montado o pacote, basta passá-lo pelo parâmetro <b>encomenda</b> no construtor de Correios::Frete::Calculador.
+
+  frete = Correios::Frete::Calculador.new :cep_origem => "04094-050",
+                                          :cep_destino => "90619-900",
+                                          :encomenda => pacote
+
+  servicos = frete.calcular :sedex, :pac
+
+  servicos[:sedex].valor         # => 29.2
+  servicos[:sedex].prazo_entrega # => 1
+
+  servicos[:pac].valor         # => 13.3
+  servicos[:pac].prazo_entrega # => 5
+
+<b>Observação:</b> Quando uma encomenda é fornecida ao calculador de frete, os parâmetros <b>peso</b>, <b>comprimento</b>, <b>largura</b>, <b>altura</b> e <b>formato</b> serão ignorados, sendo utilizados os valores da encomenda.
+
+Usando a interface pública em inglês:
+
+  item1 = Correios::Frete::PacoteItem.new :peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2
+  item2 = Correios::Frete::PacoteItem.new :peso => 0.7, :comprimento => 70, :largura => 25, :altura => 3
+
+  pacote = Correios::Frete::Pacote.new
+  pacote.add_item(item1)
+  pacote.add_item(item2)
+  pacote.items.size # => 2
+
+
 == Log
 
 Por padrão, cada chamada ao Web Service dos Correios é logada em STDOUT, com nível de log <b>:info</b>, usando a gem {LogMe}[http://github.com/prodis/log-me].
 
 Exemplo de log:
   I, [2011-10-01T00:26:16.864990 #5631]  INFO -- : Correios-Frete Request:
-  http://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?sCepOrigem=04094-050&sCepDestino=90619-900&nVlPeso=0.3&nVlComprimento=30&nVlAltura=2&nVlLargura=15&nVlDiametro=0.0&nCdFormato=1&sCdMaoPropria=N&sCdAvisoRecebimento=N&nVlValorDeclarado=0.00&nCdServico=41106&nCdEmpresa=&sDsSenha=&StrRetorno=xml
+  http://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?sCepOrigem=04094-050&sCepDestino=90619-900&nVlPeso=0.3&nVlComprimento=30&nVlAltura=2&nVlLargura=15&nVlDiametro=0.0&nCdFormato=1&sCdMaoPropria=N&sCdAvisoRecebimento=N&nVlValorDeclarado=0,00&nCdServico=41106&nCdEmpresa=&sDsSenha=&StrRetorno=xml
 
   I, [2011-10-01T00:26:17.121822 #5631]  INFO -- : Correios-Frete Response:
   HTTP/1.1 200 OK
@@ -103,7 +158,7 @@ Exemplo de log:
 
 Se você configurar o nível de log como <b>:debug</b>, serão logados também todos os cabeçalhos HTTP da resposta:
   D, [2011-10-01T00:27:50.597961 #5631] DEBUG -- : Correios-Frete Request:
-  http://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?sCepOrigem=04094-050&sCepDestino=90619-900&nVlPeso=0.3&nVlComprimento=30&nVlAltura=2&nVlLargura=15&nVlDiametro=0.0&nCdFormato=1&sCdMaoPropria=N&sCdAvisoRecebimento=N&nVlValorDeclarado=0.00&nCdServico=41106&nCdEmpresa=&sDsSenha=&StrRetorno=xml
+  http://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?sCepOrigem=04094-050&sCepDestino=90619-900&nVlPeso=0.3&nVlComprimento=30&nVlAltura=2&nVlLargura=15&nVlDiametro=0.0&nCdFormato=1&sCdMaoPropria=N&sCdAvisoRecebimento=N&nVlValorDeclarado=0,00&nCdServico=41106&nCdEmpresa=&sDsSenha=&StrRetorno=xml
 
   D, [2011-10-01T00:27:50.812046 #5631] DEBUG -- : Correios-Frete Response:
   HTTP/1.1 200 OK
@@ -170,21 +225,50 @@ Para desabilitar o log, mudar o nível do log ou configurar um outro mecanismo d
     f.altura = 2
   end
 
+=== Maneiras de adicionar itens em Correios::Frete::Pacote
+
+==== Com instâncias de Correios::Frete::PacoteItem
+
+  item1 = Correios::Frete::PacoteItem.new :peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2
+  item2 = Correios::Frete::PacoteItem.new :peso => 0.7, :comprimento => 70, :largura => 25, :altura => 3
+
+  pacote = Correios::Frete::Pacote.new
+  pacote.adicionar_item(item1)
+  pacote.adicionar_item(item2)
+
+==== Com parâmetros dos itens
+  pacote = Correios::Frete::Pacote.new
+  pacote.adicionar_item(:peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2)
+  pacote.adicionar_item(:peso => 0.7, :comprimento => 70, :largura => 25, :altura => 3)
+
 
 === Atributos de Correios::Frete::Calculador
 
 ==== String
   cep_origem, cep_destino, codigo_empresa, senha
 ==== Float
-  peso, valor_declarado
-==== Fixnum
-  comprimento, largura, altura, diametro
+  peso, comprimento, largura, altura, diametro, valor_declarado
 ==== Boolean
   mao_propria, aviso_recebimento
 ==== Symbol
   formato (:caixa_pacote, :rolo_prisma)
 
 
+=== Atributos de Correios::Frete::Pacote
+
+==== Float
+  peso, comprimento, largura, altura, volume
+==== Array de Correios::Frete::PacoteItem
+  itens
+==== Symbol
+  formato (:caixa_pacote)
+
+=== Atributos de Correios::Frete::PacoteItem
+
+==== Float
+  peso, comprimento, largura, altura, volume
+
+
 === Atributos de Correios::Frete::Servico
 
 ==== String
@@ -214,7 +298,7 @@ Para desabilitar o log, mudar o nível do log ou configurar um outro mecanismo d
 
 {Prodis a.k.a. Fernando Hamasaki}[http://prodis.blog.br]
 
-Copyright (c) 2011 Prodis
+Copyright (c) 2011-2012 Prodis
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/Rakefile

@@ -18,7 +18,7 @@ Jeweler::Tasks.new do |gem|
   gem.homepage = "http://prodis.blog.br/2011/07/03/gem-para-calculo-de-frete-dos-correios"
   gem.license = "MIT"
   gem.summary = %Q{Calculo de frete dos Correios.}
-  gem.description = %Q{Calculo de frete utilizando o Web Service dos Correios (http://www.correios.com.br/webservices). Os servicos de frete suportados sao PAC, SEDEX, SEDEX a Cobrar, SEDEX 10, SEDEX Hoje e e-SEDEX.}
+  gem.description = %Q{Calculo de frete utilizando o Web Service dos Correios (http://www.correios.com.br/webservices).\n\nOs servicos de frete suportados sao PAC, SEDEX, SEDEX a Cobrar, SEDEX 10, SEDEX Hoje e e-SEDEX.}
   gem.email = "prodis@gmail.com"
   gem.authors = ["Prodis a.k.a. Fernando Hamasaki"]
   gem.version = Correios::Frete::Version::VERSION

data/correios-frete.gemspec

@@ -5,16 +5,15 @@
 
 Gem::Specification.new do |s|
   s.name = "correios-frete"
-  s.version = "1.4.0"
+  s.version = "1.5.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Prodis a.k.a. Fernando Hamasaki"]
-  s.date = "2012-01-19"
-  s.description = "Calculo de frete utilizando o Web Service dos Correios (http://www.correios.com.br/webservices). Os servicos de frete suportados sao PAC, SEDEX, SEDEX a Cobrar, SEDEX 10, SEDEX Hoje e e-SEDEX."
+  s.date = "2012-01-25"
+  s.description = "Calculo de frete utilizando o Web Service dos Correios (http://www.correios.com.br/webservices).\n\nOs servicos de frete suportados sao PAC, SEDEX, SEDEX a Cobrar, SEDEX 10, SEDEX Hoje e e-SEDEX."
   s.email = "prodis@gmail.com"
   s.extra_rdoc_files = [
-    "README.rdoc",
-    "README_v0.3.0.rdoc"
+    "README.rdoc"
   ]
   s.files = [
     ".document",
@@ -23,17 +22,20 @@ Gem::Specification.new do |s|
     "Gemfile",
     "Gemfile.lock",
     "README.rdoc",
-    "README_v0.3.0.rdoc",
     "Rakefile",
     "correios-frete.gemspec",
     "lib/correios-frete.rb",
     "lib/correios/frete.rb",
     "lib/correios/frete/calculador.rb",
+    "lib/correios/frete/pacote.rb",
+    "lib/correios/frete/pacote_item.rb",
     "lib/correios/frete/parser.rb",
     "lib/correios/frete/servico.rb",
     "lib/correios/frete/version.rb",
     "lib/correios/frete/web_service.rb",
     "spec/correios/frete/calculador_spec.rb",
+    "spec/correios/frete/pacote_item_spec.rb",
+    "spec/correios/frete/pacote_spec.rb",
     "spec/correios/frete/parser_spec.rb",
     "spec/correios/frete/servico_spec.rb",
     "spec/correios/frete/web_service_spec.rb",

data/lib/correios-frete.rb

@@ -2,6 +2,8 @@
 require 'rubygems'
 require 'correios/frete'
 require 'correios/frete/calculador'
+require 'correios/frete/pacote'
+require 'correios/frete/pacote_item'
 require 'correios/frete/parser'
 require 'correios/frete/servico'
 require 'correios/frete/web_service'

data/lib/correios/frete/calculador.rb

@@ -3,15 +3,15 @@ module Correios
   module Frete
     class Calculador
       attr_accessor :cep_origem, :cep_destino
-      attr_accessor :peso, :comprimento, :altura, :largura, :diametro
-      attr_accessor :formato, :mao_propria, :aviso_recebimento, :valor_declarado
-      attr_accessor :codigo_empresa, :senha
+      attr_accessor :diametro, :mao_propria, :aviso_recebimento, :valor_declarado
+      attr_accessor :codigo_empresa, :senha, :encomenda
+      attr_writer :peso, :comprimento, :largura, :altura, :formato
 
       DEFAULT_OPTIONS = {
         :peso => 0.0,
         :comprimento => 0.0,
-        :altura => 0.0,
         :largura => 0.0,
+        :altura => 0.0,
         :diametro => 0.0,
         :formato => :caixa_pacote,
         :mao_propria => false,
@@ -27,6 +27,12 @@ module Correios
         yield self if block_given?
       end
 
+      [:peso, :comprimento, :largura, :altura, :formato].each do |method|
+        define_method method do
+          @encomenda ? @encomenda.send(method) : instance_variable_get("@#{method}")
+        end
+      end
+
       def calcular(*service_types)
         response = web_service(service_types).request!
         services = parser.servicos(response)

data/lib/correios/frete/pacote.rb

@@ -0,0 +1,67 @@
+# encoding: UTF-8
+module Correios
+  module Frete
+    class Pacote
+      attr_reader :peso, :comprimento, :altura, :largura, :volume
+
+      MIN_DIMENSIONS = {
+        :comprimento => 16.0,
+        :largura => 11.0,
+        :altura => 2.0
+      }
+
+      def initialize()
+        @peso = @comprimento = @largura = @altura = @volume = 0.0
+        @itens = []
+      end
+
+      def formato
+        :caixa_pacote
+      end
+
+      def itens
+        @itens
+      end
+      alias items itens
+
+      def adicionar_item(item)
+        return unless item
+
+        item = Correios::Frete::PacoteItem.new(item) if item.is_a?(Hash)
+        @itens << item
+
+        calcular_medidas(item)
+        item
+      end
+      alias add_item adicionar_item
+
+      private
+
+      def calcular_medidas(item)
+        @peso += item.peso
+        @volume += item.volume
+
+        if @itens.size == 1
+          @comprimento = item.comprimento
+          @largura = item.largura
+          @altura = item.altura
+        else
+          dimensao = @volume.to_f**(1.0/3)
+          @comprimento = @largura = @altura = dimensao
+        end
+
+        min_dimension_values
+      end
+
+      def min_dimension_values()
+        @comprimento = min(@comprimento, MIN_DIMENSIONS[:comprimento])
+        @largura = min(@largura, MIN_DIMENSIONS[:largura])
+        @altura = min(@altura, MIN_DIMENSIONS[:altura])
+      end
+
+      def min(value, minimum)
+        (value < minimum) ? minimum : value
+      end
+    end
+  end
+end

data/lib/correios/frete/pacote_item.rb

@@ -0,0 +1,27 @@
+# encoding: UTF-8
+module Correios
+  module Frete
+    class PacoteItem
+      attr_accessor :peso, :comprimento, :largura, :altura
+
+      DEFAULT_OPTIONS = {
+        :peso => 0.0,
+        :comprimento => 0.0,
+        :largura => 0.0,
+        :altura => 0.0
+      }
+
+      def initialize(options = {})
+        DEFAULT_OPTIONS.merge(options).each do |attr, value|
+          self.send("#{attr}=", value)
+        end
+
+        yield self if block_given?
+      end
+
+      def volume
+        @comprimento * @largura * @altura
+      end
+    end
+  end
+end

data/lib/correios/frete/version.rb

@@ -3,7 +3,7 @@ module Correios
   module Frete
     module Version
       MAJOR = 1
-      MINOR = 4
+      MINOR = 5
       PATCH = 0
       VERSION = [MAJOR, MINOR, PATCH].join(".")
     end

data/lib/correios/frete/web_service.rb

@@ -24,20 +24,24 @@ module Correios
         "sCepOrigem=#{frete.cep_origem}&" +
         "sCepDestino=#{frete.cep_destino}&" +
         "nVlPeso=#{frete.peso}&" +
-        "nVlComprimento=#{frete.comprimento}&" +
-        "nVlAltura=#{frete.altura}&" +
-        "nVlLargura=#{frete.largura}&" +
-        "nVlDiametro=#{frete.diametro}&" +
+        "nVlComprimento=#{format_decimal(frete.comprimento)}&" +
+        "nVlLargura=#{format_decimal(frete.largura)}&" +
+        "nVlAltura=#{format_decimal(frete.altura)}&" +
+        "nVlDiametro=#{format_decimal(frete.diametro)}&" +
         "nCdFormato=#{FORMATS[frete.formato]}&" +
         "sCdMaoPropria=#{CONDITIONS[frete.mao_propria]}&" +
         "sCdAvisoRecebimento=#{CONDITIONS[frete.aviso_recebimento]}&" +
-        "nVlValorDeclarado=#{format("%.2f" % frete.valor_declarado)}&" +
+        "nVlValorDeclarado=#{format_decimal(format("%.2f" % frete.valor_declarado))}&" +
         "nCdServico=#{service_codes_for(service_types)}&" +
         "nCdEmpresa=#{frete.codigo_empresa}&" +
         "sDsSenha=#{frete.senha}&" +
         "StrRetorno=xml"
       end
 
+      def format_decimal(value)
+        value.to_s.gsub(".", ",")
+      end
+
       def service_codes_for(service_types)
         service_types.map { |type| Correios::Frete::Servico.code_from_type(type) }.join(",")
       end

data/spec/correios/frete/calculador_spec.rb

@@ -8,8 +8,8 @@ describe Correios::Frete::Calculador do
 
       { :peso => 0.0,
         :comprimento => 0.0,
-        :altura => 0.0,
         :largura => 0.0,
+        :altura => 0.0,
         :diametro => 0.0,
         :formato => :caixa_pacote,
         :mao_propria => false,
@@ -25,27 +25,71 @@ describe Correios::Frete::Calculador do
     { :cep_origem => "01000-000",
       :cep_destino => "021222-222",
       :peso => 0.321,
-      :comprimento => 12.5,
-      :altura => 1.4,
-      :largura => 4.6,
-      :diametro => 5.0,
+      :comprimento => 30,
+      :largura => 15,
+      :altura => 2,
+      :diametro => 5,
       :formato => :rolo_prisma,
       :mao_propria => true,
       :aviso_recebimento => true,
       :valor_declarado => 1.99,
       :codigo_empresa => "1234567890",
       :senha => "senha",
+      :encomenda => Correios::Frete::Pacote.new
     }.each do |attr, value|
       context "when #{attr} is supplied" do
         it "sets #{attr}" do
-          @frete = Correios::Frete::Calculador.new(attr => value)
-          @frete.send(attr).should == value
+          frete = Correios::Frete::Calculador.new(attr => value)
+          frete.send(attr).should == value
         end
       end
 
       context "when #{attr} is supplied in a block" do
         it "sets #{attr}" do
-          @frete = Correios::Frete::Calculador.new { |f| f.send("#{attr}=", value) }
+          frete = Correios::Frete::Calculador.new { |f| f.send("#{attr}=", value) }
+          frete.send(attr).should == value
+        end
+      end
+    end
+  end
+
+  describe "#encomenda" do
+    context "when encomenda is supplied" do
+      before :each do
+        @encomenda = Correios::Frete::Pacote.new
+        @encomenda.adicionar_item(:peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2)
+        @encomenda.adicionar_item(:peso => 0.7, :comprimento => 70, :largura => 25, :altura => 3)
+        @frete = Correios::Frete::Calculador.new :peso => 10.5,
+                                                 :comprimento => 105,
+                                                 :largura => 50,
+                                                 :altura => 10,
+                                                 :formato => :rolo_prisma,
+                                                 :encomenda => @encomenda
+      end
+
+      [:peso, :comprimento, :largura, :altura, :formato].each do |attr|
+        it "#{attr} returns encomenda #{attr}" do
+          @frete.send(attr).should == @encomenda.send(attr)
+        end
+      end
+    end
+
+    context "when encomenda is not supplied" do
+      before :each do
+        @frete = Correios::Frete::Calculador.new :peso => 10.5,
+                                                 :comprimento => 105,
+                                                 :largura => 50,
+                                                 :altura => 10,
+                                                 :formato => :rolo_prisma
+      end
+
+      { :peso => 10.5,
+        :comprimento => 105,
+        :largura => 50,
+        :altura => 10,
+        :formato => :rolo_prisma
+      }.each do |attr, value|
+        it "#{attr} returns supplied #{attr}" do
           @frete.send(attr).should == value
         end
       end
@@ -112,7 +156,7 @@ describe Correios::Frete::Calculador do
         end
 
         it "returns true in respond_to?" do
-          subject.respond_to?("#{method_name}_#{service[:type]}").should be_true
+          @frete.respond_to?("#{method_name}_#{service[:type]}").should be_true
         end
       end
     end
@@ -125,7 +169,7 @@ describe Correios::Frete::Calculador do
       end
 
       it "returns false in respond_to?" do
-        subject.respond_to?("#{method_name}_servico_que_nao_existe").should be_false
+        @frete.respond_to?("#{method_name}_servico_que_nao_existe").should be_false
       end
     end
   end

data/spec/correios/frete/pacote_item_spec.rb

@@ -0,0 +1,47 @@
+# encoding: UTF-8
+require 'spec_helper'
+
+describe Correios::Frete::PacoteItem do
+  describe ".new" do
+    context "create with default value of" do
+      before(:each) { @item = Correios::Frete::PacoteItem.new }
+
+      { :peso => 0.0,
+        :comprimento => 0.0,
+        :largura => 0.0,
+        :altura => 0.0
+      }.each do |attr, value|
+        it attr do
+          @item.send(attr).should == value
+        end
+      end
+    end
+
+    { :peso => 0.3,
+      :comprimento => 30,
+      :largura => 15,
+      :altura => 2,
+    }.each do |attr, value|
+      context "when #{attr} is supplied" do
+        it "sets #{attr}" do
+          item = Correios::Frete::PacoteItem.new(attr => value)
+          item.send(attr).should == value
+        end
+      end
+
+      context "when #{attr} is supplied in a block" do
+        it "sets #{attr}" do
+          item = Correios::Frete::PacoteItem.new { |f| f.send("#{attr}=", value) }
+          item.send(attr).should == value
+        end
+      end
+    end
+  end
+
+  describe "#volume" do
+    it "calculates item volume" do
+      item = Correios::Frete::PacoteItem.new(:comprimento => 16, :largura => 11, :altura => 2)
+      item.volume.should == 16 * 11 * 2
+    end
+  end
+end

data/spec/correios/frete/pacote_spec.rb

@@ -0,0 +1,160 @@
+# encoding: UTF-8
+require 'spec_helper'
+
+describe Correios::Frete::Pacote do
+  before(:each) { @pacote = Correios::Frete::Pacote.new }
+
+  describe ".new" do
+    context "create with default value of" do
+      { :peso => 0.0,
+        :comprimento => 0.0,
+        :altura => 0.0,
+        :largura => 0.0
+      }.each do |attr, value|
+        it attr do
+          @pacote.send(attr).should == value
+        end
+      end
+
+      it "itens" do
+        @pacote.itens.should be_empty
+      end
+    end
+  end
+
+  describe "#formato" do
+    it "is caixa/pacote" do
+      @pacote.formato.should == :caixa_pacote
+    end
+  end
+
+  describe "#adicionar_item" do
+    context "when adds a package item" do
+      it "adds in items" do
+        item = Correios::Frete::PacoteItem.new
+        @pacote.adicionar_item(item)
+        @pacote.itens.first.should == item
+      end
+    end
+
+    context "when adds package item params" do
+      it "adds new item" do
+        params = { :peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2 }
+        @pacote.adicionar_item(params)
+
+        @pacote.itens.first.peso.should == params[:peso]
+        @pacote.itens.first.comprimento.should == params[:comprimento]
+        @pacote.itens.first.altura.should == params[:altura]
+        @pacote.itens.first.largura.should == params[:largura]
+      end
+    end
+
+    context "when adds nil item" do
+      it "does not add" do
+        @pacote.adicionar_item(nil)
+        @pacote.itens.should be_empty
+      end
+    end
+  end
+
+  describe "calculations" do
+    context "when adds one package item" do
+      before :each do
+        @item = Correios::Frete::PacoteItem.new(:peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2)
+        @pacote.adicionar_item(@item)
+      end
+
+      it "calculates package weight" do
+        @pacote.peso.should == @item.peso
+      end
+
+      it "calculates package volume" do
+        @pacote.volume.should == @item.volume
+      end
+
+      it "calculates package length" do
+        @pacote.comprimento.should == @item.comprimento
+      end
+
+      it "calculates package width" do
+        @pacote.largura.should == @item.largura
+      end
+
+      it "calculates package height" do
+        @pacote.altura.should == @item.altura
+      end
+
+      context "with dimensions less than each minimum" do
+        before :each do
+          item = Correios::Frete::PacoteItem.new(:peso => 0.3, :comprimento => 15, :largura => 10, :altura => 1)
+          @pacote = Correios::Frete::Pacote.new
+          @pacote.adicionar_item(item)
+        end
+
+        it "sets minimum length value" do
+          @pacote.comprimento.should == 16
+        end
+
+        it "sets minimum width value" do
+          @pacote.largura.should == 11
+        end
+
+        it "sets minimum height value" do
+          @pacote.altura.should == 2
+        end
+      end
+    end
+
+    context "when adds more than one package item" do
+      before :each do
+        @item1 = Correios::Frete::PacoteItem.new(:peso => 0.3, :comprimento => 30, :largura => 15, :altura => 2)
+        @item2 = Correios::Frete::PacoteItem.new(:peso => 0.7, :comprimento => 70, :largura => 25, :altura => 3)
+        @expected_dimension = (@item1.volume + @item2.volume).to_f**(1.0/3)
+
+        @pacote.adicionar_item(@item1)
+        @pacote.adicionar_item(@item2)
+      end
+
+      it "calculates package weight" do
+        @pacote.peso.should == @item1.peso + @item2.peso
+      end
+
+      it "calculates package volume" do
+        @pacote.volume.should == @item1.volume + @item2.volume
+      end
+
+      it "calculates package length" do
+        @pacote.comprimento.should == @expected_dimension
+      end
+
+      it "calculates package width" do
+        @pacote.largura.should == @expected_dimension
+      end
+
+      it "calculates package height" do
+        @pacote.altura.should == @expected_dimension
+      end
+
+      context "with dimensions less than each minimum" do
+        before :each do
+          item = Correios::Frete::PacoteItem.new(:peso => 0.3, :comprimento => 3, :largura => 1, :altura => 1)
+          @pacote = Correios::Frete::Pacote.new
+          @pacote.adicionar_item(item)
+          @pacote.adicionar_item(item)
+        end
+
+        it "sets minimum length value" do
+          @pacote.comprimento.should == 16
+        end
+
+        it "sets minimum width value" do
+          @pacote.largura.should == 11
+        end
+
+        it "sets minimum height value" do
+          @pacote.altura.should == 2
+        end
+      end
+    end
+  end
+end

metadata

@@ -2,7 +2,7 @@
 name: correios-frete
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors: 
 - Prodis a.k.a. Fernando Hamasaki
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-01-19 00:00:00 Z
+date: 2012-01-25 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: log-me
@@ -111,7 +111,10 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: *id009
-description: Calculo de frete utilizando o Web Service dos Correios (http://www.correios.com.br/webservices). Os servicos de frete suportados sao PAC, SEDEX, SEDEX a Cobrar, SEDEX 10, SEDEX Hoje e e-SEDEX.
+description: |-
+  Calculo de frete utilizando o Web Service dos Correios (http://www.correios.com.br/webservices).
+  
+  Os servicos de frete suportados sao PAC, SEDEX, SEDEX a Cobrar, SEDEX 10, SEDEX Hoje e e-SEDEX.
 email: prodis@gmail.com
 executables: []
 
@@ -119,7 +122,6 @@ extensions: []
 
 extra_rdoc_files: 
 - README.rdoc
-- README_v0.3.0.rdoc
 files: 
 - .document
 - .rspec
@@ -127,17 +129,20 @@ files:
 - Gemfile
 - Gemfile.lock
 - README.rdoc
-- README_v0.3.0.rdoc
 - Rakefile
 - correios-frete.gemspec
 - lib/correios-frete.rb
 - lib/correios/frete.rb
 - lib/correios/frete/calculador.rb
+- lib/correios/frete/pacote.rb
+- lib/correios/frete/pacote_item.rb
 - lib/correios/frete/parser.rb
 - lib/correios/frete/servico.rb
 - lib/correios/frete/version.rb
 - lib/correios/frete/web_service.rb
 - spec/correios/frete/calculador_spec.rb
+- spec/correios/frete/pacote_item_spec.rb
+- spec/correios/frete/pacote_spec.rb
 - spec/correios/frete/parser_spec.rb
 - spec/correios/frete/servico_spec.rb
 - spec/correios/frete/web_service_spec.rb

data/README_v0.3.0.rdoc

@@ -1,168 +0,0 @@
-= correios-frete
-
----
-Esta documentação é da <b>versão 0.3.0</b>.
-Para a versão 1.0.0 ou acima, por favor veja {README.rdoc}[https://github.com/prodis/correios-frete/blob/master/README.rdoc]
----
-
-Cálculo de frete utilizando o Web Service dos Correios (http://www.correios.com.br/webservices).
-
-Os serviços de frete suportados são <b>PAC</b>, <b>SEDEX</b>, <b>SEDEX 10</b>, <b>SEDEX Hoje</b> e <b>e-SEDEX</b> (necessário informar código de empresa e senha).
-
-== Instalando
-
-=== Gemfile
-  gem 'correios-frete'
-
-=== Instalação direta
-  $ gem install correios-frete
-
-
-== Usando
-
-  require 'correios-frete'
-
-  frete = Correios::Frete.new :cep_origem => "04094-050",
-                              :cep_destino => "90619-900",
-                              :peso => 0.3,
-                              :comprimento => 30,
-                              :largura => 15,
-                              :altura => 2
-
-Cálculo de vários serviços ao mesmo tempo:
-
-  servicos = frete.calcular :sedex, :pac
-
-  servicos[:sedex].nome          # => "SEDEX"
-  servicos[:sedex].valor         # => 26.2
-  servicos[:sedex].prazo_entrega # => 1
-
-  servicos[:pac].nome          # => "PAC"
-  servicos[:pac].valor         # => 10.0
-  servicos[:pac].prazo_entrega # => 5
-
-Cálculo de um serviço de frete passando o serviço para parâmetro:
-
-  servico = frete.calcular :sedex
-  service.nome          # => "SEDEX"
-  servico.valor         # => 26.2
-  servico.prazo_entrega # => 1
-
-  servico = frete.calcular :pac
-  service.nome          # => "PAC"
-  servico.valor         # => 10.0
-  servico.prazo_entrega # => 5
-
-Cálculo de um serviço de frete chamando o método direto do serviço:
-
-  servico = frete.calcular_sedex
-  service.nome          # => "SEDEX"
-  servico.valor         # => 26.2
-  servico.prazo_entrega # => 1
-
-  servico = frete.calcular_pac
-  service.nome          # => "PAC"
-  servico.valor         # => 10.0
-  servico.prazo_entrega # => 5
-
-Verificação de sucesso e erro:
-
-  frete.altura = 100
-
-  servico = frete.calcular_sedex
-  servico.sucesso? # => false
-  servico.erro?    # => true
-  servico.msg_erro # => "A altura nao pode ser maior que 90 cm."
-
-Usando a interface pública em inglês:
-
-  servicos = frete.calculate :sedex, :pac
-  servico = frete.calculate_sedex
-  servico.success? # => true
-  servico.error?   # => false
-
-== Informações adicionais
-
-=== Serviços suportados
-  :pac
-  :sedex
-  :sedex_10
-  :sedex_hoje
-  :e_sedex
-
-
-=== Maneiras de configurar atributos no construtor de Correios::Frete
-
-==== Com um hash
-  frete = Correios::Frete.new :cep_origem => "04094-050",
-                              :cep_destino => "90619-900",
-                              :peso => 0.3,
-                              :comprimento => 30,
-                              :largura => 15,
-                              :altura => 2
-
-==== Com um bloco
-  frete = Correios::Frete.new do |f|
-    f.cep_origem = "04094-050"
-    f.cep_destino = "90619-900"
-    f.peso = 0.3
-    f.comprimento = 30
-    f.largura = 15
-    f.altura = 2
-  end
-
-
-=== Atributos de Correios::Frete
-
-==== String
-  cep_origem, cep_destino, codigo_empresa, senha
-==== Float
-  peso, valor_declarado
-==== Fixnum
-  comprimento, largura, altura, diametro
-==== Boolean
-  mao_propria, aviso_recebimento
-==== Symbol
-  formato (:caixa_pacote, :rolo_prisma)
-
-
-=== Atributos de Correios::Frete::Servico
-
-==== String
-  codigo, erro, msg_erro, nome
-==== Float
-  valor, valor_mao_propria, valor_aviso_recebimento, valor_valor_declarado
-==== Fixnum
-  prazo_entrega
-==== Boolean
-  entrega_domiciliar, entrega_sabado
-==== Symbol
-  tipo (:pac, :sedex, :sedex_10, :sedex_hoje, :e_sedex)
-
-== Copyright
-
-(The MIT License)
-
-{Prodis a.k.a. Fernando Hamasaki}[http://prodis.blog.br]
-
-Copyright (c) 2011 Prodis
-
-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.
-