3jxddlmZgdZddlmZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl m Z e jd ZGd d e j ZGd d e j ZGddeZGddeZGddeZGddeZGdde j ZGddeZGdde j ZGddeZGdde j ZGd d!ej8ZeeeeeeeefZeej zezZ eezezeze!zZ"e#d"k(rddl Z e jHeyy)#) annotations) Contributor CopyrightCreatorDate DateBetween DatePrimitive DateRelative DateSelection DateSingleImprintText ValueType)IterableN)common) environment) exceptions21)prebasezmetadata.primitivesc eZdZdZdZdZdZddddddddddddd ddZddZd Z dd Z d Z e d Z dd ZddZddZddZedZedZedZy)ra A single date value, specified by year, month, day, hour, minute, and second. Note that this class has been created, instead of using Python's datetime, to provide greater flexibility for processing unconventional dates, ancient dates, dates with error, and date ranges. The :attr:`~music21.metadata.Date.datetime` property can be used to retrieve a datetime object when necessary. Additionally, each value can be specified as `uncertain` or `approximate`; if None, assumed to be certain. Date objects are fundamental components of :class:`~music21.metadata.DateSingle` and related subclasses that represent single dates and date ranges. >>> a = metadata.Date(year=1843, yearError='approximate') >>> a.year 1843 >>> a.yearError 'approximate' >>> a = metadata.Date(year='1843?') >>> a.yearError 'uncertain' >>> d = metadata.Date(year=1805, month=3, monthError='approximate') >>> str(d) '1805/03~/--' Note that milliseconds are not retained, as this is a tool for musicology and not for file timestamps. However, unlike datetime objects, dates in the distant past are supported (though not currently BC/BCE dates). )~x)?z)<{>}N) yearmonthdayhourminutesecond yearError monthErrordayError hourError minuteError secondErrorc L|||j|\}}|||j|\}}|| |j|\}} || |j|\}} || |j|\}} || |j|\}} |j||||||tjtdz||_tjtdz||_tjtdz||_tjtdz||_tjtdz||_ tjtdz||_ ||_ ||_ | |_ | |_| |_| |_d|_y)Nrrr r!r"r#) _stripError _sanityChecktcastintrrr r!r"r#r$r%r&r'r(r) attrNames) selfrrr r!r"r#r$r%r&r'r(r)s H/DATA/.local/lib/python3.12/site-packages/music21/metadata/primitives.py__init__z Date.__init__Zs   1"..t4OD)  !3 $ 0 0 7 E: ?x/ ,,S1MC   1"..t4OD)  +"5"&"2"26": FK  +"5"&"2"26": FK t5cV\bcFF3t8T* VVCHe, 66#d(C(FF3t8T* ffSXv. ffSXv. $-$."* #,%0%0Mc0t|t|k(SNstrr2others r3__eq__z Date.__eq__s4yCJ&&r5c dg}|j|j|jd}nd}t|jD]\}}||k\rnt j tt||}t j tt||dz}||jdl|dk(rd}nd}||z}||tj|z }t|}|j|d j|dd } t|d kDr| d d j|d dzz } | S) z Return a string representation, including error if defined. >>> d = metadata.Date() >>> d.loadStr('1030?/12~/?4') >>> str(d) '1030?/12~/04?' NError--rz%04.iz%02.i/:)r!r"r# enumerater1r.r/r9getattrappendr errorToSymboljoinlen) r2msg breakIndexiattrvalueerrorfmtsubouts r3__str__z Date.__str__s  99 !49LJJ 0GAtJFF3d 34EFF3dWn =>E} 4 6>!C!CEk$4--e44C#h 3!1"hhs2Aw s8a< 3#ab'** *C r5cd}t|tr|j|jz|jz}d}|D] }||vs|}n||jvr|j |d}d}nE||jvr|j |d}d}n"||jvr|j |d}d}t |}t||fS)a Strip error symbols from a numerical value. Return cleaned source and sym. Only one error symbol is expected per string. >>> d = metadata.Date() >>> d._stripError('1247~') (1247, 'approximate') >>> d._stripError('63?') (63, 'uncertain') Milliseconds are not retained -- this is for musicology, not computers: >>> d._stripError('4.43') (4, None) N approximate uncertainpriority) isinstancer9approximateSymbolsuncertainSymbolspriorTimeSymbolsreplacefloatr0)r2rO uncertaintysymfoundchars r3r,zDate._stripErrors&!% eS !))D,A,AADDYDYYCE3; E/// eR0+ $/// eR0) $/// eR0( e 5z;&&r5c.fd}dksdkDrtdd(dkDsdks |rtddd||d ks|d kDr td ||d ks|d kDr td ||d ks|d kDr tdyy)Ncldvxrdk(xs'dk(xrdkDxsdk(xrdk(xr duxrdzS)N)rC rC)mdyr rrs r3 month_failz%Date._sanityCheck..month_failsZm+9r T /sRxT RsbyRT5ER$QR( Ur5 z$Month must be between 1 and 12, not .rizDay z is not possible with month rzHour must be between 0 and 23;zMinute must be between 0 and 59zSecond must be between 0 and 59) ValueError)r2rrr r!r"r#rps ``` r3r-zDate._sanityChecks U  %!)urzCE7!LM M ?b7$E3)EtC5(DUG1MN N  TBY<= =  6A:">? ?  6A:">? ?2= r5c|jtjdzvrtjdS|jtjdzvrtjdSy)z Convert an error string (approximate, uncertain) into a symbol. >>> metadata.Date.errorToSymbol('approximate') '~' >>> metadata.Date.errorToSymbol('uncertain') '?' )rWr)rXN)lowerrr[r\)rOs r3rHzDate.errorToSymbols_ ;;=D336FF F**1- - ;;=D11NB B((+ + Cr5ct|tjr|j|nt|tr|j |net|t r|j t|n:t|t r|j|ntjd||j|j|j|j|j|j|j y)a" Load values by string, datetime object, or Date object: >>> a = metadata.Date(year=1843, month=3, day=3) >>> b = metadata.Date() >>> b.load(a) >>> b.year 1843 If there is an error, a ValueError is raised, but the incorrect values are retained: >>> d = metadata.Date() >>> d.load('1999/14/32/25:60:61') Traceback (most recent call last): ValueError: Month must be between 1 and 12, not 14. >>> str(d) '1999/14/32/25:60:61' zCannot load data: r+N)rZdatetime loadDatetimer9loadStrr0r loadOtherrMetadataExceptionr-rrr r!r"r#r2rOs r3loadz Date.loads( eX.. /   e $ s # LL  s # LLU $ t $ NN5 !003EeW1MN N tyy #yyT[[  Rr5c||jD]-}t||st||}|dvs!t|||/y)a? Load time data from a datetime object: >>> import datetime >>> dt = datetime.datetime(2005, 2, 1) >>> dt datetime.datetime(2005, 2, 1, 0, 0) >>> m21mdDate = metadata.Date() >>> m21mdDate.loadDatetime(dt) >>> str(m21mdDate) '2005/02/01' )rNN)r1hasattrrFsetattr)r2dtrNrOs r3r{zDate.loadDatetime%s<NNDr4 D) )D$. #r5c |jD]O}t||t||t|||dz}t||9t||t||Qy)aj Load values based on another Date object. (the "Other" in "loadOther" means another Date object, not just anything. >>> a = metadata.Date(year=1843, month=3, day=3, yearError='approximate') >>> b = metadata.Date() >>> b.loadOther(a) >>> b.year 1843 >>> b.yearError 'approximate' Nr@)r1rFr)r2r;rN errorAttrs r3r}zDate.loadOther;s[NNDud#/dGE4$89 7N 5),8D)WUI-FG #r5cg}g}|jdd}|jdd}|jdD]C}|dk(rd\}}n|j|\}}|j||j|Et t |j D]T}t ||kDst||j |||||5t||j |dz||Vy) aL Load a string date representation, which might have approximate symbols. Assume `year/month/day/hour:minute:second`: >>> d = metadata.Date() >>> d.loadStr('1030?/12~/?4') >>> d.month, d.monthError (12, 'approximate') >>> d.year, d.yearError (1030, 'uncertain') >>> d.month, d.monthError (12, 'approximate') >>> d.day, d.dayError (4, 'uncertain') >>> d = metadata.Date() >>> d.loadStr('1834/12/4/4:50:32') >>> d.minute, d.second (50, 32) rDrB rVrA)NNNr@)r^splitr,rGrangerJr1r)r2dateStrpost postErrorchunkrOrPrMs r3r|z Date.loadStrOs4 "$& //#s+//#r*]]3'E}) u#//6 u KK    U # (s4>>*+A4y1}dnnQ/a9Q<+D$.."3g"=y|L ,r5cg}|jD],}t||}|n|jt|.t j|S)a  Get a datetime object from a metadata.Date() object >>> a = metadata.Date(year=1843, month=3, day=3) >>> str(a) '1843/03/03' >>> a.datetime datetime.datetime(1843, 3, 3, 0, 0) Lack of a required date element raises an exception: >>> a = metadata.Date(year=1843, month=3) >>> str(a) '1843/03/--' >>> a.datetime Traceback (most recent call last): TypeError: function missing required argument 'day' (pos 3) )r1rFrGr0rz)r2rrNrOs r3rzz Date.datetime}sP,NNDD$'E} KKE # #   $''r5cN|j|j |jyy)a Return True if any time elements are defined: >>> a = metadata.Date(year=1843, month=3, day=3) >>> a.hasTime False >>> b = metadata.Date(year=1843, month=3, day=3, minute=3) >>> b.hasTime True TFr!r"r#r2s r3hasTimez Date.hasTimes( II !;;*;;*r5cH|jD]}t||dzyy)a Return True if any data points have error defined: >>> a = metadata.Date( ... year=1843, ... month=3, ... day=3, ... dayError='approximate', ... ) >>> a.hasError True >>> b = metadata.Date( ... year=1843, ... month=3, ... day=3, ... minute=3, ... ) >>> b.hasError False r@TF)r1rF)r2rNs r3hasErrorz Date.hasErrors+0NNDtTG^,8#r5)rint | str | Nonerrr rr!rr"rr#zint | float | str | Noner$ str | Noner%rr&rr'rr(rr)rreturnbool)rOzint | float | strrztuple[int, str | None])rO DateParseType)rzdatetime.datetimerNone)r;rrr)rr9rr)__name__ __module__ __qualname____doc__r[r\r]r4r<rTr,r- staticmethodrHrr{r}r|propertyrzrrrlr5r3rr/s\"H$!+ '+'+%)&*(,.2'+(,&*'+)-)-,N#,N%,N# ,N $ ,N & ,N,,N%,N&,N$,N%,N',N',N^'%P''(''-''R@. , ,RB/,H(*M\((@&r5rcteZdZdZd d dZd dZd dZdZedZ edZ e jdZ y )r a' A default class for all date objects, which can have different types and different "relevance" values. Note that the interaction between uncertainty on an entire DatePrimitive object vs uncertainty on a particular Date value, like month, is ill-defined and needs work. c<g|_d|_g|_||_yNrV)_data _relevance_dataUncertainty relevance)r2rs r3r4zDatePrimitive.__init__s!!#  13"r5ct|t|uxrO|j|jk(xr4|j|jk(xr|j|jk(S)a >>> dd = metadata.DateSingle('1805/3/12', 'uncertain') >>> dd2 = metadata.DateSingle('1805/3/12', 'uncertain') >>> str(dd) '1805/03/12' >>> dd == dd2 True >>> dd2.relevance='certain' >>> dd == dd2 False )typerrrr:s r3r<zDatePrimitive.__eq__s^T d5k): ekk1:--1G1GG:%//9 ;r5ct|Sr7r8rs r3 _reprInternalzDatePrimitive._reprInternal 4yr5ct|jdk(ryt|jdk(rt|jdSt|jDcgc] }t|c}Scc}w)NrrVrq)rJrr9)r2rns r3rTzDatePrimitive.__str__s] tzz?a  _ !tzz!}% % 3 1A 34 43sA6c4|jdjS)a Get a datetime object. >>> a = metadata.DateSingle('1843/03/03') >>> str(a) '1843/03/03' >>> a.datetime datetime.datetime(1843, 3, 3, 0, 0) >>> a = metadata.DateSingle('1843/03') >>> str(a) '1843/03/--' r)rrzrs r3rzzDatePrimitive.datetimes"zz!}%%%r5c|jS)z The relevance attribute takes one of three values, `'certain'`, `'approximate'`, or `'uncertain'`. rrs r3rzDatePrimitive.relevancer5c|dvr*||_g|_|jj|ytjd|)N)certainrWrX1Relevance value is not supported by this object: )rrrGrr~rs r3rzDatePrimitive.relevance"sM ; ;#DO$&D !  ! ! ( ( /00CE9MO Or5N)r)rr9r)rr9) rrrrr4r<rrTrrzrsetterrlr5r3r r s_#;"5&&$OOr5r c4eZdZdZddfd ZdZddZxZS)r a? Store a date, either as certain, approximate, or uncertain relevance. The relevance attribute is limited within each DateSingle subclass depending on the design of the class. Alternative relevance types should be configured as other DateSingle subclasses. >>> dd = metadata.DateSingle('2009/12/31', 'approximate') >>> dd >>> str(dd) '2009/12/31' >>> dd.relevance 'approximate' >>> dd = metadata.DateSingle('1805/3/12', 'uncertain') >>> str(dd) '1805/03/12' cFt|||j|yr7superr4 _prepareDatar2datar __class__s r3r4zDateSingle.__init__D # $r5c2t|jdS)Nr)r9rrs r3rTzDateSingle.__str__Hs4::a=!!r5cg|_|jg|_|jjt |jdj |y)9 Assume a string is supplied as argument rN)rrrrGrrr2rs r3rzDateSingle._prepareDataKsD  !% 0 $&! 1 4 r5)rVrrr)rrrrr4rTr __classcell__rs@r3r r .s* " !r5r cleZdZdZddfd ZfdZedZejdZddZ xZ S) r a Store a relative date, sometime `prior` or sometime `after`, `onorbefore`, or onorafter`. >>> dd = metadata.DateRelative('2009/12/31', 'prior') >>> str(dd) 'prior to 2009/12/31' >>> dd.relevance = 'after' >>> str(dd) 'after 2009/12/31' >>> dd = metadata.DateRelative('2009/12/31', 'certain') Traceback (most recent call last): music21.exceptions21.MetadataException: Relevance value is not supported by this object: 'certain' cFt|||j|yr7rrs r3r4zDateRelative.__init__ns # $r5c~|j}t| }|dk(rd|zS|dk(r|dzS|dk(r|dzSd|zS)Npriorz prior to onorbeforez or earlier onorafterz or laterzafter )rrrT)r2rdsrs r3rTzDateRelative.__str__usZ NN W_  <# # ,  % % +  # #b= r5c|jS)z The relevance attribute takes one of four values, `'prior'`, `'after'`, or `'onorbefore'` or `'onorafter'`. rrs r3rzDateRelative.relevancerr5c|dk(rd}|jdvrtjd||j|_y)Nbeforer)rafterrrr)rxrr~rrs r3rzDateRelative.relevancesJ H E ;;= M M00CE9MO O++-r5cg|_dg|_|jjt|jdj |y)rNr)rrrGrrrs r3rzDateRelative._prepareDatas?  !% $&! 1 4 r5)rVrr) rrrrr4rTrrrrrrs@r3r r [sE$  !(( !r5r cheZdZdZddfd ZdZddZedZejdZxZ S) raB Store a relative date, sometime between two dates: >>> dd = metadata.DateBetween(['2009/12/31', '2010/1/28']) >>> str(dd) '2009/12/31 to 2010/01/28' >>> dd = metadata.DateBetween(['2009/12/31', '2010/1/28'], 'certain') Traceback (most recent call last): music21.exceptions21.MetadataException: Relevance value is not supported by this object: 'certain' >>> d1 = metadata.Date(year=1605) >>> d2 = metadata.Date(year=1608, month='11?') >>> dd = metadata.DateBetween([d1, d2]) >>> str(dd) '1605/--/-- to 1608/11?/--' cFt|||j|yr7rrs r3r4zDateBetween.__init__rr5c~g}|jD]}|jt|dj|S)Nz to )rrGr9rIr2rKrns r3rTzDateBetween.__str__s4A JJs1v {{3r5cg|_g|_|D]S}t}|j||jj ||jj dUy)zK Assume a list of dates as strings is supplied as argument NrrrrrGr2rpartrns r3rzDateBetween._prepareDataU "DA FF4L JJ  a  ! ! ( ( . r5c|jS)zT The relevance attribute takes only one value: `'between'`. rrs r3rzDateBetween.relevance r5cL|dk7rtjd|||_y)Nbetweenrrr~rrs r3rzDateBetween.relevances0 I 00CE9MO Or5)rlrrzIterable[DateParseType]) rrrrr4rTrrrrrrs@r3rrsE(   /  r5rcreZdZdZdZ d d fd ZdZd dZedZ e jdZ xZ S) r a Store a selection of dates, or a collection of dates that might all be possible >>> dd = metadata.DateSelection( ... ['2009/12/31', '2010/1/28', '1894/1/28'], ... ) >>> str(dd) '2009/12/31 or 2010/01/28 or 1894/01/28' >>> dd = metadata.DateSelection( ... [1750, '1775/03?'], ... 'and' ... ) >>> str(dd) '1750/--/-- and 1775/03?/--' >>> dd = metadata.DateSelection( ... ['2009/12/31', '2010/1/28'], ... 'certain', ... ) Traceback (most recent call last): music21.exceptions21.MetadataException: Relevance value is not supported by this object: 'certain' Note that '1350 or 1351 and 1375' is not supported yet. FcFt|||j|yr7rrs r3r4zDateSelection.__init__ s  # $r5cg}|jD]}|jt|d|jdj |S)Nr)rrGr9rrIrs r3rTzDateSelection.__str__sDA JJs1v 4??#1%**3//r5cg|_g|_|D]S}t}|j||jj ||jj dUy)zL Assume a list of dates as strings is supplied as argument. Nrrs r3rzDateSelection._prepareDatarr5c|jS)z[ The relevance attribute takes only two values: `'or'` or `'and'`. rrs r3rzDateSelection.relevance(rr5cJ|dvrtjd|||_y)N)orandrrrs r3rzDateSelection.relevance0s0  %00CE9MO Or5)rlrr) rrrrisSingler4rTrrrrrrs@r3r r s\<H 24 . 0 /  r5r ceZdZdZ d d dZdZdZd dZdZe dZ e jd Z d Z y)raA One unit of text data: a title, a name, or some other text data. Store the string and a language name or code. This object can be used and/or subclassed for a variety for of text storage. >>> td = metadata.Text('concerto in d', 'en') >>> str(td) 'concerto in d' >>> td.language 'en' Nct|trE|j|_|j|_|j|_|j |_y||_||_||_||_yr7)rZrr _language isTranslatedencodingScheme)r2rlanguagerrs r3r4z Text.__init__Ls^ dD !#'::DJ'+~~DN+/+<+>> t1 = metadata.Text('some text') >>> t2 = metadata.Text('some text') >>> t1 == t2 True Language, isTranslated, and encodingScheme must all exactly match for equality. >>> t2 = metadata.Text('some text', language='en') >>> t1 == t2 False >>> t2 = metadata.Text('some text', isTranslated=True) >>> t1 == t2 False >>> t2 = metadata.Text('some text', encodingScheme='scheme42') >>> t1 == t2 False Comparison with non-Text types, including bare strings, will always be considered unequal. >>> t1 == 'some text' False FT)rrrrrr:s r3r<z Text.__eq__jsn2 ;d4j ( :: $ ==ENN *    2 2 2   %"6"6 6r5ct|t|urtS|j|j|j|j f|j|j|j|j fkS)z@ Allows for alphabetically sorting two elements )rNotImplementedrrrrr:s r3__lt__z Text.__lt__se ;d4j (! ! ZZ(9(94;N;N O{{ENNE,>,>@T@TU V r5c|jS)z Set the language of the Text stored within. >>> myText = metadata.Text('my text') >>> myText.language = 'en' >>> myText.language 'en' rrs r3rz Text.languages~~r5c||_yr7rrs r3rz Text.languages r5cXddlm}|jt||jS)a Return a string representation with normalized articles. >>> td = metadata.Text('Ale is Dear, The', language='en') >>> str(td) 'Ale is Dear, The' >>> td.getNormalizedArticle() 'The Ale is Dear' The language will determine whether the article is moved: >>> td.language = 'de' >>> td.getNormalizedArticle() 'Ale is Dear, The' r)text)music21rprependArticler9r)r2rs r3getNormalizedArticlezText.getNormalizedArticles"" !""3t9dnn==r5)rVNNN)r str | Textrrr bool | Nonerrr) rrrrr4rTrr<rrrrrrlr5r3rr=s #%&*+/,0 11#1 )1"* 1&##L    __ >r5rcDeZdZdZ ddd dfdZddZxZS) ru A subclass of text that can also have a role >>> c = metadata.primitives.Copyright('Copyright 1945 Florence Price') >>> c >>> c.role is None True >>> str(c) 'Copyright 1945 Florence Price' The text, language, isTranslated, role, etc. must be identical for equality. >>> c2 = metadata.Copyright('Copyright 1945 Florence Price') >>> c == c2 True >>> c2 = metadata.Copyright('Copyright © 1945 Florence Price') >>> c == c2 False >>> c2 = metadata.Copyright('Copyright 1945 Florence Price', language='en') >>> c == c2 False >>> c2 = metadata.Copyright('Copyright 1945 Florence Price', isTranslated=True) >>> c == c2 False >>> c2 = metadata.Copyright('Copyright 1945 Florence Price', role='other') >>> c == c2 False Comparison against a non-Copyright object will always return False. >>> c == 1945 False N)rolec6t||||||_yr7)rr4r)r2rrrrrs r3r4zCopyright.__init__s x6 r5ct|t|ury|j|jk7ry|j|jk7ry|j|jk7ry|j|jk7ryy)NFT)rrrrrr:s r3r<zCopyright.__eq__sh ;d4j ( :: $ ==ENN *    2 2 2 99 "r5)rVNN)rrrrrrr)rrrrr4r<rrs@r3rrsB!H#%&*+/ # ) r5rc neZdZdZdZddddddd d d d d Zej ZejZ dddddd ddZ dZ dZ ddZ d dZedZej"dZedZej"dZedZej"dZedZedZy)!ra A person that contributed to a work. Can be a composer, lyricist, arranger, or other type of contributor. In MusicXML, these are "creator" elements. >>> td = metadata.Contributor(role='composer', name='Chopin, Fryderyk') >>> td.role 'composer' >>> td.name 'Chopin, Fryderyk' >>> td.relevance 'contributor' >>> td contributorcomposerattributedComposersuspectedComposer composerAliascomposerCorporatelyricist librettistarranger orchestrator translator) comcoacoscolcoclyrliblarlortrnNrl)namenamesrbirthdeathc `d|_|r||_nd|_g|_|rPt|tr|jj |n$|jj t ||rW|D]R}t|tr|jj |/|jj t |Tg|_d|_d|_|%t|ts t|}n|}||_|&t|ts t|} n|} | |_yyr7) _roler_namesrZrrG _nationalityr!r"r ) r2rr rr!r"keywordsnbirthDSdeathDSs r3r4zContributor.__init__;s DIDI#% $% ""4( ""4:. a&KK&&q)KK&&tAw/  )+&* &*  eZ0$U+ DJ  eZ0$U+ DJ r5c8|jd|jS)NrDrrrs r3rzContributor._reprInternaljs))Adii[))r5c4|jsy|jSr)rrs r3rTzContributor.__str__msyyyyr5ct|t|ury|j|jk7ryt|jt|jk7ryt t |jt |jD] \}}||k7s y|j |j k7ry|j|jk7ryy)ar >>> c1 = metadata.Contributor( ... role='composer', ... name='The Composer', ... birth='1923', ... death='2013' ... ) >>> c2 = metadata.Contributor( ... role='composer', ... name='The Composer', ... birth='1923', ... death='2013' ... ) Names, role, birth, and death must all be identical for equality. >>> c1 == c2 True >>> c2.role = 'lyricist' >>> c1 == c2 False >>> c2 = metadata.Contributor( ... role='composer', ... name='A Composer', ... birth='1923', ... death='2013' ... ) >>> c1 == c2 False >>> c2 = metadata.Contributor( ... role='composer', ... names=['A Composer', 'The Composer'], ... birth='1923', ... death='2013' ... ) >>> c1 == c2 False >>> c2 = metadata.Contributor( ... role='composer', ... name='The Composer', ... birth='1924', ... death='2013' ... ) >>> c1 == c2 False >>> c2 = metadata.Contributor( ... role='composer', ... name='The Composer', ... birth='1923', ... death='2012' ... ) >>> c1 == c2 False Comparison with a non-Contributor object always returns False. >>> c1 == 'The Composer' False FT)rr$rJr%zipsortedr!r")r2r;r otherNames r3r<zContributor.__eq__rsx ;d4j ( :: $ t{{ s5<<0 0"6$++#6u||8LMOD)y  N :: $ :: $r5c|jy|j1|jj}|jj}||z Stjj|jjz S)a Calculate the age at death of the Contributor, returning a datetime.timedelta object. >>> a = metadata.Contributor( ... name='Beethoven, Ludwig van', ... role='composer', ... birth='1770/12/17', ... death='1827/3/26', ... ) >>> a.birth >>> a.age() datetime.timedelta(days=20552) >>> a.age().days 20552 >>> years = a.age().days // 365 >>> years 56 If the composer is still alive, it returns the composer's current age. >>> shaw = metadata.Contributor( ... name='Shaw, Caroline', ... role='composer', ... birth='1982/08/01', ... ) >>> shaw_years = shaw.age().days // 365 This test will fail in 2067: >>> 36 < shaw_years < 85 True N)r!r"rznow)r2rnbs r3agezContributor.agesgN ::  :: ! ##A ##Aq5L$$((*TZZ-@-@@ @r5cL|jrt|jdSy)a_ Returns the text name, or the first of many names entered. >>> td = metadata.Contributor( ... role='composer', ... names=['Chopin, Fryderyk', 'Chopin, Frederick'], ... ) >>> td.name 'Chopin, Fryderyk' >>> td.names ['Chopin, Fryderyk', 'Chopin, Frederick'] rN)r%r9rs r3rzContributor.names! ;;t{{1~& &r5cZg|_|jjt|yr7)r%rGrrs r3rzContributor.names!  4;'r5c`g}|jD]}|jt||S)an Returns all names in a list. >>> td = metadata.Contributor( ... role='composer', ... names=['Chopin, Fryderyk', 'Chopin, Frederick'], ... ) >>> td.names ['Chopin, Fryderyk', 'Chopin, Frederick'] >>> td.names = ['Czerny', 'Spohr'] >>> td.names ['Czerny', 'Spohr'] )r%rGr9)r2rKr(s r3r zContributor.names s,"A JJs1v  r5ctj|stjdg|_|D]&}|jj t |(y)Nz3.names must be a list -- do you mean .name instead?)r isIterablerr~r%rGr)r2valuesr(s r3r zContributor.names#sO  (00EG G A KK  tAw 'r5c|jS)a# The role is what part this Contributor plays in the work. Both full roll strings and roll abbreviations may be used. >>> td = metadata.Contributor() >>> td.role = 'composer' >>> td.role 'composer' In case of a Humdrum role abbreviation, the role that is set is the full name: >>> td.role = 'lor' >>> td.role 'orchestrator' Roles can be created on the fly: >>> td.role = 'court jester' >>> td.role 'court jester' )r$rs r3rzContributor.role,s0zzr5c|||jjvr||_y||jvr|j||_y||_yr7)roleAbbreviationsDictr;r$rs r3rzContributor.roleFsK =ET%?%?%F%F%HHDJ d00 033E:DJDJr5c|j}|tjvrtj|Stjd|)z Convert `abbreviation` to role name: >>> metadata.Contributor.abbreviationToRole('com') 'composer' >>> metadata.Contributor.abbreviationToRole('lib') 'librettist' zno such role: )rxrr>rr~) abbreviations r3abbreviationToRolezContributor.abbreviationToRoleOsO$))+ ;<< <44\B B00  013 3r5ctjD]8}|jtj|jk(s6|cStjd|)z Convert `roleName` to role abbreviation: >>> metadata.Contributor.roleToAbbreviation('composer') 'com' zNo such role: )rr>rxrr~)roleNamerole_ids r3roleToAbbreviationzContributor.roleToAbbreviationasV#88G~~;#D#DW#M#S#S#UU9,,~hZ-HIIr5) rstr | Text | Noner zIterable[str | Text]rrFr!None | DateSingle | strr"rGr)rzdatetime.timedelta | None)rrrrrr>keysroleAbbreviationsr; roleNamesr4rrTr<r5rrrr rrrArErlr5r3rrsb(I #"" .224%,,.I (,-/'+.2.2 -!$-!+-!% -! , -! , -!^* IZ/Af( [[(( * \\((2 [[33" J Jr5rceZdZdZdZy)raT A person that created a work. Can be a composer, lyricist, arranger, or other type of contributor. In MusicXML, these are "creator" elements. >>> td = metadata.Creator(role='composer', name='Chopin, Fryderyk') >>> td.role 'composer' >>> td.name 'Chopin, Fryderyk' >>> td.relevance 'creator' creatorN)rrrrrrlr5r3rrrs&Ir5rceZdZdZdZy)r z> An object representation of imprint, or publication. c ||_yr7)r')r2r's r3r4zImprint.__init__s   r5N)rrrrr4rlr5r3r r s !r5r cBeZdZdZdZdZdZdZdZdZ dZ d Z y ) Testcddlm}|jjd}d|_|j |j d|j |jdy)Nrmetadatazmy texten)rrS primitivesrr assertEqualrr)r2rSrs r3testTextz Test.testTextsJ$""'' 2  Y/ .r5cddlm}|jjdd}|j |j d|j |j d|j |jdy)NrrRr Gilles Binchoisr,r )rrSrUrrVrrr)r2rSr s r3testContributorzTest.testContributorsk$))55"6  )):6 .. > ))+<=r5cddlm}|jjdd}|j |j d|j |j d|j |jdy)NrrRr rYr,rL)rrSrUrrVrrr)r2rSrLs r3 testCreatorzTest.testCreatorsg$%%--".  z2 **I6 '89r5cbddlm}|jjdd}|jjd}|j |j d|j |j d|j |j d|j |j dy) NrrRi3rW)rr$z1843?)rrX)rrSrUrrVrr$)r2rSdate1date2s r3testDatez Test.testDates$##((dm(L##((g(6 T* -8 T* +6r5c,|jtd5tdddddD]3\}}}|jtd5t|||ddd5|jtd5td ddd|jtd 5td ddd|jtd 5tdddd|jtddd|jtdd|jtdd|jtdddy#1swY6xYw#1swYAxYw#1swYxYw#1swYxYw#1swYxYw)NzMonth must be.*not 13 )r)) NN)rNN)rirCN)rjN)rkrjizDay.*is not possible)rrr Hour)r!Minute=)r"Second)r#irjrk)rr rrrirtrur)assertRaisesRegexrvrassertIsNotNone)r2rnrmros r3testDateValueErrorzTest.testDateValueErrors5  # #J0G H rNIGAq! '' 4JK!1!,LK  # #J 7 bM8  # #J 9 O:  # #J 9 O: Tt1"=> Tr23 T34 Tr"R@A-I HLK8 7 9 9 9 9s; E E%: E2% E> F E"%E/ 2E;>F Fc:ddlm}|jjdd}|j t |d|j t |jd|j |jd|j |jdgy)NrrR 2009/12/31rWrq) rrSrUr rVr9rJrrr)r2rS dateSingles r3testDateSinglezTest.testDateSingles}$((33 -)  Z,7 Z--.2 .. > 44}oFr5c:ddlm}|jjdd}|j t |d|j |j d|j t|jd|j |jdgy)NrrRz 2001/12/31rzprior to 2001/12/31rq) rrSrUr rVr9rrJrr)r2rS dateRelatives r3testDateRelativezTest.testDateRelatives|$**77 gN  \*,AB //9 \//0!4 66?r5c:ddlm}|jjd}|j t |d|j |j d|j |jddg|j t|jdy)NrrR)ro 2010/1/28z2009/12/31 to 2010/01/28rrj) rrSrUrrVr9rrrJr)r2rS dateBetweens r3testDateBetweenzTest.testDateBetween$s$))55 ')  [)+EF .. : 55d|D [../3r5c@ddlm}|jjgdd}|j t |d|j |j d|j |jgd|j t|jdy)NrrR)rorvz 1894/1/28rz&2009/12/31 or 2010/01/28 or 1894/01/28)NNNr>) rrSrUr rVr9rrrJr)r2rS dateSelections r3testDateSelectionzTest.testDateSelection.s$ ++99 4   ]+A C 00$7 779KL ]00115r5N) rrrrWrZr\r`rmrqrtrxr{rlr5r3rPrPs2/ > : 7B2G@4 6r5rP__main__)% __future__r__all__collections.abcrrztypingr.unittestrrrrr Environment environLocalProtoM21Objectrr r r rr rrrrr TestCaserP _DOC_ORDERr9rr0rrmainTestrlr5r3rs# % '{&&'<= ^7 ! !^D ZOG**ZOz&!&!ZB!=B!L? -? JO MO nE>7 ! !E>T77ziJ'((iJ\ k4!g$$!@m68  m6h    X&&&s* $ { *9 4S 8  zGTr5