shodan-ruby 0.1.0

data/spec/page_spec.rb

@@ -0,0 +1,91 @@
+require 'shodan/page'
+
+require 'spec_helper'
+
+describe Page do
+  before(:all) do
+    @host_one = Host.new('127.0.0.1','16.11.2009','SSH-2.0-OpenSSH_4.2')
+    @host_two = Host.new('192.168.1.1','06.11.2009','SSH-2.0-Sun_SSH_1.1','lol.cats.net')
+
+    @page = Page.new([@host_one, @host_two])
+  end
+
+  it "should map the Page to an Array" do
+    @page.map { |host| host.ip }.should == [
+      '127.0.0.1',
+      '192.168.1.1'
+    ]
+  end
+
+  it "should select hosts from the Page into another Page" do
+    @page.select { |host| true }.class.should == Page
+  end
+
+  it "should allow the enumeration of the IP addresses of hosts" do
+    ips = []
+
+    @page.each_ip do |ip|
+      ips << ip
+    end
+
+    ips.should == ['127.0.0.1', '192.168.1.1']
+  end
+
+  it "should select hosts based on their IP address" do
+    @page.hosts_with_ip('127.0.0.1').should == [@host_one]
+  end
+
+  it "should provide the IP addresses of hosts" do
+    @page.ips.should == ['127.0.0.1', '192.168.1.1']
+  end
+
+  it "should allow the enumerations of hostnames" do
+    names = []
+
+    @page.each_hostname { |name| names << name }
+
+    names.should == ['lol.cats.net']
+  end
+
+  it "should select hosts based on their hostname" do
+    @page.hosts_with_name('lol.cats.net').should == [@host_two]
+  end
+
+  it "should provide the hostnames" do
+    @page.hostnames.should == ['lol.cats.net']
+  end
+
+  it "should allow the enumeration of the dates of added hosts" do
+    dates = []
+
+    @page.each_date { |date| dates << date }
+
+    dates.should == [@host_one.date, @host_two.date]
+  end
+
+  it "should provide the dates hosts were added on" do
+    @page.dates.should == [@host_one.date, @host_two.date]
+  end
+
+  it "should allow the enumeration of responses" do
+    responses = []
+
+    @page.each_response { |resp| responses << resp }
+
+    responses.should == [
+      'SSH-2.0-OpenSSH_4.2',
+      'SSH-2.0-Sun_SSH_1.1'
+    ]
+  end
+
+  it "should select the hosts with certain responses" do
+    @page.responses_with('Sun').should == [@host_two]
+  end
+
+  it "should provide the responses of hosts" do
+    @page.responses.should == [
+      'SSH-2.0-OpenSSH_4.2',
+      'SSH-2.0-Sun_SSH_1.1'
+    ]
+  end
+end

data/spec/query_spec.rb

@@ -0,0 +1,95 @@
+require 'shodan/query'
+
+require 'spec_helper'
+require 'has_pages_examples'
+require 'page_has_hosts_examples'
+
+describe Query do
+  before(:all) do
+    @query = Query.new(:query => 'ssh')
+    @page = @query.first_page
+  end
+
+  it_should_behave_like "has Pages"
+  it_should_behave_like "Page has Hosts"
+
+  describe "query expression" do
+    it "should support basic queries" do
+      q = Query.new(:query => 'ssh')
+
+      q.expression.should == 'ssh'
+    end
+
+    it "should support the country search operator" do
+      q = Query.new(
+        :query => 'ssh', :countries => [
+          Countries::Mexico,
+          Countries::Nicaragua
+        ]
+      )
+
+      q.expression.should == 'ssh country:MX country:NI'
+    end
+
+    it "should support host search operator" do
+      q = Query.new(
+        :query => 'http',
+        :hostnames => ['www.wired.com']
+      )
+
+      q.expression.should == 'http hostname:www.wired.com'
+    end
+
+    it "should support the net search operator" do
+      q = Query.new(
+        :query => 'ssh',
+        :networks => ['112.0.0.0/8']
+      )
+
+      q.expression.should == 'ssh net:112.0.0.0/8'
+    end
+
+    it "should support the port search operator" do
+      q = Query.new(
+        :query => 'login',
+        :ports => [21, 23]
+      )
+
+      q.expression.should == 'login port:21 port:23'
+    end
+  end
+
+  describe "search URL" do
+    before(:all) do
+      @uri = @query.search_url
+    end
+
+    it "should be a valid HTTP URI" do
+      @uri.class.should == URI::HTTP
+    end
+
+    it "should have a 'q' query-param" do
+      @uri.query_params['q'].should == @query.query
+    end
+  end
+
+  describe "page specific URLs" do
+    before(:all) do
+      @uri = @query.page_url(2)
+    end
+
+    it "should have a 'page' query-param" do
+      @uri.query_params['page'].should == 2
+    end
+  end
+
+  describe "queries from search URLs" do
+    before(:all) do
+      @query = Query.from_url("http://shodan.surtri.com/?q=login+port%3A21+port%3A23")
+    end
+
+    it "should have a query" do
+      @query.query.should == 'login port:21 port:23'
+    end
+  end
+end

data/spec/shodan_spec.rb

@@ -0,0 +1,34 @@
+require 'shodan/shodan'
+require 'shodan/version'
+
+require 'spec_helper'
+
+describe "Shodan" do
+  it "should have a VERSION constant" do
+    Shodan.const_defined?('VERSION').should == true
+  end
+
+  describe "User-Agent support" do
+    it "should have a default User-Agent string" do
+      Shodan.user_agent.should_not be_nil
+    end
+  end
+
+  describe "Proxy support" do
+    it "should provide a :host key" do
+      Shodan.proxy.has_key?(:host).should == true
+    end
+
+    it "should provide a :port key" do
+      Shodan.proxy.has_key?(:port).should == true
+    end
+
+    it "should provide a :user key" do
+      Shodan.proxy.has_key?(:user).should == true
+    end
+
+    it "should provide a :password key" do
+      Shodan.proxy.has_key?(:password).should == true
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+gem 'rspec', '>=1.2.8'
+require 'spec'
+
+require 'shodan/version'
+
+include Shodan

data/tasks/spec.rb

@@ -0,0 +1,10 @@
+require 'spec/rake/spectask'
+
+desc "Run all specifications"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs += ['lib', 'spec']
+  t.spec_opts = ['--colour', '--format', 'specdoc']
+end
+
+task :test => :spec
+task :default => :spec

data/tasks/yard.rb

@@ -0,0 +1,13 @@
+require 'yard'
+
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+  t.options = [
+    '--protected',
+    '--files', 'History.txt',
+    '--title', 'SHODAN Ruby',
+    '--quiet'
+  ]
+end
+
+task :docs => :yard

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification 
+name: shodan-ruby
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Postmodern
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDQDCCAiigAwIBAgIBADANBgkqhkiG9w0BAQUFADBGMRgwFgYDVQQDDA9wb3N0
+  bW9kZXJuLm1vZDMxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixk
+  ARkWA2NvbTAeFw0wOTA2MDMwNDU5MDNaFw0xMDA2MDMwNDU5MDNaMEYxGDAWBgNV
+  BAMMD3Bvc3Rtb2Rlcm4ubW9kMzEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYK
+  CZImiZPyLGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
+  1wvANkTDHFgVih5XLjuTwTZjgBq1lBGybXJiH6Id1lY2JOMqM5FB1DDHVvvij94i
+  mJabN0zkzu6VKWC70y0IwOxY7CPokr0eFdK/D0y7mCq1P8QITv76i2YqAl0eYqIt
+  W+IhIkANQ7E6uMZIZcdnfadC6lPAtlKkqtd9crvRbFgr6e3kyflmohbRnTEJHoRd
+  7SHHsybE6DSn7oTDs6XBTNrNIn5VfZA0z01eeos/+zBm1zKJOK2+/7xtLLDuDU9G
+  +Rd+ltUBbvxUrMNZmDG29pnmN2xTRH+Q8HxD2AxlvM5SRpK6OeZaHV7PaCCAVZ4L
+  T9BFl1sfMvRlABeGEkSyuQIDAQABozkwNzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIE
+  sDAdBgNVHQ4EFgQUKwsd+PqEYmBvyaTyoL+uRuk+PhEwDQYJKoZIhvcNAQEFBQAD
+  ggEBAB4TvHsrlbcXcKg6gX5BIb9tI+zGkpzo0Z7jnxMEcNO7NGGwmzafDBI/xZYv
+  xkRH3/HXbGGYDOi6Q6gWt5GujSx0bOImDtYTJTH8jnzN92HzEK5WdScm1QpZKF1e
+  cezArMbxbSPaosxTCtG6LQTkE28lFQsmFZ5xzouugS4h5+LVJiVMmiP+l3EfkjFa
+  GOURU+rNEMPWo8MCWivGW7jes6BMzWHcW7DQ0scNVmIcCIgdyMmpscuAEOSeghy9
+  /fFs57Ey2OXBL55nDOyvN/ZQ2Vab05UH4t+GCxjAPeirzL/29FBtePT6VD44c38j
+  pDj+ws7QjtH/Qcrr1l9jfN0ehDs=
+  -----END CERTIFICATE-----
+
+date: 2009-12-03 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mechanize
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.4.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.3
+    version: 
+description: A Ruby interface to SHODAN, a computer search engine.
+email: 
+- postmodern.mod3@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- COPYING.txt
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- COPYING.txt
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/shodan.rb
+- lib/shodan/extensions.rb
+- lib/shodan/extensions/uri.rb
+- lib/shodan/extensions/uri/query_params.rb
+- lib/shodan/extensions/uri/http.rb
+- lib/shodan/host.rb
+- lib/shodan/page.rb
+- lib/shodan/has_pages.rb
+- lib/shodan/query.rb
+- lib/shodan/shodan.rb
+- lib/shodan/version.rb
+- tasks/spec.rb
+- tasks/yard.rb
+- spec/spec_helper.rb
+- spec/host_spec.rb
+- spec/page_spec.rb
+- spec/page_has_hosts_examples.rb
+- spec/has_pages_examples.rb
+- spec/query_spec.rb
+- spec/shodan_spec.rb
+has_rdoc: yard
+homepage: http://github.com/postmodern/shodan-ruby
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: shodan-ruby
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A Ruby interface to SHODAN, a computer search engine.
+test_files: []
+

metadata.gz.sig

@@ -0,0 +1 @@
+U�p^qp�:/+���!�e�&�Ee����YԧH�
XI�^�|��lJa+J���?�����L�SA#7h/�ஜÛ}����$;Ls�xN���"�/��-Lv’�Ni���ͨ��l,��R�06�����?�:n�Ř�/��%�M�nʃ�^?���fF.)8Gy�`