Added ToReader method for streaming out XML results

xml.go

@@ -1,7 +1,9 @@
 package nmap
 
 import (
+	"bytes"
 	"encoding/xml"
+	"io"
 	"io/ioutil"
 	"strconv"
 	"time"
@@ -41,6 +43,11 @@ func (r Run) ToFile(filePath string) error {
 	return ioutil.WriteFile(filePath, r.rawXML, 0666)
 }
 
+// ToReader writes the raw XML into an streamable buffer.
+func (r Run) ToReader() io.Reader {
+	return bytes.NewReader(r.rawXML)
+}
+
 // ScanInfo represents the scan information.
 type ScanInfo struct {
 	NumServices int    `xml:"numservices,attr" json:"num_services"`
@@ -421,7 +428,7 @@ func (t *Timestamp) UnmarshalXMLAttr(attr xml.Attr) (err error) {
 // Run struct.
 func Parse(content []byte) (*Run, error) {
 	r := &Run{
-		rawXML:     content,
+		rawXML: content,
 	}
 
 	err := xml.Unmarshal(content, r)

xml_test.go

@@ -312,6 +312,29 @@ func TestToFile(t *testing.T) {
 	}
 }
 
+func TestToReader(t *testing.T) {
+	inputFile := "tests/xml/scan01.xml"
+	rawXML, err := ioutil.ReadFile(inputFile)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	result, err := Parse(rawXML)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	reader := result.ToReader()
+	byteOutput, err := ioutil.ReadAll(reader)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	if !bytes.Equal(byteOutput, result.rawXML) {
+		t.Error("expected ToReader method to return lexicographically identical results")
+	}
+}
+
 func TestTimestampJSONMarshaling(t *testing.T) {
 	dateTime := time.Date(2000, 0, 0, 0, 0, 0, 0, time.UTC)
 	dateBytes := []byte("943920000")