Added Ronin::Nmap.parse.

lib/ronin/nmap.rb

@@ -196,5 +196,22 @@ def self.scan(*targets, sudo: nil, **kwargs,&block)
         ::Nmap::XML.open(nmap.output_xml)
       end
     end
+
+    #
+    # Parses a nmap XML file.
+    #
+    # @param [String] path
+    #   The path to the nmap XML file.
+    #
+    # @return [::Nmap::XML]
+    #   The parsed nmap XML file.
+    #
+    # @see https://rubydoc.info/gems/ruby-nmap/Nmap/XML
+    #
+    # @api public
+    #
+    def self.parse(path)
+      ::Nmap::XML.open(path)
+    end
   end
 end

spec/nmap_spec.rb

@@ -2,6 +2,8 @@
 require 'ronin/nmap'
 
 RSpec.describe Ronin::Nmap do
+  let(:fixtures_dir) { File.join(__dir__,'fixtures') }
+
   describe '.scan' do
     let(:targets) { '192.168.1.*' }
 
@@ -57,4 +59,15 @@
       end
     end
   end
+
+  describe ".parse" do
+    let(:path) { File.join(fixtures_dir,'nmap.xml') }
+
+    it "must return a Nmap::XML object for the given path" do
+      xml = subject.parse(path)
+
+      expect(xml).to be_kind_of(Nmap::XML)
+      expect(xml.path).to eq(path)
+    end
+  end
 end