ifBdZdZddlZddlZddlZddlmZddlZddlZddlZddl Z ddl Z ddl m Z m Z dZ dZ d#dZ d#d Z d#d Z d#d Z d#d Z d#d Z d#dZ d#dZ d#dZ d#dZ d#dZ d#dZ d#dZd$dZdZdZGddejZGddej Z Gddej!e j"Z!Gddej#Z$Gd d!e%Z&d"Z'dS)%a  Command-line and common processing for Docutils front-end tools. This module is provisional. Major changes will happen with the switch from the deprecated "optparse" module to "arparse". Applications should use the high-level API provided by `docutils.core`. See https://docutils.sourceforge.io/docs/api/runtime-settings.html. Exports the following classes: * `OptionParser`: Standard Docutils command-line processing. Deprecated. Will be replaced by an ArgumentParser. * `Option`: Customized version of `optparse.Option`; validation support. Deprecated. Will be removed. * `Values`: Runtime settings; objects are simple structs (``object.attribute``). Supports cumulative list settings (attributes). Deprecated. Will be removed. * `ConfigParser`: Standard Docutils config file processing. Provisional. Details will change. Also exports the following functions: Interface function: `get_default_settings()`. New in 0.19. Option callbacks: `store_multiple()`, `read_config_file()`. Deprecated. Setting validators: `validate_encoding()`, `validate_encoding_error_handler()`, `validate_encoding_and_error_handler()`, `validate_boolean()`, `validate_ternary()`, `validate_nonnegative_int()`, `validate_threshold()`, `validate_colon_separated_string_list()`, `validate_comma_separated_list()`, `validate_url_trailing_slash()`, `validate_dependency_file()`, `validate_strip_class()` `validate_smartquotes_locales()`. Provisional. Misc: `make_paths_absolute()`, `filter_settings_spec()`. Provisional. reStructuredTextN) SUPPRESS_HELP)ioutilsc|D]}t|j|d|D]\}}t|j||dS)z 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)setattrvaluesitems)optionoptvalueparserargskwargs attributekeys q/builddir/build/BUILD/imunify360-venv-2.3.5/opt/imunify360/venv/lib/python3.11/site-packages/docutils/frontend.pystore_multiplerEsf00  y$////llnn++ U sE****++c ||}n,#t$r}||Yd}~nd}~wwxYw|j||dS)zQ Read a configuration file during option processing. (Option callback.) N)get_config_file_settings ValueErrorerrorr update)r r r r new_settingserrs rread_config_filerRsz66u==  S Mv.....s A<Ac|dkrdS tj|n$#t$rtd|d|dwxYw|S)Nz setting "z": unknown encoding: "")codecslookup LookupErrorsettingr option_parser config_parserconfig_sections rvalidate_encodingr)]sp {{t. e ...k$WWeee-.. .. Ls !Acr tj|n #t$rtd|zwxYw|S)Nzunknown encoding error handler: "%s" (choices: "strict", "ignore", "replace", "backslashreplace", "xmlcharrefreplace", and possibly others; see documentation for the Python ``codecs`` module))r! lookup_errorr#r$s rvalidate_encoding_error_handlerr,is^5E"""" 555 ,/4 455 55 Ls4cd|vre|d\}}t|dz|||||r|||dz|nt|j|dz|n|}t ||||||S)z 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. :_error_handler)splitr,setrr r))r%r r&r'r(encodinghandlers r#validate_encoding_and_error_handlerr4vs  e||!KK,,'' & & > + + +  O   ng8H.H% ' ' ' ' M('4D*Dg N N N Ngx#^555 Orct|tr|S |j|S#t $rt d|zwxYw)z|Check/normalize boolean settings: True: '1', 'on', 'yes', 'true' False: '0', 'off', 'no','false', '' zunknown boolean value: "%s") isinstanceboolbooleansstriplowerKeyErrorr#r$s rvalidate_booleanr<sv % A%ekkmm&9&9&;&;<< AAA7%?@@@As 0A A'ct|ts||S |j|S#t $r|cYSwxYw)zCheck/normalize three-value settings: True: '1', 'on', 'yes', 'true' False: '0', 'off', 'no','false', '' any other value: returned as-is. )r6r7r8r9r:r;r$s rvalidate_ternaryr>sj%%- %ekkmm&9&9&;&;<<  s0A AAcNt|}|dkrtd|S)Nrz(negative value; must be positive or zero)intrr$s rvalidate_nonnegative_intrAs* JJE qyyCDDD Lrc t|S#t$rJ |j|cYS#tt f$rt d|zwxYwwxYw)Nzunknown threshold: %r.)r@r thresholdsr:r;AttributeErrorr#r$s rvalidate_thresholdrEs@5zz @@@ @ +EKKMM: : : :.) @ @ @6>?? ? @@s A%=A%$A!!A%ct|ts|d}n<|}||d|S)Nr.)r6listr0popextend)r%r r&r'r(lasts r$validate_colon_separated_string_listrKsU eT " "& C  yy{{ TZZ__%%% Lrct|ts|g}|}d|dD}|||S)zHCheck/normalize list arguments (split at "," and strip whitespace). cbg|],}|d|d-S)z )r9).0is r z1validate_comma_separated_list..s5 K K K!!''':J:J KQWWW   K K Kr,)r6rGrHr0rI)r%r r&r'r(rJr s rvalidate_comma_separated_listrRs` eT " " 99;;D K Ktzz# K K KE LL LrcB|sdS|dr|S|dzS)Nz.//)endswithr$s rvalidate_url_trailing_slashrVs2 t    s{rct tj|S#t$rtjdcYSwxYwN)rDependencyListOSErrorr$s rvalidate_dependency_filer[sJ*#E*** ***#D)))))*s 77ct|||||}|D]=}tj|}||krt d|d|d>|S)NzInvalid class value z (perhaps z?))rRdocutilsnodesmake_idr)r%r r&r'r(cls normalizeds rvalidate_strip_classrbs *'5-*7 I IE22^++C00 *  * #ZZZ122 2  Lrc :t|||||}g}|D]} |dd\}}nT#t$r||Y?t$r't d|ddzwxYw|}|d} t| dkr| }n9t|dkr&t d|ddz|||f|S)z~Check/normalize a comma separated list of smart quote definitions. Return a list of (language-tag, quotes) string tuples.r.z4Invalid value "%s". Format is ":".asciibackslashreplacez[Invalid value "%s". Please specify 4 quotes (primary open/close; secondary open/close).)rRr0rDappendrencoder9len) r%r r&r'r( lc_quotesitemlangquotesmultichar_quotess rvalidate_smartquotes_localesrpsw *'5-*7 I IEI)) I::c1--LD&&      T " " " H I I IA#{{74FGGHII I I !<<,,  A % %%FF [[A  O#{{74FGGHII I $(((( s6B0Bctj|D]I}||vrC||}t|trfd|D}n|rt |}|||<JdS)z Interpret filesystem path settings relative to the `base_path` given. Paths are values in `pathdict` whose keys are in `keys`. Get `keys` from `OptionParser.relative_path_settings`. Nc0g|]}t|S)make_one_path_absolute)rNpath base_paths rrPz'make_paths_absolute..)s3,,,!0 4@@,,,r)osgetcwdr6rGrt)pathdictkeysrvrr s ` rmake_paths_absoluter{sIKK "" (??SME%&& A,,,,%*,,, A.y%@@!HSM""rc|tjtj||SrX)rwruabspathjoin)rvrus rrtrt0s& 7??27<< 488 9 99rct|}tdt|dD]}g}||D]f}d|dDd}||vr||vr|||Q||gt |||<t |S)ajReturn a copy of `settings_spec` excluding/replacing some settings. `settings_spec` is a tuple of configuration settings (cf. `docutils.SettingsSpec.settings_spec`). Optional positional arguments are names of to-be-excluded settings. Keyword arguments are option specification replacements. (See the html4strict writer for an example.) ctg|]5}|d|dddd6S)z--rN-_) startswithreplace)rN opt_strings rrPz(filter_settings_spec..DsS888&%00668 122..sC88888rrdr)rGrangerjrzrhtuple) settings_specexcludersettingsrOnewoptsopt_specopt_names rfilter_settings_specr4sM""H 1c(mmQ ' ' % %  ) )H88*21+88889;H7""7<<>>))wx01111x((((Gnn ??rc4eZdZdZfdZdZdZdZxZS)ValueszStorage for option values. Updates list attributes by extension rather than by replacement. Works in conjunction with the `OptionParser.lists` instance attribute. Deprecated. Will be removed. ctjdtdtj|i|t |ddt j|_dSdS)Nz@frontend.Values class will be removed in Docutils 0.21 or later.r stacklevelrecord_dependencies) warningswarnDeprecationWarningsuper__init__getattrrrYrselfrr __class__s rrzValues.__init__Zsv 3(Q 8 8 8 8 $)&))) 4. 5 5 =',';'='=D $ $ $ > =rc&t|tr|j}t|}|jD]6}t ||r$||vr t||}|r|||z }||=7||dSrX) r6r__dict__dictlistsrzhasattrr _update_loose)r other_dictr&r%r s rrz Values.updatecs j& ) ) -#,J*%% $*//11 , ,GtW%% ,'Z*?*?g..,Z00E"7+ :&&&&&rctj5tjdt||jcdddS#1swxYwYdS)z Return a shallow copy of `self`.ignorecategory)defaultsN)rcatch_warningsfilterwarningsrrr)rs rcopyz Values.copyos  $ & & : :  #H7I J J J J>>4=>99 : : : : : : : : : : : : : : : : : :s6AAAcft||dt|||t||S)znReturn ``self.name`` or ``default``. If ``self.name`` is unset, set ``self.name = default``. N)rr)rnamedefaults r setdefaultzValues.setdefaultus8 4t $ $ , D$ ( ( (tT"""r) __name__ __module__ __qualname____doc__rrrr __classcell__rs@rrrQso>>>>> ' ' '::: #######rrcNeZdZdZejjddgzZfdZfdZxZ S)Optionz`Add validation and override support to `optparse.Option`. Deprecated. Will be removed. validator overridescrtjdtdtj|i|dS)NzDThe frontend.Option class will be removed in Docutils 0.21 or later.rr)rrrrrrs rrzOption.__init__sJ 3(Q 8 8 8 8 $)&)))))rc t||||}|j}|r|jrxt ||} ||||}n>#t $r1}t jd|dtj |d}~wwxYwt||||j rt||j d|S)z Call the validator function on applicable settings and evaluate the 'overrides' option. Extends `optparse.Option.process`. zError in option "z": N) rprocessdestrr ExceptionoptparseOptionValueErrorr error_stringrr) rr r r rresultr% new_valuerrs rrzOption.processs eVV<<)  6~ 4007 $wv F FII 777"3333 4 4 467777333~ 6555 sA B),BB) rrrrrrATTRSrrrrs@rrrsq O ![+$> >E***** rrc eZdZdZgdZ dZ dddddd Z d d d d d d d d d d Z e e j d dpe j pdZdZddgddgddifddgddifdddgdedfddgd d!d"fd#d$d%gd&d'd(d)fd*d+d,gd&d-d(d)fd.d/gd&dd(d)fd0d1d2gdedfd3d4gdd5ifd6d7gd8ed9d:fd;dd>d?fd@dAgd=d&dBdCfdDdEgd=d dFfdGdHgddedIfdJdKgdLd dFfdMdNgddOdedPfdQdRgd dOd"fdSdTgdedfdUdVgd dWd"fdXdYgdZd[d\ed]fd^d_gdZd`d\ed]fdadbdcgeddddeedffdgdhdigd&dddd)fdjdkdlgd&dddd)fdmdngedoddeedpfdqdrgd&ddod)fdsdtgeduddeedpfdvdwgdedfdxdygd dzd"fd{d|gd}d~dfddgddedIfddgdd dFfdddgdedfddgdedfdddgddedfddgdedfdededddgdeedfdezdgeedfdddgddddfddgd~eddfddgd~dd8edfdddgddifdddgddifedgddifedgddifedgddifedgddifedgddifedgddifedgdZdedfedgddifRfZ dddddZ dZdejejr dejzpdde j dde j!dǝZ" dӈfdɄ Z#dʄZ$e%d˄Z&d̄Z'd̈́Z(d΄Z)dτZ*dЄZ+dфZ,d҄Z-xZ.S) OptionParsera Settings parser for command-line and library use. The `settings_spec` specification here and in other Docutils components are merged to build the set of command-line options and runtime settings for this process. Common settings (defined below) and component-specific settings must not conflict. Short options are reserved for common settings, and components are restricted to using long options. Deprecated. Will be replaced by a subclass of `argparse.ArgumentParser`. )z/etc/docutils.confz./docutils.confz ~/.docutilsz(info 1 warning 2 error 3 severe 4 none 5rdrrrg)infowarningrseverenoneTF) 1onyestrue0offnofalserr2NrerfzGeneral Docutils OptionszaOutput destination name. Obsoletes the positional argument. Default: None (stdout).z--outputmetavarz z'Specify the document title as metadata.z--titlezz2Include a "Generated by Docutils" credit and link.z --generatorz-g store_true)actionr���z"Do not include a generator credit.z--no-generator store_false generator)r���r���z2Include the date at the end of the document (UTC).z--datez-d store_constz%Y-%m-%d datestamp)r���constr���zInclude the time & date (UTC).z--timez-tz%Y-%m-%d %H:%M UTCz'Do not include a datestamp of any kind.z--no-datestampz&Include a "View document source" link.z --source-linkz-sz3Use <URL> for a source link; implies --source-link.z --source-urlz<URL>z-Do not include a "View document source" link.z--no-source-linkcallback) source_link source_url)r���r��� callback_argsz4Link from section headers to TOC entries. (default)z--toc-entry-backlinks toc_backlinksentry)r���r���r���r���z0Link from section headers to the top of the TOC.z--toc-top-backlinkstop)r���r���r���z+Disable backlinks to the table of contents.z--no-toc-backlinks)r���r���z6Link from footnotes/citations to references. (default)z--footnote-backlinks)r���r���r���z/Disable backlinks from footnotes and citations.z--no-footnote-backlinksfootnote_backlinksz0Enable section numbering by Docutils. (default)z--section-numbering sectnum_xform)r���r���r���r���z&Disable section numbering by Docutils.z--no-section-numberingz/Remove comment elements from the document tree.z--strip-commentsz6Leave comment elements in the document tree. (default)z--leave-commentsstrip_commentszRemove all elements with classes="<class>" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)z--strip-elements-with-classrh���strip_elements_with_classesz<class>)r���r���r���r���zRemove all classes="<class>" attributes from elements in the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)z --strip-class strip_classeszReport system messages at or higher than <level>: "info" or "1", "warning"/"2" (default), "error"/"3", "severe"/"4", "none"/"5"z--reportz-r report_levelz<level>)choicesr���r���r���r���z4Report all system messages. (Same as "--report=1".)z --verbosez-vz3Report no system messages. (Same as "--report=5".)z--quietz-qzdHalt execution at system messages at or above <level>. Levels as in --report. Default: 4 (severe).z--halt halt_level)r���r���r���r���r���z6Halt at the slightest problem. Same as "--halt=info".z--strictzjEnable a non-zero exit status for non-halting system messages at or above <level>. Default: 5 (disabled).z --exit-statusexit_status_levelz3Enable debug-level system messages and diagnostics.z--debugz Disable debug output. (default)z --no-debugdebugz-Send the output of system messages to <file>.z --warningswarning_streamz<file>)r���r���z1Enable Python tracebacks when Docutils is halted.z --tracebackz%Disable Python tracebacks. (default)z--no-traceback tracebackzdSpecify the encoding and optionally the error handler of input text. Default: <auto-detect>:strict.z--input-encodingz-iz<name[:handler]>)r���r���zlSpecify the error handler for undecodable characters. Choices: "strict" (default), "ignore", and "replace".z--input-encoding-error-handlerstrict)r���r���z^Specify the text encoding and optionally the error handler for output. Default: utf-8:strict.z--output-encodingz-outf-8)r���r���r���zSpecify error handler for unencodable output characters; "strict" (default), "ignore", "replace", "xmlcharrefreplace", "backslashreplace".z--output-encoding-error-handlerzOSpecify text encoding and optionally error handler for error output. Default: r.���.z--error-encodingz-ezSSpecify the error handler for unencodable characters in error output. Default: %s.z--error-encoding-error-handlerz<Specify the language (as BCP 47 language tag). Default: en.z --languagez-l language_codeenz<name>)r���r���r���z)Write output file dependencies to <file>.z--record-dependencies)r���r���r���z6Read configuration settings from <file>, if it exists.z--configstring)r���typer���r���z,Show this program's version number and exit.z --versionz-Vr���versionz Show this help message and exit.z--helpz-hhelpz --id-prefixr���r���z--auto-id-prefix%z--dump-settingsz--dump-internalsz--dump-transformsz--dump-pseudo-xmlz--expose-internal-attributeexpose_internals)r���r���r���z--strict-visitor)_disable_config_source _destination _config_filesgeneralz%prog (Docutils z [%s]z , Python r���z, on )rs���c�����������������j���i�|�_��������� �g�|�_�������� �dg|�_��������t����������j��������dt ����������d������������t ����������������������j��������|t����������dt����������j ��������d����������d|�|�j ��������s |�j ��������|�_ ��������|�g|R�|�_ ��������|���������������������|�j �������������������|�j����������������������������|pi������������|rp|�j��������d ���������se �|���������������������������������}n,#�t$����������$�r}|���������������������|�����������Y�d}~nd}~ww�xY�w|�j����������������������������|j�������������������dS�dS�dS�) zSet up OptionParser instance. `components` is a list of Docutils components each containing a ``.settings_spec`` attribute. `defaults` is a mapping of setting default overrides. r���ztThe frontend.OptionParser class will be replaced by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.r���r���NN���)width) option_classadd_help_option formatterr���)r��� config_filesrelative_path_settingsr���r���r���r���r���r���r���TitledHelpFormatterr���version_template componentspopulate_from_componentsr���r���get_standard_config_settingsr���r���r���) r���r ��r���read_config_filesr���r���config_settingsr���r���s ��� r���r���zOptionParser.__init__��s���� (;'7&8# �3�)Q 8� 8� 8� 8� �'-d#+#?b#I#I#I *� *"( *� *� *�|� 10DL-*-- %%do666 X^,,, � ;T]3D%E� ; "&"C"C"E"E� � �  3 M !9 : : : : :  ;� ;� ;� ;s���C$�$ D .DD c�����������������L���|D�]}||j���������}|�j����������������������������|j�������������������t����������dt ����������|����������d����������D�]}|||dz������������\��}}}|r,t ����������j��������|�||����������}|���������������������|�����������n|�}|D�]=\��} } } �|j��������| d| i| } | ��������������������d����������dk����rd|�j ��������| j ��������<���>|j ��������r|�j ����������������������������|j �������������������|D�]*}|r&|j��������r|�j ����������������������������|j�������������������+dS�)ao��Collect settings specification from components. For each component, populate from the `SettingsSpec.settings_spec` structure, then from the `SettingsSpec.settings_defaults` dictionary. After all components have been processed, check for and populate from each component's `SettingsSpec.settings_default_overrides` dictionary. Nr���r���r���r���rh���T)r���r ��rI���r���rj���r��� OptionGroupadd_option_group add_optiongetr���r���settings_defaultsr���r���settings_default_overrides) r���r �� componentr���rO���title description option_specgroup help_textoption_stringsr���r ���s ��� r���r��z%OptionParser.populate_from_components��s����$� F� FI %3M  ' . .0 2� 2� 21c-00!44� F� F2?!A#2F/{K�!$0ukJJE))%0000 E;F�7�77Y-U-~�89�8068�8Fzz(++x7726 6;/.�FM(()DEEE F�$� K� KI� KYA� K $$Y%IJJJ K� Kr���c���������������������dt�����������j��������v�r0t�����������j��������d�����������������������������t�����������j������������������}n|�j��������}d�|D�������������S�)z:Return list of config files, from environment or standard.DOCUTILSCONFIGc�����������������t����g�|�]5}|���������������������������������t����������j����������������������������|����������6S�rs���)r9���rw���ru��� expanduser)rN���fs��� r���rP���z:OptionParser.get_standard_config_files.<locals>.<listcomp>��s5����III!qwwyyI""1%%IIIr���)rw���environr0���pathsepstandard_config_files)r`���r ��s��� r���get_standard_config_filesz&OptionParser.get_standard_config_files��sL����� rz ) ):&67==bjIILL4LII|IIIIr���c�����������������.���t����������j��������������������5��t����������j��������dt���������������������t ����������������������}d�d�d������������n #�1�swxY�w�Y���|���������������������������������D�]+}|��������������������|���������������������|����������|������������,|S�)Nr���r���)r���r���r���r���r���r(��r���r���)r���r���filenames��� r���r��z)OptionParser.get_standard_config_settings��s����  $ & &� �  #H7I J J J JxxH � � � � � � � � � � � � � � �6688� K� KH OOD99(CCT J J J Js���*A  AAc��������������������t����������������������}t����������������������}t����������j��������������������5��t����������j��������dt ���������������������|�xj��������|��������������������||�����������z ��c_��������t����������������������}ddd�����������n #�1�swxY�w�Y���|�j ��������D�]r}|st����������|j ��������pd����������|j ��������fz���D�]M}||v�r| ��������������������|�����������|��������������������|����������r|��������������������||���������|������������Nst!����������|j��������|�j��������t&����������j����������������������������|���������������������|j��������S�)zAReturns a dictionary containing appropriate config file settings.r���r���Nrs���) ConfigParserr1���r���r���r���r���r ��readr���r ��r���config_section_dependenciesr(���add has_sectionr���r{���r���r ��rw���ru���dirname)r��� config_filer'���appliedr���r��sections��� r���r���z%OptionParser.get_config_file_settings��s���$ %%  $ & &� �  #H7I J J J J   !3!3K!F!F F  xxH � � � � � � � � � � � � � � �� B� BI� !)"G"M2NN(79:� B� Bg%% G$$$ ,,W55�BOOM'$:DAAA  B� H- 7GOOK88 :� :� :�  s���AB  BBc���������������������|����������������������|����������\��|_��������|_��������t����������|j��������|�j�������������������|�j��������|_��������|S�)z/Store positional arguments as runtime settings.) check_argsr���r���r{���r���r ��r ��r���)r���r ���r���s��� r��� check_valueszOptionParser.check_values��sB����.2ood.C.C++FOT-HIII#0 r���c���������������������d�x}}|r|���������������������d����������}|dk����rd�}|r|���������������������d����������}|dk����rd�}|r|���������������������d�����������|r||k����r|���������������������d�����������||fS�)Nr���r���zMaximum 2 arguments allowed.z_Do not specify the same file for both source and destination. It will clobber the source file.)rH���r���)r���r���source destinations��� r���r6��zOptionParser.check_args���s����## � XXa[[F}} � #((1++Kc!!" � 7 JJ5 6 6 6 � If ++ JJ�H� I� I� I{""r���c�����������������:����|�j�����������������������������|�����������d�S�rX���)r���r���r���r���s��� r���set_defaults_from_dictz#OptionParser.set_defaults_from_dict��s���� X&&&&&r���c���������������������t����������j��������������������5��t����������j��������dt���������������������t ����������|�j������������������}ddd�����������n #�1�swxY�w�Y���|�j��������|_��������|S�)z(Needed to get custom `Values` instances.r���r���N)r���r���r���r���r���r���r ��r���r<��s��� r���get_default_valueszOptionParser.get_default_values��s����  $ & &� -� -  #H7I J J J Jdm,,H -� -� -� -� -� -� -� -� -� -� -� -� -� -� -�"&!2s���0AAAc�����������������x����|�j���������|�gz���D�]}|j��������D�]}|j��������|k����r|c�c�S�t����������d|z������������)a�� 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. zNo option with dest == %r.) option_groups option_listr���r;���)r���r���r��r ���s��� r���get_option_by_destzOptionParser.get_option_by_dest��si�����'4&0� "� "E+� "� ";$&&!MMMMM�' "�3d:;;;r���)rs���NF)/r���r���r���r���r'��r0���threshold_choicesrC���r8���r���sysstderrr���_locale_encodingdefault_error_encoding$default_error_encoding_error_handlerr<���r���rb���rE���r4���r,���r[���r���r���rK���r���r��r(���r]��� __version____version_details__r���platformr ��r���r�� classmethodr(��r��r���r7��r6��r=��r?��rC��r���r���s���@r���r���r�����s ������� � �� �CHHJJGAANNJ@dDuEEuF�FH?%gcj*dCC�)!#!4)!(��,>(� # e � 9 ,O4 6�e � 4 + 9- /e � ? $ L/?"A�"A B e � /   LL Ne � ? T }z%02�2 3e � + T }&:%02�2 3e "� 4  '24�4 5#e (� 3 D !l1A$C�$C D)e .� @  Y0 2/e 2� :  ^9 ;� ; <3e :� A " #"mg �  ;e B� = !"me L L NCe H� 8  "m < < >Ie N� C ! "!a( *� * +Oe V� < $ %'= A A CWe \� = !!?&6 8� 8 9]e d� 3 # $"O < < >ee j� <  !0@ A A Cke p� C  ",< = = ?qe v #� ) )'D.B D� D  Ewe B #�  .B D� D  ECe N K t *;'5),>@�@ AOe X� A  -!(6 8� 8 9Ye ^� @ d  &46�6 7_e d 9 *"3\"# $68�8 9ee n� C ,=1!-/�/ 0oe t 6  ):&9)*y+=?�? @ue @� @ +,%57�7 8Ae F� - .]GDD FGe J� : .#3II KKe N� > /lt)9;�; <Oe T� 2  {mLL NUe X I t $(; =� = >Ye b B + ,-L M M Oce j ,  %(W; =� = >ke t 5� - --L M M  Oue �e B�$ # #%I%I%I K� t $(5K; =� =  >e J ( 0 1� , ,:7 9� 9  :Ke V� I  T,4!6�!6 7We \� 6 " #-E �  ]e d� C ,Hh#-;KM�M Nee j� 9  )4 6ke n� - T Xv. 0oe t� -9b/ :ue v� ,- 3/? @we z� +,x.F G{e |� ,-,/G H}e ~� -.<0H Ie @� -.<0H IAe B� 78'9< >� > ?Ce H� ,-,/G HIe �e h MR0�-1$()-*.0�0 �NN�$//#7�D&x'CCJGIJ�J;,,..q1113<<< A �#";�";�";�";�";�";HK�K�K@�J�J�[J��!�!�!0��#�#�#"'�'�'��<�<�<�<�<�<�<r���r���c�������������������R�����e�Zd�ZdZddddZ �dZdZd�fd Zd �Zd �Z d �Z d �Z �xZ S�)r,��aZ��Parser for Docutils configuration files. See https://docutils.sourceforge.io/docs/user/config.html. Option key normalization includes conversion of '-' to '_'. Config file encoding is "utf-8". Encoding errors are reported and the affected file(s) skipped. This class is provisional and will change in future versions. )pep_html writer stylesheet)rO��stylesheet_path)rO��template)pep_stylesheetpep_stylesheet_path pep_templatea ��The "[option]" section is deprecated. Support for old-format configuration files will be removed in Docutils 0.21 or later. Please revise your configuration files. See <https://docutils.sourceforge.io/docs/user/config.html>, section "Old-Format Configuration Files".zhUnable to read configuration file "%s": content not encoded as UTF-8. Skipping "%s" configuration file. Nc��������������������|t����������j��������dt����������d�����������g�}t����������|t��������������������r|g}|D�]} �|t ������������������������������������������|d����������z ��}n9#�t����������$�r,�t����������j �������� ��������������������|�j ��������||fz�������������Y�_w�xY�wd|�v�r|� ��������������������|�����������||� ��������������������||�����������|S�)Nzbfrontend.ConfigParser.read(): parameter "option_parser" will be removed in Docutils 0.21 or later.r���r���r���)r2���options)r���r���r���r6���strr���r-��UnicodeDecodeErrorrE��rF��writenot_utf8_errorhandle_old_configvalidate_settings)r��� filenamesr&���read_okr*��r���s��� r���r-��zConfigParser.readO��s ����  $ M�7�- <� <� <� <� i % %� $" I!� @� @H 577<<7<CCC%� � �    !4(7K!KLLL �D  &&x000(&&x???s���&A&&3BBc��������������������t����������j��������|�j��������t����������|d�����������|���������������������d����������}|���������������������d����������s|���������������������d�����������|��������������������������������D�]z\��}}||�j��������v�r;|�j��������|���������\��}}|���������������������|����������s|���������������������|�����������nd}|}|� ��������������������||����������s|� ��������������������|||�����������{|� ��������������������d�����������d�S�)Nr���rW��r��) r��� warn_explicit old_warningConfigDeprecationWarning get_sectionr0�� add_sectionr ��� old_settings has_optionr1���remove_section)r���r*��rW��r���r ���r4��r%���s��� r���r\��zConfigParser.handle_old_configg��s���t/1I' ,� ,� ,""9-- **� (   Y ' ' '!--//� 2� 2JCd'''#'#4S#9 ''00�.$$W---#??7G44� 2'5111 I&&&&&r���c��������������������|����������������������������������D�]}|���������������������|����������D�]} �|��������������������|����������}n#�t����������$�r�Y�%w�xY�w|j��������r|���������������������||����������} �|��������������������||||�|����������}nB#�t ����������$�r5}t����������d|�d|�dt����������j ��������|�����������d|�d|� ����������d}~ww�xY�w|� ��������������������|||�����������|j ��������r|� ��������������������||j ��������d�����������ߌdS�)zi Call the validator function and implement overrides on all applicable settings. )r'���r(���zError in config file "z ", section "[z]": z z = N) sectionsrW��rC��r;���r���r��r���r���r���r���r1���r���) r���r*��r&���r4��r%���r ���r ���r���r���s ��� r���r]��zConfigParser.validate_settingsy��s��� �}}� >� >G<<00� >� >*==gFFFF���H#� : HHWg66EI$*$4$4#UM*.w�%5�%H�%H �%�I�I�I(�*H(�*H�*H6=*H�*H020D0D*H�*H�5<*H�*H�AF*H�*H�I�I�II �HHWgy999#�>HHWf&6===% > >� >s)���A AA3B C 0CC c�����������������R����|�����������������������������������������������������dd����������S�)z Lowercase and transform '-' to '_'. So the cmdline form of option names can be used in config files. r���r���)r:���r���)r��� optionstrs��� r��� optionxformzConfigParser.optionxform��s$���� �  ((c222r���c���������������������t����������j��������dt����������d����������� �t����������|�|�������������������S�#�t����������$�r�i�cY�S�w�xY�w)z Return a given section as a dictionary. Return empty dictionary if the section doesn't exist. Deprecated. Use the configparser "Mapping Protocol Access" and catch KeyError. zNfrontend.OptionParser.get_section() will be removed in Docutils 0.21 or later.r���r���)r���r���r���r���r;���)r���r4��s��� r���rd��zConfigParser.get_section��sc�����  �C(Q 8� 8� 8� 8 W && &� � � III s���3� AArX���) r���r���r���r���rf��rb��r[��r-��r\��r]��rm��rd��r���r���s���@r���r,��r,��.��s�������� � �<E79�9L  4�N �����0'�'�'$>�>�>43�3�3������r���r,��c�����������������������e�Zd�ZdZdS�)rc��z3Warning for deprecated configuration file features.N)r���r���r���r���rs���r���r���rc��rc����s��������====r���rc��c����������������������t����������j��������������������5��t����������j��������dt���������������������t ����������|�������������������������������������������cddd�����������S�#�1�swxY�w�Y���dS�)a|��Return default runtime settings for `components`. Return a `frontend.Values` instance with defaults for generic Docutils settings and settings from the `components` (`SettingsSpec` instances). This corresponds to steps 1 and 2 in the `runtime settings priority`__. __ https://docutils.sourceforge.io/docs/api/runtime-settings.html #settings-priority r���r���N)r���r���r���r���r���r?��)r ��s��� r���get_default_settingsrq����s�����  " "�=�=3EFFFFJ''::<<=�=�=�=�=�=�=�=�=�=�=�=�=�=�=�=�=�=s���<AA!$A!)NNrX���)(r��� __docformat__r!��� configparserr���r���rw���os.pathrE��r���r]���r���r���r���r���r)���r,���r4���r<���r>���rA���rE���rK���rR���rV���r[���rb���rp���r{���rt���r���r���r���r��� SettingsSpecRawConfigParserr,�� FutureWarningrc��rq��rs���r���r���<module>rx�����sK�� .�.`�# � ������"�"�"�"�"�"� �� ���������� +� +� +/�/�/�:> � � � �HL � � � �GK���0�9= A� A� A� A�9= � � �  �AE����;?@�@�@�@�GK����FJ � � � "�GK����AE*�*�*�*�=A � � � �EI!�!�!�!H"�"�"�"(:�:�:��:+#�+#�+#�+#�+#X_�+#�+#�+#\"�"�"�"�"X_�"�"�"JG<�G<�G<�G<�G<8((*?�G<�G<�G<T |�|�|�|�|</�|�|�|~>�>�>�>�>}�>�>�> =� =� =� =� =r���