irrc 0.1.0

data/spec/features/whois_as_set_resolution_spec.rb

@@ -0,0 +1,193 @@
+require 'spec_helper'
+
+describe 'Whois as-set resolution' do
+  include_context 'whois queries'
+
+  context 'When FQDN specified for Whois server' do
+    subject { send_query(whois_fqdn, 'AS-JPNIC') }
+
+    it 'returns ipv4 and ipv6 prefixes by default' do
+      expect(subject['AS-JPNIC'][:ipv4]['AS2515']).to include '192.41.192.0/24', '202.12.30.0/24',
+      '211.120.240.0/21', '211.120.248.0/24'
+      expect(subject['AS-JPNIC'][:ipv6]['AS2515']).to include '2001:dc2::/32', '2001:0fa0::/32'
+    end
+  end
+
+  context 'When a name specified for Whois server' do
+    subject { send_query(whois, as_set) }
+
+    it 'returns the same result as if the FQDN specified' do
+      expect(subject).to eq send_query(whois_fqdn, as_set)
+    end
+  end
+
+  it 'gently closes connections to Whois server' do
+    expect_any_instance_of(Irrc::Whoisd::Client).to receive(:close)
+    send_query(whois_fqdn, as_set)
+  end
+
+  describe 'Fintering by Authoritative Whois server' do
+    subject { send_query(:jpirr, 'AS-JPNIC', source: :apnic) }
+
+    it 'returns nothing' do
+      expect(subject).to eq({})
+    end
+  end
+
+  context 'When as-set resolution is done but something wrong while further processes' do
+    subject { send_query(whois, as_set) }
+    before do
+      allow_any_instance_of(Irrc::Whoisd::Client).to receive(:resolve_prefixes_from_aut_nums){ raise }
+    end
+
+    it 'ignores a halfway result' do
+      expect(subject).to eq({})
+    end
+  end
+
+  context 'When only ipv4 is specified for protocol' do
+    subject { send_query(whois, as_set, protocol: :ipv4) }
+
+    it 'returns nothing about ipv6' do
+      expect(subject[as_set][:ipv6]).to be_nil
+    end
+  end
+
+  context 'When nil specified for protocol' do
+    subject { send_query(whois, as_set, protocol: nil) }
+
+    it 'returns nothing about the as-set' do
+      expect(subject[as_set]).to eq({})
+    end
+  end
+
+  context 'When blank protocol specified' do
+    subject { send_query(whois, as_set, protocol: []) }
+
+    it 'returns nothing about the as-set' do
+      expect(subject[as_set]).to eq({})
+    end
+  end
+
+  context 'When an invalid protocol specified' do
+    subject { send_query(whois, as_set, protocol: :invalid) }
+
+    it 'reports an ArgumentError' do
+      expect { subject }.to raise_error ArgumentError
+    end
+  end
+
+  context 'When a non-mirrored server specified for authoritative Whois server' do
+    subject { send_query(whois, as_set, source: :outsider) }
+
+    it 'returns nothing' do
+      expect(subject).to eq({})
+    end
+  end
+
+  context 'When nil specified for authoritative Whois server' do
+    subject { send_query(whois, as_set, source: nil) }
+
+    it 'returns a result without any filter of authoritative Whois server' do
+      expect(subject).to eq send_query(whois, as_set)
+    end
+  end
+
+  context 'When blank authoritative Whois server specified' do
+    subject { send_query(whois, as_set, source: []) }
+
+    it 'returns a result without any filter of authoritative Whois server' do
+      expect(subject).to eq send_query(whois, as_set)
+    end
+  end
+
+  context 'When non-existent Whois object specified' do
+    subject { send_query(whois, 'AS-NON-EXISTENT') }
+
+    it 'ignores the Whois error' do
+      expect(subject).to eq({})
+    end
+  end
+
+  context 'When invalid Whois server name specified' do
+    subject { send_query(:invalid, as_set) }
+
+    it 'reports an error' do
+      expect { subject }.to raise_error
+    end
+  end
+
+  context 'When non-resolvable Whois server fqdn specified' do
+    subject { send_query('non-resolvable.localdomain', as_set) }
+
+    it 'reports an error' do
+      expect { subject }.to raise_error
+    end
+  end
+
+  context 'When unreachable Whois server specified' do
+    subject { send_query('192.0.2.1', as_set) }
+
+    it 'reports an error' do
+      expect { subject }.to raise_error
+    end
+  end
+
+  context 'When specifing an Whois server out of service' do
+    subject { send_query('127.0.0.1', as_set) }
+
+    it 'reports an error' do
+      expect { subject }.to raise_error
+    end
+  end
+
+  describe 'NOTE: These may fail due to Whois database changes, not code. Check Whois database if fails.' do
+    describe 'route-set' do
+      subject { send_query(whois, 'RS-RC-26462') }
+
+      it 'returns the same result as Whois database' do
+        expect(subject['RS-RC-26462']).to eq(
+          {:ipv4=>{nil=>["137.238.0.0/16"]}, :ipv6=>{nil=>["2620:0:5080::/48"]}}
+        )
+      end
+    end
+
+    describe 'nested as-set' do
+      subject { send_query(whois, 'AS-PDOXUPLINKS', source: :apnic) }
+
+      it 'returns the same result as Whois database' do
+        expect(subject['AS-PDOXUPLINKS']).to eq(
+          {:ipv4=>
+             {"AS703"=>[],
+              "AS1221"=>["155.143.128.0/17", "203.92.26.0/24"],
+              "AS2764"=>[],
+              "AS7474"=>[],
+              "AS7657"=>[],
+              "AS4565"=>[],
+              "AS5650"=>[],
+              "AS6461"=>[]},
+           :ipv6=>
+             {"AS703"=>[],
+              "AS1221"=>[],
+              "AS2764"=>[],
+              "AS7474"=>[],
+              "AS7657"=>[],
+              "AS4565"=>[],
+              "AS5650"=>[],
+              "AS6461"=>[]}}
+        )
+      end
+    end
+
+    describe 'nested route-set' do
+      subject { send_query(whois, 'RS-RR-COUDERSPORT') }
+
+      it 'returns the same result as Whois database' do
+        expect(subject['RS-RR-COUDERSPORT']).to eq(
+          {:ipv4=>{nil=>["71.74.32.0/20", "75.180.128.0/19", "107.14.160.0/20"]},
+           :ipv6=>{nil=>[]}}
+        )
+      end
+    end
+  end
+end

data/spec/features/whois_invalid_object_resolution_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe 'Whois Invalid object resolution' do
+  include_context 'whois queries'
+
+  describe 'Try as-jpnic with JPIRR' do
+    context 'When invalid object specified' do
+      subject { send_query(whois, 'INVALID') }
+
+      it "doesn't report an error" do
+        expect(subject['INVALID']).to eq({})
+      end
+    end
+
+    context 'When a blank String given for IRR object to resolve' do
+      subject { send_query(whois, '') }
+
+      it "doesn't report an error" do
+        expect(subject['']).to eq({})
+      end
+    end
+
+    context 'When nil given for IRR object to resolve' do
+      subject { send_query(whois, nil) }
+
+      it 'does nothing even reporting the error' do
+        expect_any_instance_of(Irrc::Whoisd::Client).not_to receive(:connect)
+        expect(subject).to eq({})
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'irrc'
+
+Dir[File.expand_path('../support/**/*.rb', __FILE__)].each {|f| require f }
+
+RSpec.configure do |config|
+  config.include QueryHelper
+end

data/spec/support/contexts.rb

@@ -0,0 +1,12 @@
+shared_context 'irr queries' do
+  let(:irr) { :jpirr }
+  let(:irr_fqdn) { 'jpirr.nic.ad.jp' }
+  let(:as_set) { 'AS-JPNIC' }
+end
+
+shared_context 'whois queries' do
+  let(:whois) { :apnic }
+  let(:whois_fqdn) { 'whois.apnic.net' }
+  let(:as_set) { 'AS-JPNIC' }
+end
+

data/spec/support/query.rb

@@ -0,0 +1,7 @@
+module QueryHelper
+  def send_query(host, object, *options)
+    client = Irrc::Client.new(1)
+    client.query(host, object, *options)
+    client.perform
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: irrc
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Shintaro Kojima
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: irrc is a lightweight and flexible client of IRR / Whois Database to
+  expand arbitrary as-set and route-set objects into a list of origin ASs and prefixes
+  belonging to the ASs. It allows concurrent queries to IRR / Whois Databases for
+  performance.
+email:
+- goodies@codeout.net
+executables:
+- irrc
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/irrc
+- irrc.gemspec
+- lib/irrc.rb
+- lib/irrc/cli.rb
+- lib/irrc/cli/client.rb
+- lib/irrc/cli/yaml_printer.rb
+- lib/irrc/client.rb
+- lib/irrc/connecting.rb
+- lib/irrc/irr.rb
+- lib/irrc/irrd.rb
+- lib/irrc/irrd/api.rb
+- lib/irrc/irrd/client.rb
+- lib/irrc/logging.rb
+- lib/irrc/parameter.rb
+- lib/irrc/prefix.rb
+- lib/irrc/query.rb
+- lib/irrc/query_status.rb
+- lib/irrc/runner.rb
+- lib/irrc/socket.rb
+- lib/irrc/subquery.rb
+- lib/irrc/version.rb
+- lib/irrc/whoisd.rb
+- lib/irrc/whoisd/api.rb
+- lib/irrc/whoisd/client.rb
+- spec/features/irr_as_set_resolution_spec.rb
+- spec/features/irr_invalid_object_resolution_spec.rb
+- spec/features/whois_as_set_resolution_spec.rb
+- spec/features/whois_invalid_object_resolution_spec.rb
+- spec/spec_helper.rb
+- spec/support/contexts.rb
+- spec/support/query.rb
+homepage: https://github.com/codeout/irrc
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: IRR / Whois client to expand as-set and route-set into a list of origin ASs
+  and prefixes
+test_files:
+- spec/features/irr_as_set_resolution_spec.rb
+- spec/features/irr_invalid_object_resolution_spec.rb
+- spec/features/whois_as_set_resolution_spec.rb
+- spec/features/whois_invalid_object_resolution_spec.rb
+- spec/spec_helper.rb
+- spec/support/contexts.rb
+- spec/support/query.rb
+has_rdoc: