Ë ’^Ð|x÷ãóä—dZdZddlZddlZddlZddlmZddlZddlZddlZddl Z ddl Z ddl 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„Zd$d„Zd„Zd„ZGd„dej>«ZGd„dej@«Z Gd„dejBe jD«Z!Gd„dejF«Z$Gd „d!e%«Z&d"„Z'y)%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«Œ|j«D]\}}t|j||«Œy)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 ú6/usr/lib/python3.12/site-packages/docutils/frontend.pyÚstore_multiplerEsB€óˆ Ü�— ‘ ˜y¨$Õ/ðà—l‘l–n‰ ˆˆUÜ�— ‘ ˜s EÕ*ñ%ócó®— |j|«}|jj |«y#t$r}|j|«Yd}~Œô +ñ Ø × Ñ ˜n¨gÐ8HÑ.HØ%õ 'ô �M×(Ñ(¨'Ð4DÑ*DÀgÕ NàˆÜ�g˜x¨Ø# ^ô5à €Orcó´—t|t«r|S |j|j«j «S#t $rt d|z«‚wxYw)z|Check/normalize boolean settings: True: '1', 'on', 'yes', 'true' False: '0', 'off', 'no','false', '' zunknown boolean value: "%s")Ú isinstanceÚboolÚbooleansÚstripÚlowerÚKeyErrorr#r$s rÚvalidate_booleanr<�s[€ô �%œÔ؈ ðAØ×%Ñ% e§k¡k£m×&9Ñ&9Ó&;Ñ<Ð<øÜ òAÜÐ7¸%Ñ?Ó@Ð@ðAús ”*?¿Acó¤—t|t«s|€|S |j|j«j «S#t $r|cYSwxYw)zªCheck/normalize three-value settings: True: '1', 'on', 'yes', 'true' False: '0', 'off', 'no','false', '' any other value: returned as-is. )r6r7r8r9r:r;r$s rÚvalidate_ternaryr>›sP€ô�%œÔ % -؈ ðØ×%Ñ% e§k¡k£m×&9Ñ&9Ó&;Ñ<Ð<øÜ òØŠ ðús–*AÁ AÁAcó<—t|«}|dkr td«‚|S)Nrz(negative value; must be positive or zero)Úintrr$s rÚvalidate_nonnegative_intrAªs#€ä �‹J€EØ ˆq‚yÜÐCÓDÐDØ €Lrcó¶— t|«S#t$rB |j|j«cYS#tt f$rt d|z«‚wxYwwxYw)Nzunknown threshold: %r.)r@rÚ thresholdsr:r;ÚAttributeErrorr#r$s rÚvalidate_thresholdrE²sg€ð@Ü�5‹zÐøÜ ò@ð @Ø ×+Ñ+¨E¯K©K«MÑ:Ò :øÜœ.Ð)ò @ÜÐ6¸Ñ>Ó?Ð ?ð @úð@ús‚ � A—6³A¶AÁAcó¬—t|t«s|jd«}|S|j«}|j |jd««|S)Nr.)r6Úlistr0ÚpopÚextend)r%r r&r'r(Úlasts rÚ$validate_colon_separated_string_listrK½sG€ä �eœTÔ "Ø— ‘ ˜CÓ ˆð €Lð�y‰y‹{ˆØ � ‰ �T—Z‘Z “_Ô%Ø €Lrcóö—t|t«s|g}|j«}|jd«D�cgc]%}|j d«sŒ|j d«‘Œ'}}|j |«|Scc}w)zHCheck/normalize list arguments (split at "," and strip whitespace). Ú,z )r6rGrHr0r9rI)r%r r&r'r(rJÚir s rÚvalidate_comma_separated_listrOÇsi€ô �eœTÔ "Ø�ˆð �9‰9‹;€DØ'+§z¡z°#¤Ó K¡ !¸!¿'¹'À'Õ:JˆQ�W‰W�WÕ  €EÐ KØ ‡L�L�ÔØ €Lùò Ls ·A6ÁA6có8—|sy|jd«r|S|dzS)Nz./Ú/)Úendswithr$s rÚvalidate_url_trailing_slashrS×s#€á ØØ �‰˜Ô ؈ à�s‰{Ðrcóv— tj|«S#t$rtjd«cYSwxYw©N)rÚDependencyListÚOSErrorr$s rÚvalidate_dependency_filerXás8€ð*Ü×#Ñ# EÓ*Ð*øÜ ò*ä×#Ñ# DÓ)Ò)ð*ús ‚—8·8cóž—t|||||«}|D]8}tjj|«}||k7sŒ(t d|›d|›d�«‚|S)NzInvalid class value z (perhaps z?))rOÚdocutilsÚnodesÚmake_idr)r%r r&r'r(ÚclsÚ normalizeds rÚvalidate_strip_classr_ês`€ô *¨'°5¸-Ø*7¸ó I€EóˆÜ—^‘^×+Ñ+¨CÓ0ˆ Ø �*Ó ÝÚ #¢Zð1ó2ð 2ðð €Lrc óЗt|||||«}g}|D]‰} |jdd«\}}|j «}|jd«} t| «dk(r| }n,t|«dk7rt d|j dd«z«‚|j||f«Œ‹|S#t$r|j|«YŒªt$rt d|j dd«z«‚wxYw)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 ":".ÚasciiÚbackslashreplaceéz[Invalid value "%s". Please specify 4 quotes (primary open/close; secondary open/close).)rOr0rDÚappendrÚencoder9Úlen) r%r r&r'r(Ú lc_quotesÚitemÚlangÚquotesÚmultichar_quotess rÚvalidate_smartquotes_localesrmøs€ô *¨'°5¸-Ø*7¸ó I€Eð€IÛˆð IØŸ:™: c¨1Ó-‰LˆD�&ð—‘“ˆØ!Ÿ<™<¨Ó,ÐÜ ÐÓ  AÒ %Ø%‰FÜ �‹[˜AÒ ÜðOà#Ÿ{™{¨7Ð4FÓGñHóIð Ið ×ј$ ˜Õ(ð+ð, Ðøô'ò ð × Ñ ˜TÔ "Ù Üò IÜðAà#Ÿ{™{¨7Ð4FÓGñHóIð Ið Iús˜B"Â"C%Â>'C%cóÖ—|€tj«}|D]I}||vsŒ||}t|t«r|D�cgc]}t ||«‘Œ}}n|r t ||«}|||<ŒKycc}w)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`. N)ÚosÚgetcwdr6rGÚmake_one_path_absolute)ÚpathdictÚkeysÚ base_pathrr Úpaths rÚmake_paths_absolutervs}€ðÐÜ—I‘I“Kˆ ÛˆØ �(Š?ؘS‘MˆEܘ%¤Ô&á%*ó,Ù%*˜Tô0° ¸4Õ@Ø%*ðñ,áÜ.¨y¸%Ó@�Ø!ˆH�SŠMñùò,sºA&có|—tjjtjj||««SrU)roruÚabspathÚjoin)rtrus rrqrq0s$€Ü �7‰7�?‰?œ2Ÿ7™7Ÿ<™<¨ °4Ó8Ó 9Ð9rc ó�—t|«}tdt|«d«D]“}g}||D]y}|dD�cgc](}|jd«r|ddj dd«‘Œ*c}d}||vrŒB||j «vr|j ||«Œi|j |«Œ{t|«||<Œ•t|«Scc}w) 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.) ééraz--NÚ-Ú_r)rGÚrangergÚ startswithÚreplacersreÚtuple) Ú settings_specÚexcluder�ÚsettingsrNÚnewoptsÚopt_specÚ opt_stringÚopt_names rÚfilter_settings_specrŠ4sÜ€ô�MÓ"€Hä �1”c˜(“m QÖ 'ˆØˆØ  œ ˆHð+3°1ª+ó8Ù*5˜JØ%×0Ñ0°Ô6ð# 1 2˜×.Ñ.¨s°CÕ8Ø*5ñ8à89ñ;ˆHð˜7Ñ"ØØ˜7Ÿ<™<›>Ñ)Ø—‘˜w xÑ0Õ1à—‘˜xÕ(ð$ô˜G“nˆ�Š ð(ô �‹?Ðùò8s¶-Ccó4‡—eZdZdZˆfd„Zd„Zd„Zd„ZˆxZS)Ú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󪕗tjdtd¬«t‰|�|i|¤Žt |dd«€t j«|_yy)Nz@frontend.Values class will be removed in Docutils 0.21 or later.r{©Ú stacklevelÚrecord_dependencies) ÚwarningsÚwarnÚDeprecationWarningÚsuperÚ__init__ÚgetattrrrVr�©ÚselfrrÚ __class__s €rr•zValues.__init__ZsSø€Ü� ‰ ð3ä(°Qõ 8ô ‰Ñ˜$Ð) &Ò)Ü �4Ð.°Ó 5Ð =ä',×';Ñ';Ó'=ˆDÕ $ð >rcó —t|t«r |j}t|«}|jj «D].}t ||«sŒ||vsŒt||«}|sŒ$|||z }||=Œ0|j|«yrU) r6rŒÚ__dict__ÚdictÚlistsrsÚhasattrr–Ú _update_loose)r˜Ú other_dictr&r%r s rrz Values.updatecs�€Ü �j¤&Ô )Ø#×,Ñ,ˆJܘ*Ó%ˆ Ø$×*Ñ*×/Ñ/Ö1ˆGÜ�t˜WÕ%¨'°ZÒ*?Ü  gÓ.�ÚØ˜Z¨Ñ0Ñ0�EØ" 7Ñ+ð 2ð ×ј:Õ&rcóÄ—tj«5tjdt¬«|j |j ¬«cddd«S#1swYyxYw)z Return a shallow copy of `self`.Úignore©Úcategory)ÚdefaultsN)r‘Úcatch_warningsÚfilterwarningsr“r™r›)r˜s rÚcopyz Values.copyos=€ä × $Ñ $Õ &Ü × #Ñ # HÔ7IÕ JØ—>‘>¨4¯=©=�>Ó9÷'× &Ò &ús •7AÁAcóN—t||d«€ t|||«t||«S)znReturn ``self.name`` or ``default``. If ``self.name`` is unset, set ``self.name = default``. N)r–r)r˜ÚnameÚdefaults rÚ setdefaultzValues.setdefaultus,€ô �4˜˜tÓ $Ð ,Ü �D˜$ Ô (Ü�t˜TÓ"Ð"r) Ú__name__Ú __module__Ú __qualname__Ú__doc__r•rr¨r¬Ú __classcell__©r™s@rrŒrŒQsø„ñô>ò 'ò:ö #rrŒcób‡—eZdZdZej j ddgzZˆfd„Zˆfd„ZˆxZ S)ÚOptionz`Add validation and override support to `optparse.Option`. Deprecated. Will be removed. Ú validatorÚ overridescó\•—tjdtd¬«t‰|�|i|¤Žy)NzDThe frontend.Option class will be removed in Docutils 0.21 or later.r{rŽ)r‘r’r“r”r•r—s €rr•zOption.__init__‡s-ø€Ü� ‰ ð3ä(°Qõ 8ô ‰Ñ˜$Ð) &Ó)rc ó~•—t‰ |�||||«}|j}|r\|jr-t ||«} |j|||«}t|||«|jrt||jd«|S#t $r3}t jd|›dtj|«›�«‚d}~wwxYw)zœ Call the validator function on applicable settings and evaluate the 'overrides' option. Extends `optparse.Option.process`. zError in option "z": N) r”ÚprocessÚdestrµr–Ú ExceptionÚoptparseÚOptionValueErrorrÚ error_stringrr¶) r˜r r r rÚresultr%Ú new_valuerr™s €rr¹zOption.process�s±ø€ô ‘‘  e¨V°VÓ<ˆØ—)‘)ˆÙ Ø�~Š~Ü ¨Ó0�ð7Ø $§¡¨w¸¸vÓ F�Iô ˜ ¨Ô3Ø�~Š~ܘ §¡°Ô5؈ øô!ò7Ü"×3Ò3⤧¡°Ô 4ð6ó7ð7ûð7ús»B B< .B7Â7B<) r­r®r¯r°r¼r´ÚATTRSr•r¹r±r²s@rr´r´s2ø„ñð �O‰O× !Ñ ! [°+Ð$>Ñ >€Eô*÷ ðrr´c 󨇗eZdZdZgd¢Z dj «Z dddddd œZ d d d d d d d d d d œ Z e e jd d«xse jxsdZdZddgddgddif‘ddgddif‘dddgdedœf‘ddgd d!d"œf‘d#d$d%gd&d'd(d)œf‘d*d+d,gd&d-d(d)œf‘d.d/gd&dd(d)œf‘d0d1d2gdedœf‘d3d4gdd5if‘d6d7gd8ed9d:œf‘d;dd>d?œf‘d@dAgd=d&dBdCœf‘dDdEgd=d dFœf‘dGdHgddedIœf‘dJdKgdLd dFœf‘dMdNgddOdedPœf‘dQdRgd dOd"œf‘dSdTgdedœf‘dUdVgd dWd"œf‘dXdYgdZd[d\ed]œf‘d^d_gdZd`d\ed]œf‘dadbdcgeddddeedfœf‘dgdhdigd&dddd)œf‘djdkdlgd&dddd)œf‘dmdngedoddeedpœf‘dqdrgd&ddod)œf‘dsdtgeduddeedpœf‘dvdwgdedœf‘dxdygd dzd"œf‘d{d|gd}d~dœf‘d€d�gddedIœf‘d‚dƒgd„d dFœf‘d…d†d‡gdˆed‰œf‘dŠd‹gdŒed�œf‘dŽd�d�gdˆd‘ed’œf‘d“d”gdŒed�œf‘d•e›d–e›d—�d˜d™gdˆeed’œf‘dšezd›geed�œf‘dœd�džgdŸd d¡d¢œf‘d£d¤gd~edd¥œf‘d¦d§gd~d¨d8ed©œf‘dªd«d¬gd­d®if‘d¯d°d±gd­d²if‘ed³gd´dµif‘ed¶gd´d·if‘ed¸gd­dif‘ed¹gd­dif‘edºgd­dif‘ed»gd­dif‘ed¼gdZd½ed¾œf‘ed¿gd­dif‘­fZ dddddÀœZ dÁZdÂej<›ej>xrdÃej>zxsdµ›dÄe j@j «dÅ›dÆe jB›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 5rar{r|rdé)ÚinfoÚwarningrÚsevereÚnoneTF) Ú1ÚonÚyesÚtrueÚ0ÚoffÚnoÚfalserr2NrbrczGeneral Docutils OptionszaOutput destination name. Obsoletes the positional argument. Default: None (stdout).z--outputÚmetavarz 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-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-classre���Ú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_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-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-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_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 Ú)c�����������������óh��•—�i�|�_��������� �g�|�_�������� �dg|�_��������t��������j������������������dt ��������d¬«�������t ��������‰|����|t��������dt��������j������������������d¬«������dœ|¤Ž�|�j������������������s|�j������������������|�_ ��������|�g|¢­|�_ ��������|�j������������������|�j������������������«�������|�j������������������j!������������������|xs�i�«�������|rG|�j������������������d ���s7 �|�j#������������������«�������}|�j������������������j!������������������j(������������������«�������yyy#�t$��������$�r}|�j'������������������|«�������Y�d}~ŒGd}~ww�xY�w) 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•���zOptionParser.__init__Œ��s��ø€�ð�ˆŒ Ø(àˆÔØ;à'7Ð&8ˆÔ#ä� ‰ ð�3ô�)°Qõ 8ô� ‰Ñàô�'-¸dÜ#+×#?Ñ#?ÀbÔ#Iñ *à"(ò *ð��|Š|Ø×0Ñ0ˆDŒLØÐ- *Ñ-ˆŒØ ×%Ñ% d§o¡oÔ6Ø � ‰ ×јXš^¨Ô,Ù  T§]¡]Ð3DÒ%Eð Ø"&×"CÑ"CÓ"E�ð� �M‰M× Ñ  ×!9Ñ!9Õ :ð �&FÐ øô�ò� Ø— ‘ ˜3—‘ûð ús���ÃD �Ä D1ÄD,Ä,D1c�����������������óœ��—�|D��] ��}|€Œ|j�������������������}|�j������������������j������������������|j������������������«�������t��������dt ��������|«������d«������D�]º��}|||dz����\��}}}|r)t ��������j ������������������|�||«������}|�j������������������|«�������n|�}|D�]H��\��} } } �|j������������������| d| i| ¤Ž} | j������������������d«������dk(��sŒ0d|�j������������������| j������������������<���ŒJ�|j������������������sŒ–|�j������������������j������������������|j������������������«�������Œ¼��Œ �|D�]7��}|sŒ|j������������������sŒ|�j������������������j������������������|j������������������«�������Œ9�y)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Ó���re���T)rƒ���r��rI���r���rg���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°��sB��€�ô�$ˆIØÐ ØØ%×3Ñ3ˆMØ × 'Ñ '× .Ñ .Ø×0Ñ0ô 2ä˜1œc -Ó0°!Ö4�Ø2?ÀÀ!ÀAÁ#Ð2FÑ/��{ KÙÜ$×0Ñ0°°u¸kÓJ�EØ×)Ñ)¨%Õ0à �EÛ;FÑ7�Y °Ø-˜U×-Ñ-¸~ð�8°9ð�8Ø06ñ8�Fà—z‘z (Ó+¨xÓ7Ø26˜Ÿ ™  6§;¡;Ò/ð �<Gð �×.Ó.Ø—M‘M×(Ñ(¨×)DÑ)DÕEò�5ð �$ó(�$ˆIÚ˜Y×AÓAØ— ‘ ×$Ñ$ Y×%IÑ%IÕJñ�$r���c�����������������ó&��—�dt���������j������������������v�r1t���������j������������������d���j������������������t���������j������������������«������}n |�j������������������}|D��cg�c]2��}|j ������������������«�������sŒt���������j ������������������j������������������|«������‘Œ4�c}S�c�c}w�)z:Return list of config files, from environment or standard.ÚDOCUTILSCONFIG)ro���Úenvironr0���ÚpathsepÚstandard_config_filesr9���ru���Ú expanduser)r]���r��Úfs��� r���Úget_standard_config_filesz&OptionParser.get_standard_config_filesÐ��sh���€�ð� œrŸz™zÑ )ÜŸ:™:Ð&6Ñ7×=Ñ=¼b¿j¹jÓI‰Là×4Ñ4ˆLÙ/;ÓI©|¨!¸q¿w¹w½y”—‘×"Ñ" 1Õ%¨|ÑIÐIùÒIs ���ÁBÁ*!Bc�����������������ó��—�t��������j������������������«�������5��t��������j������������������dt��������¬«�������t ��������«�������}d�d�d�«�������|�j ������������������«�������D�]#��}j ������������������|�j������������������|«������|�«�������Œ%�S�#�1�sw�Y���ŒAxY�w)Nr¢���r£���)r‘���r¦���r§���r“���rŒ���r!��r���r���)r˜���r…���Úfilenames��� r���r ��z)OptionParser.get_standard_config_settingsÙ��sg���€�Ü × $Ñ $Õ &Ü × #Ñ # HÔ7IÕ JÜ“xˆH÷�'ð�×6Ñ6Ö8ˆHØ �O‰O˜D×9Ñ9¸(ÓCÀTÕ Jð�9àˆ÷ �'Ð &ús ���•&A;Á;Bc�����������������óž��—�t��������«�������}t��������«�������}t��������j������������������«�������5��t��������j������������������dt ��������¬«�������|�xj ������������������|j������������������||�«������z ��c_��������t��������«�������}ddd«�������|�j������������������D�]n��}|sŒt��������|j������������������xs�d«������|j������������������fz���D�]?��}||v�rŒ|j������������������|«�������|j������������������|«������sŒ+j������������������||���|�«�������ŒA�Œp�t!��������j"������������������|�j$������������������t&��������j(������������������j+������������������|«������«�������|j"������������������S�#�1�sw�Y���ŒÐxY�w)zAReturns a dictionary containing appropriate config file settings.r¢���r£���N©�)Ú ConfigParserr1���r‘���r¦���r§���r“���r��ÚreadrŒ���r��r‚���Úconfig_section_dependenciesr(���ÚaddÚ has_sectionr���rv���r›���r��ro���ru���Údirname)r˜���Ú config_filer'���Úappliedr…���r��Úsections��� r���r���z%OptionParser.get_config_file_settingsá��s��€�ä$›ˆ ä“%ˆÜ × $Ñ $Õ &Ü × #Ñ # HÔ7IÕ JØ × Ò  ×!3Ñ!3°KÀÓ!FÑ FÕ Ü“xˆH÷�'ð�ŸœˆIÙØÜ! )×"GÑ"GÒ"MÈ2ÓNØ(×7Ñ7Ð9ô:�à˜gÑ%ØØ— ‘ ˜GÔ$Ø ×,Ñ,¨WÕ5Ø—O‘O M°'Ñ$:¸DÕAñ :ð�)ô� ˜H×-Ñ-Ø ×7Ñ7ÜŸG™GŸO™O¨KÓ8ô :ð�× Ñ Ð ÷#�'Ð &ús ���©A EÅE c�����������������ó¤���—�|�j������������������|«������\��|_��������|_��������t��������|j������������������|�j ������������������«�������|�j ������������������|_��������|S�)z/Store positional arguments as runtime settings.)Ú check_argsrø���rù���rv���r›���r��r��rú���)r˜���r ���r���s��� r���Ú check_valueszOptionParser.check_valuesù��sA���€�à.2¯o©o¸dÓ.CÑ+ˆŒ˜Ô+ܘFŸO™O¨T×-HÑ-HÔIØ#×0Ñ0ˆÔ؈ r���c�����������������óÐ���—�d�x}}|r|j������������������d«������}|dk(��rd�}|r|j������������������d«������}|dk(��rd�}|r|�j������������������d«�������|r||k(��r|�j������������������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���r0��zOptionParser.check_args���s}���€�Ø#Ð#ˆ�Ù Ø—X‘X˜a“[ˆFؘŠ}Ø�Ù ØŸ(™( 1›+ˆKؘcÒ!Ø"� Ù Ø �J‰JÐ5Ô 6Ù �f  Ò+Ø �J‰Jð�Hô� Ià�{Ð"Ð"r���c�����������������ó:���—�|�j�������������������j������������������|«�������y�rU���)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«�������|�j ������������������_��������|S�#�1�sw�Y���ŒxY�w)z(Needed to get custom `Values` instances.r¢���r£���N)r‘���r¦���r§���r“���rŒ���r¥���r��rú���r6��s��� r���Úget_default_valueszOptionParser.get_default_values��sP���€�ä × $Ñ $Õ &Ü × #Ñ # HÔ7IÕ JܘdŸm™mÓ,ˆH÷�'ð�"&×!2Ñ!2ˆÔ؈÷ �'Ð &ús ���•1A!Á!A*c�����������������ó”���—�|�j�������������������|�gz���D�](��}|j������������������D�]��}|j������������������|k(��sŒ|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��sO���€�ð�×'Ñ'¨4¨&Ô0ˆEØ×+Ô+�Ø—;‘; $Ó&Ø!”Mñ�,ð�1ô�Ð3°dÑ:Ó;Ð;r���)r%��NF)/r­���r®���r¯���r°���r��r0���Úthreshold_choicesrC���r8���r–���ÚsysÚstderrr���Ú_locale_encodingÚdefault_error_encodingÚ$default_error_encoding_error_handlerr<���r���r_���rE���r4���r,���rX���r���r���rK���rƒ���r��r(���rZ���Ú __version__Ú__version_details__ró���Úplatformr��r•���r��Ú classmethodr!��r ��r���r1��r0��r7��r9��r=��r±���r²���s���@r���rÃ���rÃ���¤��s†��ø„�ñ òÐðð �C×HÑHÓJÐØGਰAÀÈAÑN€JØ@à ¨d¸DÀuØ E°E¸uñF€Hà?á% c§j¡j°*¸dÓCò�)Ø!#×!4Ñ!4ò)à!(ð�ð�,>Ð(ð� #Ø ðe ð� 9à ˆ,˜ OÐ4ð 6ð�e ð� 4Ø ˆ+˜  9Ð-ð /ðe ð � ?Ø ˜$Ð ¨LØ/?ñ"Að Bð e ð� /Ø Ð ¨À ÑLð Nðe ð� ?Ø �TÐ  }¸zØ%0ñ2ð 3ðe ð� +Ø �TÐ  }Ø&:Ø%0ñ2ð 3ðe ð"� 4Ø Ð ¨ÀØ'2ñ4ð 5ð#e ð(� 3Ø ˜DÐ !¨lØ1Añ$Cð Dð)e ð.� @Ø Ð ˜Y¨Ð0ð 2ð/e ð2� :Ø Ð Ø¨^Ø9ñ ;ð <ð3e ð:� AØ "Ð #Ø"¨mÀgØñ ð ð;e ðB� =Ø Ð !Ø"¨mÀeÑ Lð NðCe ðH� 8Ø Ð Ø"¨mÑ <ð >ðIe ðN� CØ !Ð "Ø!¨aØ(ñ *ð +ðOe ðV� <Ø $Ð %Ø'°=Ñ Að CðWe ð\� =Ø Ð !Ø!¨?ØÐ&6ñ 8ð 9ð]e ðd� 3Ø #Ð $Ø"¨OÑ <ð >ðee ðj� <Ø Ð Ø!Ð0@Ñ Að Cðke ðp� CØ Ð Ø"Ð,<Ñ =ð ?ðqe ðv #ð� )Ð )ØÐ'DØÐ.Bñ Dð  Eðwe ðB #ð� Ð Ø ØÐ.Bñ Dð  EðCe ðN Kà �tÐ Ð*;ÈØ'5À)Ø,>ñ@ð AðOe ðX� AØ ˜Ð ¨-À!Ø(6ñ 8ð 9ðYe ð^� @Ø �dÐ ¨ ÀØ&4ñ6ð 7ð_e ðd 9à ˆ*Ð"3¸\Ø"#° Ø$6ñ8ð 9ðee ðn� CØ ˆ, =¸1Ø!-ñ/ð 0ðoe ðt 6à Ð Ð):Ø&9Ø)*°yØ+=ñ?ð @ðue ð@� @Ø ˆ+ ,Ø%5ñ7ð 8ðAe ðF� -Ø ˆ. ]¸GÑDð FðGe ðJ� :Ø ˆ.Ð#3ÀÑIð KðKe ðN� >Ø ˆ/ l¸tØ)9ñ;ð <ðOe ðT� 2Ø Ð  {¸mÑLð NðUe ðX Ià ˜tÐ $Ø(Ø;ñ =ð >ðYe ðb Bà +Ð ,ØÐ-LÑ Mð Oðce ðj ,à  Ð %Ø(°WØ;ñ =ð >ðke ðt 5ð� -Ð -ØÐ-LÑ Mð  Oñue òB�$Ò%Ið Kð� ˜tÐ $Ø(Ð5KØ;ñ =ð  >ðe ðJ (à 0ñ 1ð� ,Ð ,Ø:Ø7ñ 9ð  :ðKe ðV� IØ ˜Ð ¨ÀTØ,4ñ!6ð 7ðWe ð\� 6Ø "Ð #ØÐ-EØñ ð ð]e ðd� CØ ˆ, H°hØ#-Ð;KñMð Nðee ðj� 9Ø ˜Ð  ¨)Ð4ð 6ðke ðn� -Ø �TÐ ˜X vÐ.ð 0ðoe ðt� ˜-˜¨9°b¨/Ð :ðue ðv� Ð,Ð-° ¸3Ð/?Ð @ðwe ðz� Ð+Ð,¨x¸Ð.FÐ Gð{e ð|� Ð,Ð-°¸,Ð/GÐ Hð}e ð~� Ð-Ð.°¸<Ð0HÐ Iðe ð@� Ð-Ð.°¸<Ð0HÐ IðAe ðB� Ð7Ð8ØÐ'9Ø<ñ >ð ?ðCe ðH� Ð,Ð-°¸,Ð/GÐ HñIe ðh €MðR0ð�-1Ø$(Ø)-Ø*.ñ0Ððð ��Nð�$×/Ò/Ø#×7Ñ7ò�DØ& x×'CÑ'CÑCòJØGIñJàŸ;™;×,Ñ,Ó.¨qÓ1°3·<³<ð AÐð �#õ";òHKð@�ñJó�ðJòò!ò0ò#ò"'òö<r���rÃ���c�������������������óR���‡�—�e�Zd�ZdZddddœZ �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)rI��Ústylesheet_path)rI��Ú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. c�����������������ót��•—�|�t��������j������������������dt��������d¬«�������g�}t��������|t��������«������r|g}|D�]A��} �|t ��������‰|����|d¬«������z ��}d|�v�r|�j������������������|«�������|€Œ0|�j������������������||«�������ŒC�|S�#�t��������$�r1�t��������j������������������j������������������|�j������������������||fz��«�������Y�Œw�xY�w)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'��ÚUnicodeDecodeErrorr?��r@��ÚwriteÚnot_utf8_errorÚhandle_old_configÚvalidate_settings)r˜���Ú filenamesr&���Úread_okr#��r™���s��� €r���r'��zConfigParser.readO��sÌ���ø€�ð� Ð $Ü �M‰Mð�7ô�-¸õ <ð�ˆÜ �i¤Ô %Ø"˜ ˆIÛ!ˆHð Øœ5™7™<¨¸7˜<ÓCÑC�ð�˜DÑ Ø×&Ñ& xÔ0ØÑ(Ø×&Ñ& x°Õ?ð�"ð�ˆøô�&ò� Ü— ‘ × Ñ  ×!4Ñ!4¸À(Ð7KÑ!KÔLÙð ús���»A=Á=7B7Â6B7c�����������������óâ��—�t��������j������������������|�j������������������t��������|d«�������|�j ������������������d«������}|�j ������������������d«������s|�j ������������������d«�������|j������������������«�������D�]r��\��}}||�j������������������v�r5|�j������������������|���\��}}|�j ������������������|«������s|�j ������������������|«�������nd}|}|�j������������������||«������rŒ`|�j������������������|||«�������Œt�|�j������������������d«�������y�)Nr���rQ��rû���) r‘���Ú warn_explicitÚ old_warningÚConfigDeprecationWarningÚ get_sectionr*��Ú add_sectionr ���Ú old_settingsÚ has_optionr1���Úremove_section)r˜���r#��rQ��r���r ���r.��r%���s��� r���rV��zConfigParser.handle_old_configg��s×���€�Ü×јt×/Ñ/Ô1IØ'¨ô ,à×"Ñ" 9Ó-ˆØ×Ñ  Ô*Ø × Ñ ˜YÔ 'Ø!Ÿ-™-ž/‰JˆC�Ø�d×'Ñ'Ñ'Ø#'×#4Ñ#4°SÑ#9Ñ �˜Ø×'Ñ'¨Ô0Ø×$Ñ$ WÕ-à#�Ø�Ø—?‘? 7¨GÕ4Ø—‘˜ '¨5Õ1ð�*ð� ×јIÕ&r���c�����������������óü��—�|�j������������������«�������D�]œ��}|�j������������������|«������D�]†��} �|j������������������|«������}|j������������������r<|�j ������������������||«������} �|j ������������������||||�|¬«������}|�j������������������|||«�������|j������������������sŒj|�j������������������||j������������������d«�������Œˆ�Œž�y#�t��������$�r�Y�Œ—w�xY�w#�t ��������$�r2}t��������d|›�d|›�dt��������j������������������|«������›�d|›�d|›�� «������‚d}~ww�xY�w)zi Call the validator function and implement overrides on all applicable settings. )r'���r(���zError in config file "z ", section "[z]": z z = N) ÚsectionsrQ��r=��r;���rµ���r��r»���r���r���r¾���r1���r¶���) r˜���r#��r&���r.��r%���r ���r ���rÀ���r���s ��� r���rW��zConfigParser.validate_settingsy��s#��€�ð �—}‘}–ˆGØŸ<™<¨Ö0�ðØ*×=Ñ=¸gÓF�Fð�×#Ò#Ø ŸH™H W¨gÓ6�EðIØ$*×$4Ñ$4Ø# U¨MØ*.¸wð�%5ó�%H˜ ð�—H‘H˜W g¨yÔ9Ø×#Ó#Ø—H‘H˜W f×&6Ñ&6¸Õ=ñ%�1ñ�'øô� ò�Ùðûô�%ò�IÜ(Ð+AÀ(Àð�L6Ø6=°Yð�?0Ü02·±ÀÓ0DÐ/Eð�F4Ø4;°9¸CÀ¸wð*Hó�Ið�IûðIús)���©B1ÁC�Â1 B=Â<B=Ã� C;à -C6Ã6C;c�����������������óB���—�|j������������������«�������j������������������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���€�ð ��‰Ó ×(Ñ(¨¨cÓ2Ð2r���c�����������������óz���—�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˜���r.��s��� r���r^��zConfigParser.get_section›��sC���€�ô� � ‰ ð�Cä(°Qõ 8ð ܘ˜W™ Ó&Ð &øÜò� ØŠIð ús ���ž ,�¬ :¹:rU���) r­���r®���r¯���r°���r`��r\��rU��r'��rV��rW��rg��r^��r±���r²���s���@r���r&��r&��.��sI���ø„�ñ ð�<ØEØ7ñ9€Lðð  4ð�ð€Nõ ò0'ò$>ò43ör���r&��c�������������������ó���—�e�Zd�ZdZy)r]��z3Warning for deprecated configuration file features.N)r­���r®���r¯���r°���r%��r���r���r]��r]��­��s���„�Ú=r���r]��c������������������ó¾���—�t��������j������������������«�������5��t��������j������������������dt��������¬«�������t ��������|�«������j ������������������«�������cddd«�������S�#�1�sw�Y���yxY�w)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Ã���r9��)r��s��� r���Úget_default_settingsrk��±��s>���€�ô� × Ñ Õ "Ü×Ñ Ô3EÕFܘJÓ'×:Ñ:Ó<÷� #× "Ò "ús ���•4AÁA)NNrU���)(r°���Ú __docformat__r!���Ú configparserr¼���r���ro���Úos.pathr?��r‘���rZ���r���r���r���r���r)���r,���r4���r<���r>���rA���rE���rK���rO���rS���rX���r_���rm���rv���rq���rŠ���rŒ���r´���rÃ���Ú SettingsSpecÚRawConfigParserr&��Ú FutureWarningr]��rk��r%��r���r���Ú<module>rr�����sF��ðñ .ð`�#€ ó�Û�Û�Ý�"Û� Û�Û� Û�ã�ß�ò +ò/ð�:>ó ð�HLó ð�GKóð0�9=ó Að�9=ó ð �AEóð�;?ó@ð�GKóð�FJó ð"�GKóð�AEó*ð�=Aó ð�EIó!óH"ò(:òô:+#ˆX�_‰_ô�+#ô\"ˆX�_‰_ô�"ôJG<�8×(Ñ(¨(×*?Ñ*?ô�G<ôT |�<×/Ñ/ô�|ô~>˜}ô�>ó =r���