shodan 0.1.0 → 0.2.0

data/README.md

@@ -34,3 +34,6 @@ To properly handle potential errors, you should wrap all requests in a try/excep
 		api.search("cisco-ios")
 	rescue Exception => e
 		puts "Error: #{e.to_s}"
+	else
+		puts "Unknown error"
+	end

data/lib/shodan/api.rb

@@ -16,10 +16,12 @@ module Shodan
   class WebAPI
     attr_accessor :api_key
     attr_accessor :base_url
+    attr_accessor :exploitdb
     
     def initialize(api_key)
       @api_key = api_key
       @base_url = "http://www.shodanhq.com/api/"
+      @exploitdb = ExploitDB.new(self)
     end
     
     # Internal method that sends out the HTTP request.
@@ -44,7 +46,6 @@ module Shodan
       
       return data
     end
-    private :request
     
     # Get all available information on an IP.
     #
@@ -67,4 +68,60 @@ module Shodan
     end
   end
   
+  # The ExploitDB class depends shouldn't be used independently,
+  # as it depends on the WebAPI class.
+  #
+  # Author:: achillean (mailto:jmath at surtri.com)
+  #
+  # :title:Shodan::ExploitDB
+  class ExploitDB
+    attr_accessor :api
+    
+    def initialize(api)
+      @api = api
+    end
+    
+    # Download the exploit code from the ExploitDB archive.
+    # 
+    # Arguments:
+    # id    -- ID of the ExploitDB entry
+    # 
+    # Returns:
+    # A hash with the following fields:
+    # filename        -- Name of the file
+    # content-type    -- Mimetype
+    # data            -- Contents of the file
+    def download(id)
+      return @api.request('exploitdb/download', {:id => "#{id}"})
+    end
+    
+    # Search the ExploitDB archive.
+    #    
+    # Arguments:
+    # query     -- Search terms
+    #
+    # Optional arguments:
+    # author    -- Name of the exploit submitter
+    # platform  -- Target platform (e.g. windows, linux, hardware etc.)
+    # port      -- Service port number
+    # type      -- Any, dos, local, papers, remote, shellcode and webapps
+    #
+    # Returns:
+    # A dictionary with 2 main items: matches (list) and total (int).
+    # Each item in 'matches' is a dictionary with the following elements:
+    #
+    # id
+    # author
+    # date
+    # description
+    # platform
+    # port
+    # type
+    def search(query, params={})
+      params[:q] = query
+      return @api.request('exploitdb/search', params)
+    end
+    
+  end
+  
 end

data/lib/shodan/version.rb

@@ -1,3 +1,3 @@
 module Shodan
-  Version = VERSION = '0.1.0'
+  Version = VERSION = '0.2.0'
 end

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: shodan
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  hash: 23
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - John Matherly
@@ -9,19 +15,25 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-10 00:00:00 -07:00
+date: 2010-11-02 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: json
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 1
+        - 4
+        - 6
         version: 1.4.6
-    version: 
+  type: :runtime
+  version_requirements: *id001
 description: "  A Ruby library to interact with the SHODAN API.\n"
 email: jmath@surtri.com
 executables: []
@@ -48,21 +60,27 @@ rdoc_options:
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: A Ruby library to interact with the SHODAN API.