[Docstring-checkins] CVS: dps/dps/writers __init__.py,1.1,1.2

[David G. <go...@us...>]

Update of /cvsroot/docstring/dps/dps/writers
In directory usw-pr-cvs1:/tmp/cvs-serv8841/dps/dps/writers

Modified Files:
	__init__.py 
Log Message:
progress

Index: __init__.py
===================================================================
RCS file: /cvsroot/docstring/dps/dps/writers/__init__.py,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** __init__.py	2002/02/06 02:56:21	1.1
--- __init__.py	2002/02/07 01:58:29	1.2
***************
*** 16,19 ****
--- 16,22 ----
  
  
+ import sys
+ 
+ 
  class Writer:
  
***************
*** 24,27 ****
--- 27,62 ----
      """
  
+     def write(self, document, destination):
+         self.document = document
+         self.destination = destination
+         self.transform()
+         self.record(self.document, self.destination)
+ 
+     def transform(self):
+         """Override to run document tree transforms."""
+         raise NotImplementedError('subclass must override this method')
+ 
+     def record(self, document, destination):
+         """Override to record `document` to `destination`."""
+         raise NotImplementedError('subclass must override this method')
+ 
+     def recordfile(self, output, destination):
+         """
+         Write `output` to a single file.
+ 
+         Parameters:
+         - `output`: Data to write.
+         - `destination`: one of:
+ 
+           (a) a file-like object, which is written directly;
+           (b) a path to a file, which is opened and then written; or
+           (c) `None`, which implies `sys.stdout`.
+         """
+         if hasattr(self.destination, 'write'):
+             destination.write(output)
+         elif self.destination:
+             open(self.destination, 'w').write(output)
+         else:
+             sys.stdout.write(output)
      pass