j+ , d dl mZ d dlZd dlZd dlmZ d dlm Z d dlm
Z
d dl m Z d dlm
Z
ej rd dlmZ d dlmc mZ d d lmZ d
d d-dZd Zd.dZd/dZd0dZd1dZd2d Z d3d Z d4d5d)Z d4d6d+Z e d,k rd dlZ ej! dS dS )7 ) annotationsN)tostring)common)meter)
xmlObjects)prebase)Callable)
Music21ObjectF)noCopyreturnstrc |du rt j | }n| }t | | D ]f}|j }t | dk rJt
| }| | | gt |d }| }|S )u
wrapper around xml.etree.ElementTree that returns a string
in every case and indents tags and sorts attributes.
>>> from music21.musicxml.m21ToXml import Element
>>> from music21.musicxml.helpers import dumpString
>>> e = Element('accidental')
>>> dumpString(e)
''
>>> e.text = '∆'
>>> e.text == '∆'
True
>>> dumpString(e)
'∆'
F unicode)encoding) copydeepcopyindentiterattriblensorteditemsclearupdate et_tostringrstrip)objr xmlElelr attribsxStrs /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/musicxml/helpers.py
dumpStringr$ s $
c""
5MMMjjll # # v;;?? V\\^^,,G LLNNN MM' " " " uy 1 1 1D ;;==D K c > t t | dS )u
wrapper around xml.etree.ElementTree that prints a string
in every case and indents tags and sorts attributes. (Prints, does not return)
>>> from music21.musicxml.helpers import dump
>>> from xml.etree.ElementTree import Element
>>> e = Element('accidental')
>>> dump(e)
>>> e.text = '∆'
>>> e.text == '∆'
True
>>> dump(e)
∆
N)printr$ )r s r# dumpr( A s $
*S//r% c d|dz z }t | }|r| j r| j s
|dz | _ | j r| j s|| _ d}| D ]}t ||dz |||_ | j r| j sd|dz z | _ dS dS |r)| j r| j s || _ dS dS dS )z4
helper method, indent an element in place:
z Nr )r textstriptailr )elemlevelilenLsubElems r# r r V s)
ut|A t99D y ! 1 1 !DDIy 1 1 DI ' 'G 7EAI & & & & GLy , 1 1 , ut|+DIII , , $) 49??+<+< DIII r% c * |s| | dS t | h}t | d D ]#\ }}|j |v r| | $| t | | dS )aH
Insert element `insert` into element `root` at the earliest position
of any instance of a child tag given in `tagList`. Append the element
if `tagList` is `None`.
>>> from xml.etree.ElementTree import fromstring as EL
>>> from music21.musicxml.helpers import insertBeforeElements, dump
>>> root = EL('G4')
>>> insert = EL('')
>>> insertBeforeElements(root, insert, tagList=['line'])
>>> dump(root)
G
4
Now insert another element at the end by not specifying a tag list:
>>> insert2 = EL('')
>>> insertBeforeElements(root, insert2)
>>> dump(root)
G
4
N*)appendr enumeratefindalltagaddinsertmin)rootr: tagList
insertIndicesr0 childs r# insertBeforeElementsr@ o s @ FYYKM dll3 / /00 ! !5 9 a KKM""F+++++r% mNum1mNum2boolc d }| |k rdS || \ }} || \ }}t | t | k r t | t | k S t ||g }||d u S )ag
Determine whether `measureNumber1` strictly precedes
`measureNumber2` given that they could involve suffixes.
Equal values return False.
>>> from music21.musicxml.helpers import measureNumberComesBefore
>>> measureNumberComesBefore('23', '24')
True
>>> measureNumberComesBefore('23', '23')
False
>>> measureNumberComesBefore('23', '23a')
True
>>> measureNumberComesBefore('23a', '23b')
True
>>> measureNumberComesBefore('23b', '23a')
False
>>> measureNumberComesBefore('23b', '24a')
True
>>> measureNumberComesBefore('23b', '23b')
False
c z d}| D ] }| r||z
} | t | d }||fS )N ) isnumericr )
measureNumbernumbercharsuffixs r# splitSuffixz-measureNumberComesBefore..splitSuffix sT ! D~~
$ s6{{||,v~ r% Fr )intr )rA rB rL m1Numericm1Suffix m2Numericm2SuffixsortedSuffixess r# measureNumberComesBeforerS s ,
~~u%+e,,Ix%+e,,Ix
9~~Y ''9~~I.. 8 455>!,,,r% r'music21.note.Rest'c d}| j dv rd}nH| j dk r=| t j }|r |j j | j j k rd}|S )NF)TalwaysTauto) fullMeasuregetContextByClassr
TimeSignature barDuration
quarterLengthduration)rT
isFullMeasure tsContexts r# isFullMeasureRestra sg M}(((
& ''(;<< !.<
@XXX M r% element
ET.Element m21Objectr
c H | dd }|sdS ||_ dS )a
MusicXML 3.1 defines the id attribute
(%optional-unique-id)
on many elements which is perfect for setting as .id on
a music21 element.
bye
>>> from xml.etree.ElementTree import fromstring as EL
>>> e = EL('')
>>> f = expressions.Fermata()
>>> musicxml.helpers.synchronizeIdsToM21(e, f)
>>> f.id
'fermata1'
Does not change the id if the id is not specified:
>>> e = EL('')
>>> f = expressions.Fermata()
>>> f.id = 'doNotOverwrite'
>>> musicxml.helpers.synchronizeIdsToM21(e, f)
>>> f.id
'doNotOverwrite'
idN)getrf )rb rd newIds r# synchronizeIdsToM21ri s/ 2
KKd # #E ILLLr% prebase.ProtoM21Object | NoneNonec t |t j sdS t |d sdS |j }|dS t j | sdS | d| dS )a
MusicXML 3.1 defines the id attribute (entity: %optional-unique-id)
on many elements which is perfect for getting from .id on
a music21 element.
>>> from xml.etree.ElementTree import fromstring as EL
>>> e = EL('')
>>> f = expressions.Fermata()
>>> f.id = 'fermata1'
>>> musicxml.helpers.synchronizeIdsToXML(e, f)
>>> e.get('id')
'fermata1'
Does not set attr: id if el.id is not valid or default:
>>> e = EL('')
>>> f = expressions.Fermata()
>>> musicxml.helpers.synchronizeIdsToXML(e, f)
>>> e.get('id', None) is None
True
>>> f.id = '123456' # invalid for MusicXML id
>>> musicxml.helpers.synchronizeIdsToXML(e, f)
>>> e.get('id', None) is None
True
None can be passed in instead of a m21object.
>>> e = EL('')
>>> musicxml.helpers.synchronizeIdsToXML(e, None)
>>> e.get('id', 'no idea')
'no idea'
Nrf )
isinstancer ProtoM21Objecthasattrrf r isValidXSDIDset)rb rd m21Ids r# synchronizeIdsToXMLrs sy N i!7 8 8 9d # # LE } "5 ) ) KKe r% m21Elt.Anyr xmlAttributeName
attributeName
str | None transform Callable[[str], t.Any] | Nonec | | }|dS | || }|t j | }t | || dS )a
If xmlEl has at least one element of tag==tag with some text. If
it does, set the attribute either with the same name (with "foo-bar" changed to
"fooBar") or with attributeName to the text contents.
Pass a function or lambda function as transform to transform the value before setting it
>>> from xml.etree.ElementTree import fromstring as EL
>>> e = EL('')
>>> setb = musicxml.helpers.setM21AttributeFromAttribute
>>> pl = layout.PageLayout()
>>> setb(pl, e, 'page-number')
>>> pl.pageNumber
'4'
>>> setb(pl, e, 'new-page', 'isNew')
>>> pl.isNew
'yes'
Transform the pageNumber value to an int.
>>> setb(pl, e, 'page-number', transform=int)
>>> pl.pageNumber
4
More complex:
>>> convBool = musicxml.xmlObjects.yesNoToBoolean
>>> setb(pl, e, 'new-page', 'isNew', transform=convBool)
>>> pl.isNew
True
N)rg r hyphenToCamelCasesetattrrt r rv rw ry values r# setM21AttributeFromAttributer % se P
II& ' 'E } % 01ABB
E=%(((((r% Callable[[t.Any], t.Any] | Nonec |t j | }t | |d }|dS | || }| |t | dS )a
If m21El has at least one element of tag==tag with some text. If
it does, set the attribute either with the same name (with "foo-bar" changed to
"fooBar") or with attributeName to the text contents.
Pass a function or lambda function as transform to transform the value before setting it
>>> from xml.etree.ElementTree import fromstring as EL
>>> e = EL('')
>>> setb = musicxml.helpers.setXMLAttributeFromAttribute
>>> pl = layout.PageLayout()
>>> pl.pageNumber = 4
>>> pl.isNew = True
>>> setb(pl, e, 'page-number')
>>> e.get('page-number')
'4'
>>> XB = musicxml.m21ToXml.XMLExporterBase()
>>> XB.dump(e)
>>> setb(pl, e, 'new-page', 'isNew')
>>> e.get('new-page')
'True'
Transform the isNew value to 'yes'.
>>> convBool = musicxml.xmlObjects.booleanToYesNo
>>> setb(pl, e, 'new-page', 'isNew', transform=convBool)
>>> e.get('new-page')
'yes'
N)r r| getattrrq r
r~ s r# setXMLAttributeFromAttributer Y sm R 01ABB
E=$ / /E } % II E
+++++r% __main__)r r
)r )N)rA r
rB r
r rC )rT rU r rC )rb rc rd r
)rb rc rd rj r rk )NN) rt ru r rc rv r
rw rx ry rz r rk )
rt ru r rc rv r
rw rx ry r )"
__future__r r typingtxml.etree.ElementTreer r music21r r music21.musicxmlr r
TYPE_CHECKINGcollections.abcr etree ElementTreeET music21.baser
r$ r( r r@ rS ra ri rs r r __name__mainTest r% r# r s # " " " " " 9 9 9 9 9 9 ' ' ' ' ' ' ? +((((((&&&&&&&&&****** $ ! ! ! ! ! !H * 2(, (, (, (,V(- (- (- (-V <3 3 3 3 v #-1 1) 1) 1) 1) 1)p #/3 3, 3, 3, 3, 3,n zNNNG r%