ruby-nmap 0.9.3 → 1.0.0

data/lib/nmap/version.rb

@@ -1,4 +1,4 @@
 module Nmap
   # ruby-nmap version
-  VERSION = '0.9.3'
+  VERSION = '1.0.0'
 end

data/lib/nmap/xml/address.rb

@@ -0,0 +1,38 @@
+module Nmap
+  class XML
+    #
+    # Represents an IP or MAC address and Vendor name.
+    #
+    # @since 1.0.0
+    #
+    class Address < Struct.new(:type, :addr, :vendor)
+
+      #
+      # Initializes the address.
+      #
+      # @param [Symbol] type
+      #   The type of address.
+      #
+      # @param [String] addr
+      #   The address.
+      #
+      # @param [String, nil] vendor
+      #   The optional vendor.
+      #
+      def initialize(type,addr,vendor=nil)
+        super(type,addr,vendor)
+      end
+
+      #
+      # Converts the address to a String.
+      #
+      # @return [String]
+      #   The address.
+      #
+      def to_s
+        self.addr.to_s
+      end
+
+    end
+  end
+end

data/lib/nmap/xml/cpe/url.rb

@@ -0,0 +1,80 @@
+module Nmap
+  class XML
+    module CPE
+      #
+      # Represents a [Common Platform Enumeration (CPE)][CPE] URL.
+      #
+      # [CPE]: http://nmap.org/book/output-formats-cpe.html
+      #
+      # @since 1.0.0
+      #
+      class URL < Struct.new(:part,:vendor,:product,:version,:update,:edition,
+                             :language)
+
+        # CPE part codes
+        PARTS = {
+          '/a' => :application,
+          '/h' => :hardware,
+          '/o' => :os
+        }
+
+        #
+        # Parses a CPE URL.
+        #
+        # @param [String] url
+        #   The raw URL.
+        #
+        # @return [URL]
+        #   The parsed URL.
+        #
+        def self.parse(url)
+          scheme,
+            part,
+            vendor,
+            product,
+            version,
+            update,
+            edition,
+            language = url.split(':',8)
+
+          unless scheme == 'cpe'
+            raise(ArgumentError,"CPE URLs must begin with 'cpe:'")
+          end
+
+          vendor   = vendor.to_sym
+          product  = product.to_sym
+          language = language.to_sym if language
+
+          return new(
+            PARTS[part],
+            vendor,
+            product,
+            version,
+            update,
+            edition,
+            language
+          )
+        end
+
+        #
+        # Converts the CPE URL back into a String.
+        #
+        # @return [String]
+        #   The raw CPE URL.
+        #
+        def to_s
+          'cpe:' + [
+            PARTS.invert[part],
+            vendor,
+            product,
+            version,
+            update,
+            edition,
+            language
+          ].compact.join(':')
+        end
+
+      end
+    end
+  end
+end

data/lib/nmap/xml/cpe.rb

@@ -0,0 +1,47 @@
+require 'nmap/xml/cpe/url'
+
+module Nmap
+  class XML
+    #
+    # Mixins that adds methods for parsing [Common Platform Enumeration
+    # (CPE)][CPE] information.
+    #
+    # [CPE]: http://nmap.org/book/output-formats-cpe.html
+    #
+    # @since 1.0.0
+    #
+    module CPE
+      #
+      # Parses each Common Platform Enumeration (CPE) String.
+      #
+      # @yield [cpe]
+      #   Passes each CPE URL to the given block.
+      #
+      # @yieldparam [URL] cpe
+      #   The CPE URL.
+      #
+      # @return [Enumerator]
+      #   If no block is given, an enumerator object will be returned.
+      #
+      def each_cpe
+        return enum_for(__method__) unless block_given?
+
+        @node.xpath('cpe').each do |cpe|
+          yield URL.parse(cpe.inner_text)
+        end
+
+        return self
+      end
+
+      #
+      # Parses each Common Platform Enumeration (CPE) String.
+      #
+      # @return [Array<URL>]
+      #   The CPE URLs.
+      #
+      def cpe
+        each_cpe.to_a
+      end
+    end
+  end
+end

data/lib/nmap/xml/hop.rb

@@ -0,0 +1,22 @@
+module Nmap
+  class XML
+    #
+    # Represents a hop in a traceroute.
+    #
+    # @since 1.0.0
+    #
+    class Hop < Struct.new(:addr, :host, :ttl, :rtt)
+
+      #
+      # Converts the hop to a String.
+      #
+      # @return [String]
+      #   The IP address of the hop.
+      #
+      def to_s
+        self.addr.to_s
+      end
+
+    end
+  end
+end