o
Ni!( @ sD d dl mZ d dlZd dlmZ d dlmZ zd dlmZ W n e y- d dl
mZ Y nw zd dl m Z W n e yE d dl
m Z Y nw d5dd Zd
d Zd d
Zdd Zdd Zdd Zdd Zdd Zdd Zdd Zd d Zd d Zd d! Zd"d# Zd$d% Z d&d' Z d(d) Z d*d+ Z d,d- Z d.d/ Z!d6d1d2Z"d3d4 Z#dS )7 ) annotationsN)nodes)Lexer)Parser)Node c C s d}t t | j}W d n1 sw Y |du s"|dkr,t| | j n t| | j d| | j}|rQ|durSt||d |j}|dusAdS dS dS )a
A convenience function to ease debugging.
It will print the node structure that's returned from CommonMark.
The usage would be something like:
>>> content = Parser().parse('Some big text block
===================
with content
')
>>> custom_walker(content)
document
heading
text Some big text block
paragraph
text with content
Spaces are used to convey nesting
r N z )
contextlibsuppress Exceptionliteralprintt first_child
custom_walkernxt)nodespacetxtcur r F/home/ubuntu/.local/lib/python3.10/site-packages/sphinxarg/markdown.pyr s r c C sR d}| j dur
| j }tdd|}| jd d |_t| D ]}|| q |S )zB
Process a paragraph, which includes all content under it
r N r )string_contentr paragraphjoin sourceposlinemarkdownappend)r textonr r r r 3 s
r c C s t | jS )z
Text in a paragraph
)r Textr r r r r r B s r c C
t dS )z*
A
in html or "
" in ascii
r r# r$ r r r hardbreakI
r( c C r% )z!
A line ending or space.
r& r' r$ r r r softbreakP r) r* c C s< t }| j|d< | jr| j|d< t| D ]}||7 }q|S )zp
A hyperlink. Note that alt text doesn't work,
since there's no apparent way to do that in docutils
refuriname)r reference destinationtitler r r! r" r r r r- W s
r- c C " t }t| D ]}||7 }q|S )z
An italicized section
)r emphasisr r0 r r r r2 e
r2 c C r1 )z
A bolded section
)r strongr r0 r r r r4 o r3 r4 c s g }z j dur fddt j j ddD }W n ty" Y nw dg} j dur1| j t|dkrGtj|d}|D ]}||7 }q?ntj j|d }t D ]}||7 }qS|S )
z
Inline code
Nc " g | ]
} j |d |d dqS r )classesr inline.0_r$ r r
zliteral..long
tokennamescoder r8 r r8 )infor r r r lenr r r renderedr8 r! elementr" r r$ r r y s,
r c s g }z j dur fddt j j ddD }W n ty" Y nw dg} j dur1| j t|dkrGtj|d}|D ]}||7 }q?ntj j|d } jd d |_ t
D ]}||7 }q[|S )
z
A block of code
Nc r5 r6 r9 r; r$ r r r> r? z!literal_block..r@ rA rC r rD rE ) rF r r r r rG r
literal_blockr r r rH r r$ r rK s.
rK c C sH t j| j| jdd}| jdur| jd d |_t| D ]}||7 }q|S )z1
Add some raw html (possibly as a block)
html)formatNr )r rawr r r r r0 r r r rN s
rN c C s t S )z3
An
tag in html. This has no children
)r
transitionr$ r r r rO s rO c C s t | jj| jjS )z*
A title node. It has no children
)r r/ r r r$ r r r r/ s r/ c C sP d}| j dur| j jdkr| j j j}tj|g|gd}t| D ]}||7 }q |S )zh
A section in reStructuredText, which needs a title (the first child)
This is a custom type
r Nheading)idsnames)r r r r sectionr )r r/ r! r" r r r rS s
rS c C s2 t }| jd d |_t| D ]}||7 }q|S )z
A block quote
r )r block_quoter r r r0 r r r rT s
rT c C s( t j| jd}| jdur| jj|d< |S )ze
An image element
The first child is the alt text. reStructuredText can't handle titles
)uriNalt)r imager. r r )r r! r r r rW s
rW c C r1 )z
An item in a list
)r list_itemr r0 r r r rX r3 rX c C sX | j d dkrtj| j d d}ntj| j d d| j d d}t| D ]}||7 }q#|S ) zc
A list (numbered or not)
For numbered lists, the suffix is only rendered as . in html
typebullet bullet_char)rZ delimiterarabicstart)suffixenumtyper^ ) list_datar bullet_listenumerated_listr r0 r r r list_node s
rd c C s | j }g }|dur|j}|dkr|t| n|dkr$|t| n|dkr0|t| n|dkr<|t| n|dkrH|t| n|dkrT|t| n|dkr`|t | n|d krl|t
| n||d
krx|t | np|d kr|t | nd|d ks|d
kr|t
| nT|dkr|t| nH|dkr|t| n<|dkr|t| n0|dkr|t| n$|dkr|t| n|dkr|t| n td| d | |j}|dus |S )zZ
Returns a list of nodes, containing CommonMark nodes converted to docutils nodes
Nr r r* linebreaklinkrP emphr4 rC
code_block html_inline
html_blockrT thematic_breakrW listitem MDsectionzReceived unhandled type: z. Full print of node:)r r r r r r* r( r- r/ r2 r4 r rK rN rT rO rW rd rX rS r
prettyr )r r outputr r r r r sV *r c C s> | j }| j}|dur
d|_|dur | |_|j}|dusdS dS )z3
Correct the nxt and parent for each child
N)r
last_childr parent)rS r lastr r r finalize_sectionE s rt r7 c C s | j }|durg }d}|dur#|jdkr |j|kr d}n|j}|dus|s'dS tdd}| |_| j }|dur||jdkrS|j|krS|j durSt| || tdd}|j}|j du rq|jdkrk|j|krk|| n || n|| |}|dus6|j durt| || d| _ d| _ |d }|D ])}|jdkrt
||d | j du r|| _ n|| j _| |_d|_| j |_ || _ qdS dS ) a
Sections aren't handled by CommonMark at the moment.
This function adds sections to a block of nodes.
'title' nodes with an assigned level below 'level' will be put in a child section.
If there are no child nodes with titles of level 'level' then nothing is done
NFrP Trn r r7 )level) r r ru r r rr rt r append_childrq
nest_sectionsprev) blockru r childrennestrS r
next_levelchildr r r rw S s^
)rw c C s t | }t| t|S )z
Parses a block of text, returning a list of docutils nodes
>>> parse_markdown_block("Some
====
block of text
Header
======
blah
")
[]
)r parserw r )r ry r r r parse_markdown_block s r )r )r7 )$
__future__r r docutilsr docutils.utils.code_analyzerr
commonmarkr ImportError
CommonMarkcommonmark.noder CommonMark.noder r r r( r* r- r2 r4 r rK rN rO r/ rS rT rW rX rd r rt rw r r r r r sH
!
5
A