[Docstring-checkins] CVS: dps/dps/transforms universal.py,1.3,1.4

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

Update of /cvsroot/docstring/dps/dps/transforms
In directory usw-pr-cvs1:/tmp/cvs-serv24264/dps/dps/transforms

Modified Files:
	universal.py 
Log Message:
  - Added "Pending" transforms.
  - API update.

Index: universal.py
===================================================================
RCS file: /cvsroot/docstring/dps/dps/transforms/universal.py,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** universal.py	11 Mar 2002 03:38:56 -0000	1.3
--- universal.py	16 Mar 2002 05:58:54 -0000	1.4
***************
*** 27,39 ****
      """
  
!     def transform(self, doctree):
!         self.setup_transform(doctree)
!         if len(doctree.messages) > 0:
              section = nodes.section(CLASS='system-messages')
              # @@@ get this from the language module?
              section += nodes.title('', 'Docutils System Messages')
!             section += doctree.messages.getchildren()
!             doctree.messages[:] = []
!             doctree += section
  
  
--- 27,38 ----
      """
  
!     def transform(self):
!         if len(self.doctree.messages) > 0:
              section = nodes.section(CLASS='system-messages')
              # @@@ get this from the language module?
              section += nodes.title('', 'Docutils System Messages')
!             section += self.doctree.messages.getchildren()
!             self.doctree.messages[:] = []
!             self.doctree += section
  
  
***************
*** 44,64 ****
      """
  
!     def transform(self, doctree):
!         self.setup_transform(doctree)
!         doctree += doctree.messages.getchildren()
  
  
  test_transforms = (TestMessages,)
! """Tuple of universal transforms to apply to the raw doctree when testing."""
  
! first_reader_transforms = ()
! """Tuple of universal transforms to apply before any other Reader transforms."""
  
! last_reader_transforms = (Messages,)
! """Tuple of universal transforms to apply after all other Reader transforms."""
  
! first_writer_transforms = ()
! """Tuple of universal transforms to apply before any other Writer transforms."""
  
! last_writer_transforms = ()
! """Tuple of universal transforms to apply after all other Writer transforms."""
--- 43,101 ----
      """
  
!     def transform(self):
!         self.doctree += self.doctree.messages.getchildren()
! 
! 
! class Pending(Transform):
! 
!     """
!     Execute pending transforms.
!     """
! 
!     stage = None
!     """The stage of processing applicable to this transform; match with
!     `nodes.pending.stage`.  Possible values include 'first_reader',
!     'last_reader', 'first_writer', and 'last_writer'.  Override in
!     subclasses."""
! 
!     def transform(self):
!         for pending in self.doctree.pending:
!             if pending.stage == self.stage:
!                 pending.transform(self.doctree, pending).transform()
! 
! 
! class FirstReaderPending(Pending):
! 
!     stage = 'first_reader'
! 
! 
! class LastReaderPending(Pending):
! 
!     stage = 'last_reader'
! 
! 
! class FirstWriterPending(Pending):
! 
!     stage = 'first_writer'
! 
! 
! class LastWriterPending(Pending):
! 
!     stage = 'last_writer'
! 
  
  
  test_transforms = (TestMessages,)
! """Universal transforms to apply to the raw doctree when testing."""
  
! first_reader_transforms = (FirstReaderPending,)
! """Universal transforms to apply before any other Reader transforms."""
  
! last_reader_transforms = (LastReaderPending, Messages)
! """Universal transforms to apply after all other Reader transforms."""
  
! first_writer_transforms = (FirstWriterPending,)
! """Universal transforms to apply before any other Writer transforms."""
  
! last_writer_transforms = (LastWriterPending,)
! """Universal transforms to apply after all other Writer transforms."""