pagseguro-oficial 2.0.5 → 2.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f1f8e2e4b489f3e61836e032ffdb59abd5fc5260
-  data.tar.gz: ed7b50c45c771d5bae7d545556c5453f67a66546
+  metadata.gz: 788279b727dd7437ae09d37c26ae11bac42e8310
+  data.tar.gz: d2523d522ed794650fe5d807c64104e230a11824
 SHA512:
-  metadata.gz: 97200bbddcd310de48999f219bb65ac8df682c874da71f8267327ee7657eaaaec4b2a228e48faabc992e6dfebe80efded5b1142d3d7dc6f3a3a490c0b449d89b
-  data.tar.gz: 5d0ef25bdec187a122e446e05d65b9315abb57807adc5aeba3d3766917ef8ee352e3693266a8e5be26482c27fe2ad520527d991990af914403201311f0a2704d
+  metadata.gz: e24fe077d815397578847a3d2e842803d2ba2894eb82a846ee521989d694891a551f3105d9ca9dda5b8a30c294c0b68a6c4c8de8811ba4ee94ea626e95e9663f
+  data.tar.gz: 1fcd33a1722fd8d9b985f3385220ada6dc81a1b183f77f3bbb9b950a7bbb728a44ca6f3bbef02dc0405b3c36f33c26b1e3965abe80826fc4ebd95b264b695a5a

data/.gitignore

@@ -18,3 +18,11 @@ Gemfile.lock
 .env
 *~
 .rvmrc
+.ruby-gemset
+.ruby-version
+
+#################
+## IntelliJ
+#################
+.idea/
+*.iml

data/.travis.yml

@@ -1,9 +1,12 @@
 language: ruby
 rvm:
+  - 2.2.0
+  - 2.1.5
   - 2.0.0
   - 1.9.3
   - jruby-19mode
 
 notifications:
   email:
-    - fnando.vieira@gmail.com
+    - lucas.renan@codeminer42.com
+    - vitor.kusiaki@codeminer42.com

data/CHANGELOG.md

@@ -0,0 +1,36 @@
+## 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)
+
+## Stable
+
+2.0.6
+
+ - Adicionando environment sandbox, entre outras melhorias
+
+2.0.5
+
+ - Fixa a versão da biblioteca Aitch; a versão antiga não possui a mesma API utilizada nesta gem.
+
+2.0.4
+
+ - PaymentRequest com email e token alternativos
+
+2.0.3
+
+ - Ajuste no parser XML e paginação de relatórios.
+ - Incluindo parâmetro para indicar a página inicial em uma busca de transações.
+ - Correções de testes.
+
+2.0.2
+
+ - Atualização dos tipos e códigos de meio de pagamento.
+ - Correção do exemplo payment_request.
+
+2.0.1
+
+ - Classes de domínios que representam pagamentos, notificações e transações.
+ - Criação de checkouts via API.
+ - Tratamento de notificações de pagamento enviadas pelo PagSeguro.
+ - Consulta de transações.
+

data/Gemfile

@@ -1,4 +1,4 @@
 source "https://rubygems.org"
 gemspec
 
-gem "pry-meta", platforms: :ruby
+gem "pry-meta", platforms: [:ruby_20, :ruby_21]

data/README.md

@@ -58,7 +58,7 @@ class CheckoutController < ApplicationController
 
     payment = PagSeguro::PaymentRequest.new
 
-    # Você também pode fazer o request de pagamento usando credenciais 
+    # Você também pode fazer o request de pagamento usando credenciais
     # diferentes, como no exemplo abaixo
 
     payment = PagSeguro::PaymentRequest.new(email: 'abc@email', token: 'token')
@@ -76,6 +76,12 @@ class CheckoutController < ApplicationController
       }
     end
 
+    # Caso você precise passar parâmetros para a api que ainda não foram
+    # mapeados na gem, você pode fazer de maneira dinâmica utilizando um
+    # simples hash.
+    payment.extra_params << { extraParam: 'value' }
+    payment.extra_params << { itemExtra1: 'value1' }
+
     response = payment.register
 
     # Caso o processo de checkout tenha dado errado, lança uma exceção.
@@ -257,29 +263,20 @@ payment.max_uses = 100
 payment.max_age = 3600  # em segundos
 ```
 
-## Changelog
-
-2.0.4
+#### Definindo environment e/ou encoding
 
- - PaymentRequest com email e token alternativos
-
-2.0.3
+```ruby
+PagSeguro.environment = "production" # production ou sandbox
+PagSeguro.encoding = "UTF-8" # UTF-8 ou ISO-8859-1
+```
 
- - Ajuste no parser XML e paginação de relatórios.
- - Incluindo parâmetro para indicar a página inicial em uma busca de transações.
- - Correções de testes.
- 
-2.0.2
+## Dúvidas?
 
- - Atualização dos tipos e códigos de meio de pagamento.
- - Correção do exemplo payment_request.
+Caso tenha dúvidas ou precise de suporte, acesse nosso [fórum].
 
-2.0.1
+## Changelog
 
- - Classes de domínios que representam pagamentos, notificações e transações.
- - Criação de checkouts via API.
- - Tratamento de notificações de pagamento enviadas pelo PagSeguro.
- - Consulta de transações.
+https://github.com/pagseguro/ruby/blob/master/CHANGELOG.md
 
 ## Licença
 
@@ -297,16 +294,19 @@ Unless required by applicable law or agreed to in writing, software distributed
  - Certifique-se que tenha definido corretamente o charset de acordo com a codificação (ISO-8859-1 ou UTF-8) do seu sistema. Isso irá prevenir que as transações gerem possíveis erros ou quebras ou ainda que caracteres especiais possam ser apresentados de maneira diferente do habitual.
  - Para que ocorra normalmente a geração de logs, certifique-se que o diretório e o arquivo de log tenham permissões de leitura e escrita.
 
-## [Dúvidas?]
-
-
 ## Contribuições
 
 Achou e corrigiu um bug ou tem alguma feature em mente e deseja contribuir?
 
-* Faça um fork.
-* Adicione sua feature ou correção de bug.
-* Envie um pull request no [GitHub].
+* Faça um fork
+* Adicione sua feature ou correção de bug (`git checkout -b my-new-feature`)
+* Commit suas mudanças (`git commit -am 'Added some feature'`)
+* Rode um push para o branch (`git push origin my-new-feature`)
+* Envie um Pull Request
+
+O código, os commits e os comentários devem ser em inglês.
+Adicione exemplos para sua nova feature.
+Se seu Pull Request for relacionado a uma versão específica, o Pull Request não deve ser enviado para o branch master e sim para o branch correspondente a versão.
 
 
   [requisições de pagamentos]: https://pagseguro.uol.com.br/v2/guia-de-integracao/api-de-pagamentos.html
@@ -314,7 +314,7 @@ Achou e corrigiu um bug ou tem alguma feature em mente e deseja contribuir?
   [transações por código]: https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-por-codigo.html
   [transações por intervalo de datas]: https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-por-intervalo-de-datas.html
   [transações abandonadas]: https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-abandonadas.html
-  [Dúvidas?]: https://pagseguro.uol.com.br/desenvolvedor/comunidade.jhtml
+  [fórum]: http://forum.pagseguro.uol.com.br/
   [Ruby]: http://www.ruby-lang.org/pt/
   [GitHub]: https://github.com/pagseguro/ruby/
-  [Aitch]: https://github.com/fnando/aitch
+  [Aitch]: https://github.com/fnando/aitch

data/examples/payment_request.rb

@@ -1,4 +1,4 @@
-# -*- encoding : utf-8 -*- 
+# -*- encoding : utf-8 -*-
 require_relative "boot"
 
 payment = PagSeguro::PaymentRequest.new
@@ -36,6 +36,10 @@ payment.shipping = {
   }
 }
 
+# Add extras params to request
+# payment.extra_params << { extraParam: 'value' }
+# payment.extra_params << { itemExtra1: 'value1' }
+
 puts "=> REQUEST"
 puts PagSeguro::PaymentRequest::Serializer.new(payment).to_params
 

data/lib/pagseguro.rb

@@ -7,6 +7,7 @@ require "aitch"
 require "i18n"
 
 require "pagseguro/version"
+require "pagseguro/config"
 require "pagseguro/errors"
 require "pagseguro/exceptions"
 require "pagseguro/extensions/mass_assignment"
@@ -33,21 +34,16 @@ I18n.load_path += Dir[File.expand_path("../../locales/*.yml", __FILE__)]
 
 module PagSeguro
   class << self
-    # Primary e-mail associated with this account.
-    attr_accessor :email
-
-    # The e-mail that will be displayed when sender is redirected
-    # to PagSeguro.
-    attr_accessor :receiver_email
-
-    # The API token associated with this account.
-    attr_accessor :token
+    # Delegates some calls to the config object
+    extend Forwardable
+    def_delegators :configuration, :email, :receiver_email, :token
+    def_delegators :configuration, :email=, :receiver_email=, :token=
 
     # The encoding that will be used.
     attr_accessor :encoding
 
     # The PagSeguro environment.
-    # Only +production+ for now.
+    # +production+ or +sandbox+.
     attr_accessor :environment
   end
 
@@ -60,6 +56,10 @@ module PagSeguro
       production: {
         api: "https://ws.pagseguro.uol.com.br/v2",
         site: "https://pagseguro.uol.com.br/v2"
+      },
+      sandbox: {
+        site: 'https://sandbox.pagseguro.uol.com.br/v2',
+        api:  'https://ws.sandbox.pagseguro.uol.com.br/v2'
       }
     }
   end
@@ -71,6 +71,11 @@ module PagSeguro
     root[type.to_sym]
   end
 
+  # The configuration intance for the thread
+  def self.configuration
+    Thread.current[:pagseguro_config] ||= PagSeguro::Config.new
+  end
+
   # Set the global configuration.
   #
   #   PagSeguro.configure do |config|
@@ -79,7 +84,7 @@ module PagSeguro
   #   end
   #
   def self.configure(&block)
-    yield self
+    yield configuration
   end
 
   # The API endpoint.

data/lib/pagseguro/config.rb

@@ -0,0 +1,14 @@
+module PagSeguro
+  # Holds the configuration of the user
+  class Config
+    # Primary e-mail associated with this account.
+    attr_accessor :email
+
+    # The e-mail that will be displayed when sender is redirected
+    # to PagSeguro.
+    attr_accessor :receiver_email
+
+    # The API token associated with this account.
+    attr_accessor :token
+  end
+end

data/lib/pagseguro/payment_request.rb

@@ -57,6 +57,8 @@ module PagSeguro
     # The token that identifies the request. Defaults to PagSeguro.token
     attr_accessor :token
 
+    # The extra parameters for payment request
+    attr_accessor :extra_params
 
     # Products/items in this payment request.
     def items
@@ -84,6 +86,7 @@ module PagSeguro
 
     private
     def before_initialize
+      self.extra_params = []
       self.currency = "BRL"
       self.email    = PagSeguro.email
       self.token    = PagSeguro.token

data/lib/pagseguro/payment_request/serializer.rb

@@ -24,6 +24,7 @@ module PagSeguro
 
         serialize_sender(payment_request.sender)
         serialize_shipping(payment_request.shipping)
+        serialize_extra_params(payment_request.extra_params)
 
         params.delete_if {|key, value| value.nil? }
 
@@ -83,6 +84,14 @@ module PagSeguro
         params[:shippingAddressComplement] = address.complement
       end
 
+      def serialize_extra_params(extra_params)
+        return unless extra_params
+
+        extra_params.each do |extra_param|
+          params[extra_param.keys.first] = extra_param.values.first
+        end
+      end
+
       def to_amount(amount)
         "%.2f" % BigDecimal(amount.to_s).round(2).to_s("F") if amount
       end

data/lib/pagseguro/version.rb

@@ -1,3 +1,3 @@
 module PagSeguro
-  VERSION = "2.0.5"
+  VERSION = "2.0.6"
 end

data/spec/pagseguro/config_spec.rb

@@ -0,0 +1,5 @@
+require "spec_helper"
+
+describe PagSeguro::Config do
+  it_behaves_like "a configuration"
+end

data/spec/pagseguro/pagseguro_spec.rb

@@ -11,11 +11,27 @@ describe PagSeguro do
   it { expect(PagSeguro.token).to eql("TOKEN") }
   it { expect(PagSeguro.receiver_email).to eql("RECEIVER_EMAIL") }
 
+  context "config delegation" do
+    subject { PagSeguro }
+    it_behaves_like "a configuration"
+  end
+
   context "configuring library" do
     it "yields PagSeguro" do
       expect {|block|
         PagSeguro.configure(&block)
-      }.to yield_with_args(PagSeguro)
+      }.to yield_with_args(PagSeguro::Config)
+    end
+
+    it "is threadsafe" do
+      thread = Thread.new do
+        PagSeguro.configure do |config|
+          config.receiver_email = 'ANOTHER_RECEIVER_EMAIL'
+        end
+      end
+      thread.join
+
+      expect(PagSeguro.receiver_email).to eql("RECEIVER_EMAIL")
     end
   end
 
@@ -33,9 +49,16 @@ describe PagSeguro do
       }.to raise_exception(PagSeguro::InvalidEnvironmentError)
     end
 
-    it "returns api url" do
+    it "returns production api url when the environment is :production" do
       expect(PagSeguro.api_url("/some/path")).to eql("https://ws.pagseguro.uol.com.br/v2/some/path")
     end
+
+    it "returns sandbox api url when the environment is :sandbox" do
+      PagSeguro.environment = :sandbox
+
+      expect(PagSeguro.api_url("/some/path")).to eql("https://ws.sandbox.pagseguro.uol.com.br/v2/some/path")
+    end
+
   end
 
   describe ".site_url" do
@@ -47,8 +70,13 @@ describe PagSeguro do
       }.to raise_exception(PagSeguro::InvalidEnvironmentError)
     end
 
-    it "returns site url" do
+    it "returns production site url when the environment is production" do
       expect(PagSeguro.site_url("/some/path")).to eql("https://pagseguro.uol.com.br/v2/some/path")
     end
+
+    it "returns sandbox site url when the environment is :sandbox" do
+      PagSeguro.environment = :sandbox
+      expect(PagSeguro.site_url("/some/path")).to eql("https://sandbox.pagseguro.uol.com.br/v2/some/path")
+    end
   end
 end

data/spec/pagseguro/payment_request/serializer_spec.rb

@@ -139,4 +139,18 @@ describe PagSeguro::PaymentRequest::Serializer do
     it_behaves_like "item serialization", 1
     it_behaves_like "item serialization", 2
   end
+
+  context "extra params serialization" do
+    before do
+      payment_request.stub({
+        extra_params: [
+          { extraParam: 'param_value' },
+          { newExtraParam: 'extra_param_value' }
+        ]
+      })
+    end
+
+    it { expect(params).to include(extraParam: 'param_value') }
+    it { expect(params).to include(newExtraParam: 'extra_param_value') }
+  end
 end

data/spec/pagseguro/payment_request_spec.rb

@@ -104,4 +104,20 @@ describe PagSeguro::PaymentRequest do
       expect(payment.register).to eql(response)
     end
   end
+
+  describe "#extra_params" do
+    it "is empty before initialization" do
+      expect(subject.extra_params).to eql([])
+    end
+
+    it "allows extra parameter addition" do
+      subject.extra_params << { extraParam: 'value' }
+      subject.extra_params << { itemParam1: 'value1' }
+
+      expect(subject.extra_params).to eql([
+        { extraParam: 'value' },
+        { itemParam1: 'value1' }
+      ])
+    end
+  end
 end

data/spec/pagseguro/transaction/serializer_spec.rb

@@ -26,7 +26,7 @@ describe PagSeguro::Transaction::Serializer do
     it { expect(data.keys).not_to include(:cancellation_source) }
     it { expect(data.keys).not_to include(:escrow_end_date) }
 
-    it { expect(data[:items]).to have(1).item }
+    it { expect(data[:items].size).to eq(1) }
     it { expect(data[:items].first).to include(id: "1234") }
     it { expect(data[:items].first).to include(description: "Some product") }
     it { expect(data[:items].first).to include(quantity: 1) }

data/spec/pagseguro/transaction_spec.rb

@@ -112,7 +112,7 @@ describe PagSeguro::Transaction do
     it { expect(transaction.items).to be_a(PagSeguro::Items) }
     it { expect(transaction.payment_method).to be_a(PagSeguro::PaymentMethod) }
     it { expect(transaction.status).to be_a(PagSeguro::PaymentStatus) }
-    it { expect(transaction.items).to have(1).item }
+    it { expect(transaction.items.size).to eq(1) }
     it { expect(transaction).to respond_to(:escrow_end_date) }
   end
 end

data/spec/support/shared_examples_for_configuration.rb

@@ -0,0 +1,8 @@
+RSpec.shared_examples "a configuration" do
+  it { is_expected.to respond_to(:email) }
+  it { is_expected.to respond_to(:email=) }
+  it { is_expected.to respond_to(:receiver_email) }
+  it { is_expected.to respond_to(:receiver_email=) }
+  it { is_expected.to respond_to(:token) }
+  it { is_expected.to respond_to(:token=) } 
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pagseguro-oficial
 version: !ruby/object:Gem::Version
-  version: 2.0.5
+  version: 2.0.6
 platform: ruby
 authors:
 - Nando Vieira
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-06 00:00:00.000000000 Z
+date: 2015-03-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aitch
@@ -174,6 +174,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE-2.0.txt
 - README.md
@@ -187,6 +188,7 @@ files:
 - lib/pagseguro-oficial.rb
 - lib/pagseguro.rb
 - lib/pagseguro/address.rb
+- lib/pagseguro/config.rb
 - lib/pagseguro/errors.rb
 - lib/pagseguro/exceptions.rb
 - lib/pagseguro/extensions/ensure_type.rb
@@ -217,6 +219,7 @@ files:
 - spec/fixtures/transactions/additional.xml
 - spec/fixtures/transactions/success.xml
 - spec/pagseguro/address_spec.rb
+- spec/pagseguro/config_spec.rb
 - spec/pagseguro/errors_spec.rb
 - spec/pagseguro/item_spec.rb
 - spec/pagseguro/items_spec.rb
@@ -236,6 +239,7 @@ files:
 - spec/spec_helper.rb
 - spec/support/ensure_type_macro.rb
 - spec/support/mass_assignment_macro.rb
+- spec/support/shared_examples_for_configuration.rb
 homepage: http://www.pagseguro.com.br
 licenses:
 - ASL
@@ -256,7 +260,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.3
 signing_key: 
 specification_version: 4
 summary: Biblioteca oficial de integração PagSeguro em Ruby
@@ -268,6 +272,7 @@ test_files:
 - spec/fixtures/transactions/additional.xml
 - spec/fixtures/transactions/success.xml
 - spec/pagseguro/address_spec.rb
+- spec/pagseguro/config_spec.rb
 - spec/pagseguro/errors_spec.rb
 - spec/pagseguro/item_spec.rb
 - spec/pagseguro/items_spec.rb
@@ -287,3 +292,4 @@ test_files:
 - spec/spec_helper.rb
 - spec/support/ensure_type_macro.rb
 - spec/support/mass_assignment_macro.rb
+- spec/support/shared_examples_for_configuration.rb