\c@sdZddlZddlZddlZddlZddlmZddlmZm Z ddl m Z m Z m Z ddlmZmZmZmZmZmZmZmZddlmZddlmZmZdd lmZmZdd lm Z dd l!m"Z"dd l#m$Z$dd l%m&Z&m'Z'e(rddl m Z m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m Z ddl/m0Z0ddl1m2Z2ne j3e4Z5dZ6eej7ej8fZ9ej:dZ;ere<Z=ne dde<fde fde e>e=ffgZ?dZ@deAfdYZBegZCerReCjDendeAfdYZEdZFdZGdZHdZId ZJd!ZKd"ZLdS(#s sphinx.config ~~~~~~~~~~~~~ Build configuration file handling. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. iN(t OrderedDict(tpathtgetenv(tAnyt NamedTupletUnion(tPY2tPY3t iteritemst string_typest binary_typet text_typet integer_typest class_types(tRemovedInSphinx30Warning(t ConfigErrortExtensionError(t_t__(tlogging(t format_date(tcd(t execfile_tNoneType(RtCallabletDictt GeneratortIteratortListtTupleR(tSphinx(tTagssconf.pys^((\d{4}-)?)(\d{4})(?=[ ,])t ConfigValuetnametvaluetrebuildcCst|trtSt|tr`xgt|D]*\}}t| sUt| r/tSq/Wn,t|tttfrt d|DSt S(s'Check if object is serializable or not.css|]}t|VqdS(N(tis_serializable(t.0ti((s,lib/python2.7/site-packages/sphinx/config.pys >s( t isinstancetUNSERIALIZABLE_TYPEStFalsetdictRR$tlistttupletsettalltTrue(tobjtkeyR"((s,lib/python2.7/site-packages/sphinx/config.pyR$4s tENUMcBs eZdZdZdZRS(srepresents the config value should be a one of candidates. Example: app.add_config_value('latex_show_urls', 'no', None, ENUM('no', 'footnote', 'inline')) cGs ||_dS(N(t candidates(tselfR3((s,lib/python2.7/site-packages/sphinx/config.pyt__init__Iscs@t|ttfr/tfd|DS|jkSdS(Nc3s|]}|jkVqdS(N(R3(R%titem(R4(s,lib/python2.7/site-packages/sphinx/config.pys Ps(R'R+R,R.R3(R4R"((R4s,lib/python2.7/site-packages/sphinx/config.pytmatchMs(t__name__t __module__t__doc__R5R7(((s,lib/python2.7/site-packages/sphinx/config.pyR2Cs tConfigccBseZdZedddgfdddgfdddgfd ddgfd ddgfd ddgfd dVdefd dVdefddgdgfdddegfdddgfdidd6defdddgfdidgfdgdgfddVdefdedgfdedgfde dgfde dgfd dVdefd!d"dgfd#idgfd$gdgfd%dVdefd&e dgfd'gdgfd(gdgfd)dVdefd*dVdefd+edgfd,d-de gfd.dVdVefd/idVgfd0dVdgfd1e dVgfd2gdVgfd3e dgfd4d5dgfd6idgfd7e dgfd8dVdefd9edgfd:edgfd;dVdgfd<edgfd=d>dgfd?id@gdA6dBdCgdD6dgf0Z dEZ e dVdVdFZdGZdHZdIZdJZdKZdLZdMZdNZdOZdPZdQZdRZdSZdTZdUZRS(WsConfiguration file abstraction. The config object makes the values of all config values available as attributes. It is exposed via the :py:attr:`sphinx.application.Application.config` and :py:attr:`sphinx.environment.Environment.config` attributes. For example, to get the value of :confval:`language`, use either ``app.config.language`` or ``env.config.language``. tprojecttPythontenvtauthortunknownt copyrighttthtmltversiontreleasettodayt today_fmttlanguaget locale_dirstlocalestfigure_language_filenameu{root}.{language}{ext}t master_doctcontentst source_suffixtrestructuredtexts.rsttsource_encodings utf-8-sigtsource_parserstexclude_patternst default_roletadd_function_parenthesestadd_module_namesttrim_footnote_reference_spacet show_authorstpygments_stylethighlight_languagetdefaultthighlight_optionsttemplates_pathttemplate_bridget keep_warningstsuppress_warningstmodindex_common_prefixt rst_epilogt rst_prologttrim_doctest_flagstprimary_domaintpyt needs_sphinxtneeds_extensionst manpages_urltnitpickytnitpick_ignoretnumfigtnumfig_secnum_depthit numfig_formattmath_number_alltmath_eqref_formatt math_numfigt tls_verifyt tls_cacertst smartquotestsmartquotes_actiontqDetsmartquotes_excludestjat languagestmanttexttbuilderscGskt|dkrmtjdtdd|\}}}}|dkrOi}qttj|||}nXt|dkrii}}n6t|dkr|di}}n|d \}}||_t j j |_ ||_ |jdd|_d|krRt|dtr<|jdjd |dGs(R'R (R4R#((R#s,lib/python2.7/site-packages/sphinx/config.pytfilterCs cCsi}xFt|jD]5\}}|jdsKt| rAq|||%ss%YN(RAR(RRRtcopyright_year_retsub(RRtktreplace((s,lib/python2.7/site-packages/sphinx/config.pytcorrect_copyright_years   c Cs x|D]}|j|j\}}}t|drD||}n|d kr]| r]qn|tkrlqt|tr|j|jst d}t j |j d|jd|jd|j qqt|jt|krqnt|j|kr qntt|jjt|jftt|j@}|jt|r]qn|rt d}t j |j d|jdt|jdtg|D]}|j^qqt d}t j |j d|jdt|jd t|qWd S( scheck all values for deviation from the default value's type, since that can result in TypeErrors all over the place NB. RsTThe config value `{name}` has to be a one of {candidates}, but `{current}` is given.R!tcurrentR3sQThe config value `{name}' has type `{current.__name__}', expected to {permitted}.t permittedsZThe config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.RZN(RR!RRRR'R2R7R"RRRtformatR3ttypeR-t __bases__tdiscardtobjectRR8( RRtconfvalRZR#t annotationsRt common_basestc((s,lib/python2.7/site-packages/sphinx/config.pyRs@    %  ) cCsmtjd}xWt|jD]F\}}t|tr|j|rtjt d|dqqWdS(scheck all string values for non-ASCII characters in bytestrings, since that can result in UnicodeErrors all over the place s [\x80-\xff]sthe config value %r is set to a string with non-ASCII characters; this can lead to Unicode errors occurring. Please use Unicode strings, e.g. %r.uContentN( tretcompileRRR'R tsearchRRR(Rt nonascii_reR!R"((s,lib/python2.7/site-packages/sphinx/config.pyRs cCsY|jdt|jdt|jdt|jdtidd6td6td6S(Ns config-initedtbuiltinRDtparallel_read_safetparallel_write_safe(tconnectRRRRR/(R((s,lib/python2.7/site-packages/sphinx/config.pyR}s(MR:RRRRt collectionsRtosRRttypingRRRtsixRRRR R R R R tsphinx.deprecationRt sphinx.errorsRRt sphinx.localeRRt sphinx.utilRtsphinx.util.i18nRtsphinx.util.osutilRtsphinx.util.pycompatRRR)RRRRRRtsphinx.applicationRtsphinx.util.tagsRt getLoggerR8RRt ModuleTypet FunctionTypeR(RRRtunicodetboolR R$RR2RtappendR;RRRRRRR}(((s,lib/python2.7/site-packages/sphinx/config.pyt sT    ::        1