k7inSrSSKJr SrSSKrSSKrSSKJr SSKJ r SSK J r SSK J r JrJrJrJr SS KJrJr SS KJrJrJr SS KJrJr SS KJr S r\(aSSKJr S(S)Sjjr "SS\5r!"SS\5r""SS\5r#"SS\5r$"SS\5r%"SS\5r&"SS\5r'"SS\5r("S S!\RR5r*"S"S#\5r+"S$S%\5r,"S&S'\5r-g)*zMiscellaneous directives.) annotationsreStructuredTextN)Path)urlopen)URLError)frontendionodes statemachineutils) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines)miscF)StrPathcU(a'URS5(a[U5nUSSnO[U5Rn[R"SX0- 5$)N/) startswithrparentr relative_path)pathsource root_prefixbases ^/home/james-whalen/.local/lib/python3.13/site-packages/docutils/parsers/rst/directives/misc.py adapt_pathr!sN ts++K ABxF|""   tTY //c ~\rSrSrSrSrSrSr\R\R\R\R\ \ \ \R\R\R"S\ 5\R \RS. r\"\R(5R*S- rSS jrSS jrSS jrSS jrSS jrSSjrSrg)Include*a Include content read from a separate source file. Content may be parsed by the parser, or included as a literal block. The encoding of the included file can be specified. Only a part of the given file argument may be included by specifying start and end line or text to match before and/or after the text to be used. https://docutils.sourceforge.io/docs/ref/rst/directives.html#include rrTN) literalcodeencodingparser tab-width start-lineend-line start-after end-before number-linesclassnameincludecJURRR=UlnUR(dUR SUR -5eUR RSUR5UlUR RSS5UR RSS5UR RSS5UR RSS54Ul [R"URS 5nURS 5(a+URS 5(aS US S-nURnO UR n[#UURRR$U5nX R S'UR'U5nSUR ;aUR)U5$SUR ;aUR+U5$SUR ;aUR-U5$UR/U5 /$)zInclude a file as part of the content of this reST file. Depending on the options, the file content (or a clipping) is converted to nodes and returned or inserted into the input stream. "%s" directive disabled.r+r,Nr-r.r/r<>rrrr'r(r*)statedocumentsettingsfile_insertion_enabledwarningr2optionsget tab_width clip_optionsrr argumentsrendswithstandard_include_pathrr!current_source read_fileas_literal_block as_code_block custom_parseinsert_into_input_lines)selfr<rr inputstrings r run Include.runKs $(::#6#6#?#?? ..,,9DIIEF F))+x7I7IJ!\\--lDA!\\--j$?!\\--mR@!\\--lB?At~~a01 ??3  DMM#$6$6a#D44K"..K$**--<<%'"& XnnT*  $((5 5 T\\ !%%k2 2 t|| #$$[1 1 $$[1 r"c 8URRSURR5nURRn[ R "UUUS9nURRRU5 UR5nUR upxpU(dUb#UR#5n S R%XU5nU (aFUR'U 5n U S :aURS URS35eXl[)U 5-SnU (a;UR'U 5n U S :aURSURS35eUSU nU$![a# URSURSUS35e[a;nURSURS[ R"U5S35eSnAff=f![a;nURS URS 3[ R"U5-5eSnAff=f)zARead text file at `path`. Clip and return content. Provisional. r) source_pathr) error_handlerProblems with "z1" directive path: Cannot encode input file path "z" (wrong locale?)." directive path: .NProblem with " " directive:  rz&Problem with "start-after" option of "z" directive: Text not found.z%Problem with "end-before" option of ")r?r@r<input_encodinginput_encoding_error_handlerr FileInputrecord_dependenciesaddUnicodeEncodeErrorseverer2OSError error_stringread UnicodeErrorrB splitlinesjoinfindlen)rLrr)rS include_fileerrortext startlineendline starttextendtextlines after_index before_indexs r rGInclude.read_fileos% <<##J 0L0LM BB  8<>Q ??4>>2D++ v||'7'7'DF %!\\--lA>B  m$ T\\ ) ^49I$$T*D 3t'8#99H 2t*yCF"(!U\\"e%MMM!UZZ%66M #) UZZ- -Mr"c ~URS:aURUR5n[URURR S5/URUR S5/URURURURUR5 nUR5$)z>Pass `text` to the `CodeBlock` directive class. Provisional. rr(rY) rArvrr2r?poprzlinenocontent_offset block_textr: state_machinerN)rLrk codeblocks r rIInclude.as_code_blocks >>Q ??4>>2Ddii#||//78"ll#0067"kk"11"oo"jj"00  }}r"cURS"5n[R"U5nURRR 5HupE[ X4U5 M URSUl[R"URU5nURRRUl URRRUl URRRUlURRRUlUR!X5 URRR"R%UR"5 UR&R)U45 UR&R+5 URRR,R%UR,5 UR.$)zParse with custom parser. Parse with ``self.options['parser']`` into a new (dummy) document, apply the parser's default transforms, return child elements. Provisional. r*r)r?rget_default_settingsr<__dict__itemssetattr_sourcer new_documentr:r; include_logidsnameids nametypesparseparse_messagesextend transformerpopulate_from_componentsapply_transformstransform_messageschildren)rLrkr*r<kvr;s r rJInclude.custom_parsesah')008MM**002DA H #3<<1%%h&6&6A#zz22>>zz**.. ::..66!ZZ00:: T$ **11(2I2IJ55vi@--/ ..55  ' ' )   r"cVURSn[R"XRSS9n[ U5HbupE[ U5UR R:dM*US-URRSS5-nURSUSUS 35e URRRnU(dH[R"S URRR5nUR!US 45 X R"4U;aHS [%U55n S R'U/U Q75n URSUR(SU 35eUR!X R"45 USSUS3/- nUR*R-X25 g )zLInsert file content into the rST input of the calling parser. Provisional. rT)convert_whitespacerr,r"z": line z exceeds the line-length-limit.N)NNr6r6c3*# UH upUv M g7fr&).0pthopts r 2Include.insert_into_input_lines..sH2GJSC2Gsz > zcircular inclusion in "rXr6z.. end of inclusion from ")r?r string2linesrA enumeraterhr<line_length_limitr@r>r:r;rr rrFappendrBreversedrfr2r insert_input) rLrkr textlinesirxline_norrF source_chaininclusion_chains r rKInclude.insert_into_input_liness h' --dNNAEG !+GA4y4==:::a%$,,"2"2<"CCllQvhhwi@9$9::, jj))55 "00 $djj&9&9&H&HJN   0DE F %% &+ 5H(;2GHL$kk6*AL*ABO,,!8 D//>.? AB BF$5$567b6vha@AA  '' :r")rBr<rAN)returnlist)rrrstr)rkrrzlist[nodes.literal_block])rkrrr)rkrrNone)__name__ __module__ __qualname____firstlineno____doc__required_argumentsoptional_argumentsfinal_argument_whitespacerflag unchangedr) parser_nameintunchanged_requiredvalue_or class_option option_specrr__file__rrErNrGrHrIrJrK__static_attributes__rr"r r$r$*s  $(oo%//)22'33 #!$"","?"?!+!>!>#-#6#6w#D&33%// 1K!1889D"H.`8(!:;r"r$c\rSrSrSrSrSrSr\R\R\R\RS.r SrSrSrg ) Rawiz Pass through content unchanged Content is included in output based on type argument Content may be included inline (content section of directive) or imported from a file or url. rrT)fileurlr)r1c nURRRnUR(a1UR(d>SUR ;dSUR ;aUR SUR-5eSSRURSR5R550nUR RSUR5nURnUR(a[SUR ;dSUR ;aUR!SUR-5eS RUR5nGO=SUR ;aSUR ;aUR!S UR-5e[#UR SURRR$UR&5n[(R*"UUUS 9nUR,R/U5 UR75nXbS'OuSUR ;aUUR Sn [;U 5R75n [(R>"XUUS9nUR75nXS'OURA5 [BRD"SW4SUR RS/50UD6n URFRIURJ5uU l&U l'U /$![0a;nUR3S URS [(R4"U5S35eSnAff=f![8a;nUR3SURS3[(R4"U5-5eSnAff=f![<[04aKnUR3S URSUR SS[(R4"U5S35eSnAff=f![8a;nUR3SURS3[(R4"U5-5eSnAff=f)Nrrr5format rr)zF"%s" directive may not both specify an external file and have content.rYzXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.rQrTrUrVrWrXrz" directive URL "z": )rrRr)rSr6rur1)(r:r;r< raw_enabledr=r?r>r2rfrClowersplitr@rZr[contentrjr!rFrr r\r]r^rar`rbrcrdrr StringInputassert_has_contentr rawrget_source_and_linerrrx) rLr< attributesr)rSrkrraw_filerjrraw_textraw_nodes r rNRaw.run"s::&&//$$33t||+u /D,,9DIIEF F):)@)@)B)H)H)J KL <<##J0G0GH == <<%$,,)>jj(*.))45599T\\*D t|| # $jj8:>))DEEdll62"jj11@@&224D 7<>!+<=a@FFH--/D C$11$7 uzz'* *G   Cjj$("//%*@"BCC CsE F'-FFrN)rrrrrrrrrrrrecompilerrNrrr"r rrsM $%??&OO&OO-Kjj!12O r"rc.\rSrSrSrSrSrSrSrSr Sr g) Classiz Set a "class" attribute on the directive content or the next element. When applied to the next element, a "pending" element is inserted, and a transform does the work later. rrTc[R"URS5n/nUR (a[R"5nURRUR URU5 UHnUSRU5 M URUR5 U$[R"[R XR S.UR"5nUR$R&R)U5 UR+U5 U$![a2 UR SUR <SURS<S35ef=f)Nrz#Invalid class attribute value for "z" directive: "".ru)r1 directive)rrrCrrjr2rr rr:rrrrpendingrClassAttributerrr; note_pendingr)rL class_value node_list containerrr s r rN Class.runs' 2$11$..2CDK  << I JJ # #DLL$2E2E$- /!Y&&{3"   Y// 0 mm##%II>!G    ' ' 4 4W =   W %' 2**99dnnQ/12 2 2s #D,,5 U$![*R,apn URRSUR<SU <S3[R"UR UR 5URS 9nXW/-sSn A $Sn A ff=f![2apn URRSUR<SU <S3[R"UR UR 5URS 9nXW/-sSn A $Sn A ff=f)z?Dynamically create and register a custom interpreted text role.z4"%s" directive requires arguments on the first line.rrz-" directive arguments not valid role names: "rrN#Unknown interpreted text role "%s".rrCz&Supplemental directive arguments for "z)" directive not supported (specified by "z" role).)option_presetsrrXrVr1zInvalid argument for ")rrrrjr2argument_patternmatchgrouprrolerlanguager:rr rwrgeneric_custom_rolehasattrrparse_directive_blockr MarkupErrorrrr CustomRoleregister_local_role)rLargsr new_role_namebase_role_namer base_rolerjconverted_rolerCr?rrdetailrs r rNRole.runs    ,DLL**%'+yy12 2||A%%++D1**(, 49: : A Q "'** 2 2 ; ;T[[ ###% I  ++119NJ''I2& ')) !11I9k22 L59YY  K L2 &7 BN11LL$d&9&9"227 Y ' ! *#-#:#:=#I  'K !!-6%!! &MM''3799fE##DOOT__E[[("Eg% %  & * ++yy&*''I ,&  '))  *s?6AI>K K A%K?K K  MA%M<MMrN) rrrrrrrrInliner simplenamerrNrrr"r rrs:Kzz"A&,nn&?&?%AA%E#GH4r"rc&\rSrSrSrSrSrSrSrg) DefaultRoleiz&Set the default interpreted text role.rFcUR(d'S[R;a[RS /$URSn[R"XRR UR URR5up#Uc`URRRSU-[R"URUR5UR S9nX4/-$U[RS'U$)Nr6rrr) rCr_rolesrrrrr:rrjr rwr)rL role_namerrrjs r rNDefaultRole.runs~~U\\!LL$INN1% I/A/A/J/J$(KK1D1DF <JJ''--5 A##DOOT__E[[."Eg% % Rr"rN) rrrrrrrrNrrr"r r-r-s0 %r"r-c&\rSrSrSrSrSrSrSrg)Titlei0rrTcRURSURRS'/$)Nrtitle)rCrr;)rLs r rN Title.run6s&/3~~a/@##G, r"rN) rrrrrrrrNrrr"r r3r30s $r"r3c \rSrSrSrSrSrg)MetaBodyi;c\URU5upEU=RU- sl/U/4$)z Meta element.) parsemetar)rLrcontext next_stater blank_finishs r field_markerMetaBody.field_marker=s.!^^E2 t :r!!r"c BURU5n[R"[R"U55nUR R UR55up4pV[R"5n[R"[R"SRU555US'U(dLUR RnURRSU-[R"X55n X4$UR5n [R"U S5SupXU R!5'U SSH1n [R"U 5SupXU R!5'M3 Xv4$![R"a U SUS'N[f=f![R"a^nUR RnURR%SU <SU<S 3[R"X55n X4sSnAs $SnAff=f) NrrzNo content for meta tag "%s".rr2rz"Error parsing meta tag attribute "z": rV)parse_field_markerr unescaper escape2nullrget_first_known_indentedendmetarfrxrinforwrextract_name_valuerNameValueErrorrj)rLrr2indentedindent line_offsetr=rrxmsgrattnamevaltokenr(s r r:MetaBody.parsemetaCs&&u-~~e//56    8 8 E ;zz|..):):,/HHX,>*@AY%%**D--$$1D8%%d13C$ $ % 33F1I>qALG$' !ABZE )$77>qA (+W]]_% !!## %!!9DL % '' )))..mm))().)<)r:rrr"r r8r8;s " "r"r8c(\rSrSrSrS\40rSrSrg)MetaidT state_classesc UR5 [R"5nURR UR UR USSURS9up#X R - [UR 5:waRURRS[R"URUR5URS9nX- nURRR[R [R"45=(d SnUR$URRXU&/$)Nr8T) initial_stater=state_machine_kwargszInvalid meta directive.rr)rr rr:nested_list_parserrSMkwargsrhrrjrwrrr;first_child_not_matching_classTitularrFr)rLrnew_line_offsetr=rjindexs r rNMeta.runjs !}}(, (D(D LL$--t$4!%)E)0% 11 1c$,,6G GMM'')##DOOT__E[[("E MD ##BB). (CEJHI +/== E( r"rN) rrrrrr8rYrNrrr"r rSrSdsK(-Hr"rSc\rSrSrSrSrSrg)DateiTc2[UR[R5(dUR SUR -5eSR UR5=(d Sn[R"U5n[R"U5/$)NrrYz%Y-%m-%d) rr:rrrjr2rfrtimestrftimer r|)rL format_strrks r rNDate.runsv$**f&<&<==**-/3yy9: :YYt||,: "}}Z( 4 !!r"rNrrr"r r`r`s K"r"r`cF\rSrSrSrSrSrS\R0r Sr Sr Sr g) TestDirectiveiz3This directive is useful only for testing purposes.rToptionc UR(aSRUR5nURRSUR<SUR <SUR <S3[R"X5URS9nU/$URRSUR<SUR <SUR <S3URS9nU/$)NrYzDirective processed. Type="z ", arguments=z , options=z , content:rz, content: None) rrfrrGr2rCr?r rwr)rLrkrGs r rNTestDirective.runs <<99T\\*D==%%"iiG##D/dkk&CDv ==%%#'99dnndllL[[&"Dv r"rN) rrrrrrrrrrrrNrrr"r rgrgs+= $Z::;KK r"rg)r6r6)rrrr).r __future__r __docformat__rrbpathlibrurllib.requestr urllib.errorrdocutilsrr r r r docutils.parsers.rstr rrrr$docutils.parsers.rst.directives.bodyrrdocutils.transformsr TYPE_CHECKINGdocutils.nodesrr!r$rrrrrr-r3SpecializedBodyr8rSr`rgrr"r rws  "" "!==F::G$ & 0`;i`;HT)TniB) i) X#I#L;9;|)4I&"v%%&"R96"9"<Ir"