ah MathML element classes based on `xml.etree`.
The module is intended for programmatic generation of MathML
and covers the part of `MathML Core`_ that is required by
Docutil's *TeX math to MathML* converter.
This module is PROVISIONAL:
the API is not settled and may change with any minor Docutils version.
.. _MathML Core: https://www.w3.org/TR/mathml-core/
) annotationsreStructuredTextN)classdir displaystyleidnonce scriptlevelstyletabindexc e Zd ZdZdZ dZ d fd Zed ZddZ dd Z
d fd
Z d fd Z d Z
d
Z fdZd ZddZd ZdddZddZd dZ xZS ) MathElementz Base class for MathML elements.NreturnNonec fd| D } t j j j fi | | dS )a Set up node with `children` and `attributes`.
Attribute names are normalised to lowercase.
You may use "CLASS" to set a "class" attribute.
Attribute values are converted to strings
(with True -> "true" and False -> "false").
>>> math(CLASS='test', level=3, split=True)
math(class='test', level='3', split='true')
>>> math(CLASS='test', level=3, split=True).toxml()
''
c f i | ]-\ }}| | .S )lowera_str).0kvselfs /Users/kimhansen/Desktop/03 Workspace/ceo-agents/chl-effectiveness/mcp-servers/whoop/.venv/lib/python3.11/site-packages/docutils/utils/math/mathml_elements.py
z(MathElement.__init__..S s1 JJJtq!!''))TZZ]]JJJ N)itemssuper__init__ __class____name__extend)r children
attributesattribr s ` r r zMathElement.__init__E sh KJJJz7G7G7I7IJJJ 0;;F;;; H r c t | t r!t | S t | S N)
isinstanceboolstrr )r s r r zMathElement.a_strW s5 a "q66<<>> !1vv
r r* c d | D }| j r'| t | j | j | j j k r | d| j t | dd r| d |d | D z
}| j dd | d S )
z"Return full string representation.c , g | ]}t | S r )reprr childs r
z(MathElement.__repr__..` s ...U ...r z
nchildren=switchNz switch=Truec & g | ]\ }}|| d|S )N=r )r r r s r r0 z(MathElement.__repr__..g s' HHH$!Q!-A ---r (, )) textappendr- nchildrenr getattrr tagjoinr argss r __repr__zMathElement.__repr__^ s ..... 9 ) KKTY ( ( ( >T^ 5 5 5 KK5T^55 6 6 6 44 ( ( ' KK
& & & HH$**,,HHHH(//TYYt__////r c | j rt | j }n d d | D }| j d| dS )z/Return concise, informal string representation.r5 c 3 K | ]}| V d S r' r r. s r z&MathElement.__str__..o s$ : :EZ : : : : : :r r4 r6 )r7 r- r< r; r= s r __str__zMathElement.__str__j sT 9 ; ??DD99 : :T : : :::D($$T$$$$r c r t || | d S r' )r setr )r keyvaluer s r rE zMathElement.setr s-
CE**+++++r c n | j dk rt d| d t |t r| |_ nV| j rCt | t | z | j k rt d| d| j d |D ] }| |_
t
|| d S )Nr Element "z" does not take children.z
" takes only children)r9 TypeErrorr( r parentlenr __setitem__)r rF rG er s r rN zMathElement.__setitem__u s >Q G G G GHH H e[ ) ) ELL~
-#d))c%jj"84>"I"I !,D !, !,t~ !, !, !, - - -
C'''''r c D | j duot | | j k S )z;Return boolean indicating whether children may be appended.N)r9 rM r s r is_fullzMathElement.is_full s! ~T)Ic$ii4>.IIr c t | | _ | j }|1| r |j }|| |S )z:Close element and return first non-full anchestor or None.)rM r9 rL rR )r rL s r closezMathElement.close sN T V^^%5%5 ]F V^^%5%5
r c & | r+| j r d| j d}nd}t d| d| d t | | |_ | r| S | S )aL Append `element` and return new "current node" (insertion point).
Append as child element and set the internal `parent` attribute.
If self is already full, raise TypeError.
If self is full after appending, call `self.close()`
(returns first non-full anchestor or None) else return `self`.
z takes only rJ zdoes not take childrenrI z" .)rR r9 rK r r8 rL rT )r elementstatusr s r r8 zMathElement.append s <<>> ;~
2@t~@@@1 9 9 9 9 9 9:: :
w <<>> ::<< r c > | }|D ]}| | }|S )ziSequentially append `elements`. Return new "current node".
Raise TypeError if overfull.
)r8 )r elements current_noderW s r r" zMathElement.extend s1
0 0G ;;w//LLr c | | }| |= |S r' r )r indexrW s r popzMathElement.pop s u+ Kr c | d + | j S # t $ r Y dS w xY w| d dk S )zReturn True, if `self` or an ancestor has ``display='block'``.
Used to find out whether we are in inline vs. displayed maths.
displayNFblock)getrL in_blockAttributeErrorrQ s r rd zMathElement.in_block sh
88I &
{++---!
uu
xx ""g--s 0
>> r c 2 t j | || dS )zFormat XML output with indents.
Use with care:
Formatting whitespace is permanently added to the
`text` and `tail` attributes of `self` and anchestors!
N)ETindent)r spacelevels r
indent_xmlzMathElement.indent_xml s $u%%%%%r c | D ]a}t |t s%|j r |j |_ |j r |j |_ bdS )zStrip whitespace at the end of `text` and `tail` attributes...
to revert changes made by the `indent_xml()` method.
Use with care, trailing whitespace from the original may be lost.
N)iterr( MathTokenr7 rstriptail)r rO s r unindent_xmlzMathElement.unindent_xml sm ) )A a++
)
) v
) ) )r c t j | |pdd } | dd }n9# t $ r, | d | d }Y nw xY w|S )a Return an XML representation of the element.
By default, the return value is a `str` instance. With an explicit
`encoding` argument, the result is a `bytes` instance in the
specified encoding. The XML default encoding is UTF-8, any other
encoding must be specified in an XML document header.
Name and encoding handling match `xml.dom.minidom.Node.toxml()`
while `etree.Element.tostring()` returns `bytes` by default.
unicodeF)short_empty_elementsu zs )rh tostringreplacerK encode)r encodingxmls r toxmlzMathElement.toxml s k$ 5I/46 6 6 M++h(9::CC M M M++hooh 7 79KLLCCC M
s 2 3A('A(r r )r r* )r\ )rf r r' )r!
__module__ __qualname____doc__r9 rL r staticmethodr r? rC rE rN rR rT r8 r" r_ rd rl rr r{
__classcell__r s @r r r < s ))I-
F- $ \
0
0
0
0% % % %, , , , , , ( ( ( ( ( (J J J ,
.
.
. & & & & &
)
)
)
) r r c e Zd ZdZdS )MathRowz:Base class for elements treating content as a single mrow.Nr! r} r~ r r r r r r s DDDDr r c 2 e Zd ZdZdZd fd Z fdZ xZS )
MathSchemazBase class for schemata expecting 2 or more children.
The special attribute `switch` indicates that the last two child
elements are in reversed order and must be switched before XML-export.
See `msub` for an example.
r r c p | dd | _ t j |i | d S )Nr1 F)r_ r1 r r )r r# kwargsr s r r zMathSchema.__init__ s: jj511 (-f-----r c t | }| j r2| r | d | d c| d< | d< d| _ |S )z2Append element. Normalize order and close if full.r\ F)r r8 r1 rR )r rW r[ r s r r8 zMathSchema.append sZ ww~~g.. ; 4<<>> !%b48 DHd2h DKr r| )r! r} r~ r r9 r r8 r r s @r r r sg I. . . . . . r r c ( e Zd ZdZdZd fd Z xZS )ro zgToken Element: contains textual data instead of children.
Expect text data on initialisation.
r r r c t j di | t |t t j f st
d| d t | | _ d S )Nz0MathToken element expects `str` or number, not "z".r )r r r( r* numbersNumber
ValueErrorr7 )r r7 r$ r s r r zMathToken.__init__ ss &&:&&&$gn 566 0 /&* / / / 0 0
0II r r| )r! r} r~ r r9 r r r s @r ro ro sN I r ro c e Zd ZdZdS )mathz8Top-level MathML element, a single mathematical formula.Nr r r r r r % s BBBBr r c e Zd ZdZdS )mtextz*Arbitrary text with no notational meaning.Nr r r r r r , s 4444r r c e Zd ZdZdS )mizCIdentifier, such as a function name, variable or symbolic constant.Nr r r r r r 0 s MMMMr r c e Zd ZdZdS )mnzNumeric literal.
>>> mn(3.41).toxml()
'3.41'
Normally a sequence of digits with a possible separator (a dot or a comma).
(Values with comma must be specified as `str`.)
Nr r r r r r 4 s r r c e Zd ZdZdS )moa Operator, Fence, Separator, or Accent.
>>> mo('<').toxml()
'<'
Besides operators in strict mathematical meaning, this element also
includes "operators" like parentheses, separators like comma and
semicolon, or "absolute value" bars.
Nr r r r r r ? s r r c e Zd ZdZdZdS )mspacezBlank space, whose size is set by its attributes.
Takes additional attributes `depth`, `height`, `width`.
Takes no children and no text.
See also `mphantom`.
r Nr! r} r~ r r9 r r r r r K s IIIr r c * e Zd ZdZddZ fdZ xZS )mrowzyGeneric element to group children as a horizontal row.
Removed on closing if not required (see `mrow.close()`).
r r c 8 ddd}| D ]\ }}|dv r`|r^| | rI|| | | || |f }| || dS )zTransfer attributes from self to other.
"List values" (class, style) are appended to existing values,
other values replace existing values.
z; )r r N)r rc r< rp rE )r other
delimitersr r s r transfer_attributeszmrow.transfer_attributes_ s #T22
JJLL DAq&&&1&99Q<< A"1
** 1 ,,Z];;Q?A AA IIaOOOO r c B | j }|vt | dk rc| d } ||t | | < ||_ n# t t
f$ r Y dS w xY w| | t S )z|Close element and return first non-full anchestor or None.
Remove if it has only one child element.
N r ) rL rM listr^ re r r r rT )r rL r/ r s r rT z
mrow.closem s
#d))q..GE
38tF||))$//0 % "J/
tt
$ $U + + +ww}} s ,A A)(A)r| )r! r} r~ r r rT r r s @r r r Y sV
r r c e Zd ZdZdS )mfraczAFractions or fraction-like objects such as binomial coefficients.Nr r r r r r s KKKKr r c e Zd ZdZdZdS )msqrtz Square root. See also `mroot`.r Nr r r r r r s ((IIIr r c e Zd ZdZdS )mrootz/Roots with an explicit index. See also `msqrt`.Nr r r r r r 9999r r c e Zd ZdZdS )mstylezStyle Change.
In modern browsers, is equivalent to an element.
However, may still be relevant for compatibility with
MathML implementations outside browsers.
Nr r r r r r s r r c e Zd ZdZdS )merrorz#Display contents as error messages.Nr r r r r r s ----r r c e Zd ZdZdZdS )menclosezRenders content inside an enclosing notation...
... specified by the notation attribute.
Non-standard but still required by Firefox for boxed expressions.
r Nr r r r r r s IIIr r c e Zd ZdZdS )mpaddedz Adjust space around content.Nr r r r r r s &&&&r r c e Zd ZdZdZdS )mphantomz8Placeholder: Rendered invisibly but dimensions are kept.r Nr r r r r r s BBIIIr r c e Zd ZdZdS )msubz$Attach a subscript to an expression.Nr r r r r r s ....r r c e Zd ZdZdS )msupz&Attach a superscript to an expression.Nr r r r r r s 0000r r c e Zd ZdZdZdS )msubsupz;Attach both a subscript and a superscript to an expression. Nr r r r r r s EEIIIr r c e Zd ZdZdS )munderz0Attach an accent or a limit under an expression.Nr r r r r r s ::::r r c e Zd ZdZdS )moverz/Attach an accent or a limit over an expression.Nr r r r r r r r r c e Zd ZdZdS )
munderoverz;Attach accents or limits both under and over an expression.Nr r r r r r s EEEEr r c e Zd ZdZdS )mtablezTable or matrix element.Nr r r r r r s """"r r c e Zd ZdZdS )mtrzRow in a table or a matrix.Nr r r r r r %%%%r r c e Zd ZdZdS )mtdzCell in a table or a matrixNr r r r r r r r r )'r
__future__r
__docformat__r xml.etree.ElementTreeetree ElementTreerh GLOBAL_ATTRIBUTESElementr r r ro 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 s1
# " " " " ""
" " " " " " " " "
l l l l l"* l l lpE E E E Ek E E E 2 $C C C C C7 C C C5 5 5 5 5I 5 5 5N N N N N N N N [ # # # # # 7 # # # LL L L L LJ L L L G
: : : : :J : : : W . . . . .W . . . w ' ' ' ' 'g ' ' '
w / / / / /: / / /1 1 1 1 1: 1 1 1 j $; ; ; ; ;T ; ; ;: : : : :D : : :F F F F F F F F# # # # #[ # # #& & & & &' & & && & & & &' & & & & &r