o Ni9 @sdZdZddlZddlZddlmZddlmZmZddl m Z m Z ddl m Zidd d d d d ddddddddddddddddddd d!d"d#d$d%d&d'd(d)id*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdU Z iZ dVdWZdXdYZdZd[Zd\d]Zd^d_Zd`daZdbdcZdddeZdfdgZgdhZdidjZdkdlZddndoZdpdqZedrej Z!dsdtZ"dudvZ#dwdxZ$dydzZ%d{d|Z&d}d~Z'ddZ(ddZ)ddZ*ddZ+dS)z9 This package contains directive implementation modules. reStructuredTextN) import_module)nodesparsers)split_escaped_whitespace escape2null)en attention) admonitions Attentioncaution)r Cautioncode)body CodeBlockdanger)r Dangererror)r Error important)r Importantnote)r Notetip)r Tiphint)r Hintwarning)r Warning admonition)r Admonitionsidebar)rSidebartopic)rTopicz line-block)r LineBlockzparsed-literal)r ParsedLiteralmath)r MathBlockrubric)rRubricepigraph)rEpigraph highlights)r Highlightsz pull-quote)r PullQuotecompound)rCompound container)r Containertable)tablesRSTTablez csv-table)r5CSVTablez list-table)r5 ListTableimage)imagesImagefigure)r:Figurecontents)partsContentssectnum)r?Sectnumheader)r?Headerfooter)r?Footerz target-notes) references TargetNotesmeta)miscMetaraw)rJRaw)rJInclude)rJReplace)rJUnicode)rJClass)rJRole)rJ DefaultRole)rJTitle)rJDate)rJ TestDirective) includereplaceunicodeclassrolez default-roletitledatezrestructuredtext-test-directivec Cs|}g}g}|tvrt||fSd}z|j|}Wn-ty6}z|d||fWYd}~nd}~wtyH|d||jfYnw|slztj|}|d|Wntyk|d||}Ynw|r|jj d ||j d}||zt |\} } Wn tyd|fYSwzt d| } Wn'ty} z||jjd | || f|j dd|fWYd} ~ Sd} ~ wwzt| | } | t|<W| |fSty||jjd | | |f|j dd|fYSw) z Locate and return a directive function from its language-dependent name. If not found in the current language, check English. Return None if the named directive cannot be found. Nz?Problem retrieving directive entry from language module %r: %s.z+No directive entry for "%s" in module "%s".z*Using English fallback for directive "%s".z(Trying "%s" as canonical directive name. )linez docutils.parsers.rst.directives.z:Error importing directive module "%s" (directive "%s"): %sz8No directive class "%s" in module "%s" (directive "%s").)lower _directives directivesAttributeErrorappendKeyError__name___fallback_language_modulereporterinfojoin current_line_directive_registryr ImportErrorrgetattr)directive_namelanguage_moduledocumentnormnamemessagesmsg_text canonicalnamermessage modulename classnamemoduledetail directiver|\/home/ubuntu/.local/lib/python3.10/site-packages/docutils/parsers/rst/directives/__init__.pyr{Ms              r{cCs |t|<dS)z Register a nonstandard application-defined directive function. Language lookups are not needed for such functions. N)ra)namer{r|r|r}register_directives rcCs|r |r td|dS)z Check for a valid flag option (no argument) and return ``None``. (Directive option conversion function.) Raise ``ValueError`` if an argument is found. z%no argument is allowed; "%s" suppliedN)strip ValueErrorargumentr|r|r}flags  rcCs|durtd|S)z Return the argument text, unchanged. (Directive option conversion function.) Raise ``ValueError`` if no argument is found. N#argument required but none supplied)rrr|r|r}unchanged_requiredsrcCs|durdS|S)z Return the argument text, unchanged. (Directive option conversion function.) No argument implies empty string (""). Nr|rr|r|r} unchangedsrcCs(|durtdddd|DS)z Return the path argument unwrapped (with newlines removed). (Directive option conversion function.) Raise ``ValueError`` if no argument is found. Nrrcss|]}|VqdSN)r.0sr|r|r} zpath..)rrj splitlinesrr|r|r}pathsrcCs0|durtdtt|}ddd|DS)z Return the URI argument with unescaped whitespace removed. (Directive option conversion function.) Raise ``ValueError`` if no argument is found. Nr css$|] }dt|VqdS)rN)rjrunescapesplit)rpartr|r|r}rszuri..)rrrrj)rr?r|r|r}uris   rcCt|}|dkr td|S)z| Check for a nonnegative integer argument; raise ``ValueError`` if not. (Directive option conversion function.) rz(negative value; must be positive or zerointrrvaluer|r|r}nonnegative_intrcCs.z |d}Wt|StyYt|Sw)zw Check for an integer percentage value with optional percent sign. (Directive option conversion function.) z %)rstriprcrrr|r|r} percentages  r)emexpxincmmmptpcc Csltdd||}z t|dWnttfy+tdddd|Dw|d|dS) a Check for a positive argument of one of the units and return a normalized string of the form "" (without space in between). (Directive option conversion function.) To be called from directive option conversion functions. z^([0-9.]+) *(%s)$|z8not a positive measure of one of the following units: %srcs|]}d|VqdSz"%s"Nr|)rir|r|r}rrzget_measure..)rematchrjfloatgrouprcr)runitsrr|r|r} get_measures rcCst|tdgS)Nr)r length_unitsrr|r|r}length_or_unitlesssrrc Cs`z t|tdgWSty/z t|dg|WYSty.t|tdgYYSww)a Return normalized string of a length or percentage unit. (Directive option conversion function.) Add if there is no unit. Raise ValueError if the argument is not a positive measure of one of the valid CSS units (or without unit). >>> length_or_percentage_or_unitless('3 pt') '3pt' >>> length_or_percentage_or_unitless('3%', 'em') '3%' >>> length_or_percentage_or_unitless('3') '3' >>> length_or_percentage_or_unitless('3', 'px') '3px' %r)rrr)rdefaultr|r|r} length_or_percentage_or_unitless s  rcCsN|durtd|}g}|D]}t|}|std|||q|S)z Convert the argument into a list of ID-compatible strings and return it. (Directive option conversion function.) Raise ``ValueError`` if no argument is found. Nrz"cannot make "%s" into a class name)rrrmake_idrd)rnames class_namesr~ class_namer|r|r} class_option%s   rz2(?:0x|x|\\x|U\+?|\\u)([0-9a-f]+)$|&#x([0-9a-f]+);$c Cstz'|r tt|WSt|}|r%|dp|d}tt|dWS|WSty9}ztd|d}~ww)a Convert a Unicode character code to a Unicode character. (Directive option conversion function.) Codes may be decimal numbers, hexadecimal numbers (prefixed by ``0x``, ``x``, ``\x``, ``U+``, ``u``, or ``\u``; e.g. ``U+262E``), or XML-style numeric character entities (e.g. ``☮``). Other text remains as-is. Raise ValueError for illegal Unicode code values. rrzcode too large (%s)N)isdigitchrrunicode_patternrr OverflowErrorr)rrrrzr|r|r} unicode_code<s   rcCs$t|}t|dkrtd||S)z A single character is returned as-is. Unicode character codes are converted as in `unicode_code`. (Directive option conversion function.) rz8%r invalid; must be a single character or a Unicode code)rlenrrcharr|r|r}single_char_or_unicodeUs  rcCs,|dkrd}|S|dkrd}|St|}|S)z As with `single_char_or_unicode`, but "tab" and "space" are also supported. (Directive option conversion function.) tab spacer)rrr|r|r}$single_char_or_whitespace_or_unicodeasrcCr)z Converts the argument into an integer. Raises ValueError for negative, zero, or non-integer values. (Directive option conversion function.) rz(negative or zero value; must be positiverrr|r|r} positive_intorrcCs*d|vr |d}n|}dd|DS)z Converts a space- or comma-separated list of values into a Python list of integers. (Directive option conversion function.) Raises ValueError for non-positive-integer values. ,cSsg|]}t|qSr|)r)rentryr|r|r} sz%positive_int_list..)r)rentriesr|r|r}positive_int_listzs rcCs,zt|W|Stytd|w)z Verifies the encoding argument by lookup. (Directive option conversion function.) Raises ValueError for unknown encodings. zunknown encoding: "%s")codecslookup LookupErrorrrr|r|r}encodings   rcCsPz|}Wntytdt|w||vr|Std|t|f)a Directive option utility function, supplied to enable options whose argument must be a member of a finite set of possible values (must be lower case). A custom conversion function must be written to use it. For example:: from docutils.parsers.rst import directives def yesno(argument): return directives.choice(argument, ('yes', 'no')) Raise ``ValueError`` if no argument is found or if the argument's value is not valid (not an entry in the supplied list). z'must supply an argument; choose from %sz"%s" unknown; choose from %s)r`rrcr format_values)rvaluesrr|r|r}choices  rcCs(dddd|ddD|dfS)Nz %s, or "%s"z, csrrr|rr|r|r}rrz format_values..)rj)rr|r|r}rsrcsfdd}|S)zl Directive option conversion function. The argument can be any of `values` or `argument_type`. cs|vr|S|Srr|rotherrr|r} auto_or_otherszvalue_or..auto_or_otherr|)rrrr|rr}value_orsrc Cs:|sdSzt|WSty}ztt|d}~ww)z Return a docutils parser whose name matches the argument. (Directive option conversion function.) Return `None`, if the argument evaluates to `False`. Raise `ValueError` if importing the parser module fails. N)rget_parser_classrmrstr)rerrr|r|r} parser_names  r)r),__doc__ __docformat__rr importlibrdocutilsrrdocutils.utilsrrdocutils.parsers.rst.languagesrrgrlrar{rrrrrrrrrrrrrcompile IGNORECASErrrrrrrrrrrr|r|r|r}s        #$&'1;