7 f> 6 d Z ddlmZ ddlmZ ddlmZmZmZ ddl m
Z
ddl m Z
ddl mZ ddlmZ dd lmZmZ dd
lmZ dd lmZ dd lmZ dd
lmZ er ddl m Z ddl m Z ej e! Z" G d de Z# G d d Z$ G d dee
Z%dS )z5Manual page writer, extended for Sphinx custom nodes. ) annotations)Iterable)
TYPE_CHECKINGAnycast)nodes)
Translator)Writer)addnodes)_admonitionlabels)logging)SphinxTranslator) format_date) NodeMatcher)Element)Builderc ( e Zd Zd fd ZddZ xZS ) ManualPageWriterbuilderr returnNonec V t || _ d S N)super__init__r )selfr __class__s L/var/www/equiseq/venv/lib/python3.11/site-packages/sphinx/writers/manpage.pyr zManualPageWriter.__init__ s$
c D t | j }| | j | j | j }t t | | _ | j | | j | _
d S r ) NestedInlineTransformdocumentapplyr create_translatorr ManualPageTranslatorvisitor walkaboutastextoutput)r transformr' s r translatezManualPageWriter.translate s} )$-88 ,00 MM 0'::
(((l))++ r )r r r r )r r )__name__
__module__ __qualname__r r,
__classcell__r s @r r r sQ , , , , , , , ,r r c " e Zd ZdZd dZd d Zd
S )
r" a
Flatten nested inline nodes:
Before:
foo=1
&bar=2
After:
foo=var
&bar=2
r# nodes.documentr r c || _ d S r )r# )r r# s r r z NestedInlineTransform.__init__4 s
r kwargsr c t t j t j t j t | j D ]}t fd|D r|j
| }t t | D ]t}| | | r |j
|dz | A |j dd|fi |j }|j
|dz | ut! | s|j | d S )Nc 3 . K | ]} | V d S r ).0subnodematchers r z.NestedInlineTransform.apply..: s- 88777##888888r )r r literalemphasisstronglistr# findallanyparentindexreversedremoveinsertr
attributeslen)r r5 nodeposr: newnoder; s @r r$ zNestedInlineTransform.apply7 sH emU^U\JJ ..w7788 - -D8888488888
-k''-- 'T
3 3 = =GKK((( ww'' = **37G<<<<"0$.R"T"TDO"T"T **37G<<<<4yy -K&&t,,, - -r N)r# r3 r r )r5 r r r )r- r. r/ __doc__r r$ r8 r r r" r" ) sF ! ! ! !- - - - - -r r" c e Zd ZU dZi Zded< db fd
Zdcd ZdddZdddZ dddZ
dddZ dddZ dddZ
dddZdddZdddZdddZdddZdddZdddZddd Zddd Zddd Zddd Zddd Zddd!Zddd"Zddd#Z ddd$Z ddd%Z ddd&Z ddd'Z ddd(Z!ddd)Z"ddd*Z#ddd+Z$ddd,Z%ddd-Z&ddd.Z'ddd/Z(ddd0Z)dd fd1 Z*ddd2Z+dd fd3 Z,ddd4Z-ddd5Z.ddd6Z/ddd7Z0ddd8Z1ddd9Z2ddd:Z3ddd;Z4ddd<Z5ddd=Z6ddd>Z7ddd?Z8ddd@Z9dddAZ:dddBZ;dddCZdddFZ?dddGZ@dddHZAdddIZBdddJZCdddKZDdddLZEdddMZFdddNZGdddOZHdddPZIdddQZJdddRZKdddSZLdddTZMdddUZNdd fdV ZOdd fdW ZPdd fdX ZQdd fdY ZRdddZZSddd[ZTddd\ZUddd]ZVddd^ZWddd_ZXddd`ZYdddaZZ xZ[S )er& z%
Custom man page translator.
zdict[str, Any]_docinfor# r3 r r r r c t || d| _ d| _ | j j | j d< | j j | j d< | j j r| j j | j d< | j j | j d< | j d
| j d< | j j r| j j | j d< n d}| j d r|dz
}|| j z S )NzW.TH "%(title_upper)s" "%(manual_section)s" "%(date)s" "%(version)s" "%(manual_group)s"
rU z#.SH NAME
%(title)s \- %(subtitle)s
)rQ )r tmpls r headerzManualPageTranslator.headero s5 G = $ 5 4
5Ddm##r rL r c d S r r8 r rL s r visit_start_of_filez(ManualPageTranslator.visit_start_of_filew r c d S r r8 rr s r depart_start_of_filez)ManualPageTranslator.depart_start_of_filez rt r c 0 | | d S r )visit_definition_listrr s r
visit_descz ManualPageTranslator.visit_desc ""4(((((r c 0 | | d S r )depart_definition_listrr s r depart_descz ManualPageTranslator.depart_desc s ##D)))))r c Z | | | | d S r )visit_definition_list_item
visit_termrr s r visit_desc_signaturez)ManualPageTranslator.visit_desc_signature s. ''--- r c 0 | | d S r ) depart_termrr s r depart_desc_signaturez*ManualPageTranslator.depart_desc_signature s r c d S r r8 rr s r visit_desc_signature_linez.ManualPageTranslator.visit_desc_signature_line rt r c : | j d d S )N bodyappendrr s r depart_desc_signature_linez/ManualPageTranslator.depart_desc_signature_line r c 0 | | d S r )visit_definitionrr s r visit_desc_contentz'ManualPageTranslator.visit_desc_content d#####r c 0 | | d S r )depart_definitionrr s r depart_desc_contentz(ManualPageTranslator.depart_desc_content t$$$$$r c d S r r8 rr s r visit_desc_inlinez&ManualPageTranslator.visit_desc_inline rt r c d S r r8 rr s r depart_desc_inlinez'ManualPageTranslator.depart_desc_inline rt r c d S r r8 rr s r visit_desc_namez$ManualPageTranslator.visit_desc_name rt r c d S r r8 rr s r depart_desc_namez%ManualPageTranslator.depart_desc_name rt r c d S r r8 rr s r visit_desc_addnamez'ManualPageTranslator.visit_desc_addname rt r c d S r r8 rr s r depart_desc_addnamez(ManualPageTranslator.depart_desc_addname rt r c d S r r8 rr s r visit_desc_typez$ManualPageTranslator.visit_desc_type rt r c d S r r8 rr s r depart_desc_typez%ManualPageTranslator.depart_desc_type rt r c : | j d d S )Nz -> r rr s r visit_desc_returnsz'ManualPageTranslator.visit_desc_returns s r c d S r r8 rr s r depart_desc_returnsz(ManualPageTranslator.depart_desc_returns rt r c H | j d d| _ d S )N(r= r r first_paramrr s r visit_desc_parameterlistz-ManualPageTranslator.visit_desc_parameterlist & r c : | j d d S )N)r rr s r depart_desc_parameterlistz.ManualPageTranslator.depart_desc_parameterlist r r c H | j d d| _ d S )N[r= r rr s r visit_desc_type_parameter_listz3ManualPageTranslator.visit_desc_type_parameter_list r r c : | j d d S N]r rr s r depart_desc_type_parameter_listz4ManualPageTranslator.depart_desc_type_parameter_list r r c Z | j s | j d d S d| _ d S )N, r )r r r rr s r visit_desc_parameterz)ManualPageTranslator.visit_desc_parameter s7 ! I T " " " " " D r c d S r r8 rr s r depart_desc_parameterz*ManualPageTranslator.depart_desc_parameter rt r c 0 | | d S r )r rr s r visit_desc_type_parameterz.ManualPageTranslator.visit_desc_type_parameter s !!$'''''r c 0 | | d S r )r rr s r depart_desc_type_parameterz/ManualPageTranslator.depart_desc_type_parameter rz r c : | j d d S )Nr r rr s r visit_desc_optionalz(ManualPageTranslator.visit_desc_optional r r c : | j d d S r r rr s r depart_desc_optionalz)ManualPageTranslator.depart_desc_optional r r c d S r r8 rr s r visit_desc_annotationz*ManualPageTranslator.visit_desc_annotation rt r c d S r r8 rr s r depart_desc_annotationz+ManualPageTranslator.depart_desc_annotation rt r c 0 | | d S r )visit_paragraphrr s r visit_versionmodifiedz*ManualPageTranslator.visit_versionmodified T"""""r c 0 | | d S r )depart_paragraphrr s r depart_versionmodifiedz+ManualPageTranslator.depart_versionmodified r r c t | t j r | j d d S t
| d S N
)rD rC r rA r r r r r rL r s r r z ManualPageTranslator.visit_term s[ t||EL)) * * % I T " " " " " GG t $ $ $ $ $r c t j r r SkipNoderr s r
visit_commentz"ManualPageTranslator.visit_comment
n r c r | t | d S r )
ensure_eolr visit_footnoter s r r z#ManualPageTranslator.visit_footnote s1
t$$$$$r c | t | dk r| dt d fv rc| j d| | z dz t j | j d d S )Nr= Footnotesz.SH r .sp
)
r rK r) r r r ri rc r r rr s r visit_rubricz!ManualPageTranslator.visit_rubric s t99>>dkkmm Q{^^/L L L I VdnnT[[]]&C&C&I&I&K&K Kd R S S S. !!!!!r c : | j d d S r r rr s r
depart_rubricz"ManualPageTranslator.depart_rubric s r c 2 | |d d S )Nseealso)visit_admonitionrr s r
visit_seealsoz"ManualPageTranslator.visit_seealso
s dI.....r c 0 | | d S r )depart_admonitionrr s r depart_seealsoz#ManualPageTranslator.depart_seealso
r r c | g }| xj dz
c_ | j d t t
t j | }|D ] }| |d t d |D }d }|D ]"}|d r|d | }| j | j
d d | j | | | j | j
d d | j d n/|-| j dd t | z z |
| | j d
$| j d | xj dz c_ t j ) Nr= z.sp
.nf
tokennamec 3 4 K | ]}t | V d S r )rK )r9 names r r< z. s( 114SYY111111r rA r z ::= z%s r r z
.fi
)r r^ r r r r r
productionmaxljustdefsri rK r( r r )r rL namesproductionlistr maxlenlastnames r visit_productionlistz)ManualPageTranslator.visit_productionlist s !# &&& hx': ;TBB( 2 2J LLK0 1 1 1 111511111(
#
#J+&
D%k288@@ 8!4Q!7888 !9!9::: 8!4Q!7888 ))))% cCMM.A!BCCC & & & I T " " " " ### !# n r c d S r r8 rr s r visit_productionz%ManualPageTranslator.visit_production) rt r c d S r r8 rr s r depart_productionz&ManualPageTranslator.depart_production, rt r c d|j v r3| j t d |d z dz | j t d dz t j )Naltz [image: %s]r z[image])rJ r r r r r rr s r visit_imagez ManualPageTranslator.visit_image0 sd DO # # I Q} - -U ;d B C C C 9 ,---n r c N | j | j d d | | | j | j d d | dd }| d r| j j rx| |k r`| d r
|dd }| j d | j d
d || j d
d d g t j ) N referencer r= refurir> )mailto:zhttp:zhttps:zftp:r z ) r r r
visit_Textget
startswithrd
man_show_urlsr) extendr r )r rL uris r visit_referencez$ManualPageTranslator.visit_reference7 s ;/2333
;/2333hhx$$ >>@ A A {(
T[[]]c-A-A>>),, " abb'C Ih'*C81DQ1G" n r c t j | dd }| | t j )NrT #)r Textr r r )r rL texts r visit_number_referencez+ManualPageTranslator.visit_number_referenceJ s9 z$((7C0011 n r c b | | j d d S )Nz.sp
.ce
)r r r rr s r visit_centeredz#ManualPageTranslator.visit_centeredO s. &&&&&r c : | j d d S )Nz
.ce 0
r rr s r depart_centeredz$ManualPageTranslator.depart_centeredS s %%%%%r c d S r r8 rr s r visit_compact_paragraphz,ManualPageTranslator.visit_compact_paragraphV rt r c d S r r8 rr s r depart_compact_paragraphz-ManualPageTranslator.depart_compact_paragraphY rt r c d S r r8 rr s r visit_download_referencez-ManualPageTranslator.visit_download_reference\ rt r c d S r r8 rr s r depart_download_referencez.ManualPageTranslator.depart_download_reference_ rt r c t j r r rr s r
visit_toctreez"ManualPageTranslator.visit_toctreeb r r c t j r r rr s r visit_indexz ManualPageTranslator.visit_indexe r r c t j r r rr s r visit_tabular_col_specz+ManualPageTranslator.visit_tabular_col_spech r r c d S r r8 rr s r visit_glossaryz#ManualPageTranslator.visit_glossaryk rt r c d S r r8 rr s r depart_glossaryz$ManualPageTranslator.depart_glossaryn rt r c t t j |d }t t t j | }| t t j |d }t t t j | }| j d d |D dz | j d t j )Nr r c 3 > K | ]}| V d S r )r) )r9 ns r r< z2ManualPageTranslator.visit_acks..w s* "B"B!188::"B"B"B"B"B"Br .r )
r r bullet_listr list_itemr r r joinr )r rL r+
list_itemss r
visit_acksz ManualPageTranslator.visit_acksq s 5,d1g66 (5?3[AA
5,d1g66 (5?3[AA
"B"Bz"B"B"BBBSHIII n r c 0 | | d S r )visit_bullet_listrr s r visit_hlistz ManualPageTranslator.visit_hlist{ r r c 0 | | d S r )depart_bullet_listrr s r depart_hlistz!ManualPageTranslator.depart_hlist~ s %%%%%r c d S r r8 rr s r visit_hlistcolz#ManualPageTranslator.visit_hlistcol rt r c d S r r8 rr s r depart_hlistcolz$ManualPageTranslator.depart_hlistcol rt r c , | | S r )visit_emphasisrr s r visit_literal_emphasisz+ManualPageTranslator.visit_literal_emphasis s ""4(((r c , | | S r )depart_emphasisrr s r depart_literal_emphasisz,ManualPageTranslator.depart_literal_emphasis s ##D)))r c , | | S r visit_strongrr s r visit_literal_strongz)ManualPageTranslator.visit_literal_strong &&&r c , | | S r
depart_strongrr s r depart_literal_strongz*ManualPageTranslator.depart_literal_strong !!$'''r c d S r r8 rr s r visit_abbreviationz'ManualPageTranslator.visit_abbreviation rt r c d S r r8 rr s r depart_abbreviationz(ManualPageTranslator.depart_abbreviation rt r c , | | S r rA rr s r
visit_manpagez"ManualPageTranslator.visit_manpage rD r c , | | S r rF rr s r depart_manpagez#ManualPageTranslator.depart_manpage rI r c t |j t j r6|j d r | j d d S t | d S )N
literal_blockr )
isinstancerE r containerr r r r
visit_captionr s r rV z"ManualPageTranslator.visit_caption sh dk5? 3 3 ( 8X8X ( I W % % % % % GG ! !$ ' ' ' ' 'r c t |j t j r6|j d r | j d d S t | d S )NrS r ) rT rE r rU r r r r depart_captionr s r rX z#ManualPageTranslator.depart_caption sh dk5? 3 3 ) 8X8X ) I T " " " " " GG " "4 ( ( ( ( (r c t |j t j r | j d d S t |j t j r| j dk r t j | j dk r`| j d|
| z t j t | S )Nz.IP "r r= z.SH %s
)rT rE r r r r r rb r_ r ri r) rc r visit_titler s r rZ z ManualPageTranslator.visit_title s dk8#3 4 4
% I W % % %4
U]
3
3 %!Q&&n$#q(( !%
0C0C0E0E!F!F"G H H Hn$ww""4(((r c t |j t j r | j d d S t
| S )Nz"
)rT rE r r r r r depart_titler s r r\ z!ManualPageTranslator.depart_title sM dk8#3 4 4 I U # # #4ww##D)))r c d| dd v r,| j | t
j )Nmanpageformatr> )r splitr r r) r r rr s r visit_rawz ManualPageTranslator.visit_raw sM 2..4466 6 6 I T[[]] + + +n r c t j r r rr s r
visit_metaz ManualPageTranslator.visit_meta r r c d S r r8 rr s r visit_inlinez!ManualPageTranslator.visit_inline rt r c d S r r8 rr s r
depart_inlinez"ManualPageTranslator.depart_inline rt r c d S r r8 rr s r
visit_mathz ManualPageTranslator.visit_math rt r c d S r r8 rr s r depart_mathz ManualPageTranslator.depart_math rt r c 0 | | d S r )r rr s r visit_math_blockz%ManualPageTranslator.visit_math_block s D!!!!!r c 0 | | d S r )r rr s r depart_math_blockz&ManualPageTranslator.depart_math_block r r )r# r3 r r r r )r rm )rL r r r )\r- r. r/ rO rQ __annotations__r rp rs rv ry r} r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r" r$ r& r/ r2 r5 r7 r9 r< r? rC rH rK rM rO rQ rV rX rZ r\ ra rc re rg ri rk rm ro r0 r1 s @r r& r& H s/ "H!!!! F F F F F F@$ $ $ $
) ) ) )* * * *
$ $ $ $% % % %
! ! ! !
! ! ! !
( ( ( () ) ) )
# # # #$ $ $ $% % % % % % % % % % % %
" " " " / / / /% % % % 2
&
' ' ' '& & & &
% % % %& & & &
) ) ) )* * * *' ' ' '( ( ( (
' ' ' '( ( ( (( ( ( ( ( ( ) ) ) ) ) ) ) ) ) ) ) ) * * * * * *
" " " "# # # # # # # #r r& N)&rO
__future__r collections.abcr typingr r r docutilsr docutils.writers.manpager BaseTranslatorr
sphinxr
sphinx.localer r
sphinx.utilr sphinx.util.docutilsr sphinx.util.i18nr sphinx.util.nodesr docutils.nodesr sphinx.buildersr getLoggerr- loggerr r" r& r8 r r r s ; ; " " " " " " $ $ $ $ $ $ + + + + + + + + + + A A A A A A + + + + + + - - - - - - - - 1 1 1 1 1 1 ( ( ( ( ( ( ) ) ) ) ) ) (&&&&&&'''''' 8 $ $ , , , , ,v , , , - - - - - - - ->Q# Q# Q# Q# Q#+^ Q# Q# Q# Q# Q#r