dat

Overview ¶

Package dat implements parsing of XML dat files as commonly used by ROM/Disc preservation projects such as http://redump.org and https://no-intro.org. The DTD supports more elements but currently just the minimal subset used by these two projects are implemented.

It has the facility to mark a ROM as matched/found and so when the File is marshalled back to XML, any such ROMs are not included in the output. This means if all of the ROMs for a particular Game are matched, that Game will not be included at all in the output and consequently if all ROMs for all Games are matched, no XML will be output at all for the entire File.

An example:

import (
        "encoding/xml"
        "os"

        "github.com/bodgit/rom/dat"
)

func main() {
        b, err := os.ReadFile(os.Args[1])
        if err != nil {
                panic(err)
        }

        f := new(dat.File)
        if err := xml.Unmarshal(b, f); err != nil {
                panic(err)
        }

        // Mark the first ROM of the first Game as matched
        f.Game[0].ROM[0].Matched()

        b, err = xml.MarshalIndent(f, "", "\t")
        if err != nil {
                panic(err)
        }

        fmt.Println(string(b))
}