k7i< SrSSKJr SrSSKrSSKrSSKJr SSKJ r J r SSK J r J r SSKJr S r\(aSS KJrJr 0S S _S S_SS_SS_SS_SS_SS_SS_SS_SS_SS _S!S"_S#S$_S%S&_S'S(_S)S*_S+S,_0S-S._S/S0_S1S2_S3S4_S5S6_S7S8_S9S:_S;S<_S=S>_S?S@_SASB_SCSD_SESF_SGSH_SISJ_SKSL_SMSN_ESOSPSQSRSSSTSUSVSWSX. Er0rSYrSrSZjrSsS[jrStS\jrStS]jrStS^jrStS_jrSuS`jrSuSajrSbr /\ Qr!Scr"StSdjr#SvSejr$SwSfjr%\RL"Sg\RN5r(Shr)StSijr*StSjjr+SuSkjr,SxSljr-StSmjr.Snr/SySojr0SzSpjr1S{Sqjr2g)|z9 This package contains directive implementation modules. ) annotationsreStructuredTextN) import_module)nodesparsers)split_escaped_whitespace escape2null)enF)CallableSequence attention) admonitions Attentioncaution)rCautioncode)body CodeBlockdanger)rDangererror)rError important)r Importantnote)rNotetip)rTiphint)rHintwarning)rWarning 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)r9CSVTablez list-table)r9 ListTableimage)imagesImagefigure)r>Figurecontents)partsContentssectnum)rCSectnumheader)rCHeaderfooter)rCFooterz target-notes) references TargetNotesmeta)miscMetaraw)rNRaw)rNInclude)rNReplace)rNUnicode)rNClass)rNRole)rN DefaultRole)rNTitle)rNDate)rN TestDirective) includereplaceunicodeclassrolez default-roletitledatezrestructuredtext-test-directivec fUR5n/n/nU[;a [UU4$SnURUnU(d([RUnUR SU-5 U(aDURRS RU5URS 9nUR U5 [Uup[S U -5n [!X5n U [U'X4$![a$nUR SU<SU<S35 SnANSnAf[ a( UR SU<SUR <S35 GN f=f![ a UR S U-5 UnGNf=f![ a SU4s$f=f![aMn UR URRS U <SU<SU <3URS 95 SU4sSn A $Sn A ff=f![aG UR URRSU <SU <SU<S3URS 95 SU4s$f=f)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. Nz8Problem retrieving directive entry from language module z: .zNo directive entry for "z " in module "z".z*Using English fallback for directive "%s".z(Trying "%s" as canonical directive name. )linez docutils.parsers.rst.directives.z"Error importing directive module "z" (directive "z"): zNo directive class "z").)lower _directives directivesAttributeErrorappendKeyError__name___fallback_language_modulereporterinfojoin current_line_directive_registryr ImportErrorrgetattr)directive_namelanguage_moduledocumentnormnamemessagesmsg_text canonicalnamermessage modulename classnamemoduledetail directives b/home/james-whalen/.local/lib/python3.13/site-packages/docutils/parsers/rst/directives/__init__.pyrrSsX ##%HHH;8$h..MF'228<   %5@@JM OOH,- .##(( IIh h&;&;)=  3M B A*LMF. ) H  U E,;UD E E F)?+C+CE FF % OOF,- .%M  % X~ ))//>6 3&&0( )X~  ))//*n 6&&0( )X~ ssC)'E 7 E1FG) E3D1EE E.-E.1FF GAGGGAH0/H0cU[U'g)zt Register a nonstandard application-defined directive function. Language lookups are not needed for such functions. N)rg)namers rregister_directivers "KcXU(a#UR5(a[SU-5eg)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 ValueErrorarguments rflagrs'HNN$$@8KLLrc"Uc [S5eU$)z Return the argument text, unchanged. Directive option conversion function for options that require a value. Raise ``ValueError`` if no argument is found. #argument required but none supplied)rrs runchanged_requiredrs>??rcUcgU$)zv Return the argument text, unchanged. (Directive option conversion function.) No argument implies empty string (""). rs r unchangedrsrcjUc [S5eSRSUR555$)z Return the path argument unwrapped (with newlines removed). (Directive option conversion function.) Raise ``ValueError`` if no argument is found. rrc3@# UHoR5v M g7fN)r.0ss r path..s@*?Qwwyy*?s)rrp splitlinesrs rpathrs4>??ww@(*=*=*?@@@rcvUc [S5e[[U55nSRSU55$)z Return the URI argument with unescaped whitespace removed. (Directive option conversion function.) Raise ``ValueError`` if no argument is found. r c3# UH8nSR[R"U5R55v M: g7f)rN)rprunescapesplit)rparts rruri..s5+$)Dt 4 : : <==$)sAA)rrr rp)rrCs rurirsC>??(X)>?xx+$)++ +rc>[U5nUS:a [S5eU$)zp Check for a nonnegative integer argument; raise ``ValueError`` if not. (Directive option conversion function.) rz(negative value; must be positive or zerointrrvalues rnonnegative_intr% ME qyCDD Lrc\URS5n[U5$![a Nf=f)zk Check for an integer percentage value with optional percent sign. (Directive option conversion function.) z %)rstriprirrs r percentagers6  ??4( 8 $$    s  ++)emexchremvwvhvminvmaxcmmmQinptpcpxc[R"U5up#US:dX1;a$[SSRSU55-5eUU3$)z Check for a positive argument of one of the `units`. Return a normalized string of the form "" (without space inbetween). To be called from directive option conversion functions. rz@not a positive number or measure of one of the following units: , c36# UHo(dM Uv M g7frr)rus rrget_measure..s.5aA5s  )r parse_measurerrp)runitsrunits r get_measurersZ%%h/KE qyD% Oii.5.. /0 0WTF rc([U[S-5$)Nr)rCSS3_LENGTH_UNITSrs rlength_or_unitlessrs x!2U!: ;;rc[U[S-5$![a+n[US/5U-sSnA$![a Uef=fSnAff=f)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' )%rN)rrr)rdefaultrs r length_or_percentage_or_unitlessrsV"8%6%?@@  x".8 8 K s# A 5A  AAA cUc [S5eUR5n/nUH?n[R"U5nU(d[SU-5eUR U5 MA U$)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. rz"cannot make "%s" into a class name)rrrmake_idrj)rnames class_namesr class_names r class_optionr3si>?? NN EK]]4( ADHI I:&  rz2(?:0x|x|\\x|U\+?|\\u)([0-9a-f]+)$|&#x([0-9a-f]+);$cNUR5(a[[U55$[R U5nU(a>UR S5=(d UR S5n[[US55$U$![ an[SU-5eSnAff=f)ap 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. zcode too large (%s)N)isdigitchrrunicode_patternmatchgroup OverflowErrorr)rrrrs r unicode_coderJs 9 <<>>s4y> !#))$/E A8%++a.3ub>** 9.7889s#(BABB B$BB$cV[U5n[U5S:a[SU-5eU$)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)rlenrrchars rsingle_char_or_unicodercs8  !D 4y1}*,012 2 KrcDUS:XaSnU$US:XaSnU$[U5nU$)zu As with `single_char_or_unicode`, but "tab" and "space" are also supported. (Directive option conversion function.) tab spacer)rrs r$single_char_or_whitespace_or_unicoderos? 5 K W  K&h/ Krc>[U5nUS:a [S5eU$)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 positiverrs r positive_intr}rrcSU;aURS5nOUR5nUVs/sHn[U5PM sn$s snf)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. ,)rr)rentriesentrys rpositive_int_listrsB h..%.."-4 5WEL W 55 5sAcl[R"U5 U$![a [SU-5ef=f)z} Verifies the encoding argument by lookup. (Directive option conversion function.) Raises ValueError for unknown encodings. zunknown encoding: "%s")codecslookup LookupErrorrrs rencodingrs<> h O >1H<==>s3cUR5R5nX!;aU$[SU<S[ U5<35e![a [S[ U5-5ef=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: str): 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 %s"z" unknown; choose from )rfrrir format_values)rvaluesrs rchoicersr2 &&(  $mF&;=> > 2B(012 22s A"A%cNSRSUSS55<SUS<S3$)Nrc3,# UH nSU-v M g7f)z"%s"Nrrs rr format_values..s%F+Qfqj+sz, or "r)rp)rs rrrs+ II%F&"+%FF"2J ((rc^^SUU4SjjnU$)z` Directive option conversion function. The argument can be any of `values` or `argument_type`. c$>UT;aU$T"U5$rr)rotherrs r auto_or_othervalue_or..auto_or_others v O? "r)rstrr)rrrs`` rvalue_orrs ## rcU(dg[R"U5$![an[[ U55eSnAff=f)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_classrsrr)rerrs r parser_namer s? #''11 #S""#s A>A)returnNone)rrr r )rrr r)rrr rr)rrr z list[str])rrr z list[int])r r)rz Sequence[str]rtyper r )rrr ztype[parsers.Parser])3__doc__ __future__r __docformat__rer importlibrdocutilsrrdocutils.utilsrr docutils.parsers.rst.languagesr rm TYPE_CHECKINGcollections.abcr r rrrgrrrrrrrrrr length_unitsrrrrcompile IGNORECASErrrrrrrrrrr rrrrs #" ##@J 20/0+0 #0) 0 ' 0 / 0 %0 #0 %0+010$0 0)010  #!0""#0$&%0&*'0())0*&+0,(-00%102)304+506"708$90:';0<%=0>#?0@#A0F3G0H I0L _M0N%$$ - )B_0b5 #8v"    A + %>$"# A"<4&**92==J92   6 >6(  #r