buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/__init__.py
changeset 179 d8ac696cc51f
parent 1 be27ed110b50
child 180 e02a83d4c571
child 592 3215c239276a
--- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/__init__.py	Wed Oct 28 14:39:48 2009 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,107 +0,0 @@
-# $Id: __init__.py 4974 2007-03-01 18:06:52Z wiemann $
-# Authors: David Goodger <goodger@python.org>; Ueli Schlaepfer
-# Copyright: This module has been placed in the public domain.
-
-"""
-This package contains Docutils Reader modules.
-"""
-
-__docformat__ = 'reStructuredText'
-
-
-from docutils import utils, parsers, Component
-from docutils.transforms import universal
-
-
-class Reader(Component):
-
-    """
-    Abstract base class for docutils Readers.
-
-    Each reader module or package must export a subclass also called 'Reader'.
-
-    The two steps of a Reader's responsibility are `scan()` and
-    `parse()`.  Call `read()` to process a document.
-    """
-
-    component_type = 'reader'
-    config_section = 'readers'
-
-    def get_transforms(self):
-        return Component.get_transforms(self) + [
-            universal.Decorations,
-            universal.ExposeInternals,
-            universal.StripComments,]
-
-    def __init__(self, parser=None, parser_name=None):
-        """
-        Initialize the Reader instance.
-
-        Several instance attributes are defined with dummy initial values.
-        Subclasses may use these attributes as they wish.
-        """
-
-        self.parser = parser
-        """A `parsers.Parser` instance shared by all doctrees.  May be left
-        unspecified if the document source determines the parser."""
-
-        if parser is None and parser_name:
-            self.set_parser(parser_name)
-
-        self.source = None
-        """`docutils.io` IO object, source of input data."""
-
-        self.input = None
-        """Raw text input; either a single string or, for more complex cases,
-        a collection of strings."""
-
-    def set_parser(self, parser_name):
-        """Set `self.parser` by name."""
-        parser_class = parsers.get_parser_class(parser_name)
-        self.parser = parser_class()
-
-    def read(self, source, parser, settings):
-        self.source = source
-        if not self.parser:
-            self.parser = parser
-        self.settings = settings
-        self.input = self.source.read()
-        self.parse()
-        return self.document
-
-    def parse(self):
-        """Parse `self.input` into a document tree."""
-        self.document = document = self.new_document()
-        self.parser.parse(self.input, document)
-        document.current_source = document.current_line = None
-
-    def new_document(self):
-        """Create and return a new empty document tree (root node)."""
-        document = utils.new_document(self.source.source_path, self.settings)
-        return document
-
-
-class ReReader(Reader):
-
-    """
-    A reader which rereads an existing document tree (e.g. a
-    deserializer).
-
-    Often used in conjunction with `writers.UnfilteredWriter`.
-    """
-
-    def get_transforms(self):
-        # Do not add any transforms.  They have already been applied
-        # by the reader which originally created the document.
-        return Component.get_transforms(self)
-
-
-_reader_aliases = {}
-
-def get_reader_class(reader_name):
-    """Return the Reader class from the `reader_name` module."""
-    reader_name = reader_name.lower()
-    if _reader_aliases.has_key(reader_name):
-        reader_name = _reader_aliases[reader_name]
-    module = __import__(reader_name, globals(), locals())
-    return module.Reader