knu 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,36 @@
+PATH
+  remote: .
+  specs:
+    knu (0.0.1)
+      crack
+      httpi
+      nokogiri
+      rack
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    crack (0.3.2)
+    diff-lcs (1.1.3)
+    httpi (2.0.2)
+      rack
+    nokogiri (1.5.6)
+    rack (1.5.2)
+    rake (10.0.3)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  knu!
+  nokogiri
+  rake
+  rspec

data/README.md

@@ -0,0 +1,19 @@
+KNU
+=============
+
+Client de consulta do KNU via WebService. Mais informações: https://knu.com.br/ajuda/documentacao/webservice
+
+Instalação
+------------
+
+    gem install knu
+
+Utilização
+----------
+
+    require "knu"
+
+    knu = Knu.new("usuario@server.com", "senhaknu")
+    knu.receitaCPF("12345678900")
+
+    # {"@metodo"=>"receitaCPF", "nome"=>"FULANO DE TAL", "situacao"=>"REGULAR"}

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler"
+require "rspec/core/rake_task"
+
+Bundler::GemHelper.install_tasks
+RSpec::Core::RakeTask.new
+
+task :default => :spec

data/knu.gemspec

@@ -0,0 +1,30 @@
+#encoding: UTF-8
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+
+require "knu/version"
+
+Gem::Specification.new do |gem|
+  gem.name          = "knu"
+  gem.version       = Knu::VERSION
+  gem.date          = "2012-03-12"
+  gem.summary       = "Client Knu Webservice"
+  gem.description   = "Client Knu Webservice"
+  gem.authors       = ["Rodrigo Panachi"]
+  gem.email         = "rpanachi@gmail.com"
+  gem.files         = ["lib/knu.rb"]
+  gem.homepage      = 'https://github.com/rpanachi/knu'
+
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  gem.require_paths = ["lib"]
+
+  gem.add_runtime_dependency "rack"
+  gem.add_runtime_dependency "httpi"
+  gem.add_runtime_dependency "nokogiri"
+  gem.add_runtime_dependency "crack"
+
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "rspec"
+  gem.add_development_dependency "nokogiri"
+end

data/lib/knu.rb

@@ -0,0 +1,5 @@
+require "knu/knu"
+require "knu/version"
+
+require "httpi"
+require "crack"

data/lib/knu/knu.rb

@@ -0,0 +1,108 @@
+#encoding: UTF-8
+
+class Knu
+
+  WEBSERVICE_URL = "https://c.knu.com.br/webservice"
+  RETURN_FORMATS = {:json => 2, :xml => 1}
+  STATUS_OK      = "0"
+
+  FUNCTIONS = %w(
+    receitaCPF
+    receitaCNPJ
+    receitaSimples
+    fgtsCNPJ
+    ibgeCodigo
+    ibgeMunicipio
+    consultarEndereco
+    receitaCCD
+    cadespCNPJ
+    consultarNfeHtml
+    sintegraAC_CNPJ
+    sintegraAP_CNPJ
+    sintegraAM_CNPJ
+    sintegraBA_CNPJ
+    sintegraDF_CNPJ
+    sintegraCE_CNPJ
+    sintegraMS_CNPJ
+    sintegraPE_CNPJ
+    sintegraPB_CNPJ
+    sintegraRR_CNPJ
+    sintegraTO_CNPJ
+    sintegraRJ_CNPJ
+    sintegraSE_CNPJ
+    sintegraSP_CNPJ
+    sintegraSU
+    denatran
+    detranSP
+  )
+
+  attr_reader :user, :password, :format
+
+  def initialize(user, password, format = :json)
+    @user     = user
+    @password = password
+    @format   = format
+  end
+
+  FUNCTIONS.each do |function|
+    define_method(function.to_sym) do |param, extra = nil|
+      data     = build_request_xml(function, param, extra)
+      response = request(data)
+    end
+  end
+
+  # builds the standard request xml
+  def build_request_xml(function, param, extra = nil)
+    xml = "<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?>\n"
+    xml << "<dados>\n"
+    xml << "  <usuario>#{@user}</usuario>\n"
+    xml << "  <senha>#{@password}</senha>\n"
+    xml << "  <funcao>#{function}</funcao>\n"
+    xml << "  <param>#{param}</param>\n"
+    xml << "  <param2>#{extra}</param2>\n" if extra
+    xml << "  <retorno>#{RETURN_FORMATS[@format]}</retorno>\n"
+    xml << "</dados>"
+    xml
+  end
+
+  def request(xml)
+    request = HTTPI::Request.new(WEBSERVICE_URL)
+    request.body = xml
+    request.open_timeout = 10 # sec
+    request.read_timeout = 30 # sec
+    request.auth.ssl.verify_mode = :none
+
+    response = HTTPI.post(request)
+    handle_response(response.body)
+  end
+
+  def handle_response(response)
+    data = parse_response(response)
+    validate_data!(data)
+    data["dados"]["consulta"]["root"]
+  end
+
+  def validate_data!(data)
+    dados = data["dados"]
+    unless (status = dados["status"]) == STATUS_OK
+      raise "Error #{status}: " + dados["desc"]
+    else
+      root = dados["consulta"]["root"]
+      if error = root["cod_erro"]
+        raise "Error #{error}: " + root["desc_erro"]
+      end
+    end
+  rescue => ex
+    raise "Invalid response: #{ex.message}"
+  end
+
+  def parse_response(response, format = @format)
+    case format
+      when :json
+        Crack::JSON.parse(response)
+      when :xml
+        Crack::XML.parse(response)
+    end
+  end
+
+end

data/lib/knu/version.rb

@@ -0,0 +1,3 @@
+class Knu
+  VERSION = "0.0.1"
+end

data/spec/knu/knu_spec.rb

@@ -0,0 +1,113 @@
+#encoding: UTF-8
+
+require "spec_helper"
+
+describe Knu do
+
+  subject { Knu.new("user@server.com", "1234") }
+
+  it { should respond_to(:user) }
+  it { should respond_to(:password) }
+  it { should respond_to(:format) }
+
+  it "format json as default" do
+    subject.format.should == :json
+  end
+
+  context "request" do
+
+    context "build xml" do
+      before do
+        request_xml = subject.build_request_xml("function", "000")
+        @doc = Nokogiri.XML(request_xml)
+      end
+      it { @doc.xpath("//dados/usuario").first.content.should == subject.user }
+      it { @doc.xpath("//dados/senha").first.content.should == subject.password }
+      it { @doc.xpath("//dados/funcao").first.content.should == "function" }
+      it { @doc.xpath("//dados/param").first.content.should == "000" }
+    end
+
+    context "handle" do
+
+      let :valid_response do
+        %(
+            <?xml version="1.0" encoding="utf-8"?>
+            <dados>
+                <status>0</status>
+                <desc></desc>
+                <consulta>
+                    <root metodo="receitaCNPJ" arg="00000000000191">
+                        <numero_inscricao>00.000.000/0001-91</numero_inscricao>
+                        <data_abertura>01/08/1966</data_abertura>
+                        <nome_empresarial>BANCO DO BRASIL SA</nome_empresarial>
+                    </root>
+                </consulta>
+            </dados>
+        )
+      end
+
+      let :invalid_response do
+        %(
+            <?xml version="1.0" encoding="utf-8"?>
+            <dados>
+                <status>55</status>
+                <desc>Xml inválido</desc>
+                <consulta></consulta>
+            </dados>
+        )
+      end
+
+      let :invalid_response_content do
+        %(
+            <?xml version="1.0" encoding="utf-8"?>
+            <dados>
+                <status>0</status>
+                <desc></desc>
+                <consulta>
+                    <root metodo="receitaCNPJ" arg="00000000000190">
+                        <cod_erro>6</cod_erro>
+                        <desc_erro>Erro codigo 6: Parametro invalido.</desc_erro>
+                    </root>
+                </consulta>
+            </dados>
+        )
+      end
+
+      context "parse_response" do
+        it "xml" do
+          data = subject.parse_response(valid_response, :xml)
+          data["dados"].should_not be_empty
+        end
+
+        it "json" do
+          data = subject.parse_response(valid_response, :json)
+          data["dados"].should_not be_empty
+        end
+      end
+
+      context "validate data" do
+        it "successfull" do
+          data = Crack::XML.parse(valid_response)
+          expect { subject.validate_data!(data) }.to_not raise_error
+        end
+        it "error category 1" do
+          data = Crack::XML.parse(invalid_response)
+          expect { subject.validate_data!(data) }.to raise_error
+        end
+        it "error category 2" do
+          data = Crack::XML.parse(invalid_response_content)
+          expect { subject.validate_data!(data) }.to raise_error
+        end
+      end
+
+      context "response" do
+        subject { Knu.new("email@server.com", "1234", :xml) }
+        it "successfull" do
+          result = subject.handle_response(valid_response)
+          result["numero_inscricao"].should == "00.000.000/0001-91"
+        end
+      end
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require "rspec"
+require "knu"
+require "nokogiri"

metadata

@@ -0,0 +1,168 @@
+--- !ruby/object:Gem::Specification
+name: knu
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Rodrigo Panachi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httpi
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: crack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Client Knu Webservice
+email: rpanachi@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- knu.gemspec
+- lib/knu.rb
+- lib/knu/knu.rb
+- lib/knu/version.rb
+- spec/knu/knu_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/rpanachi/knu
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Client Knu Webservice
+test_files: []
+has_rdoc: