Class XMLFile

Create an XMLFile

Keywords:

• path - a pathname from which the file can be read
• file - an open file object from which the raw xml can be read
• raw - the raw xml itself
• root - name of root tag, if not reading content

Usage scenarios:

1. Working with existing content - you must supply input in one of the following ways:
   • 'path' must be an existing file, or
   • 'file' must be a readable file object, or
   • 'raw' must contain raw xml as a string
2. Creating whole new content - you must give the name of the root tag in the 'root' keyword

Notes:

• Keyword precedence governing existing content is:
  1. path (if existing file)
  2. file
  3. raw
• If working with existing content:
  • if the 'root' is given, then the content's toplevel tag MUST match the value given for 'root'
  • trying to _save will raise an exception unless 'path' has been given
• if not working with existing content:
  • 'root' must be given
  • _save() will raise an exception unless 'path' has been given

Saves the document.

If argument 'where' is given, saves to it, otherwise tries to save to the original given 'path' (or barfs)

Value can be a string (taken to be a file path), or an open file object.