rrr r)r*r,)statedocumentsettingsfile_insertion_enabledwarningr4optionsget tab_width clip_optionsrr argumentsrendswithstandard_include_pathr!r$current_source read_fileas_literal_block as_code_block custom_parseinsert_into_input_lines)selfr>rr! inputstrings r#runz Include.runKs $(:#6#?? . G,,9DIEFF F))+x7IJJ!\--lDAA!\--j$??!\--mR@@!\--lB??At~a011 ??3   /DMM#$6$6 /ad#D4KK".K$*-<%''"& XnnT**  $ $((55 5 T\ ! !%%k22 2 t| # #$$[11 1 $$[111 r%rrrc "|jd|jj}|jj} t j|||}|jj|no#t$r"| d|j d|dt$r8}| d|j dt j |dd}~wwxYw |}nE#t$r8}| d |j d t j |zd}~wwxYw|j\}}} } |s|1|} d | ||}| rS|| } | d kr| d |j d|| t)| zd}| rC|| } | d kr| d|j d|d| }|S)zQRead 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 ")rArBr>input_encodinginput_encoding_error_handlerr FileInputrecord_dependenciesaddUnicodeEncodeErrorseverer4OSError error_stringread UnicodeErrorrD splitlinesjoinfindlen)rNrr+rT include_fileerrortext startlineendline starttextendtextlines after_index before_indexs r#rIzInclude.read_fileos <##J 0LMM B  8Q  ??4>22D+ vt|'7'7'D'DFFF % !\--lA>>B  m$$$ T\ ) ) ^49I$$T**D 3t'8'8#9#99H 2t*y(CCF"( 7 77!U\"eW%M%M%MMMM!UZ%6%66MM  7 UZ-- -Mr%c B|jdkr||j}t|j|jdg|j|dg|j|j|j |j |j }| S)zNPass `text` to the `CodeBlock` directive class. Provisional. rr*rZ) rCrwrr4rApopr{linenocontent_offset block_textr< state_machinerP)rNrl codeblocks r#rKzInclude.as_code_blocks >Q  ??4>22Ddi#|//778"l#00667"k"1"o"j"0   }}r%c |jd}tj|}|jjD]\}}t ||||jd|_tj |j|}|j j j |_ |j j j |_ |j j j|_|j j j|_||||j j j|j|j|f|j|j j j|j|jS)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 )rArget_default_settingsr>__dict__itemssetattr_sourcer new_documentr<r= include_logidsnameids nametypesparseparse_messagesextend transformerpopulate_from_componentsapply_transformstransform_messageschildren)rNrlr,r>kvr=s r#rLzInclude.custom_parsesT(h'))088M*0022 $ $DAq Ha # # # #<1%h&6AA#z2>z*. :.6!Z0: T8$$$ *11(2IJJJ55vi@@@--/// .55  ' ) ) )  r%Nonec|jd}tj||jd}t |D]_\}}t ||jjkr=|dz|jddz}| d|d|d `|j j j }|s;tjd |j j j}||d f||jf|vrRd t%|D} d |g| R} | d|jd| |||jf|dd|dgz }|j||d S)z\Insert file content into the rST input of the calling parser. Provisional. r T)convert_whitespacerr.r"z": line z exceeds the line-length-limit.N)NNrrc3 K|] \}}|V dSr().0pthopts r# z2Include.insert_into_input_lines..s&HHJS#CHHHHHHr%z > zcircular inclusion in "rYrz.. end of inclusion from ")rAr string2linesrC enumeraterir>line_length_limitrBr@r<r=rr rrHappendrDreversedrgr4r insert_input) rNrlr textlinesiryline_norrH source_chaininclusion_chains r#rMzInclude.insert_into_input_liness h' -dDNAEGGG !++ : :GAt4yy4=:::a%$,"2"2<"C"CCll$9v$9$9w$9$9$9:::; j)5  G"0 $dj&9&HJJN   0DE F F F D% &+ 5 5HH(;2G2GHHHL$kk6*AL*A*ABBO,, A A A/> A ABB BFD$56777b@v@@@AA  '' 6:::::r%N)rr6)rrrr)rlrrrt)rlrrr6)rlrrr)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacerflag unchangedr+ parser_nameintunchanged_requiredvalue_or class_option option_specrr__file__rrGrPrIrJrKrLrMrr%r#r'r'*s   $(o%/)2'3 #!$"","?!+!>#6:#6w#D#D&3%/ 1 1K!D1189D""""H....`8(!!!!:;;;;;;r%r'c^eZdZdZdZdZdZejej ej ej dZ dZ dZdS)Rawz 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+r3c |jjj}|jr|js/d|jvs d|jvr|d|jzdd|j d i}|j d|j }|j}|jrKd|jvs d|jvr|d|jzd |j}n[d|jvr0d|jvr|d |jzt#|jd|jjj|j} t)j||| }|j|nE#t0$r8}|d |jd t)j|dd}~wwxYw |}nE#t8$r8}|d|jdt)j|zd}~wwxYw||d<n!d|jvr|jd} t;| } nZ#t<t0f$rF}|d |jd|jddt)j|dd}~wwxYwt)j| | ||} |}nE#t8$r8}|d|jdt)j|zd}~wwxYw| |d<n| tCj"d|fd|j dgi|} |j#$|j%\| _&| _'| gS)Nrrr8format rr+zF"%s" directive may not both specify an external file and have content.rZzXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.rRrUrVrWrXrYr z" directive URL "z": )r rSr+rTrrvr3)(r<r=r> raw_enabledr?rAr@r4rgrElowersplitrBr[r\contentrkr$rHr!r r]r^r_rbrarcrdrerr StringInputassert_has_contentr rawrget_source_and_linerr ry) rNr> attributesr+rTrlrraw_filerkr raw_textraw_nodes r#rPzRaw.run"s:&/$ G3 Gt|++u /D/D,,9DIEFF F):)@)@)B)B)H)H)J)J K KL <##J0GHH = <2 &%%$,)>)>jj(*.)455599T\**DD t| # # $$jj8:>)DEEEdl62"j1@&244D 73H99H> !JKAKK5L M 3MM N)rrrrrrrrrurir+rr has_contentrPrr%r#rrso $%?$.)2&355KK@@@@@r%rceZdZdZdZdS)ReplaceTcxt|jtjs|d|jz|d|j}tj |}|j |j|j |d}g}|D]}|st|tj r|}!t|tjrg|d<||V|jd|jd|jgcS|r ||jzS|S)NVInvalid context: the "%s" directive can only be used within a substitution definition.rZbackrefs Error in "z1" directive: may contain a single paragraph only.ry) isinstancer<rSubstitutionDefrkr4rrgrr Element nested_parser paragraphsystem_messagerreporterrr)rNrlelementnodemessageselems r#rPz Replace.runis$*f&<== :**-/3y9:: : !!!yy&&-%%  d.A ' ) ) ) G GD GJtU_== GD%"677 G#%Z %%%%M''3TY3339=(FFGGGG  ,dm+ +r%NrrrrrPrr%r#rres(Kr%rcneZdZdZdZdZdZejejejdZ e j dZ dZ dS) Unicodea{ Convert Unicode character codes (numbers) to characters. 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. ``☮``). Text following ".." is a comment and is ignored. Spaces are ignored, and any other text remains as-is. rrT)trimltrimrtrimz ( |\n|^)\.\. c t|jtjs|d|jz|jj}d|jvrd|j d<d|j d<d|jvr d|j d<d|jvr d|j d<|j |j dd }tj}|D]n} tj|}n?#t"$r2}|d|dt%j|d}~wwxYw|tj|z }o|jS) NrrrrrrzInvalid character code: rZ)rr<rrrkr4rrrArcomment_patternrrEr rr unicode_code ValueErrorr rcr}r)rNsubstitution_definitioncodesrr*decodedrks r#rPz Unicode.runs$*f&<== :**-/3y9:: :#'"4"9 T\ ! !:; # .w 7:; # .w 7 dl " ":; # .w 7 dl " ":; # .w 7$**4>!+<==a@FFHH-// + +D C$1$77 C C Cjjj$(DD"/%*@*@*@"BCCC C uz'** *GGs!C66 D2-D--D2N)rrrrrrrrrrrecompilerrPrr%r#rrsp $%?&O&O--K!bj!122O     r%rc(eZdZdZdZdZdZdZdZdS)Classz 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. rrTcx tj|jd}n:#t$r-|d|jd|jddwxYwg}|jrttj}|j |j|j ||D]}|d || |j natjtj||jd|j}|jj||||S)Nrz#Invalid class attribute value for "z" directive: "".rv)r3 directive)rrrErrkr4rr rr<rrrrpendingrClassAttributerrr= note_pendingr)rN class_value node_list containerrrs r#rPz Class.runsU 2$1$.2CDDKK 2 2 2***999dnQ///122 2 2 < & I J # #DL$2E$- / / /! 4 4Y&&{3333   Y/ 0 0 0 0m#%DI>>!!G   ' 4 4W = = =   W % % %s "7AN) rrrrrrrrrPrr%r#rrsF  $Kr%rcZeZdZdZejdejjfdzzZ dZ dS)RoleTz(%s)\s*(\(\s*(%s)\s*\)\s*)?$c|j|jks|js|d|jz|jd}|j|}|s!|d|jd|d|d}|d}g}|rtj ||j j |j|j j \}}|M|j j d |ztj|j|j|j }||gzSn tj}t%|d rJd |jd |d t'|}|j |jdd|j|i\} } } } nm#t*j$r[} |j d|jd| dtj|j|j|j }||gzcYd} ~ Sd} ~ wwxYwd| vr t/j|| d<nh#t2$r[} |j d|jd| dtj|j|j|j }||gzcYd} ~ Sd} ~ wwxYwtj||| | }tj|||S)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".rrEz&Supplemental directive arguments for "z)" directive not supported (specified by "z" role).)option_presetsrrYrWr3zInvalid argument for ")rrrrkr4argument_patternmatchgrouprrolerlanguager<rr rxrgeneric_custom_rolehasattrrparse_directive_blockr MarkupErrorrrr CustomRoleregister_local_role)rNargsr  new_role_namebase_role_namer base_rolerkconverted_rolerErArrdetailrs r#rPzRole.runsY   , ,DL ,**%'+y122 2|A%++D11 :***(, 4449:: : A Q  2"'* 2 ;T[ ##%#% Ix  +119NJ'II2&& 5')) !1I9k22 L L L59YYY  K L L L &7 BBN11L$d&9"2277 Y..! & & &M'''37999fffE#DOT_EE[(""Eug% % % % % % %  & ' ! ! *#-#:=#I#I   * * * +++yyy&&&*'II ,&&  5')))))))  * y'7KK !-666s?#AF((H7AH H HH22 J,>*@*@AAY %%*D-$$1D8%dD1133C $ $ % 3F1I>>qALGS$'D ! !# % % %!!9DLLL %ABBZ ) )E )$7>>qA (+W]]__%%' ) ) )).m)))().)rbsJ  """"""" """"""!!!!!!==============FFFFFFFF::::::::::GGGGGGGG$$$$$$ '&&&&&& 0 0 0 0 0`;`;`;`;`;i`;`;`;HTTTTT)TTTniB) ) ) ) ) i) ) ) X#####I###L;;;;;9;;;|)4I&"&"&"&"&"v%&"&"&"R96"""""9"""<Ir%