ruby-nmap 0.1.1 → 0.2.0

data/spec/spec_helper.rb

@@ -1,7 +1,4 @@
-require 'rubygems'
-gem 'rspec', '>=1.1.12'
-require 'spec'
-
+require 'rspec'
 require 'nmap/version'
 
 include Nmap

data/spec/task_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+require 'nmap/task'
+
+describe Task do
+  subject { Task.new }
+
+  describe "ports" do
+    it "should ignore empty port Arrays" do
+      subject.ports = []
+
+      subject.arguments.should == []
+    end
+
+    it "should format a String of ports" do
+      subject.ports = '80,21,25'
+
+      subject.arguments.should == %w[-p 80,21,25]
+    end
+
+    it "should format an Array of String ports" do
+      subject.ports = %w[80 21 25]
+
+      subject.arguments.should == %w[-p 80,21,25]
+    end
+
+    it "should format an Array of Integer ports" do
+      subject.ports = [80, 21, 25]
+
+      subject.arguments.should == %w[-p 80,21,25]
+    end
+
+    it "should format a Range of ports" do
+      subject.ports = [80, 21..25]
+
+      subject.arguments.should == %w[-p 80,21-25]
+    end
+  end
+end

data/spec/xml_spec.rb

@@ -1,8 +1,8 @@
-require 'nmap/xml'
-
 require 'spec_helper'
 require 'helpers/xml'
 
+require 'nmap/xml'
+
 describe XML do
   include Helpers
 
@@ -26,6 +26,10 @@ describe XML do
     @xml.scanner.arguments.should == 'nmap -v -oX samples/backspace.xml -O -P0 -sS 192.168.5.*'
   end
 
+  it "should parse the scanner start time" do
+    @xml.scanner.start_time.should == Time.at(1218934249)
+  end
+
   it "should parse the scan information" do
     scan_info = @xml.scan_info
 
@@ -42,6 +46,22 @@ describe XML do
     @xml.debugging.should == 0
   end
 
+  it "should parse the scan tasks" do
+    tasks = @xml.tasks
+
+    tasks.should_not be_empty
+
+    tasks.each do |task|
+      task.name.should_not be_nil
+      task.name.should_not be_empty
+
+      task.start_time.should > Time.at(0)
+
+      task.end_time.should > Time.at(0)
+      task.end_time.should >= task.start_time
+    end
+  end
+
   it "should parse the hosts" do
     @xml.hosts.length.should == 10
   end

metadata

@@ -1,153 +1,187 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nmap
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.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-----
+cert_chain: []
 
-date: 2010-01-02 00:00:00 -08:00
+date: 2010-10-29 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: nokogiri
-  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 
-        version: 1.4.0
-    version: 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :runtime
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: rprogram
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        version: 0.1.8
-    version: 
+        segments: 
+        - 0
+        - 2
+        - 0
+        version: 0.2.0
+  type: :runtime
+  version_requirements: *id002
 - !ruby/object:Gem::Dependency 
-  name: rspec
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  name: ore
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        version: 1.1.12
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: yard
+        segments: 
+        - 0
+        - 2
+        - 1
+        version: 0.2.1
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: ore-tasks
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        version: 0.2.3.5
-    version: 
+        segments: 
+        - 0
+        - 1
+        - 2
+        version: 0.1.2
+  type: :development
+  version_requirements: *id004
 - !ruby/object:Gem::Dependency 
-  name: hoe
+  name: rspec
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 0
+        version: 2.0.0
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        version: 2.4.0
-    version: 
+        segments: 
+        - 0
+        - 6
+        - 0
+        version: 0.6.0
+  type: :development
+  version_requirements: *id006
 description: A Ruby interface to Nmap, the exploration tool and security / port scanner.
-email: 
-- postmodern.mod3@gmail.com
+email: postmodern.mod3@gmail.com
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- Manifest.txt
+- README.md
 files: 
-- History.rdoc
-- Manifest.txt
-- README.rdoc
+- .rspec
+- .yardopts
+- ChangeLog.md
+- LICENSE.txt
+- README.md
 - Rakefile
+- gemspec.yml
 - lib/nmap.rb
-- lib/nmap/task.rb
-- lib/nmap/program.rb
 - lib/nmap/address.rb
 - lib/nmap/host.rb
+- lib/nmap/os.rb
 - lib/nmap/os_class.rb
 - lib/nmap/os_match.rb
-- lib/nmap/os.rb
 - lib/nmap/port.rb
-- lib/nmap/scanner.rb
+- lib/nmap/program.rb
 - lib/nmap/scan.rb
+- lib/nmap/scan_task.rb
+- lib/nmap/scanner.rb
 - lib/nmap/status.rb
-- lib/nmap/xml.rb
+- lib/nmap/task.rb
 - lib/nmap/version.rb
-- tasks/spec.rb
-- tasks/yard.rb
-- spec/spec_helper.rb
+- lib/nmap/xml.rb
+- ruby-nmap.gemspec
 - spec/helpers/scan.xml
 - spec/helpers/xml.rb
-- spec/os_spec.rb
 - spec/host_spec.rb
-- spec/xml_spec.rb
 - spec/nmap_spec.rb
+- spec/os_spec.rb
+- spec/spec_helper.rb
+- spec/task_spec.rb
+- spec/xml_spec.rb
 has_rdoc: yard
-homepage: http://ruby-nmap.rubyforge.org/
-licenses: []
-
+homepage: http://github.com/sophsec/ruby-nmap
+licenses: 
+- MIT
 post_install_message: 
-rdoc_options: 
-- --main
-- README.rdoc
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
-requirements: []
-
+requirements: 
+- nmap, 4.xx or greater
 rubyforge_project: ruby-nmap
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: A Ruby interface to Nmap, the exploration tool and security / port scanner.
-test_files: []
-
+summary: A Ruby interface to Nmap.
+test_files: 
+- spec/host_spec.rb
+- spec/nmap_spec.rb
+- spec/os_spec.rb
+- spec/xml_spec.rb
+- spec/task_spec.rb

data/History.rdoc

@@ -1,11 +0,0 @@
-=== 0.1.1 / 2010-01-02
-
-* Require RProgram >= 0.1.8.
-  * Adds +sudo+ and +sudo=+ instance methods to {Nmap::Task}.
-
-=== 0.1.0 / 2009-11-13
-
-* Initial release.
-  * Provides a Ruby interface for running Nmap.
-  * Provides a Parser for enumerating Nmap XML scan files.
-

data/Manifest.txt

@@ -1,27 +0,0 @@
-History.rdoc
-Manifest.txt
-README.rdoc
-Rakefile
-lib/nmap.rb
-lib/nmap/task.rb
-lib/nmap/program.rb
-lib/nmap/address.rb
-lib/nmap/host.rb
-lib/nmap/os_class.rb
-lib/nmap/os_match.rb
-lib/nmap/os.rb
-lib/nmap/port.rb
-lib/nmap/scanner.rb
-lib/nmap/scan.rb
-lib/nmap/status.rb
-lib/nmap/xml.rb
-lib/nmap/version.rb
-tasks/spec.rb
-tasks/yard.rb
-spec/spec_helper.rb
-spec/helpers/scan.xml
-spec/helpers/xml.rb
-spec/os_spec.rb
-spec/host_spec.rb
-spec/xml_spec.rb
-spec/nmap_spec.rb

data/README.rdoc

@@ -1,83 +0,0 @@
-= ruby-nmap
-
-* http://ruby-nmap.rubyforge.org/
-* http://github.com/sophsec/ruby-nmap
-* http://github.com/sophsec/ruby-nmap/issues
-* Postmodern (postmodern.mod3 at gmail.com)
-
-== DESCRIPTION:
-
-A Ruby interface to Nmap, the exploration tool and security / port scanner.
-
-== FEATURES:
-
-* Provides a Ruby interface for running Nmap.
-* Provides a Parser for enumerating Nmap XML scan files.
-
-== EXAMPLES:
-
-* Run Nmap from Ruby:
-
-    require 'nmap/program'
-    
-    Nmap::Program.scan do |nmap|
-      nmap.sudo = true
-
-      nmap.syn_scan = true
-      nmap.service_scan = true
-      nmap.os_fingerprint = true
-      nmap.xml = 'scan.xml'
-      nmap.verbose = true
-
-      nmap.ports = [20,21,22,23,25,80,110,443,512,522,8080,1080]
-      nmap.targets = '192.168.1.*'
-    end
-
-* Parse Nmap XML scan files:
-
-    require 'nmap/xml'
-
-    Nmap::XML.new('scan.xml') do |xml|
-      xml.each_host do |host|
-        puts "[#{host.ip}]"
-    
-        host.each_port do |port|
-          puts "  #{port.number}/#{port.protocol}\t#{port.state}\t#{port.service}"
-        end
-      end
-    end
-
-== REQUIREMENTS:
-
-* {nmap}[http://www.insecure.org/]
-* {nokogiri}[http://nokogiri.rubyforge.org/] >= 1.4.0
-* {rprogram}[http://rprogram.rubyforge.org/] >= 0.1.8
-
-== INSTALL:
-
-  $ sudo gem install ruby-nmap
-
-== LICENSE:
-
-The MIT License
-
-Copyright (c) 2009-2010 Hal Brodigan
-
-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.