ares_cz 0.3.2

data/README.rdoc

@@ -0,0 +1,58 @@
+= Ares
+
+Simple library for querying Ares system in Czech republic with translation of
+labels.
+
+  http://wwwinfo.mfcr.cz/ares/ares.html.cz
+
+== Usage
+
+Is simple as creating ares instance by finder and calling methods on it:
+  
+  require 'rubygems'
+  require 'ares_cz'
+
+  ares = Ares.find(:ico => '27386830')
+  ares.found? == true
+  ares.company_name == "GravaStar s.r.o."
+  ares.subject_type == "P"
+  ares.address == {
+    :city => "16000 Praha",
+    :street => "Charlese de Gaulla 800/3",
+    :country => "Česká republika"
+  }
+  ares = Ares.find(:ico => '666')
+  ares.found? == false
+
+It should be posible to find by company name, but is not tested. Also subject
+type F needs more testing (see rake test:rcov).
+
+== Dependencies
+
+Only crack for xml parsing. Install with sudo gem install crack.
+
+== License
+
+Copyright (c) 2008 pepe@gravastar.cz
+
+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.
+

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'rake'
+require 'ftools'
+require 'rspec'
+require 'rspec/core/rake_task'
+
+desc "Runs all specs as default"
+task :default => 'test:spec'
+
+namespace :test do
+  desc "Run all specs"
+  RSpec::Core::RakeTask.new do |t|
+    t.pattern = 'spec/erector/*_spec.rb'    
+    t.rspec_opts = ['-u']
+  end
+
+  desc "Run all examples with RCov"
+  RSpec::Core::RakeTask.new('rcov') do |t|
+    t.pattern = 'spec/erector/*_spec.rb'    
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec']
+  end
+end
+
+namespace :gems do
+  desc "Install gems"
+  task :install do
+    exec 'gem install crack'
+  end
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "ares_cz"
+    gem.summary = %Q{Simple ruby wrapper for Czech Ares service}
+    gem.email = "pepe@gravastar.cz"
+    gem.homepage = "http://github.com/pepe/ares"
+    gem.authors = ["Josef Pospisil"]
+    gem.description = "Simple library for querying Ares system in Czech republic with translation of labels."
+    gem.add_dependency('crack', '>= 0.1.4')
+    IGNORE = [/\.gitignore$/, /VERSION$/]
+    gem.files.reject! { |f| IGNORE.any? { |re| f.match(re) } }
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end

data/ares_cz.gemspec

@@ -0,0 +1,42 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "ares_cz"
+  s.version = "0.3.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Josef Pospisil"]
+  s.date = "2012-10-05"
+  s.description = "Simple library for querying Ares system in Czech republic with translation of labels."
+  s.email = "pepe@gravastar.cz"
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    "README.rdoc",
+    "Rakefile",
+    "ares_cz.gemspec",
+    "lib/ares_cz.rb",
+    "spec/ares_cz_spec.rb"
+  ]
+  s.homepage = "http://github.com/pepe/ares"
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Simple ruby wrapper for Czech Ares service"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<crack>, [">= 0.1.4"])
+    else
+      s.add_dependency(%q<crack>, [">= 0.1.4"])
+    end
+  else
+    s.add_dependency(%q<crack>, [">= 0.1.4"])
+  end
+end
+

data/lib/ares_cz.rb

@@ -0,0 +1,103 @@
+# -*- encoding : utf-8 -*-
+require 'net/http'
+require 'crack/xml'
+
+class Ares
+  SERVICE_URL = "http://wwwinfo.mfcr.cz/cgi-bin/ares/darv_std.cgi?%s".freeze
+  attr_reader :options, :result
+
+  # class methods
+  class << self
+    # finds subject by any part on ares service
+    def find(options)
+      return new(options)
+    end
+  end
+
+  # initializes new ares object 
+  def initialize(options)
+    @options = options
+    @result = Crack::XML.parse(Net::HTTP.get(URI.parse(SERVICE_URL % self.params)))
+    return self
+  end
+
+  # returns true if subject found on ares, otherwise false
+  def found?
+    @found ||= !(self.result["are:Ares_odpovedi"]["are:Odpoved"]["are:Pocet_zaznamu"] == '0' ||
+      self.result["are:Ares_odpovedi"]["are:Odpoved"]["are:Error"])
+  end
+
+  # returns params like concatenated options
+  def params
+    sanitize_options
+    @params ||= URI.escape(@options.sort.inject([]) do |res, pair|
+       res << "%s=%s" % [pair.first, pair.last]
+    end.join('&'))
+  end
+
+  # returns just answer part
+  def answer
+    @answer ||= self.result["are:Ares_odpovedi"]["are:Odpoved"]["are:Zaznam"]
+  end
+
+  # returns company name
+  def company_name
+    @company_name ||= self.answer["are:Obchodni_firma"]
+  end
+
+  # returns ico
+  def ico
+    @ico ||= self.answer["are:ICO"]
+  end
+
+  # returns subject type
+  def subject_type
+    @subject_type ||= if self.answer["are:Identifikace"]["are:Osoba"].nil?
+                        "P"
+                      end
+  end
+
+  # returns address
+  def address
+    unless @address 
+      @address = {
+      :city => self.raw_address['dtt:PSC'][0..0] == "1" ? self.raw_address['dtt:Nazev_mestske_casti'] : self.raw_address['dtt:Nazev_obce'],
+      :street => [street_name, building_number].join(' '),
+      :street_name => street_name,
+      :building_number => building_number,
+      :zip => self.raw_address['dtt:PSC']
+    }
+      @address[:country] = "Česká republika" if self.raw_address['dtt:Kod_statu'].to_i == 203
+    end
+    return @address
+  end
+
+  # returns raw address
+  def raw_address
+    @raw_address ||= if self.subject_type == "P"
+                   self.answer["are:Identifikace"]["are:Adresa_ARES"]
+                 end
+  end
+
+  private
+  # returns street name
+  def street_name
+    self.raw_address["dtt:Nazev_ulice"] 
+  end
+
+  # returns building number
+  def building_number
+    [self.raw_address['dtt:Cislo_domovni'],
+      self.raw_address['dtt:Cislo_orientacni']].compact.join('/')
+  end
+
+  # sanitizes url options 
+  def sanitize_options
+    @options = @options.inject({}) do |opts, (key, value)| 
+      opts[key.to_s] = value 
+      opts[key.to_s || key] = value 
+      opts 
+    end 
+    @options['ico'] = @options['ico'].gsub(/ /, '')
+  end
+end

data/spec/ares_cz_spec.rb

@@ -0,0 +1,185 @@
+require 'rubygems'
+require 'rspec'
+require 'lib/ares_cz'
+
+SERVICE_URL = "http://wwwinfo.mfcr.cz/cgi-bin/ares/darv_std.cgi?%s".freeze
+describe "ares" do
+  # mocks net/http to return gravastar result
+  def mock_found
+    @test_xml = <<TEST_XML
+      <?xml version="1.0" encoding="UTF-8"?>
+      <are:Ares_odpovedi xmlns:are="http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/ares/ares_answer/v_1.0.1" xmlns:dtt="http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/ares/ares_datatypes/v_1.0.4" xmlns:udt="http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/uvis_datatypes/v_1.0.1" odpoved_datum_cas="2009-08-07T10:55:41" odpoved_pocet="1" odpoved_typ="Standard" vystup_format="XML" xslt="klient" validation_XSLT="/ares/xml_doc/schemas/ares/ares_answer/v_1.0.0/ares_answer.xsl" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/ares/ares_answer/v_1.0.1 http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/ares/ares_answer/v_1.0.1/ares_answer_v_1.0.1.xsd" Id="ares">
+      <are:Odpoved>
+      <are:Pocet_zaznamu>1</are:Pocet_zaznamu>
+      <are:Typ_vyhledani>FREE</are:Typ_vyhledani>
+      <are:Zaznam>
+      <are:Shoda_ICO>
+      <dtt:Kod>9</dtt:Kod>
+      </are:Shoda_ICO>
+      <are:Vyhledano_dle>ICO</are:Vyhledano_dle>
+      <are:Typ_registru>
+      <dtt:Kod>2</dtt:Kod>
+
+      <dtt:Text>OR</dtt:Text>
+      </are:Typ_registru>
+      <are:Datum_vzniku>2005-11-03</are:Datum_vzniku>
+      <are:Datum_platnosti>2009-08-07</are:Datum_platnosti>
+      <are:Pravni_forma>
+      <dtt:Kod_PF>112</dtt:Kod_PF>
+      </are:Pravni_forma>
+      <are:Obchodni_firma>GravaStar s.r.o.</are:Obchodni_firma>
+      <are:ICO>27386830</are:ICO>
+      <are:Identifikace>
+      <are:Adresa_ARES>
+
+      <dtt:ID_adresy>202396372</dtt:ID_adresy>
+      <dtt:Kod_statu>203</dtt:Kod_statu>
+      <dtt:Nazev_okresu>Hlavní město Praha</dtt:Nazev_okresu>
+      <dtt:Nazev_obce>Praha</dtt:Nazev_obce>
+      <dtt:Nazev_casti_obce>Bubeneč</dtt:Nazev_casti_obce>
+      <dtt:Nazev_mestske_casti>Praha 6</dtt:Nazev_mestske_casti>
+      <dtt:Nazev_ulice>Charlese de Gaulla</dtt:Nazev_ulice>
+      <dtt:Cislo_domovni>800</dtt:Cislo_domovni>
+      <dtt:Cislo_orientacni>3</dtt:Cislo_orientacni>
+
+      <dtt:PSC>16000</dtt:PSC>
+      <dtt:Adresa_UIR>
+      <udt:Kod_oblasti>19</udt:Kod_oblasti>
+      <udt:Kod_kraje>19</udt:Kod_kraje>
+      <udt:Kod_okresu>3100</udt:Kod_okresu>
+      <udt:Kod_obce>554782</udt:Kod_obce>
+      <udt:Kod_pobvod>60</udt:Kod_pobvod>
+      <udt:Kod_sobvod>60</udt:Kod_sobvod>
+      <udt:Kod_casti_obce>490024</udt:Kod_casti_obce>
+
+      <udt:Kod_mestske_casti>500178</udt:Kod_mestske_casti>
+      <udt:PSC>16000</udt:PSC>
+      <udt:Kod_ulice>470813</udt:Kod_ulice>
+      <udt:Cislo_domovni>800</udt:Cislo_domovni>
+      <udt:Typ_cislo_domovni>1</udt:Typ_cislo_domovni>
+      <udt:Cislo_orientacni>3</udt:Cislo_orientacni>
+      <udt:Kod_adresy>22182616</udt:Kod_adresy>
+      <udt:Kod_objektu>22099042</udt:Kod_objektu>
+      <udt:PCD>2495506</udt:PCD>
+
+      </dtt:Adresa_UIR>
+      </are:Adresa_ARES>
+      </are:Identifikace>
+      <are:Kod_FU>6</are:Kod_FU>
+      <are:Priznaky_subjektu>NAAANANNNNNNNNNNNNNNNNNNNNNNNN</are:Priznaky_subjektu>
+      </are:Zaznam>
+      </are:Odpoved>
+      </are:Ares_odpovedi>
+TEST_XML
+    Net::HTTP.stub!(:get).and_return(@test_xml)
+  end
+
+  # mocks net/http to return empty result
+  def mock_not_found
+    @test_xml = <<TEST_XML
+      <?xml version="1.0" encoding="UTF-8"?>
+      <are:Ares_odpovedi xmlns:are="http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/ares/ares_answer/v_1.0.1" xmlns:dtt="http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/ares/ares_datatypes/v_1.0.4" xmlns:udt="http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/uvis_datatypes/v_1.0.1" odpoved_datum_cas="2009-08-07T10:49:40" odpoved_pocet="1" odpoved_typ="Standard" vystup_format="XML" xslt="klient" validation_XSLT="/ares/xml_doc/schemas/ares/ares_answer/v_1.0.0/ares_answer.xsl" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/ares/ares_answer/v_1.0.1 http://wwwinfo.mfcr.cz/ares/xml_doc/schemas/ares/ares_answer/v_1.0.1/ares_answer_v_1.0.1.xsd" Id="ares">
+      <are:Odpoved>
+      <are:Pocet_zaznamu>0</are:Pocet_zaznamu>
+      <are:Typ_vyhledani>FREE</are:Typ_vyhledani>
+      </are:Odpoved>
+      </are:Ares_odpovedi>
+TEST_XML
+    Net::HTTP.should_receive(:get).at_least(:once).and_return(@test_xml)
+  end
+
+  describe "initialization and basic methods" do
+    before(:each) do
+      mock_not_found
+    end
+
+    it "should be created by finder" do
+      mock_found
+      ares = Ares.find(:ico => '666')
+      ares.should_not be_nil
+      ares.class.should == Ares
+    end
+
+    it "should store options" do
+      mock_found
+      ares = Ares.find(:ico => '666')
+      ares.options.should == {"ico" => '666'}
+    end
+
+    it "should have params with equal sign concatenated options" do
+      mock_found
+      ares = Ares.find(:ico => '27386830')
+      ares.params.should == "ico=27386830" 
+      ares = Ares.find(:ico => '27386830', :obchodni_firma => 'Grava')
+      ares.params.should == "ico=27386830&obchodni_firma=Grava" 
+      ares = Ares.find(:ico => '27386 830')
+      ares.params.should == "ico=27386830" 
+    end
+
+    it "should have result with hash from xml" do
+      ares = Ares.find(:ico => '27386830')
+      ares.result.class.should == Hash
+    end
+  end
+
+  describe "founding" do
+    it "should not find not existing subject on ares" do
+      mock_not_found
+      ares = Ares.find(:ico => '666')
+      ares.found?.should be_false
+    end
+
+    it "should find existing subject on ares" do
+      mock_found
+      ares = Ares.find(:ico => '27386830')
+      ares.found?.should be_true
+    end
+
+    it "should not find when there is ico with not suitable chars" do
+      mock_not_found
+      ares = Ares.find(:ico => '27386$830')
+      ares.found?.should be_false
+    end
+
+    it "should find when there is ico with spaces in it" do
+      mock_not_found
+      ares = Ares.find(:ico => '27386$830')
+      ares.found?.should be_false
+    end
+  end
+
+  describe "parser" do
+    it "should parse company_name" do
+      mock_found
+      ares = Ares.find(:ico => '27386830')
+      ares.company_name.should == "GravaStar s.r.o."
+    end
+
+    it "should parse ico" do
+      mock_found
+      ares = Ares.find(:ico => '27386830')
+      ares.ico.should == '27386830'
+    end
+
+    it "should parse subject type" do
+      mock_found
+      ares = Ares.find(:ico => '27386830')
+      ares.subject_type.should == 'P'
+    end
+
+    it "should parse address" do
+      mock_found
+      ares = Ares.find(:ico => '27386830')
+      ares.address.is_a?(Hash).should be_true
+      ares.address.should == {
+        :city => "Praha 6",
+        :street => "Charlese de Gaulla 800/3",
+        :street_name => "Charlese de Gaulla",
+        :building_number => "800/3",
+        :zip => '16000',
+        :country => "Česká republika"
+      }
+    end
+  end
+end
+

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: ares_cz
+version: !ruby/object:Gem::Version
+  version: 0.3.2
+  prerelease: 
+platform: ruby
+authors:
+- Josef Pospisil
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: crack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.4
+description: Simple library for querying Ares system in Czech republic with translation
+  of labels.
+email: pepe@gravastar.cz
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- README.rdoc
+- Rakefile
+- ares_cz.gemspec
+- lib/ares_cz.rb
+- spec/ares_cz_spec.rb
+homepage: http://github.com/pepe/ares
+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: Simple ruby wrapper for Czech Ares service
+test_files: []