Merge branch 'issue76'

Author: jimnicholls

pymarc/writer.py

@@ -1,48 +1,247 @@
+import pymarc
 from pymarc import Record, WriteNeedsRecord
 
+try:
+    import xml.etree.ElementTree as ET  # builtin in Python 2.5
+except ImportError:
+    import elementtree.ElementTree as ET
+
+try:
+    # the json module was included in the stdlib in python 2.6
+    # http://docs.python.org/library/json.html
+    import json
+except ImportError:
+    # simplejson 2.0.9 is available for python 2.4+
+    # http://pypi.python.org/pypi/simplejson/2.0.9
+    # simplejson 1.7.3 is available for python 2.3+
+    # http://pypi.python.org/pypi/simplejson/1.7.3
+    import simplejson as json
+
+
 class Writer(object):
 
+    def __init__(self, file_handle, own_file_handle = True):
+        self.file_handle = file_handle
+        self.own_file_handle = own_file_handle
+
     def write(self, record):
-        pass
+        if not isinstance(record, Record):
+            raise WriteNeedsRecord
+
+    def close(self):
+        """
+        Closes the writer.
+
+        If own_file_handle is True, also closes the file handle.
+        """
+        if self.own_file_handle:
+            self.file_handle.close()
+        self.file_handle = None
+
+
+class JSONWriter(Writer):
+    """
+    A class for writing records as an array of MARC-in-JSON objects.
+
+    IMPORTANT: You must the close a JSONWriter,
+    otherwise you will not get valid JSON.
+
+    Simple usage::
+
+        >>> from pymarc import JSONWriter
+
+        ### writing to a file
+        >>> writer = JSONWriter(open('file.json','wt'))
+        >>> writer.write(record)
+        >>> writer.close() # Important!
+
+        ### writing to a string
+        >>> string = StringIO()
+        >>> writer = JSONWriter(string, own_file_handle = False)
+        >>> writer.write(record)
+        >>> writer.close() # Important!
+        >>> print string
+    """
+
+    def __init__(self, file_handle, own_file_handle = True):
+        """
+        You need to pass in a text file like object.
+
+        If own_file_handle is True (the default) then the file handle will be
+        closed when the writer is closed. Otherwise the file handle will be
+        left open.
+        """
+        super(JSONWriter, self).__init__(file_handle, own_file_handle)
+        self.write_count = 0
+        self.file_handle.write('[')
+
+    def write(self, record):
+        """
+        Writes a record.
+        """
+        Writer.write(self, record)
+        if self.write_count > 0:
+            self.file_handle.write(',')
+        json.dump(record.as_dict(), self.file_handle, separators=(',', ':'))
+        self.write_count += 1
+
+    def close(self):
+        """
+        Closes the writer.
+
+        If own_file_handle is True, also closes the file handle.
+        """
+        self.file_handle.write(']')
+        Writer.close(self)
+
 
 class MARCWriter(Writer):
     """
     A class for writing MARC21 records in transmission format.
 
-    Simple usage:
+    Simple usage::
+
+        >>> from pymarc import MARCWriter
 
-        from pymarc import MARCWriter
+        ### writing to a file
+        >>> writer = MARCWriter(open('file.dat','wb'))
+        >>> writer.write(record)
+        >>> writer.close()
 
-        ## pass in a file
-        writer = MARCWriter(file('file.dat','w'))
-        writer.write(record)
+        ### writing to a string (Python 2 only)
+        >>> string = StringIO()
+        >>> writer = MARCWriter(string)
+        >>> writer.write(record)
+        >>> writer.close()
+        >>> print string
 
-        ## use StringIO if you want to write to a string
-        string = StringIO()
-        writer = MARCWriter(string)
-        writer.write(record)
-        print string
+        ### writing to memory (Python 3 only)
+        >>> memory = BytesIO()
+        >>> writer = MARCWriter(memory)
+        >>> writer.write(record)
+        >>> writer.close()
     """
 
-    def __init__(self, file_handle):
+    def __init__(self, file_handle, own_file_handle = True):
         """
-        You need to pass in a file like object.
+        You need to pass in a byte file like object.
+
+        If own_file_handle is True (the default) then the file handle will be
+        closed when the writer is closed. Otherwise the file handle will be
+        left open.
         """
-        super(MARCWriter, self).__init__()
-        self.file_handle = file_handle
+        super(MARCWriter, self).__init__(file_handle, own_file_handle)
 
     def write(self, record):
         """
         Writes a record.
         """
-        if not isinstance(record, Record):
-            raise WriteNeedsRecord
+        Writer.write(self, record)
         self.file_handle.write(record.as_marc())
 
-    def close(self):
+
+class TextWriter(Writer):
+    """
+    A class for writing records in prettified text MARCMaker format.
+
+    A blank line separates each record.
+
+    Simple usage::
+
+        >>> from pymarc import TextWriter
+
+        ### writing to a file
+        >>> writer = TextWriter(open('file.txt','wt'))
+        >>> writer.write(record)
+        >>> writer.close()
+
+        ### writing to a string
+        >>> string = StringIO()
+        >>> writer = TextWriter(string, own_file_handle = False)
+        >>> writer.write(record)
+        >>> writer.close()
+        >>> print string
+    """
+
+    def __init__(self, file_handle, own_file_handle = True):
         """
-        Closes the file.
+        You need to pass in a text file like object.
+
+        If own_file_handle is True (the default) then the file handle will be
+        closed when the writer is closed. Otherwise the file handle will be
+        left open.
         """
-        self.file_handle.close()
-        self.file_handle = None
+        super(TextWriter, self).__init__(file_handle, own_file_handle)
+        self.write_count = 0
+
+    def write(self, record):
+        """
+        Writes a record.
+        """
+        Writer.write(self, record)
+        if self.write_count > 0:
+            self.file_handle.write('\n')
+        self.file_handle.write(str(record))
+        self.write_count += 1
+
+
+class XMLWriter(Writer):
+    """
+    A class for writing records as a MARCXML collection.
 
+    IMPORTANT: You must the close an XMLWriter, otherwise you will not get
+    a valid XML document.
+
+    Simple usage::
+
+        >>> from pymarc import XMLWriter
+
+        ### writing to a file
+        >>> writer = XMLWriter(open('file.xml','wb'))
+        >>> writer.write(record)
+        >>> writer.close() # Important!
+
+        ### writing to a string (Python 2 only)
+        >>> string = StringIO()
+        >>> writer = XMLWriter(string)
+        >>> writer.write(record)
+        >>> writer.close() # Important!
+        >>> print string
+
+        ### writing to memory (Python 3 only)
+        >>> memory = BytesIO()
+        >>> writer = XMLWriter(memory)
+        >>> writer.write(record)
+        >>> writer.close() # Important!
+    """
+
+    def __init__(self, file_handle, own_file_handle = True):
+        """
+        You need to pass in a binary file like object.
+
+        If own_file_handle is True (the default) then the file handle will be
+        closed when the writer is closed. Otherwise the file handle will be
+        left open.
+        """
+        super(XMLWriter, self).__init__(file_handle, own_file_handle)
+        self.file_handle.write(
+            b'<?xml version="1.0" encoding="UTF-8"?>')
+        self.file_handle.write(
+            b'<collection xmlns="http://www.loc.gov/MARC21/slim">')
+
+    def write(self, record):
+        """
+        Writes a record.
+        """
+        Writer.write(self, record)
+        node = pymarc.record_to_xml_node(record)
+        self.file_handle.write(ET.tostring(node, encoding='utf-8'))
+
+    def close(self):
+        """
+        Closes the writer.
+
+        If own_file_handle is True, also closes the file handle.
+        """
+        self.file_handle.write(b'</collection>')
+        Writer.close(self)