§
    ’MÍc-›  ã                   óÒ  — d Z dZddlZddlZddlZddlmZ ddlZddlZddlZddl	Z	ddl
Z
ddl
mZmZ d„ Zd„ Z	 d#d„Z	 d#d	„Z	 d#d
„Z	 d#d„Z	 d#d„Z	 d#d„Z	 d#d„Z	 d#d„Z	 d#d„Z	 d#d„Z	 d#d„Z	 d#d„Z	 d#d„Zd$d„Zd„ Zd„ Z G d„ dej        ¦  «        Z G d„ dej         ¦  «        Z  G d„ dej!        e
j"        ¦  «        Z! G d„ dej#        ¦  «        Z$ G d „ d!e%¦  «        Z&d"„ Z'dS )%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.
ÚreStructuredTexté    N)ÚSUPPRESS_HELP)ÚioÚutilsc                 óœ   — |D ]}t          |j        |d¦  «         Œ|                     ¦   «         D ]\  }}t          |j        ||¦  «         ŒdS )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)ÚsetattrÚvaluesÚitems)ÚoptionÚoptÚvalueÚparserÚargsÚkwargsÚ	attributeÚkeys           ú3/usr/lib/python3/dist-packages/docutils/frontend.pyÚstore_multipler   E   sf   € ð ð 0ð 0ˆ	Ý�”˜y¨$Ñ/Ô/Ð/Ð/Ø—l’l‘n”nð +ð +‰
ˆˆUÝ�”˜s EÑ*Ô*Ð*Ð*ð+ð +ó    c                 óÂ   — 	 |                      |¦  «        }n,# t          $ r}|                     |¦  «         Y d}~nd}~ww xY w|j                             ||¦  «         dS )zQ
    Read a configuration file during option processing.  (Option callback.)
    N)Úget_config_file_settingsÚ
ValueErrorÚerrorr	   Úupdate)r   r   r   r   Únew_settingsÚerrs         r   Úread_config_filer   R   sz   € ðØ×6Ò6°uÑ=Ô=ˆˆøÝð ð ð Ø�Š�SÑÔÐÐÐÐÐÐøøøøðøøøà
„M×Ò˜ vÑ.Ô.Ð.Ð.Ð.s   ‚ ˜
A¢<¼Ac                 óz   — 	 t          j        |¦  «         n$# t          $ r t          d| ›d|›d�¦  «        ‚w xY w|S )Nz	setting "z": unknown encoding: "ú")ÚcodecsÚlookupÚLookupError©Úsettingr   Úoption_parserÚconfig_parserÚconfig_sections        r   Úvalidate_encodingr(   ]   sb   € ð.ÝŒ�eÑÔÐÐøÝð .ð .ð .ÝˆkØ$˜W˜W e e eð-ñ .ô .ð 	.ð.øøøð €Ls   ‚ —!8c                 ór   — 	 t          j        |¦  «         n # t          $ r t          d|z  ¦  «        ‚w xY w|S )Nz¿unknown 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        r   Úvalidate_encoding_error_handlerr+   g   s^   € ð5ÝÔ˜EÑ"Ô"Ð"Ð"øÝð 5ð 5ð 5Ýð,ð /4ñ4ñ5ô 5ð 	5ð5øøøð €Ls   ‚ —4c                 ó  — d|v re|                      d¦  «        \  }}t          | dz   ||||¦  «         |r|                     || dz   |¦  «         nt          |j        | dz   |¦  «         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+   Úsetr   r	   r(   )r$   r   r%   r&   r'   ÚencodingÚhandlers          r   Ú#validate_encoding_and_error_handlerr3   t   sÃ   € ð ˆe€|€|Ø!ŸKšK¨Ñ,Ô,Ñˆ�'Ý'ØÐ&Ñ&¨°Ø˜>ñ	+ô 	+ð 	+ð ð 	OØ×Ò˜n¨gÐ8HÑ.HØ%ñ'ô 'ð 'ð 'õ �MÔ(¨'Ð4DÑ*DÀgÑNÔNÐNÐNàˆÝ�g˜x¨Ø# ^ñ5ô 5ð 5à€Or   c                 óÔ   — t          |t          ¦  «        r|S 	 |j        |                     ¦   «                              ¦   «                  S # t
          $ r t          d|z  ¦  «        ‚w xY w)z|Check/normalize boolean settings:
         True:  '1', 'on', 'yes', 'true'
         False: '0', 'off', 'no','false', ''
    zunknown boolean value: "%s")Ú
isinstanceÚboolÚbooleansÚstripÚlowerÚKeyErrorr"   r#   s        r   Úvalidate_booleanr;   ‹   sv   € õ �%�ÑÔð ØˆðAØÔ% e§k¢k¡m¤m×&9Ò&9Ñ&;Ô&;Ô<Ð<øÝð Að Að AÝÐ7¸%Ñ?Ñ@Ô@Ð@ðAøøøs   ™0A
 Á
A'c                 ó¼   — t          |t          ¦  «        s|€|S 	 |j        |                     ¦   «                              ¦   «                  S # t
          $ r |cY S w xY w)zªCheck/normalize three-value settings:
         True:  '1', 'on', 'yes', 'true'
         False: '0', 'off', 'no','false', ''
         any other value: returned as-is.
    )r5   r6   r7   r8   r9   r:   r#   s        r   Úvalidate_ternaryr=   ™   sj   € õ �%�ÑÔð  % -ØˆðØÔ% e§k¢k¡m¤m×&9Ò&9Ñ&;Ô&;Ô<Ð<øÝð ð ð Øˆˆˆðøøøs   ›0A ÁAÁAc                 óN   — t          |¦  «        }|dk     rt          d¦  «        ‚|S )Nr   z(negative value; must be positive or zero)Úintr   r#   s        r   Úvalidate_nonnegative_intr@   ¨   s*   € å�‰JŒJ€EØˆq‚y€yÝÐCÑDÔDÐDØ€Lr   c                 óÐ   — 	 t          |¦  «        S # t          $ rJ 	 |j        |                     ¦   «                  cY S # t          t
          f$ r t          d|z  ¦  «        ‚w xY ww xY w)Nzunknown threshold: %r.)r?   r   Ú
thresholdsr9   r:   ÚAttributeErrorr"   r#   s        r   Úvalidate_thresholdrD   °   s�   € ð@Ý�5‰zŒzÐøÝð @ð @ð @ð	@Ø Ô+¨E¯KªK©M¬MÔ:Ð:Ð:Ð:øÝ�.Ð)ð 	@ð 	@ð 	@ÝÐ6¸Ñ>Ñ?Ô?Ð?ð	@øøøð@øøøs   ‚ ‘
A%œ=ºA%½$A!Á!A%c                 óÔ   — t          |t          ¦  «        s|                     d¦  «        }n<|                     ¦   «         }|                     |                     d¦  «        ¦  «         |S )Nr-   )r5   Úlistr/   ÚpopÚextend)r$   r   r%   r&   r'   Úlasts         r   Ú$validate_colon_separated_string_listrJ   »   sU   € å�e�TÑ"Ô"ð &Ø—’˜CÑ Ô ˆˆà�yŠy‰{Œ{ˆØ�Š�T—Z’Z ‘_”_Ñ%Ô%Ð%Ø€Lr   c                 óÆ   — t          |t          ¦  «        s|g}|                     ¦   «         }d„ |                     d¦  «        D ¦   «         }|                     |¦  «         |S )zHCheck/normalize list arguments (split at "," and strip whitespace).
    c                 ób   — g | ],}|                      d ¦  «        ¯|                      d ¦  «        ‘Œ-S )z 	
)r8   )Ú.0Úis     r   ú
<listcomp>z1validate_comma_separated_list.<locals>.<listcomp>Ð   s5   € ÐKÐKÐK !¸!¿'º'À'Ñ:JÔ:JÐKˆQ�WŠW�WÑÔÐKÐKÐKr   ú,)r5   rF   rG   r/   rH   )r$   r   r%   r&   r'   rI   r
   s          r   Úvalidate_comma_separated_listrQ   Å   s`   € õ �e�TÑ"Ô"ð Ø�ˆð �9Š9‰;Œ;€DØKÐK t§z¢z°#¡¤ÐKÑKÔK€EØ	‡L‚L�ÑÔÐØ€Lr   c                 óB   — |sdS |                      d¦  «        r|S |dz   S )Nz./ú/)Úendswithr#   s        r   Úvalidate_url_trailing_slashrU   Õ   s2   € àð ØˆtØ	�Š˜Ñ	Ô	ð Øˆà�s‰{Ðr   c                 ót   — 	 t          j        |¦  «        S # t          $ r t          j        d ¦  «        cY S w xY w©N)r   ÚDependencyListÚOSErrorr#   s        r   Úvalidate_dependency_filerZ   ß   sJ   € ð*ÝÔ# EÑ*Ô*Ð*øÝð *ð *ð *åÔ# DÑ)Ô)Ð)Ð)Ð)ð*øøøs   ‚ –7¶7c                 ó¬   — t          | ||||¦  «        }|D ]=}t          j                             |¦  «        }||k    rt	          d|›d|›d�¦  «        ‚Œ>|S )NzInvalid class value z
 (perhaps z?))rQ   ÚdocutilsÚnodesÚmake_idr   )r$   r   r%   r&   r'   ÚclsÚ
normalizeds          r   Úvalidate_strip_classra   è   sƒ   € õ *¨'°5¸-Ø*7¸ñIô I€Eð ð 2ð 2ˆÝ”^×+Ò+¨CÑ0Ô0ˆ
Ø�*ÒÐÝ�*Ø #   Z Z Zð1ñ 2ô 2ð 2ð ð €Lr   c           	      ó:  — t          | ||||¦  «        }g }|D �]}	 |                     dd¦  «        \  }}nT# t          $ r |                     |¦  «         Y Œ?t          $ r' t	          d|                     dd¦  «        z  ¦  «        ‚w xY w|                     ¦   «         }|                     d¦  «        }	t          |	¦  «        dk    r|	}n9t          |¦  «        dk    r&t	          d|                     dd¦  «        z  ¦  «        ‚|                     ||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 "<language>:<quotes>".ÚasciiÚbackslashreplaceé   z[Invalid value "%s". Please specify 4 quotes
    (primary open/close; secondary open/close).)rQ   r/   rC   Úappendr   Úencoder8   Úlen)
r$   r   r%   r&   r'   Ú	lc_quotesÚitemÚlangÚquotesÚmultichar_quotess
             r   Úvalidate_smartquotes_localesro   ö   sw  € õ *¨'°5¸-Ø*7¸ñIô I€Eð €IØð )ñ )ˆð
	IØŸ:š: c¨1Ñ-Ô-‰LˆD�&�&øÝð 	ð 	ð 	ð ×Ò˜TÑ"Ô"Ð"ØˆHÝð 	Ið 	Ið 	IÝð Aà#Ÿ{š{¨7Ð4FÑGÔGñHñ Iô Ið Ið	Iøøøð
 —’‘”ˆØ!Ÿ<š<¨Ñ,Ô,ÐÝÐÑ Ô  AÒ%Ð%Ø%ˆFˆFÝ�‰[Œ[˜AÒÐÝð Oà#Ÿ{š{¨7Ð4FÑGÔGñHñ Iô Ið Ið 	×Ò˜$ ˜Ñ(Ô(Ð(Ñ(ØÐs   œ6¶BÁ0Bc                 óÊ   ‡— ‰€t          j        ¦   «         Š|D ]I}|| v rC| |         }t          |t          ¦  «        rˆfd„|D ¦   «         }n|rt	          ‰|¦  «        }|| |<   ŒJdS )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`.
    Nc                 ó0   •— g | ]}t          ‰|¦  «        ‘ŒS © )Úmake_one_path_absolute)rM   ÚpathÚ	base_paths     €r   rO   z'make_paths_absolute.<locals>.<listcomp>'  s3   ø€ ð ,ð ,ð ,Ø!õ 0°	¸4Ñ@Ô@ð ,ð ,ð ,r   )ÚosÚgetcwdr5   rF   rs   )ÚpathdictÚkeysru   r   r   s     `  r   Úmake_paths_absoluterz     s    ø€ ð ÐÝ”I‘K”Kˆ	Øð "ð "ˆØ�(ˆ?ˆ?Ø˜S”MˆEÝ˜%¥Ñ&Ô&ð Að,ð ,ð ,ð ,Ø%*ð,ñ ,ô ,��àð AÝ.¨y¸%Ñ@Ô@�Ø!ˆH�S‰Møð"ð "r   c                 ó|   — t           j                             t           j                             | |¦  «        ¦  «        S rW   )rv   rt   ÚabspathÚjoin)ru   rt   s     r   rs   rs   .  s&   € ÝŒ7�?Š?�2œ7Ÿ<š<¨	°4Ñ8Ô8Ñ9Ô9Ð9r   c                 ó†  — t          | ¦  «        }t          dt          |¦  «        d¦  «        D ]…}g }||         D ]f}d„ |d         D ¦   «         d         }||v rŒ||                     ¦   «         v r|                     ||         ¦  «         ŒQ|                     |¦  «         Œgt          |¦  «        ||<   Œ†t          |¦  «        S )aj  Return 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.)
    é   é   c                 ót   — g | ]5}|                      d ¦  «        ¯|dd…                              dd¦  «        ‘Œ6S )z--r   Nú-Ú_)Ú
startswithÚreplace)rM   Ú
opt_strings     r   rO   z(filter_settings_spec.<locals>.<listcomp>B  sS   € ð 8ð 8ð 8Ø&Ø%×0Ò0°Ñ6Ô6ð8˜
 1 2 2œ×.Ò.¨s°CÑ8Ô8ð 8ð 8ð 8r   rc   r   )rF   Úrangeri   ry   rg   Útuple)Úsettings_specÚexcluder…   ÚsettingsrN   ÚnewoptsÚopt_specÚopt_names           r   Úfilter_settings_specr�   2  sã   € õ �MÑ"Ô"€Hå�1•c˜(‘m”m QÑ'Ô'ð %ð %ˆØˆØ  œð 
	)ð 
	)ˆHð8ð 8Ø*2°1¬+ð8ñ 8ô 8à89ô;ˆHð ˜7Ð"Ð"ØØ˜7Ÿ<š<™>œ>Ð)Ð)Ø—’˜w xÔ0Ñ1Ô1Ð1Ð1à—’˜xÑ(Ô(Ð(Ð(Ý˜G‘n”nˆ�‰ˆÝ�‰?Œ?Ðr   c                   ó4   ‡ — e Zd ZdZˆ fd„Zd„ Zd„ Zd„ Zˆ xZS )ÚValueszÒStorage 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.
    c                 óÈ   •— t          j        dt          d¬¦  «          t          ¦   «         j        |i |¤Ž t          | dd ¦  «        €t          j        ¦   «         | _        d S d S )Nz@frontend.Values class will be removed in Docutils 0.21 or later.r   ©Ú
stacklevelÚrecord_dependencies)	ÚwarningsÚwarnÚDeprecationWarningÚsuperÚ__init__Úgetattrr   rX   r•   ©Úselfr   r   Ú	__class__s      €r   rš   zValues.__init__X  sv   ø€ ÝŒð 3å(°Qð	8ñ 	8ô 	8ð 	8ð 	�‰ŒÔ˜$Ð) &Ð)Ð)Ð)Ý�4Ð.°Ñ5Ô5Ð=å',Ô';Ñ'=Ô'=ˆDÔ$Ð$Ð$ð >Ð=r   c                 ó&  — t          |t          ¦  «        r|j        }t          |¦  «        }|j                             ¦   «         D ]6}t          | |¦  «        r$||v r t          | |¦  «        }|r|||         z  }||= Œ7|                      |¦  «         d S rW   )	r5   r‘   Ú__dict__ÚdictÚlistsry   Úhasattrr›   Ú_update_loose)r�   Ú
other_dictr%   r$   r   s        r   r   zValues.updatea  s¬   € Ý�j¥&Ñ)Ô)ð 	-Ø#Ô,ˆJÝ˜*Ñ%Ô%ˆ
Ø$Ô*×/Ò/Ñ1Ô1ð 	,ð 	,ˆGÝ�t˜WÑ%Ô%ð ,¨'°ZÐ*?Ð*?Ý  gÑ.Ô.�Øð ,Ø˜Z¨Ô0Ñ0�EØ" 7Ð+øØ×Ò˜:Ñ&Ô&Ð&Ð&Ð&r   c                 óÈ   — t          j        ¦   «         5  t          j        dt          ¬¦  «         |                      | j        ¬¦  «        cddd¦  «         S # 1 swxY w Y   dS )z Return a shallow copy of `self`.Úignore©Úcategory)ÚdefaultsN)r–   Úcatch_warningsÚfilterwarningsr˜   rž   r    )r�   s    r   ÚcopyzValues.copym  sŸ   € åÔ$Ñ&Ô&ð 	:ð 	:ÝÔ# HÕ7IÐJÑJÔJÐJØ—>’>¨4¬=�>Ñ9Ô9ð	:ð 	:ð 	:ð 	:ñ 	:ô 	:ð 	:ð 	:ð 	:ð 	:ð 	:ð 	:øøøð 	:ð 	:ð 	:ð 	:ð 	:ð 	:s   ”6AÁAÁAc                 óf   — t          | |d¦  «        €t          | ||¦  «         t          | |¦  «        S )zUV.setdefault(n[,d]) -> getattr(V,n,d), also set D.n=d if n not in D or None.
        N)r›   r   )r�   ÚnameÚdefaults      r   Ú
setdefaultzValues.setdefaults  s8   € õ �4˜˜tÑ$Ô$Ð,Ý�D˜$ Ñ(Ô(Ð(Ý�t˜TÑ"Ô"Ð"r   )	Ú__name__Ú
__module__Ú__qualname__Ú__doc__rš   r   r­   r±   Ú__classcell__©rž   s   @r   r‘   r‘   O  so   ø€ € € € € ðð ð>ð >ð >ð >ð >ð
'ð 
'ð 
'ð:ð :ð :ð#ð #ð #ð #ð #ð #ð #r   r‘   c                   óN   ‡ — e Zd ZdZej        j        ddgz   Zˆ fd„Zˆ fd„Zˆ xZ	S )ÚOptionz`Add validation and override support to `optparse.Option`.

    Deprecated. Will be removed.
    Ú	validatorÚ	overridesc                 ór   •— t          j        dt          d¬¦  «          t          ¦   «         j        |i |¤Ž d S )NzDThe frontend.Option class will be removed in Docutils 0.21 or later.r   r“   )r–   r—   r˜   r™   rš   rœ   s      €r   rš   zOption.__init__ƒ  sJ   ø€ ÝŒð 3å(°Qð	8ñ 	8ô 	8ð 	8ð 	�‰ŒÔ˜$Ð) &Ð)Ð)Ð)Ð)Ð)r   c           	      óš  •— t          ¦   «                              ||||¦  «        }| j        }|rœ| j        rxt	          ||¦  «        }	 |                      |||¦  «        }n># t
          $ r1}t          j        d|›dt          j	        |¦  «        ›�¦  «        ‚d}~ww xY wt          |||¦  «         | j        rt          || j        d¦  «         |S )zœ
        Call the validator function on applicable settings and
        evaluate the 'overrides' option.
        Extends `optparse.Option.process`.
        zError in option "z":
    N)r™   ÚprocessÚdestrº   r›   Ú	ExceptionÚoptparseÚOptionValueErrorr   Úerror_stringr   r»   )
r�   r   r   r	   r   Úresultr$   Ú	new_valuer   rž   s
            €r   r¾   zOption.process‰  sí   ø€ õ ‘”—’  e¨V°VÑ<Ô<ˆØ”)ˆØð 	6ØŒ~ð 4Ý ¨Ñ0Ô0�ð7Ø $§¢¨w¸¸vÑ FÔ F�I�IøÝ ð 7ð 7ð 7Ý"Ô3Ð3à˜3˜3¥¤°Ñ 4Ô 4Ð 4ð6ñ7ô 7ð 7øøøøð7øøøõ ˜ ¨Ñ3Ô3Ð3ØŒ~ð 6Ý˜ ¤°Ñ5Ô5Ð5Øˆs   ÁA Á
BÁ),BÂB)
r²   r³   r´   rµ   rÁ   r¹   ÚATTRSrš   r¾   r¶   r·   s   @r   r¹   r¹   {  sq   ø€ € € € € ðð ð
 ŒOÔ! [°+Ð$>Ñ>€Eð*ð *ð *ð *ð *ðð ð ð ð ð ð ð ð r   r¹   c                   óˆ  ‡ — e Zd ZdZg d¢Z	 d                     ¦   «         Z	 dddddd	œZ	 d
d
d
d
ddddddœ	Z	  e	e
j        dd¦  «        pej        pdZdZddg ddgi f‘dddgdedœf‘ddgdddœf‘ddd gd!d"d#d$œf‘d%d&d'gd!d(d#d$œf‘d)d*gd!dd#d$œf‘d+d,d-gdedœf‘d.d/gd0d1if‘d2d3gd4ed5d6œf‘d7d8gd9d!d:d:d;œf‘d<d=gd9d!d>d?œf‘d@dAgd9ddBœf‘dCdDgddedEœf‘dFdGgdHddBœf‘dIdJgddKdedLœf‘dMdNgddKdœf‘dOdPgdedœf‘dQdRgddSdœf‘dTdUgdVdWdXedYœf‘dZd[gdVd\dXedYœf‘d]d^d_gedd`daedbœf‘dcdddegd!dd`d$œf‘dfdgdhgd!dd`d$œf‘didjgedkddaedlœf‘dmdngd!ddkd$œf‘dodpgedqddaedlœf‘drdsgdedœf‘dtdugddvdœf‘dwdxgdydzd{œf‘d|d}gddedEœf‘d~dgd€ddBœf‘d�d‚dƒgd„ed…œf‘d†d‡gdˆed‰œf‘dŠd‹dŒgd„d�edŽœf‘d�d�gdˆed‰œf‘d‘ez  d’d“gd„eedŽœf‘d”ez  d•geed‰œf‘d–d—d˜gd™dšd›dœœf‘d�džgdzeddŸœf‘d d¡gdzd¢d4ed£œf‘d¤d¥d¦gd§d¨if‘d©dªd«gd§d¬if‘ed­gd®d¯if‘ed°gd®d±if‘ed²gd§dif‘ed³gd§dif‘ed´gd§dif‘edµgd§dif‘ed¶gdVd·ed¸œf‘ed¹gd§dif‘R fZ	 dddddºœZ	 d»Zd¼ej        ›ej        r
d½ej        z  pd¯›d¾e
j                              ¦   «         d¿         ›dÀe
j!        ›dÁ�Z"	 dÍˆ fdÃ„	Z#dÄ„ Z$e%dÅ„ ¦   «         Z&dÆ„ Z'dÇ„ Z(dÈ„ Z)dÉ„ Z*dÊ„ Z+dË„ Z,dÌ„ Z-ˆ xZ.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 5rc   r   r€   rf   é   )ÚinfoÚwarningr   ÚsevereÚnoneTF)	Ú1ÚonÚyesÚtrueÚ0ÚoffÚnoÚfalseÚ r1   Nrd   re   zGeneral Docutils Optionsz'Specify the document title as metadata.z--titlez2Include 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¿   zInclude 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-urlÚmetavarz<URL>z-Do not include a "View document source" link.z--no-source-linkÚcallback)Úsource_linkÚ
source_url)rØ   rß   Úcallback_argsz4Link from section headers to TOC entries.  (default)z--toc-entry-backlinksÚtoc_backlinksÚentry)r¿   rØ   rÝ   r°   z0Link from section headers to the top of the TOC.z--toc-top-backlinksÚtop)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-backlinksÚfootnote_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-commentsÚstrip_commentsz‹Remove all elements with classes="<class>" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)z--strip-elements-with-classrg   Ústrip_elements_with_classesz<class>)rØ   r¿   rÞ   rº   z”Remove all classes="<class>" attributes from elements in the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)z--strip-classÚstrip_classeszReport 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-statusÚexit_status_levelz3Enable debug-level system messages and diagnostics.z--debugz Disable debug output.  (default)z
--no-debugÚdebugz-Send the output of system messages to <file>.z
--warningsÚwarning_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-handlerÚstrict)r°   rº   z^Specify the text encoding and optionally the error handler for output.  Default: utf-8:strict.z--output-encodingz-oúutf-8)rÞ   r°   rº   zŠSpecify error handler for unencodable output characters; "strict" (default), "ignore", "replace", "xmlcharrefreplace", "backslashreplace".z--output-encoding-error-handlerzˆSpecify text encoding and optionally error handler for error output.  Default text encoding: system encoding. Default error handler: %s.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_codeÚenz<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--configÚstring)rÞ   ÚtyperØ   rß   z,Show this program's version number and exit.z	--versionz-VrØ   Úversionz Show this help message and exit.z--helpz-hÚhelpz--id-prefixr°   rÖ   z--auto-id-prefixú%z--dump-settingsz--dump-internalsz--dump-transformsz--dump-pseudo-xmlz--expose-internal-attributeÚexpose_internals)rØ   r¿   rº   z--strict-visitor)Ú_disable_configÚ_sourceÚ_destinationÚ_config_filesÚgeneralz%prog (Docutils z [%s]z	, Python r   z, on ú)rr   c                 ój  •— i | _         	 g | _        	 dg| _        t          j        dt
          d¬¦  «          t          ¦   «         j        |t          dt          j
        d¬¦  «        dœ|¤Ž | j        s| j        | _        | g|¢R | _        |                      | j        ¦  «         | j                             |pi ¦  «         |rp| j        d	         se	 |                      ¦   «         }n,# t$          $ r}|                      |¦  «         Y d}~nd}~ww xY w| j                             |j        ¦  «         dS dS dS )
zÓSet 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“   NéN   )Úwidth)Úoption_classÚadd_help_optionÚ	formatterrü   )r¢   Úconfig_filesÚrelative_path_settingsr–   r—   r˜   r™   rš   r¹   rÁ   ÚTitledHelpFormatterrø   Úversion_templateÚ
componentsÚpopulate_from_componentsrª   r   Úget_standard_config_settingsr   r   r    )	r�   r  rª   Úread_config_filesr   r   Úconfig_settingsr   rž   s	           €r   rš   zOptionParser.__init__…  s�  ø€ ð ˆŒ
Ø(àˆÔØ;à'7Ð&8ˆÔ#åŒð 3õ )°Qð	8ñ 	8ô 	8ð 	8ð 	�‰ŒÔàõ '-¸dÝ#+Ô#?ÀbÐ#IÑ#IÔ#Ið	*ð 	*à"(ð	*ð 	*ð 	*ð Œ|ð 	1ØÔ0ˆDŒLØÐ- *Ð-Ð-ˆŒØ×%Ò% d¤oÑ6Ô6Ð6ØŒ×Ò˜X˜^¨Ñ,Ô,Ð,Øð 	; T¤]Ð3DÔ%Eð 	;ð Ø"&×"CÒ"CÑ"EÔ"E��øÝð  ð  ð  Ø—
’
˜3‘”������øøøøð øøøàŒM× Ò  Ô!9Ñ:Ô:Ð:Ð:Ð:ð	;ð 	;ð 	;ð 	;s   ÃC$ Ã$
DÃ.DÄDc                 óL  — |D ]ó}|€Œ|j         }| j                             |j        ¦  «         t          dt	          |¦  «        d¦  «        D ]©}|||dz   …         \  }}}|r,t          j        | ||¦  «        }|                      |¦  «         n| }|D ]=\  }	}
} |j        |
d|	i|¤Ž}| 	                    d¦  «        dk    rd| j
        |j        <   Œ>|j        r| j                             |j        ¦  «         ŒªŒô|D ]*}|r&|j        r| j                             |j        ¦  «         Œ+dS )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Ø   rg   T)r‰   r	  rH   r‡   ri   rÁ   ÚOptionGroupÚadd_option_groupÚ
add_optionÚgetr¢   r¿   Úsettings_defaultsrª   r   Úsettings_default_overrides)r�   r  Ú	componentr‰   rN   ÚtitleÚdescriptionÚoption_specÚgroupÚ	help_textÚoption_stringsr   r   s                r   r  z%OptionParser.populate_from_components©  s—  € ð $ð 	Fð 	FˆIØÐ ØØ%Ô3ˆMØÔ'×.Ò.ØÔ0ñ2ô 2ð 2å˜1�c -Ñ0Ô0°!Ñ4Ô4ð Fð F�Ø2?ÀÀ!ÀAÁ#ÀÔ2FÑ/��{ KØð !Ý$Ô0°°u¸kÑJÔJ�EØ×)Ò)¨%Ñ0Ô0Ð0Ð0à �EØ;Fð 7ð 7Ñ7�Y °Ø-˜UÔ-¸~ð 8°9ð 8Ø06ð8ð 8�Fà—z’z (Ñ+Ô+¨xÒ7Ð7Ø26˜œ
 6¤;Ñ/øØÔ.ð FØ”M×(Ò(¨Ô)DÑEÔEÐEøðFð $ð 	Kð 	KˆIØð K˜YÔAð KØ”×$Ò$ YÔ%IÑJÔJÐJøð	Kð 	Kr   c                 ó¤   — dt           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 rr   )r8   rv   rt   Ú
expanduser)rM   Úfs     r   rO   z:OptionParser.get_standard_config_files.<locals>.<listcomp>Ð  s5   € ÐIÐIÐI¨!¸q¿wºw¹y¼yÐI•”×"Ò" 1Ñ%Ô%ÐIÐIÐIr   )rv   Úenvironr/   ÚpathsepÚstandard_config_files)r_   r  s     r   Úget_standard_config_filesz&OptionParser.get_standard_config_filesÉ  sL   € ð �rœzÐ)Ð)Ýœ:Ð&6Ô7×=Ò=½b¼jÑIÔIˆLˆLàÔ4ˆLØIÐI¨|ÐIÑIÔIÐIr   c                 ó.  — t          j        ¦   «         5  t          j        dt          ¬¦  «         t	          ¦   «         }d d d ¦  «         n# 1 swxY 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Ï   € ÝÔ$Ñ&Ô&ð 	 ð 	 ÝÔ# HÕ7IÐJÑJÔJÐJÝ‘x”xˆHð	 ð 	 ð 	 ñ 	 ô 	 ð 	 ð 	 ð 	 ð 	 ð 	 ð 	 øøøð 	 ð 	 ð 	 ð 	 ð ×6Ò6Ñ8Ô8ð 	Kð 	KˆHØ�OŠO˜D×9Ò9¸(ÑCÔCÀTÑJÔJÐJÐJØˆs   ”*A
Á
AÁAc                 óœ  — t          ¦   «         }t          ¦   «         }t          j        ¦   «         5  t          j        dt
          ¬¦  «         | xj        |                     || ¦  «        z  c_        t          ¦   «         }ddd¦  «         n# 1 swxY w Y   | j	        D ]r}|sŒt          |j        pd¦  «        |j        fz   D ]M}||v rŒ|                     |¦  «         |                     |¦  «        r|                     ||         | ¦  «         ŒNŒst!          |j        | j        t&          j                             |¦  «        ¦  «         |j        S )zAReturns a dictionary containing appropriate config file settings.r§   r¨   Nrr   )ÚConfigParserr0   r–   r«   r¬   r˜   r  Úreadr‘   r  rˆ   Úconfig_section_dependenciesr'   ÚaddÚhas_sectionr   rz   r    r	  rv   rt   Údirname)r�   Úconfig_filer&   Úappliedr‹   r  Úsections          r   r   z%OptionParser.get_config_file_settingsÚ  s�  € å$™œˆå‘%”%ˆÝÔ$Ñ&Ô&ð 	 ð 	 ÝÔ# HÕ7IÐJÑJÔJÐJØÐÔ ×!3Ò!3°KÀÑ!FÔ!FÑFÐÔÝ‘x”xˆHð	 ð 	 ð 	 ñ 	 ô 	 ð 	 ð 	 ð 	 ð 	 ð 	 ð 	 øøøð 	 ð 	 ð 	 ð 	 ð œð 		Bð 		BˆIØð ØÝ! )Ô"GÐ"MÈ2ÑNÔNØ(Ô7Ð9ñ:ð Bð B�à˜gÐ%Ð%ØØ—’˜GÑ$Ô$Ð$Ø ×,Ò,¨WÑ5Ô5ð BØ—O’O M°'Ô$:¸DÑAÔAÐAøðBõ 	˜HÔ-Ø Ô7ÝœGŸOšO¨KÑ8Ô8ñ	:ô 	:ð 	:ð Ô Ð s   °AB
Â
BÂBc                 ó–   — |                       |¦  «        \  |_        |_        t          |j        | j        ¦  «         | j        |_        |S )z/Store positional arguments as runtime settings.)Ú
check_argsrý   rþ   rz   r    r	  r  rÿ   )r�   r	   r   s      r   Úcheck_valueszOptionParser.check_valuesò  sB   € à.2¯oªo¸dÑ.CÔ.CÑ+ˆŒ˜Ô+Ý˜FœO¨TÔ-HÑIÔIÐIØ#Ô0ˆÔØˆr   c                 óö   — d x}}|r|                      d¦  «        }|dk    rd }|r|                      d¦  «        }|dk    rd }|r|                      d¦  «         |r||k    r|                      d¦  «         ||fS )Nr   r‚   zMaximum 2 arguments allowed.z_Do not specify the same file for both source and destination.  It will clobber the source file.)rG   r   )r�   r   ÚsourceÚdestinations       r   r5  zOptionParser.check_argsù  s°   € Ø#Ð#ˆ�Øð 	Ø—X’X˜a‘[”[ˆFØ˜Š}ˆ}Ø�Øð 	#ØŸ(š( 1™+œ+ˆKØ˜cÒ!Ð!Ø"�Øð 	7Ø�JŠJÐ5Ñ6Ô6Ð6Øð 	I�f Ò+Ð+Ø�JŠJð Hñ Iô Ið Ià�{Ð"Ð"r   c                 ó:   — | j                              |¦  «         d S rW   )rª   r   ©r�   rª   s     r   Úset_defaults_from_dictz#OptionParser.set_defaults_from_dict
  s   € àŒ×Ò˜XÑ&Ô&Ð&Ð&Ð&r   c                 óÒ   — t          j        ¦   «         5  t          j        dt          ¬¦  «         t	          | j        ¦  «        }ddd¦  «         n# 1 swxY 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_valueszOptionParser.get_default_values  sž   € åÔ$Ñ&Ô&ð 	-ð 	-ÝÔ# HÕ7IÐJÑJÔJÐJÝ˜dœmÑ,Ô,ˆHð	-ð 	-ð 	-ñ 	-ô 	-ð 	-ð 	-ð 	-ð 	-ð 	-ð 	-øøøð 	-ð 	-ð 	-ð 	-ð "&Ô!2ˆÔØˆs   ”0AÁAÁAc                 óx   — | j         | gz   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.
        zNo option with dest == %r.)Úoption_groupsÚoption_listr¿   r:   )r�   r¿   r  r   s       r   Úget_option_by_destzOptionParser.get_option_by_dest  si   € ð Ô'¨4¨&Ñ0ð 	"ð 	"ˆEØÔ+ð "ð "�Ø”; $Ò&Ð&Ø!�M�M�M�M�Mð 'ð"õ Ð3°dÑ:Ñ;Ô;Ð;r   )rr   NF)/r²   r³   r´   rµ   r&  r/   Úthreshold_choicesrB   r7   r›   ÚsysÚstderrr   Ú_locale_encodingÚdefault_error_encodingÚ$default_error_encoding_error_handlerr;   r   ra   rD   r3   r+   rZ   r   r   rJ   r‰   r  r'   r\   Ú__version__Ú__version_details__rø   Úplatformr  rš   r  Úclassmethodr'  r  r   r6  r5  r<  r>  rB  r¶   r·   s   @r   rÈ   rÈ      sÐ	  ø€ € € € € ðð ðð ð Ððð
 C×HÒHÑJÔJÐØGà¨°AÀÈAÐNÐN€JØ@à ¨d¸DÀuØ E°E¸uðFð F€Hà?à%˜g c¤j°*¸dÑCÔCð )Ø!#Ô!4ð)à!(ð ð ,>Ð(ð 	#Øðb	Ð
3Øˆ+�rð
ð b	à
>Ø˜$Ð
¨LØ/?ð"Að "Að
Bðb	ð
 /ØÐ
¨ÀÐLÐLð
Nðb	ð ?Ø�TÐ
 }¸zØ%0ð2ð 2ð
3ðb	ð +Ø�TÐ
 }Ø&:Ø%0ð2ð 2ð
3ðb	ð 4ØÐ
¨ÀØ'2ð4ð 4ð
5ðb	ð" 3Ø˜DÐ
!¨lØ1Að$Cð $Cð
Dð#b	ð( @ØÐ
˜Y¨Ð0ð
2ð)b	ð, :ØÐ
Ø¨^Ø9ð;ð ;ð
<ð-b	ð4 AØ"Ð
#Ø"¨mÀgØðð ð
 ð5b	ð< =Ø Ð
!Ø"¨mÀeÐ
LÐ
Lð
Nð=b	ðB 8ØÐ
 Ø"¨mÐ
<Ð
<ð
>ðCb	ðH CØ!Ð
"Ø!¨aØ(ð*ð *ð
+ðIb	ðP <Ø$Ð
%Ø'°=Ð
AÐ
Að
CðQb	ðV =Ø Ð
!Ø!¨?ØÐ&6ð8ð 8ð
9ðWb	ð^ 3Ø#Ð
$Ø"¨OÐ
<Ð
<ð
>ð_b	ðd <ØÐ
Ø!Ð0@Ð
AÐ
Að
Cðeb	ðj CØÐ
Ø"Ð,<Ð
=Ð
=ð
?ðkb	ðp#ð )Ð
)ØÐ'DØÐ.BðDð Dð	
Eðqb	ð|#ð Ð
Ø ØÐ.BðDð Dð	
Eð}b	ðHKà�tÐ
Ð*;ÈØ'5À)Ø,>ð@ð @ð
AðIb	ðR AØ˜Ð
¨-À!Ø(6ð 8ð  8ð
9ðSb	ðX @Ø�dÐ
¨ÀØ&4ð6ð 6ð
7ðYb	ð^9àˆ*Ð"3¸\Ø"#°	Ø$6ð8ð 8ð
9ð_b	ðh CØˆ, =¸1Ø!-ð/ð /ð
0ðib	ðn6àÐ
Ð):Ø&9Ø)*°yØ+=ð?ð ?ð
@ðob	ðz @Øˆ+ ,Ø%5ð7ð 7ð
8ð{b	ð@ -Øˆ. ]¸GÐDÐDð
FðAb	ðD :Øˆ.Ð#3ÀÐIÐIð
KðEb	ðH >Øˆ/ l¸tØ)9ð;ð ;ð
<ðIb	ðN 2ØÐ
 {¸mÐLÐLð
NðOb	ðRIà˜tÐ
$Ø(Ø;ð=ð =ð
>ðSb	ð\Bà+Ð
,ØÐ-LÐ
MÐ
Mð
Oð]b	ðd,à Ð
%Ø(°WØ;ð=ð =ð
>ðeb	ðn5ð -Ð
-ØÐ-LÐ
MÐ
Mð	
Oðob	ðx'à)MñNð ˜tÐ
$Ø(Ð5KØ;ð=ð =ð	
>ðyb	ðD(à0ñ1ð ,Ð
,Ø:Ø7ð9ð 9ð	
:ðEb	ðP IØ˜Ð
¨ÀTØ,4ð!6ð !6ð
7ðQb	ðV 6Ø"Ð
#ØÐ-EØðð ð
ðWb	ð^ CØˆ, H°hØ#-Ð;KðMð Mð
Nð_b	ðd 9Ø˜Ð
 ¨)Ð4ð
6ðeb	ðh -Ø�TÐ
˜X vÐ.ð
0ðib	ðn ˜-˜¨9°b¨/Ð	:ðob	ðp Ð,Ð-°	¸3Ð/?Ð	@ðqb	ðt Ð+Ð,¨x¸Ð.FÐ	Gðub	ðv Ð,Ð-°¸,Ð/GÐ	Hðwb	ðx Ð-Ð.°¸<Ð0HÐ	Iðyb	ðz Ð-Ð.°¸<Ð0HÐ	Ið{b	ð| Ð7Ð8ØÐ'9Ø<ð>ð >ð
?ð}b	ðB Ð,Ð-°¸,Ð/GÐ	HðCb	ð b	ðe€MðL0ð -1Ø$(Ø)-Ø*.ð0ð 0Ððð
 €N€Nð $Ô/Ð/Ø#Ô7ð DØ& xÔ'CÑCðJØGIðJð Jàœ;×,Ò,Ñ.Ô.¨qÔ1Ð1Ð1°3´<°<°<ð	AÐð
 #ð";ð ";ð ";ð ";ð ";ð ";ðHKð Kð Kð@ ðJð Jñ „[ðJðð ð ð!ð !ð !ð0ð ð ð#ð #ð #ð"'ð 'ð 'ðð ð ð<ð <ð <ð <ð <ð <ð <r   rÈ   c                   óR   ‡ — e Zd ZdZddddœZ	 dZdZdˆ fd	„	Zd
„ Zd„ Z	d„ Z
d„ Zˆ xZ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)rN  Ústylesheet_path)rN  Útemplate)Úpep_stylesheetÚpep_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        dt          d¬¦  «         g }t          |t          ¦  «        r|g}|D ]”}	 |t          ¦   «                              |d¬¦  «        z  }n9# t          $ r, t          j	         
                    | j        ||fz  ¦  «         Y Œ_w xY wd| v r|                      |¦  «         |�|                      ||¦  «         Œ•|S )Nzbfrontend.ConfigParser.read(): parameter "option_parser" will be removed in Docutils 0.21 or later.r   r“   ró   )r1   Úoptions)r–   r—   r˜   r5   Ústrr™   r,  ÚUnicodeDecodeErrorrD  rE  ÚwriteÚnot_utf8_errorÚhandle_old_configÚvalidate_settings)r�   Ú	filenamesr%   Úread_okr)  rž   s        €r   r,  zConfigParser.readH  s  ø€ ð Ð$ÝŒMð 7õ -¸ð<ñ <ô <ð <ð ˆÝ�i¥Ñ%Ô%ð 	$Ø"˜ˆIØ!ð 
	@ð 
	@ˆHðØ�5™7œ7Ÿ<š<¨¸7˜<ÑCÔCÑC��øÝ%ð ð ð Ý”
× Ò  Ô!4¸À(Ð7KÑ!KÑLÔLÐLØ�ðøøøð ˜DÐ Ð Ø×&Ò& xÑ0Ô0Ð0ØÐ(Ø×&Ò& x°Ñ?Ô?Ð?øØˆs   ¿&A&Á&3BÂBc                 ó  — t          j        | j        t          |d¦  «         |                      d¦  «        }|                      d¦  «        s|                      d¦  «         |                     ¦   «         D ]z\  }}|| j        v r;| j        |         \  }}|                      |¦  «        s|                      |¦  «         nd}|}|  	                    ||¦  «        s|  
                    |||¦  «         Œ{|                      d¦  «         d S )Nr   rV  r   )r–   Úwarn_explicitÚold_warningÚConfigDeprecationWarningÚget_sectionr/  Úadd_sectionr
   Úold_settingsÚ
has_optionr0   Úremove_section)r�   r)  rV  r   r   r3  r$   s          r   r[  zConfigParser.handle_old_config`  s  € ÝÔ˜tÔ/Õ1IØ'¨ñ	,ô 	,ð 	,à×"Ò" 9Ñ-Ô-ˆØ×Ò 	Ñ*Ô*ð 	(Ø×Ò˜YÑ'Ô'Ð'Ø!Ÿ-š-™/œ/ð 		2ð 		2‰JˆC�Ø�dÔ'Ð'Ð'Ø#'Ô#4°SÔ#9Ñ �˜Ø×'Ò'¨Ñ0Ô0ð .Ø×$Ò$ WÑ-Ô-Ð-øà#�Ø�Ø—?’? 7¨GÑ4Ô4ð 2Ø—’˜ '¨5Ñ1Ô1Ð1øØ×Ò˜IÑ&Ô&Ð&Ð&Ð&r   c                 ó  — |                       ¦   «         D ]ö}|                      |¦  «        D ]Þ}	 |                     |¦  «        }n# t          $ r Y Œ%w xY w|j        r‹|                      ||¦  «        }	 |                     |||| |¬¦  «        }nB# t          $ r5}t          d|› d|› dt          j	        |¦  «        › d|› d|› �
¦  «        ‚d}~ww xY w|  
                    |||¦  «         |j        r|  
                    ||j        d¦  «         ŒßŒ÷dS )zi
        Call the validator function and implement overrides on all applicable
        settings.
        )r&   r'   zError in config file "z", section "[z]":
    z	
        z = N)ÚsectionsrV  rB  r:   rº   r  rÀ   r   r   rÃ   r0   r»   )	r�   r)  r%   r3  r$   r   r   rÅ   r   s	            r   r\  zConfigParser.validate_settingsr  s¤  € ð
 —}’}‘”ð 	>ð 	>ˆGØŸ<š<¨Ñ0Ô0ð >ð >�ðØ*×=Ò=¸gÑFÔF�F�FøÝð ð ð Ø�HðøøøàÔ#ð :Ø ŸHšH W¨gÑ6Ô6�EðIØ$*×$4Ò$4Ø# U¨MØ*.¸wð %5ñ %Hô %H˜	˜	øõ %ð Ið Ið IÝ(ð *HÀ(ð *Hð *HØ6=ð*Hð *Hå02´ÀÑ0DÔ0Dð*Hð *Hð 5<ð*Hð *Hð AFð*Hð *Hñ Iô Ið IøøøøðIøøøð
 —H’H˜W g¨yÑ9Ô9Ð9ØÔ#ð >Ø—H’H˜W fÔ&6¸Ñ=Ô=Ð=øð%>ð	>ð 	>s)   ¯AÁ
AÁAÁ3BÂ
CÂ0CÃCc                 óR   — |                      ¦   «                              dd¦  «        S )z
        Lowercase and transform '-' to '_'.

        So the cmdline form of option names can be used in config files.
        r‚   rƒ   )r9   r…   )r�   Ú	optionstrs     r   ÚoptionxformzConfigParser.optionxformŒ  s$   € ð �ŠÑ Ô ×(Ò(¨¨cÑ2Ô2Ð2r   c                 óŠ   — t          j        dt          d¬¦  «         	 t          | |         ¦  «        S # t          $ r i cY S w xY 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�   r3  s     r   rc  zConfigParser.get_section”  sc   € õ 	Œð Cå(°Qð	8ñ 	8ô 	8ð 	8ð	Ý˜˜WœÑ&Ô&Ð&øÝð 	ð 	ð 	ØˆIˆIˆIð	øøøs   ž3 ³AÁArW   )r²   r³   r´   rµ   re  ra  rZ  r,  r[  r\  rl  rc  r¶   r·   s   @r   r+  r+  '  s°   ø€ € € € € ð
ð 
ð <ØEØ7ð9ð 9€Lðð
	4ð ð€Nð
ð ð ð ð ð ð0'ð 'ð 'ð$>ð >ð >ð43ð 3ð 3ðð ð ð ð ð ð r   r+  c                   ó   — e Zd ZdZdS )rb  z3Warning for deprecated configuration file features.N)r²   r³   r´   rµ   rr   r   r   rb  rb  ¦  s   € € € € € Ø=Ð=Ð=Ð=r   rb  c                  óÔ   — t          j        ¦   «         5  t          j        dt          ¬¦  «         t	          | ¦  «                             ¦   «         cddd¦  «         S # 1 swxY w Y   dS )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_settingsrp  ª  s¥   € õ 
Ô	 Ñ	"Ô	"ð =ð =ÝÔ Õ3EÐFÑFÔFÐFÝ˜JÑ'Ô'×:Ò:Ñ<Ô<ð=ð =ð =ð =ñ =ô =ð =ð =ð =ð =ð =ð =øøøð =ð =ð =ð =ð =ð =s   ”<AÁA!Á$A!)NNrW   )(rµ   Ú__docformat__r    ÚconfigparserrÁ   r   rv   Úos.pathrD  r–   r\   r   r   r   r   r(   r+   r3   r;   r=   r@   rD   rJ   rQ   rU   rZ   ra   ro   rz   rs   r�   r‘   r¹   rÈ   ÚSettingsSpecÚRawConfigParserr+  ÚFutureWarningrb  rp  rr   r   r   ú<module>rw     sK  ðð
.ð .ð` #€ð €€€Ø Ð Ð Ð Ø €€€Ø "Ð "Ð "Ð "Ð "Ð "Ø 	€	€	€	Ø €€€Ø 
€
€
€
Ø €€€à €€€Ø Ð Ð Ð Ð Ð Ð Ð ð
+ð 
+ð 
+ð/ð /ð /ð :>ðð ð ð ð HLð
ð 
ð 
ð 
ð GKðð ð ð ð0 9=ðAð Að Að Að 9=ðð ð ð ð  AEðð ð ð ð ;?ð@ð @ð @ð @ð GKðð ð ð ð FJðð ð ð ð" GKðð ð ð ð AEð*ð *ð *ð *ð =Aðð ð ð ð EIð!ð !ð !ð !ðH"ð "ð "ð "ð(:ð :ð :ðð ð ð:)#ð )#ð )#ð )#ð )#ˆXŒ_ñ )#ô )#ð )#ðX"ð "ð "ð "ð "ˆXŒ_ñ "ô "ð "ðJD<ð D<ð D<ð D<ð D<�8Ô(¨(Ô*?ñ D<ô D<ð D<ðN|ð |ð |ð |ð |�<Ô/ñ |ô |ð |ð~>ð >ð >ð >ð >˜}ñ >ô >ð >ð=ð =ð =ð =ð =r   