pagseguro-oficial 2.0.7 → 2.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b0050b2e944dc6682bd9f7df9132100ca1ee4358
-  data.tar.gz: 2b7d750c8adabea028fad019a1bebe11ecbc42d5
+  metadata.gz: e774d4d23c27502385d14f5e9bc90ada28317325
+  data.tar.gz: 6000c710d322c4faae2c4d95d0b3a03c34045d2e
 SHA512:
-  metadata.gz: df2981bdb81aa06ec264e84ab5e74bc4779327b5e66147734346556a22d490ac0d383f735a5e8acc0e2139d2d7109f3d713881fff0a0c5d4bd467fcd6952a0b8
-  data.tar.gz: 098b3b8a5dee04b6961f0057c3e8bfe42ebdc5ff5d330ba32951f7990f3cbdea19540567805bd84e7dc84a6deb1a11672a9a9c68fa1c3e62939651bc93f6ca4d
+  metadata.gz: fd59c649d168459fb7864fb2a30c34a3ef381c3355c7ff4455058f20b37905447a7f5095bc1e17e775d2d5f340a15a27cc21c3052d853f57dad85c004a01f80f
+  data.tar.gz: ef3e534a97d8e8486f44099d80f82f76c2f14c05303aee1a2ffe3456df4f8cfb0025ede3b50ce68aa7128e564004950dfd41821326a1dfb10ad34dc5cea01a19

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## Next release - 2.0.8
+
+- Consulta de opções de parcelamento
+
 ## Next release - 2.0.7
 
  - Suporte para adicionar parâmetros dinamicamente na criação de requisições de pagamentos (isso possibilita a utilização de parâmetros da api que ainda não foram mapeados na gem)

data/README.md

@@ -12,6 +12,7 @@ A biblioteca PagSeguro em Ruby é um conjunto de classes de domínio que facilit
  - Consultar [transações por código]
  - Consultar [transações por intervalo de datas]
  - Consultar [transações abandonadas]
+ - Consultar opções de parcelamento
  - Receber [notificações]
 
 
@@ -26,7 +27,7 @@ A biblioteca PagSeguro em Ruby é um conjunto de classes de domínio que facilit
  - Adicione a biblioteca ao seu Gemfile.
 
 ```ruby
-gem "pagseguro-oficial", git: "git://github.com/pagseguro/ruby.git"
+gem "pagseguro-oficial", "~> 2.0.8"
 ```
 
  - Execute o comando `bundle install`.
@@ -177,6 +178,29 @@ while report.next_page?
 end
 ```
 
+### Consultar opções de parcelamento
+
+Você pode consultar as opções de parcelamento para um determinado valor.
+
+```ruby
+installments = PagSeguro::Installment.find("100.00")
+
+puts "=> INSTALLMENTS"
+puts
+installments.each do |installment|
+  puts installment.inspect
+end
+
+visa_installments = PagSeguro::Installment.find("100.00", "visa")
+
+puts
+puts "=> VISA INSTALLMENTS"
+puts
+visa_installments.each do |installment|
+  puts installment.inspect
+end
+```
+
 ## API
 
 ### PagSeguro::PaymentRequest

data/examples/installment.rb

@@ -0,0 +1,19 @@
+require_relative "boot"
+
+installments = PagSeguro::Installment.find("100.00")
+
+puts "=> INSTALLMENTS"
+puts
+installments.each do |installment|
+  puts installment.inspect
+end
+
+
+visa_installments = PagSeguro::Installment.find("100.00", "visa")
+
+puts
+puts "=> VISA INSTALLMENTS"
+puts
+visa_installments.each do |installment|
+  puts installment.inspect
+end

data/lib/pagseguro.rb

@@ -15,6 +15,9 @@ require "pagseguro/extensions/ensure_type"
 require "pagseguro/address"
 require "pagseguro/shipping"
 require "pagseguro/phone"
+require "pagseguro/installment"
+require "pagseguro/installment/response"
+require "pagseguro/installment/serializer"
 require "pagseguro/item"
 require "pagseguro/items"
 require "pagseguro/payment_method"

data/lib/pagseguro/installment.rb

@@ -0,0 +1,46 @@
+module PagSeguro
+  class Installment
+    include Extensions::MassAssignment
+
+    # Set the credit card brand.
+    attr_accessor :card_brand
+
+    # Set the installments quantity.
+    attr_accessor :quantity
+
+    # Set the amount.
+    # Must fit the patern: \\d+.\\d{2} (e.g. "12.00")
+    attr_accessor :amount
+
+    # Set total amount.
+    attr_accessor :total_amount
+
+    # Set interest free.
+    attr_accessor :interest_free
+
+    # Find installment options by a given amount
+    # Optional. Credit card brand
+    # Return an Array of PagSeguro::Installment instances
+    def self.find(amount, card_brand = nil)
+      string = "installments?amount=#{amount}"
+      string += "&cardBrand=#{card_brand}" if card_brand
+      load_from_response Request.get(string)
+    end
+
+    # Serialize the HTTP response into data.
+    def self.load_from_response(response) # :nodoc:
+      if response.success? and response.xml?
+        Nokogiri::XML(response.body).css("installments > installment").map do |node|
+          load_from_xml(node)
+        end
+      else
+        Response.new Errors.new(response)
+      end
+    end
+
+    # Serialize the XML object.
+    def self.load_from_xml(xml) # :nodoc:
+      new Serializer.new(xml).serialize
+    end
+  end
+end

data/lib/pagseguro/installment/response.rb

@@ -0,0 +1,12 @@
+module PagSeguro
+  class Installment
+    class Response
+      # Set the response errors.
+      attr_reader :errors
+
+      def initialize(errors = Errors.new)
+        @errors = errors
+      end
+    end
+  end
+end

data/lib/pagseguro/installment/serializer.rb

@@ -0,0 +1,22 @@
+module PagSeguro
+  class Installment
+    class Serializer
+      # The installment that will be serialized
+      attr_reader :xml
+
+      def initialize(xml)
+        @xml = xml
+      end
+
+      def serialize
+        {}.tap do |data|
+          data[:card_brand] = xml.css("cardBrand").text
+          data[:quantity] = xml.css("quantity").text
+          data[:amount] = xml.css("amount").text
+          data[:total_amount] = xml.css("totalAmount").text
+          data[:interest_free] = xml.css("interestFree").text
+        end
+      end
+    end
+  end
+end

data/lib/pagseguro/version.rb

@@ -1,3 +1,3 @@
 module PagSeguro
-  VERSION = "2.0.7"
+  VERSION = "2.0.8"
 end

data/spec/fixtures/installment/success.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<installments>
+  <installment>
+    <cardBrand>visa</cardBrand>
+    <quantity>1</quantity>
+    <amount>500.00</amount>
+    <totalAmount>500.00</totalAmount>
+    <interestFree>true</interestFree>
+  </installment>
+  <installment>
+    <cardBrand>visa</cardBrand>
+    <quantity>2</quantity>
+    <amount>261.28</amount>
+    <totalAmount>522.55</totalAmount>
+    <interestFree>false</interestFree>
+  </installment>
+  <installment>
+    <cardBrand>visa</cardBrand>
+    <quantity>3</quantity>
+    <amount>176.73</amount>
+    <totalAmount>530.20</totalAmount>
+    <interestFree>false</interestFree>
+  </installment>
+</installments>

data/spec/fixtures/payment_request/failure.xml

@@ -4,4 +4,4 @@
     <code>11024</code>
     <message>Items invalid quantity.</message>
   </error>
-</errors>
+</errors>

data/spec/pagseguro/installment/serializer_spec.rb

@@ -0,0 +1,33 @@
+require "spec_helper"
+
+describe PagSeguro::Installment::Serializer do
+  context "when there are installments" do
+    let(:source) { File.read("./spec/fixtures/installment/success.xml") }
+    let(:xml) { Nokogiri::XML(source) }
+    subject(:data) do
+      xml.css("installments > installment").map do |xml|
+        described_class.new(xml).serialize
+      end
+    end
+
+    it { expect(data.size).to eq(3) }
+
+    it { expect(data[0]).to include(card_brand: "visa") }
+    it { expect(data[0]).to include(quantity: "1") }
+    it { expect(data[0]).to include(amount: "500.00") }
+    it { expect(data[0]).to include(total_amount: "500.00") }
+    it { expect(data[0]).to include(interest_free: "true") }
+
+    it { expect(data[1]).to include(card_brand: "visa") }
+    it { expect(data[1]).to include(quantity: "2") }
+    it { expect(data[1]).to include(amount: "261.28") }
+    it { expect(data[1]).to include(total_amount: "522.55") }
+    it { expect(data[1]).to include(interest_free: "false") }
+
+    it { expect(data[2]).to include(card_brand: "visa") }
+    it { expect(data[2]).to include(quantity: "3") }
+    it { expect(data[2]).to include(amount: "176.73") }
+    it { expect(data[2]).to include(total_amount: "530.20") }
+    it { expect(data[2]).to include(interest_free: "false") }
+  end
+end

data/spec/pagseguro/installment_spec.rb

@@ -0,0 +1,97 @@
+require "spec_helper"
+
+describe PagSeguro::Installment do
+  it_assigns_attribute :card_brand
+  it_assigns_attribute :quantity
+  it_assigns_attribute :amount
+  it_assigns_attribute :total_amount
+  it_assigns_attribute :interest_free
+
+  describe ".find" do
+    context "when request succeeds" do
+      let(:request) { double("request") }
+
+      it "finds installments by the given amount" do
+        expect(PagSeguro::Request).to receive(:get)
+          .with("installments?amount=100.00")
+          .and_return(request)
+        expect(PagSeguro::Installment).to receive(:load_from_response)
+          .with(request)
+
+        PagSeguro::Installment.find("100.00")
+      end
+
+      it "find installments by amount and credit card brand" do
+        expect(PagSeguro::Request).to receive(:get)
+          .with("installments?amount=100.00&cardBrand=visa")
+          .and_return(request)
+        expect(PagSeguro::Installment).to receive(:load_from_response)
+          .with(request)
+
+        PagSeguro::Installment.find("100.00", :visa)
+      end
+    end
+
+    context "when request fails" do
+      it "returns response with errors" do
+        body = %[<?xml version="1.0"?><errors><error><code>1234</code>
+          <message>Sample error</message></error></errors>]
+        FakeWeb.register_uri :get, %r[.+], status: [400, "Bad Request"],
+          body: body, content_type: "text/xml"
+        response = PagSeguro::Installment.find("invalid")
+
+        expect(response).to be_a(PagSeguro::Installment::Response)
+        expect(response.errors).to include("Sample error")
+      end
+    end
+  end
+
+  describe ".load_from_response" do
+    context "when response succeeds" do
+      let(:response_body) { double(:response_body) }
+      let(:response) do
+        double(:response, success?: true, xml?: true, body: response_body)
+      end
+      let(:xml) { double(:xml) }
+      let(:node) { double(:node) }
+      let(:installments_nodes) { [node] }
+
+      it "loads response" do
+        expect(Nokogiri).to receive(:XML).with(response_body).and_return(xml)
+        expect(xml).to receive(:css).with("installments > installment")
+          .and_return(installments_nodes)
+        expect(PagSeguro::Installment).to receive(:load_from_xml).with(node)
+
+        PagSeguro::Installment.load_from_response(response)
+      end
+    end
+
+    context "when response fails" do
+      let(:response) { double(:response, success?: false) }
+      let(:error) { double(:error) }
+
+      it "returns response with errors" do
+        expect(PagSeguro::Errors).to receive(:new).with(response)
+          .and_return(error)
+        expect(PagSeguro::Installment::Response).to receive(:new).with(error)
+
+        PagSeguro::Installment.load_from_response(response)
+      end
+    end
+  end
+
+  describe ".load_from_xml" do
+    let(:xml) { double(:xml) }
+    let(:serializer) { double(:serializer) }
+    let(:data) { double(:data) }
+
+    it "serializes the xml" do
+      expect(PagSeguro::Installment::Serializer).to receive(:new).with(xml)
+        .and_return(serializer)
+      expect(serializer).to receive(:serialize).and_return(data)
+      expect(PagSeguro::Installment).to receive(:new).with(data)
+
+      PagSeguro::Installment.load_from_xml(xml)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pagseguro-oficial
 version: !ruby/object:Gem::Version
-  version: 2.0.7
+  version: 2.0.8
 platform: ruby
 authors:
 - Nando Vieira
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-03 00:00:00.000000000 Z
+date: 2015-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aitch
@@ -181,6 +181,7 @@ files:
 - Rakefile
 - examples/abandoned_transactions.rb
 - examples/boot.rb
+- examples/installment.rb
 - examples/invalid_transaction_by_notification_code.rb
 - examples/payment_request.rb
 - examples/transaction_by_notification_code.rb
@@ -193,6 +194,9 @@ files:
 - lib/pagseguro/exceptions.rb
 - lib/pagseguro/extensions/ensure_type.rb
 - lib/pagseguro/extensions/mass_assignment.rb
+- lib/pagseguro/installment.rb
+- lib/pagseguro/installment/response.rb
+- lib/pagseguro/installment/serializer.rb
 - lib/pagseguro/item.rb
 - lib/pagseguro/items.rb
 - lib/pagseguro/notification.rb
@@ -213,6 +217,7 @@ files:
 - locales/pt-BR.yml
 - pagseguro-oficial.gemspec
 - spec/fixtures/by_date/success.xml
+- spec/fixtures/installment/success.xml
 - spec/fixtures/invalid_code.xml
 - spec/fixtures/payment_request/failure.xml
 - spec/fixtures/payment_request/success.xml
@@ -221,6 +226,8 @@ files:
 - spec/pagseguro/address_spec.rb
 - spec/pagseguro/config_spec.rb
 - spec/pagseguro/errors_spec.rb
+- spec/pagseguro/installment/serializer_spec.rb
+- spec/pagseguro/installment_spec.rb
 - spec/pagseguro/item_spec.rb
 - spec/pagseguro/items_spec.rb
 - spec/pagseguro/notification_spec.rb
@@ -266,6 +273,7 @@ specification_version: 4
 summary: Biblioteca oficial de integração PagSeguro em Ruby
 test_files:
 - spec/fixtures/by_date/success.xml
+- spec/fixtures/installment/success.xml
 - spec/fixtures/invalid_code.xml
 - spec/fixtures/payment_request/failure.xml
 - spec/fixtures/payment_request/success.xml
@@ -274,6 +282,8 @@ test_files:
 - spec/pagseguro/address_spec.rb
 - spec/pagseguro/config_spec.rb
 - spec/pagseguro/errors_spec.rb
+- spec/pagseguro/installment/serializer_spec.rb
+- spec/pagseguro/installment_spec.rb
 - spec/pagseguro/item_spec.rb
 - spec/pagseguro/items_spec.rb
 - spec/pagseguro/notification_spec.rb