; E@c@sodZdZdkZdkZdkZdklZlZdkl Z l Z dkl Z l Z de fdYZ de fd YZd fd YZd fd YZde fdYZdefdYZdefdYZdefdYZdZdZdZde fdYZdZedZdZdZdZdS( s: Miscellaneous utilities for the documentation utilities. sreStructuredTextN(s StringTypes UnicodeType(sApplicationErrors DataError(sfrontendsnodess SystemMessagecBstZdZRS(NcCs#ti||i||_dS(N(s Exceptions__init__sselfssystem_messagesastextslevel(sselfssystem_messageslevel((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/utils.pys__init__s(s__name__s __module__s__init__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/utils.pys SystemMessagessSystemMessagePropagationcBstZRS(N(s__name__s __module__(((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/utils.pysSystemMessagePropagationssReportercBstZdZdiZeddddZeddZdZeZ dZ e Z d Z d Z d Zd Zd ZdZdZdZdZRS(s Info/warning/error reporter and ``system_message`` element generator. Five levels of system messages are defined, along with corresponding methods: `debug()`, `info()`, `warning()`, `error()`, and `severe()`. There is typically one Reporter object per process. A Reporter object is instantiated with thresholds for reporting (generating warnings) and halting processing (raising exceptions), a switch to turn debug output on or off, and an I/O stream for warnings. These are stored in the default reporting category, '' (zero-length string). Multiple reporting categories [#]_ may be set, each with its own reporting and halting thresholds, debugging switch, and warning stream (collectively a `ConditionSet`). Categories are hierarchical dotted-name strings that look like attribute references: 'spam', 'spam.eggs', 'neeeow.wum.ping'. The 'spam' category is the ancestor of 'spam.bacon.eggs'. Unset categories inherit stored conditions from their closest ancestor category that has been set. When a system message is generated, the stored conditions from its category (or ancestor if unset) are retrieved. The system message level is compared to the thresholds stored in the category, and a warning or error is generated as appropriate. Debug messages are produced iff the stored debug switch is on. Message output is sent to the stored warning stream if not set to ''. The default category is '' (empty string). By convention, Writers should retrieve reporting conditions from the 'writer' category (which, unless explicitly set, defaults to the conditions of the default category). The Reporter class also employs a modified form of the "Observer" pattern [GoF95]_ to track system messages generated. The `attach_observer` method should be called before parsing, with a bound method or function which accepts system messages. The observer can be removed with `detach_observer`, and another added in its place. .. [#] The concept of "categories" was inspired by the log4j project: http://jakarta.apache.org/log4j/. .. [GoF95] Gamma, Helm, Johnson, Vlissides. *Design Patterns: Elements of Reusable Object-Oriented Software*. Addison-Wesley, Reading, MA, USA, 1995. sDEBUG INFO WARNING ERROR SEVEREisasciisreplacecCs||_|tjo ti}nt|ttfjog|djoVt|tjot |d}qt|tjot |i d}qqn||_ ||_ hdt ||||<|_g|_d|_dS(s Initialize the `ConditionSet` forthe `Reporter`'s default category. :Parameters: - `source`: The path to or description of the source data. - `report_level`: The level at or above which warning output will be sent to `stream`. - `halt_level`: The level at or above which `SystemMessage` exceptions will be raised, halting execution. - `debug`: Show debug (level=0) system messages? - `stream`: Where warning output is sent. Can be file-like (has a ``.write`` method), a string (file name, opened for writing), '' (empty string, for discarding all stream messages) or `None` (implies `sys.stderr`; default). - `encoding`: The encoding for stderr output. - `error_handler`: The error handler for stderr output encoding. sswiN(ssourcesselfsstreamsNonessyssstderrstypes StringTypes UnicodeTypesopensencodesencodings error_handlers ConditionSetsdebugs report_levels halt_levels categoriess observerss max_level(sselfssources report_levels halt_levelsstreamsdebugsencodings error_handler((sC/mit/golem/arch/share/lib/python2.3/site-packages/docutils/utils.pys__init__Qs,    !    cCs:|tjo ti}nt|||||i |