; nAc@sdZdZdkZdkZdkZdkZdkZdkZdkZ dk Z dk Z dk Z dk l Z lZdZdZeedZeedZeedZeed Zeed Zeed Zeed Zed ZdZde i fdYZ de ifdYZde ie ifdYZde ifdYZdefdYZdS(s Command-line and common processing for Docutils front-end tools. Exports the following classes: * `OptionParser`: Standard Docutils command-line processing. * `Option`: Customized version of `optparse.Option`; validation support. * `Values`: Runtime settings; objects are simple structs (``object.attribute``). Supports cumulative list settings (attributes). * `ConfigParser`: Standard Docutils config file processing. Also exports the following functions: * Option callbacks: `store_multiple`, `read_config_file`. * Setting validators (see `OptionParser.validators`: `validate_encoding`, `validate_encoding_error_handler`, `validate_encoding_and_error_handler`, `validate_boolean`, `validate_threshold`, `validate_colon_separated_string_list`. * `make_paths_absolute`. sreStructuredTextN(sValuess SUPPRESS_HELPcOsXx!|D]}t|i|tqWx-|iD]\}}t|i||q1WdS(s Store multiple values in `parser.values`. (Option callback.) Store `None` for each attribute named in `args`, and store the value for each key (attribute name) in `kwargs`. N( sargss attributessetattrsparsersvaluessNoneskwargssitemsskeysvalue(soptionsoptsvaluesparsersargsskwargss attributeskey((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysstore_multiple+s cCsOy|i|}Wn"tj o}|i|nX|ii||dS(sQ Read a configuration file during option processing. (Option callback.) N(sparsersget_config_file_settingssvalues new_settingss ValueErrorserrorsvaluessupdate(soptionsoptsvaluesparsers new_settingsserror((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysread_config_file7s cCsXyti|Wn<tj o0td||fttidfnX|SdS(Ns$setting "%s": unknown encoding: "%s"i(scodecsslookupsvalues LookupErrorssettingsNonessyssexc_info(ssettingsvalues option_parsers config_parsersconfig_section((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysvalidate_encodingAs .cCsyti|Wntj oG|ddddfjo'td|ttidfqn7tj o*td|ttidfnX|SdS(Nsstrictsignoresreplacesxmlcharrefreplaceseunknown encoding error handler: "%s" (choices: "strict", "ignore", "replace", or "xmlcharrefreplace")isunknown encoding error handler: "%s" (choices: "strict", "ignore", "replace", "backslashreplace", "xmlcharrefreplace", and possibly others; see documentation for the Python ``codecs`` module)(scodecss lookup_errorsvaluesAttributeErrors LookupErrorsNonessyssexc_info(ssettingsvalues option_parsers config_parsersconfig_section((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysvalidate_encoding_error_handlerKs+(cCsd|jol|id\}}t|d|||||o|i ||d|qt |i |d|n|}t ||||||SdS(s Side-effect: if an error handler is included in the value, it is inserted into the appropriate place as if it was a separate setting/option. s:s_error_handlerN( svaluessplitsencodingshandlersvalidate_encoding_error_handlerssettings option_parsers config_parsersconfig_sectionssetssetattrsvaluessvalidate_encoding(ssettingsvalues option_parsers config_parsersconfig_sectionsencodingshandler((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pys#validate_encoding_and_error_handler^s     cCsst|tioXy|i|iiSWqktj o*t d|t t i dfqkXn|SdS(Nsunknown boolean value: "%s"i( s isinstancesvaluestypess StringTypes option_parsersbooleanssstripslowersKeyErrors LookupErrorsNonessyssexc_info(ssettingsvalues option_parsers config_parsersconfig_section((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysvalidate_booleants ,cCsyyt|SWndtj oXy|i|iSWquttfj o'td|t t i dfquXnXdS(Nsunknown threshold: %r.i( sintsvalues ValueErrors option_parsers thresholdsslowersKeyErrorsAttributeErrors LookupErrorsNonessyssexc_info(ssettingsvalues option_parsers config_parsersconfig_section((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysvalidate_threshold~scCsPt|tio|id}n#|i}|i|id|SdS(Ns:(s isinstancesvaluestypess StringTypessplitspopslastsextend(ssettingsvalues option_parsers config_parsersconfig_sectionslast((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pys$validate_colon_separated_string_lists  cCs4| odSn!|ido|Sn |dSdS(Ns./s/(svaluesendswith(ssettingsvalues option_parsers config_parsersconfig_section((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysvalidate_url_trailing_slashs cCs|tjoti}nx|D]}|i|oy||}t |t i o4gi }|D]}|t||qe~}n|ot||}n|||}tid||ii|fttidfnXt|||qn|SdS(sp Call the validator function on applicable settings. Extends `optparse.Option.process`. s Error in option "%s": %s: %siN(soptparsesOptionsprocesssselfsoptsvaluesvaluessparsersresultsdestssettingsgetattrs validatorssgets validators new_values ExceptionserrorsOptionValueErrors __class__s__name__sNonessyssexc_infossetattr( sselfsoptsvaluesvaluessparserssettingsresultserrors new_values validator((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysprocesss :(s__name__s __module__sprocess(((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysOptionss OptionParserc.BsrtZdZdddgZdiZhdd<dd<d d <d d <d d<d>e <d?d@dAf<d>e verbatim for a "View document source" link; implies --source-link.s --source-urlsmetavarss-Do not include a "View document source" link.s--no-source-linkscallbacks callback_argss source_links source_urlsYEnable backlinks from section headers to table of contents entries. This is the default.s--toc-entry-backlinkss toc_backlinkssentrysdefaultsJEnable backlinks from section headers to the top of the table of contents.s--toc-top-backlinksstops+Disable backlinks to the table of contents.s--no-toc-backlinkssXEnable backlinks from footnotes and citations to their references. This is the default.s--footnote-backlinkss/Disable backlinks from footnotes and citations.s--no-footnote-backlinkssfootnote_backlinkss"Disable Docutils section numberings--no-section-numberings sectnum_xformsSet verbosity threshold; report system messages at or higher than (by name or number: "info" or "1", warning/2, error/3, severe/4; also, "none" or "5"). Default is 2 (warning).s--reports-rschoicess report_levelssNReport all system messages, info-level and higher. (Same as "--report=info".)s --verboses-vs>Do not report any system messages. (Same as "--report=none".)s--quiets-qsSet the threshold () at or above which system messages are converted to exceptions, halting execution immediately by exiting (or propagating the exception if --traceback set). Levels as in --report. Default is 4 (severe).s--halts halt_levels@Same as "--halt=info": halt processing at the slightest problem.s--strictsEnable a non-zero exit status for normal exit if non-halting system messages (at or above ) were generated. Levels as in --report. Default is 5 (disabled). Exit status is the maximum system message level plus 10 (11 for INFO, etc.).s --exit-statussexit_status_levelsBReport debug-level system messages and generate diagnostic output.s--debugsHDo not report debug-level system messages or generate diagnostic output.s --no-debugsdebugs8Send the output of system messages (warnings) to .s --warningsswarning_streamssEnable Python tracebacks when halt-level system messages and other exceptions occur. Useful for debugging, and essential for issue reports.s --tracebacksaDisable Python tracebacks when errors occur; report just the error instead. This is the default.s--no-tracebacks tracebacksASpecify the encoding of input text. Default is locale-dependent.s--input-encodings-issSpecify the text encoding for output. Default is UTF-8. Optionally also specify the error handler for unencodable characters, after a colon (":"); default is "strict". (See "--output-encoding-error-encoding".)s--output-encodings-ossutf-8sSpecify the error handler for unencodable characters in the output. Acceptable values include "strict", "ignore", "replace", "xmlcharrefreplace", and "backslashreplace" (in Python 2.3+). Default is "strict". Usually specified as part of --output-encoding.s--output-encoding-error-handlersstrictsSpecify the text encoding for error output. Default is ASCII. Optionally also specify the error handler for unencodable characters, after a colon (":"); default is "%s". (See "--output-encoding-error-encoding".s--error-encodings-esasciisSpecify the error handler for unencodable characters in error output. See --output-encoding-error-handler for acceptable values. Default is "%s". Usually specified as part of --error-encoding.s--error-encoding-error-handlers]Specify the language of input text (ISO 639 2-letter identifier). Default is "en" (English).s --languages-ls language_codesens6Read configuration settings from , if it exists.s--configstypesstrings,Show this program's version number and exit.s --versions-Vsversions Show this help message and exit.s--helps-hshelps--dump-settingss--dump-internalss--dump-transformss--dump-pseudo-xmls--expose-internal-attributesappendsexpose_internalss_disable_configs_sources _destinationsgenerals%%prog (Docutils %s)c Osh|_h|_tii|dtdtdtidd|||i o|i |_ nt |i|_|ft||_|i|i|i|ph|o |id oIy|i}Wn"tj o}|i|nX|i|indS(s `components` is a list of Docutils components each containing a ``.settings_spec`` attribute. `defaults` is a mapping of setting default overrides. s option_classsadd_help_options formatterswidthiNs_disable_configN(sselfs validatorsslistssoptparses OptionParsers__init__sOptionsNonesTitledHelpFormattersargsskwargssversionsversion_templateslistsrelative_path_settingsstuples componentsspopulate_from_componentss set_defaultssdefaultssread_config_filessget_standard_config_settingssconfig_settingss ValueErrorserrors__dict__(sselfs componentssdefaultssread_config_filessargsskwargsserrorsconfig_settings((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pys__init__s&   cCsx}|D]u}|tjoqn|i}|ii|ix<tdt|dD]"}|||d!\}}}|o&t i|||}|i|n|}x|D]\} } } | i} | ido| d} | d=nt} |id| | | } | o| |i| i, section "Old-Format Configuration Files". cCst|titifjo |g}nxR|D]J}tii|||i do|i |n|i ||q3WdS(Nsoptions(stypes filenamesstypess StringTypes UnicodeTypesfilenamesCPs ConfigParsersreadsselfs has_sectionshandle_old_configsvalidate_settingss option_parser(sselfs filenamess option_parsersfilename((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysreadAs cCsti|it|d|id}|id o|i dnx|i D]\}}|i i|o9|i |\}}|i| o|i |qn d}|}|i|| o|i|||qWqWW|iddS(Nisoptionssgeneral(swarningss warn_explicitsselfs old_warningsConfigDeprecationWarningsfilenames get_sectionsoptionss has_sections add_sectionsitemsskeysvalues old_settingsshas_keyssectionssettings has_optionssetsremove_section(sselfsfilenamesvaluessettingskeyssectionsoptions((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pyshandle_old_configJs   c Csx|iD]}x|i|D]}|ii|}|o|i||dd}y"||||d|d|}WnPt j oD}t d|||ii|||fttidfnX|i|||q#q#Wq WdS(s7Call the validator function on all applicable settings.srawis config_parsersconfig_sectionsEError in config file "%s", section "[%s]": %s: %s %s = %siN(sselfssectionsssectionsoptionsssettings option_parsers validatorssgets validatorsvalues new_values Exceptionserrors ValueErrorsfilenames __class__s__name__sNonessyssexc_infosset( sselfsfilenames option_parserssectionserrorsvaluessettings new_values validator((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pysvalidate_settings\s  @cCs|iiddSdS(sW Transform '-' to '_' so the cmdline form of option names can be used. s-s_N(s optionstrslowersreplace(sselfs optionstr((sF/mit/golem/arch/share/lib/python2.3/site-packages/docutils/frontend.pys optionxformoscCsXh}|i|o:x7|i|D]"}|i||dd||