m 8Oc@sdZdZdkZdkZdkZdkZdkZdkZdk Z dk l Z dk Z dk Z dk Z dklZlZlZdZdZeedZeedZeed Zeed Zeed Zeed Zeed ZeedZeedZeedZedZdZ dZ!de i"fdYZ"de i#fdYZ#de i$e i%fdYZ$dei&fdYZde'fdYZ(dS(sC 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: `validate_encoding`, `validate_encoding_error_handler`, `validate_encoding_and_error_handler`, `validate_boolean`, `validate_threshold`, `validate_colon_separated_string_list`, `validate_dependency_file`. * `make_paths_absolute`. * SettingSpec manipulation: `filter_settings_spec`. treStructuredTextN(s SUPPRESS_HELP(slocale_encodings ErrorOutputs ErrorStringcOsXx!|D]}t|i|dqWx-|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( targst attributetsetattrtparsertvaluestNonetkwargstitemstkeytvalue(toptiontoptR RRRRR ((tk/home/project-web/docutils/web-update/infrastructure/update-dir/aux/snapshots/docutils/docutils/frontend.pytstore_multiple,s cCsOy|i|}Wn"tj o}|i|nX|ii||dS(sQ Read a configuration file during option processing. (Option callback.) N(Rtget_config_file_settingsR t new_settingst ValueErrorterrorRtupdate(R R R RRR((R tread_config_file8s cCsTyti|Wn<tj o0td||fdtidfnX|S(Ns$setting "%s": unknown encoding: "%s"i(tcodecstlookupR t LookupErrortsettingRtsystexc_info(RR t option_parsert config_parsertconfig_section((R tvalidate_encodingBs .cCsNyti|Wn6tj o*td|dtidfnX|S(Nsunknown encoding error handler: "%s" (choices: "strict", "ignore", "replace", "backslashreplace", "xmlcharrefreplace", and possibly others; see documentation for the Python ``codecs`` module)i(Rt lookup_errorR RRRR(RR RRR((R tvalidate_encoding_error_handlerLs (cCsd|jol|id\}}t|d|||||o|i ||d|qt |i |d|n|}t ||||||S(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. t:t_error_handlerN( R tsplittencodingthandlerR RRRRtsetRRR(RR RRRR$R%((R t#validate_encoding_and_error_handlerYs     cCslt|toXy|i|iiSWqhtj o*td|dt i dfqhXn|S(Nsunknown boolean value: "%s"i( t isinstanceR tunicodeRtbooleanststriptlowertKeyErrorRRRR(RR RRR((R tvalidate_booleanos ,cCs-t|}|djotdn|S(Nis(negative value; must be positive or zero(tintR R(RR RRR((R tvalidate_nonnegative_intys  cCsyyt|SWndtj oXy|i|iSWquttfj o'td|dt i dfquXnXdS(Nsunknown threshold: %r.i( R/R RRt thresholdsR,R-tAttributeErrorRRRR(RR RRR((R tvalidate_thresholdscCsIt|to|id}n#|i}|i|id|S(NR!(R(R R)R#tpoptlasttextend(RR RRRR5((R t$validate_colon_separated_string_lists  cCs3|pdSn!|ido|Sn |dSdS(Ns./t/(R tendswith(RR RRR((R tvalidate_url_trailing_slashs cCs>ytii|SWn#tj otiidSnXdS(N(tdocutilstutilstDependencyListR tIOErrorR(RR RRR((R tvalidate_dependency_filesc Cst|to |g}ntdg}|iidD]}||i q=~}xG|D]?}t i i|} || jotd|| fqcqcW|i||S(Nt,s$invalid class value %r (perhaps %r?)(R(R R)tfilterRt_[1]R4R#tvR+t class_valuest class_valueR;tnodestmake_idt normalizedRR6( RR RRRRBRERDRCRH((R tvalidate_strip_classs ?  cCs|djoti}nx|D]}||jop||}t|t o.g}|D]}|t ||q\~}n|ot ||}n|||d?ghd"d@<d@e<dAdBdCf for a source link; implies --source-link.s --source-urltmetavarss-Do not include a "View document source" link.s--no-source-linktcallbackt callback_argst source_linkt source_urls4Link from section headers to TOC entries. (default)s--toc-entry-backlinkst toc_backlinkstentrytdefaults0Link from section headers to the top of the TOC.s--toc-top-backlinksttops+Disable backlinks to the table of contents.s--no-toc-backlinkss6Link from footnotes/citations to references. (default)s--footnote-backlinkss/Disable backlinks from footnotes and citations.s--no-footnote-backlinkstfootnote_backlinkss0Enable section numbering by Docutils. (default)s--section-numberingt sectnum_xforms&Disable section numbering by Docutils.s--no-section-numberings/Remove comment elements from the document tree.s--strip-commentss6Leave comment elements in the document tree. (default)s--leave-commentststrip_commentssRemove all elements with classes="" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)s--strip-elements-with-classRctstrip_elements_with_classesssRemove all classes="" attributes from elements in the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)s --strip-classt strip_classessReport system messages at or higher than : "info" or "1", "warning"/"2" (default), "error"/"3", "severe"/"4", "none"/"5"s--reports-rtchoicest report_levelss4Report all system messages. (Same as "--report=1".)s --verboses-vs3Report no system messages. (Same as "--report=5".)s--quiets-qsdHalt execution at system messages at or above . Levels as in --report. Default: 4 (severe).s--haltt halt_levels6Halt at the slightest problem. Same as "--halt=info".s--strictsjEnable a non-zero exit status for non-halting system messages at or above . Default: 5 (disabled).s --exit-statustexit_status_levels3Enable debug-level system messages and diagnostics.s--debugs Disable debug output. (default)s --no-debugtdebugs-Send the output of system messages to .s --warningstwarning_streamss1Enable Python tracebacks when Docutils is halted.s --tracebacks%Disable Python tracebacks. (default)s--no-tracebackt tracebacksiSpecify the encoding and optionally the error handler of input text. Default: :strict.s--input-encodings-isslSpecify the error handler for undecodable characters. Choices: "strict" (default), "ignore", and "replace".s--input-encoding-error-handlertstricts^Specify the text encoding and optionally the error handler for output. Default: UTF-8:strict.s--output-encodings-osutf-8sSpecify error handler for unencodable output characters; "strict" (default), "ignore", "replace", "xmlcharrefreplace", "backslashreplace".s--output-encoding-error-handlersJSpecify text encoding and error handler for error output. Default: %s:%s.s--error-encodings-esSSpecify the error handler for unencodable characters in error output. Default: %s.s--error-encoding-error-handlers<Specify the language (as BCP 47 language tag). Default: en.s --languages-lt language_codetenss)Write output file dependencies to .s--record-dependenciess6Read configuration settings from , if it exists.s--configttypetstrings,Show this program's version number and exit.s --versions-Vtversions Show this help message and exit.s--helps-hthelps --id-prefixs--auto-id-prefixtids--dump-settingss--dump-internalss--dump-transformss--dump-pseudo-xmls--expose-internal-attributetexpose_internalss--strict-visitort_disable_configt_sourcet _destinationt _config_filestgenerals+%%prog (Docutils %s [%s], Python %s, on %s)c Osh|_g|_tii|dtdddtidd|||i p|i |_ nt |i|_|ft||_|i|i|i|ph|oX|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. t option_classtadd_help_optiont formattertwidthiNRN(RjRot config_filesRhRRiRwRtTitledHelpFormatterRRRtversion_templateROtrelative_path_settingsRdt componentstpopulate_from_componentstset_defaults_from_dictRrtread_config_filestget_standard_config_settingstconfig_settingsRRRm(RjRRrRRRRR((R Ris&   c Cskx+|D]#}|djoqn|i}|ii|ixtdt|dD]}|||d!\}}}|o&t i|||}|i|n|}xY|D]Q\} } } |id| | | } | iddjod|i| iMs(RKtenvironR#tpathsepRR-Rjtstandard_config_filesRPt expandusertexpandtpwdt ImportErrorRBtfR+(RjRRRBRR((R tget_standard_config_files<s  cCs=t}x-|iD]}|i|i||qW|S(N(RfRXRjRtfilenameRR(RjRRX((R RPs   cCst}|i|||ii|iti i |}h}t }x|iD]v}|pqWnx_t|ipf|ifD]=}||joqnd||<|i|i||qWqWWt|i|i||iS(sAReturns a dictionary containing appropriate config file settings.iN(t ConfigParserRtreadt config_fileRjRR6t_filesRKRPtdirnameRJtappliedRfRXRRRdtconfig_section_dependenciesRtsectionRt get_sectionRRRmR(RjRRRXRRRJR((R RVs&   !  !cCs>|i|\|_|_t|i|i|i |_ |S(s/Store positional arguments as runtime settings.N( Rjt check_argsRRRRRRRmRRR(RjRR((R t check_valuesks  cCsd}}|o*|id}|djo d}q;n|o*|id}|djo d}qln|o|idn|o||jo|idn||fS(NiRUsMaximum 2 arguments allowed.s_Do not specify the same file for both source and destination. It will clobber the source file.(Rtsourcet destinationRR4RjR(RjRRR((R Rrs   cCs|ii|dS(N(RjRrR(RjRr((R RscCst|i}|i|_|S(s(Needed to get custom `Values` instances.N(RfRjRrRR(RjRr((R tget_default_valuess cCs[xD|i|gD]2}x)|iD]}|i|jo|Sq!q!WqWtd|dS(s Get an option by its dest. If you're supplying a dest which is shared by several options, it is undefined which option of those is returned. A KeyError is raised if there is no option with the supplied dest. sNo option with dest == %r.N(Rjt option_groupsRt option_listR R|R-(RjR|RR ((R tget_option_by_dests  (-RtRuRvRR#tthreshold_choicesR1R*RpRtstderrRtlocale_encodingtdefault_error_encodingt$default_error_encoding_error_handlerR.RRIR3R'R R?Rt SUPPRESS_HELPR7RWRRRR;t __version__t__version_details__RtplatformRRiRRRRRRRRR(((R R#sJ  3W * ,        RcBsktZhdd<dd<dd, section "Old-Format Configuration Files". shUnable to read configuration file "%s": content not encoded as UTF-8. Skipping "%s" configuration file. cOs/tii|||g|_t|_dS(N( tCPtRawConfigParserRiRjRRRt ErrorOutputt_stderr(RjRR((R Ris cCs<t|ttfjo |g}nx|D]}yti|dd}Wntj o q-nXyDt i djot i i |||nt i i|||Wn=tj o1|ii|i||f|iq-nX|i|ii||ido|i|n|i||q-WdS(Ntrsutf-8iitoptions(ii(Rt filenameststrR)RRtopentfpR>Rt version_infoRRtreadfpRjt read_filetUnicodeDecodeErrorRtwritetnot_utf8_errortcloseRRct has_sectionthandle_old_configtvalidate_settingsR(RjR RRR((R Rs*   cCsti|it|d|id}|idp|i dnx|i D]\}}||i jo8|i |\}}|i|p|i |qn d}|}|i||p|i|||qVqVW|iddS(NiR R(twarningst warn_explicitRjt old_warningtConfigDeprecationWarningRRR Rt add_sectionRR R t old_settingsRRt has_optionR&tremove_section(RjRR RR RR ((R Rs   c Cs-x&|iD]}x|i|D]}y|i|}Wntj o q#nX|i o|i ||}y%|i |||d|d|}WnMt j oA}td||t|||fdtidfnX|i|||n|io|i||idq#q#Wq WdS(si Call the validator function and implement overrides on all applicable settings. RRsAError in config file "%s", section "[%s]": %s %s = %siN(RjtsectionsRR RRRR R-RxRR R}R~RRRRRRRR&Ry( RjRRR RRR RR}((R Rs&  = cCs|iiddS(sW Transform '-' to '_' so the cmdline form of option names can be used. RURVN(t optionstrR,R`(RjR"((R t optionxformscCsNh}|i|o4x1|i|D]}|i||||