== Pickle Failures ==

Our schemas are "best guesses" based on what we've seen on the
wire. From time to time they'll be wrong, and thus the (un)pickler
implementation will fail to unpickle some XML document. The easiest
way to test a fix for this is interactively: it's quick, and error
messages are written to the console. Here's an example of such a
session (wrapped for readability):

  $ ghci
  htsn-import> runX $ xunpickleDocument
                      TSN.XML.AutoRacingResults.pickle_message
                      parse_opts
		      "schemagen/AutoRacingResultsXML/21241892.xml"
  [Message {xml_xml_file_id = 21241892... stamp = 2014-06-08 04:05:00 UTC}]

If there's an error, you'll see something like the following:

  $ ghci
  htsn-import> runX $ xunpickleDocument
                      TSN.XML.AutoRacingResults.pickle_message
                      parse_opts
		      "schemagen/AutoRacingResultsXML/21241892-bad.xml"
  fatal error: document unpickling failed
  xpElem: got element name "RaceDate", but expected "RaceID"
  context:    element "message"
  contents:   <Title>IRL - Firestone 600 - Final Results</Title><Track_Location>
  Texas Motor Sp...
  []