rhjSSKJr /SQrSSKJr SSKrSSKrSSKrSSK J r SSK J r SSK J r SSK J r \ R"S 5r"S S \ R 5r"S S \ R 5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\ R 5r"SS\5r"SS\ R 5r"SS\5r"SS\ R 5r"S S!\R85r\\\\\\\\4r\\R -\-r \\-\-\-\!-r"\#S":XaSSK r \ RH"\5 gg)#) annotations) Contributor CopyrightCreatorDate DateBetween DateRelative DateSelection DateSingleImprintText)IterableN)common) environment) exceptions21)prebasezmetadata.primitivesc  \rSrSrSrSrSrSrSSSSSSSSSSSSS. SSjjrSS jr S r SS jr S r \ S 5rSSjrSSjrSSjrSSjr\S5r\S5r\S5rSrg)r.ac 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 LUbUcURU5upUbUcURU5up(UbU cURU5up9UbU cURU5upJUbU cURU5up[UbU cURU5uplURXX4XVS9 [R"[S-U5Ul[R"[S-U5Ul[R"[S-U5Ul[R"[S-U5Ul[R"[S-U5Ul [R"[S-U5Ul Xpl Xl Xl XlXlXlSUlg)Nrrrr r!r") _stripError _sanityChecktcastintrrrr r!r"r#r$r%r&r'r( attrNames) selfrrrr r!r"r#r$r%r&r'r(s U/home/james-whalen/.local/lib/python3.13/site-packages/music21/metadata/primitives.py__init__ Date.__init__Ysv   1"..t4OD  !3 $ 0 0 7 E ?x/ ,,S1MC   1"..t4OD  +"5"&"2"26": F  +"5"&"2"26": F tcVcFF3t8T* VVCHe, 66#d(C(FF3t8T* ffSXv. ffSXv. $-$."* #,%0%0Mc0[U5[U5:H$Nstrr1others r2__eq__ Date.__eq__s4yCJ&&r5c t/nURcURcURcSnOSn[UR5Hup4X2:a O[ R "[[X55n[ R "[[XS-55nUcURS5 MmUS:XaSnOSnXu-nUbU[RU5- n[U5nURU5 M S RUSS 5n [U5S :aU S S RUS S5-- n U $) 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" enumerater0r-r.r9getattrappendr errorToSymboljoinlen) r1msg breakIndexiattrvalueerrorfmtsubouts r2__str__ Date.__str__s 99 !49LJJ 0GAFF3 34EFF3Wn =>E} 4 6>!C!Ck$4--e44C#h 3!1"hhs2Aw s8a< 3#ab'** *C r5cSn[U[5(aURUR-UR-nSnUH nXS;dM Un O X@R;aUR US5nSnOGX@R;aUR US5nSnO#X@R;aUR US5nSn[ U5n[U5U4$)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) isinstancer9approximateSymbolsuncertainSymbolspriorTimeSymbolsreplacefloatr/)r1rP uncertaintysymfoundchars r2r+Date._stripErrors&!% eS ! !))D,A,AADDYDYYCE; E/// eR0+ /// eR0) /// eR0( e 5z;&&r5cZ^^^UUU4SjnTbTS:dTS:a[STS35eTb0TS:dTS:dTb!U"TTT5(a[STSTS35eUbUS :dUS :a [S 5eUbUS :dUS :a [S 5eUbUS :dUS :a [S5egg)Nc>TS;=(a TS:H=(d@ TS:H=(a TS:=(d( TS:H=(a TS:H=(a TSL=(a TS-$)N)rD rD)mdyrrrs r2 month_fail%Date._sanityCheck..month_failsZm+9r T /sRxT RsbyRT5ER$QR( Ur5 z$Month must be between 1 and 12, not .rlzDay 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)r1rrrr r!r"rss ``` r2r,Date._sanityChecks U  %!)urzCE7!LM M ?b7$E3)E)EtC5(DUG1MN N  TBY<= =  6A:">? ?  6A:">? ?2= r5cUR5[RS-;a[RS$UR5[RS-;a[RS$g)z Convert an error string (approximate, uncertain) into a symbol. >>> metadata.Date.errorToSymbol('approximate') '~' >>> metadata.Date.errorToSymbol('uncertain') '?' )rYr)rZN)lowerrr]r^)rPs r2rIDate.errorToSymbols_ ;;=D336FF F**1- - ;;=D11NB B((+ + Cr5c 4[U[R5(aURU5 O[U[5(aUR U5 Op[U[ 5(aUR [U55 O@[U[ 5(aURU5 O[R"SU35eURURURURURURUR S9 g)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)r\datetime loadDatetimer9loadStrr/r loadOtherrMetadataExceptionr,rrrr r!r"r1rPs r2load Date.loads( eX.. / /   e $ s # # LL  s # # LLU $ t $ $ NN5 !003EeW1MN N tyy #yyT[[  Rr5cURH4n[X5(dM[X5nUS;dM([XU5 M6 g)z 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)r0hasattrrGsetattr)r1dtrOrPs r2rDate.loadDatetime$s9NNDr  ) )D. #r5c URHNn[X5cM[X[X55 US-n[X5cM9[X[X55 MP g)a 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' NrA)r0rGr)r1r;rO errorAttrs r2rDate.loadOther:sONNDu#/GE$89 7N 5,8DWU-FG #r5c/n/nURSS5nURSS5nURS5HCnUS:XaSupVOURU5upVURU5 URU5 ME [ [ UR 55HTn[ U5U:dM[XR UX'5 X7cM6[XR US-X75 MV g) a 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) rErC rXrB)NNNrA)r`splitr+rHrangerKr0r)r1dateStrpost postErrorchunkrPrQrNs r2r Date.loadStrNs4 "$& //#s+//#r*]]3'E}) u#//6  KK    U # (s4>>*+A4y1}nnQ/9<+D.."3g"=y|L ,r5c/nURH-n[X5nUc OUR[U55 M/ [R"U6$)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) )r0rGrHr/r)r1rrOrPs r2r Date.datetime|sN,NNDD'E} KKE # #   $''r5cTURcURc URbgg)z 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"r1s r2hasTime Date.hasTimes( II !;;*;;*r5cLURHn[XS-5cM g g)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 rATF)r0rG)r1rOs r2hasError Date.hasErrors)0NNDtG^,8#r5) r0rr%r r&r!r'rr$r"r(rr#)rint | str | Nonerrrrr rr!rr"zint | float | str | Noner# str | Noner$rr%rr&rr'rr(rreturnbool)rPzint | float | strrztuple[int, str | None])rP DateParseType)rzdatetime.datetimerNone)r;rrr)rr9rr)__name__ __module__ __qualname____firstlineno____doc__r]r^r_r3r<rUr+r, staticmethodrIrrrrpropertyrrr__static_attributes__ror5r2rr.s\"H$!+ '+'+%)&*(,.2'+(,&*'+)-)-,N#,N%,N# ,N $ ,N & ,N,,N%,N&,N$,N%,N',N',N^'%P''(''-''R@. , ,RB/,H(*M\((@&r5rc\rSrSrSrS S SjjrSSjrSSjrSr\ S5r \ S5r \ RS 5r S r g ) DatePrimitiveia 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:/UlSUl/UlXlgNrX)_data _relevance_dataUncertainty relevance)r1rs r2r3DatePrimitive.__init__s!#  13"r5c[U5[U5L=(aY URUR:H=(a9 URUR:H=(a URUR:H$)z >>> 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 r2r<DatePrimitive.__eq__s^T d5k): ekk1:--1G1GG:%//9 ;r5c[U5$r7r8rs r2 _reprInternalDatePrimitive._reprInternal 4yr5c[UR5S:Xag[UR5S:Xa[URS5$[URVs/sHn[U5PM sn5$s snf)NrrXru)rKrr9)r1rqs r2rUDatePrimitive.__str__s] tzz?a  _ !tzz!}% % 3 1A 34 43sA;c4URSR$)z 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)rrrs r2rDatePrimitive.datetimes"zz!}%%%r5cUR$)zd The relevance attribute takes one of three values, `'certain'`, `'approximate'`, or `'uncertain'`. rrs r2rDatePrimitive.relevancer5cUS;a)Xl/UlURRU5 g[R"SU<35e)N)certainrYrZ1Relevance value is not supported by this object: )rrrHrrrs r2rr!sK ; ;#O$&D !  ! ! ( ( /00CE9MO Or5)rrrrN)r)rr9r)rr9)rrrrrr3r<rrUrrrsetterrror5r2rrs_#;"5&&$OOr5rcD^\rSrSrSrSSU4SjjjrSrSSjrSrU=r $) r i-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' cF>[TU]U5 URU5 gr7superr3 _prepareDatar1datar __class__s r2r3DateSingle.__init__C # $r5c2[URS5$)Nr)r9rrs r2rUDateSingle.__str__Gs4::a=!!r5c/UlUR/UlURR[ 55 URSR U5 g)) Assume a string is supplied as argument rN)rrrrHrrr1rs r2rDateSingle._prepareDataJsD  !% 0 $&! 1 4 r5)rr)rXrrr) rrrrrr3rUrr __classcell__rs@r2r r -s!*  " ! !r5r c~^\rSrSrSrS S U4SjjjrU4Sjr\S5r\RS5rS Sjr Sr U=r $) r iZa 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' cF>[TU]U5 URU5 gr7rrs r2r3DateRelative.__init__ms # $r5c>URn[TU] 5nUS:XaSU-$US:XaUS-$US:XaUS-$SU-$)Npriorz prior to onorbeforez or earlier onorafterz or laterzafter )rrrU)r1rdsrs r2rUDateRelative.__str__tsZ NN W_  <# # ,  % % +  # #b= r5cUR$)zm The relevance attribute takes one of four values, `'prior'`, `'after'`, or `'onorbefore'` or `'onorafter'`. rrs r2rDateRelative.relevancerr5cUS:XaSnUR5S;a[R"SU<35eUR5Ulg)Nbeforer)rafterrrr)r}rrrrs r2rrsJ H E ;;= M M00CE9MO O++-r5c/UlS/UlURR[55 URSR U5 g)rNr)rrrHrrrs r2rDateRelative._prepareDatas?  !% $&! 1 4 r5rrr)rXrr) rrrrrr3rUrrrrrrrs@r2r r ZsO$   !(( ! !r5r cx^\rSrSrSrS S U4SjjjrSrS Sjr\S5r \ RS5r Sr U=r $) ria  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?/--' cF>[TU]U5 URU5 gr7rrs r2r3DateBetween.__init__rr5c/nURHnUR[U55 M SRU5$)Nz to )rrHr9rJr1rLrqs r2rUDateBetween.__str__s4A JJs1v {{3r5c/Ul/UlUHTn[5nURU5 URR U5 URR S5 MV g)z; Assume a list of dates as strings is supplied as argument NrrrrrHr1rpartrqs r2rDateBetween._prepareDataU "DA FF4L JJ  a  ! ! ( ( . r5cUR$)z< The relevance attribute takes only one value: `'between'`. rrs r2rDateBetween.relevance r5cPUS:wa[R"SU<35eXlg)Nbetweenrrrrrs r2rrs. I 00CE9MO Or5r)rorrzIterable[DateParseType]) rrrrrr3rUrrrrrrrs@r2rrsJ(    /  r5rc^\rSrSrSrSrS S U4SjjjrSrS Sjr\ S5r \ RS5r S r U=r $) r ia 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. FcF>[TU]U5 URU5 gr7rrs r2r3DateSelection.__init__s  # $r5c/nURHnUR[U55 M SURS3R U5$)Nr)rrHr9rrJrs r2rUDateSelection.__str__sDA JJs1v 4??#1%**3//r5c/Ul/UlUHTn[5nURU5 URR U5 URR S5 MV g)z< Assume a list of dates as strings is supplied as argument. Nrrs r2rDateSelection._prepareDatarr5cUR$)zC The relevance attribute takes only two values: `'or'` or `'and'`. rrs r2rDateSelection.relevance'rr5cPUS;a[R"SU<35eXlg)N)orandrrrs r2rr/s.  %00CE9MO Or5r)rorr)rrrrrisSingler3rUrrrrrrrs@r2r r sa<H 24 .  0 /  r5r c\rSrSrSrS SSjjrSrSrSSjrSr \ S 5r \ RS 5r S r S rg)r i<a 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' Nc[U[5(aEURUlURUlURUlUR UlgXlX lX0lX@lgr7)r\r r _language isTranslatedencodingScheme)r1rlanguagerrs r2r3 Text.__init__KsY 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 r2r< Text.__eq__isn2 ;d4j ( :: $ ==ENN *    2 2 2   %"6"6 6r5c[U5[U5La[$URURURUR 4URURURUR 4:$)z0 Allows for alphabetically sorting two elements )rNotImplementedrrrrr:s r2__lt__ Text.__lt__se ;d4j (! ! ZZ(9(94;N;N O{{ENNE,>,>@T@TU V r5cUR$)z Set the language of the Text stored within. >>> myText = metadata.Text('my text') >>> myText.language = 'en' >>> myText.language 'en' rrs r2r Text.languages~~r5cXlgr7r'rs r2rr(sr5cXSSKJn UR[U5UR5$)aI 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)music21r+prependArticler9r)r1r+s r2getNormalizedArticleText.getNormalizedArticles"" !""3t9dnn==r5)rrrr)rXNNN)r str | Textrrr bool | Nonerrr)rrrrrr3rUrr<r$rrrr.rror5r2r r <s #%&*+/,0 11#1 )1"* 1&##L    __ >r5r cV^\rSrSrSrSSS.SU4SjjjjrS SjrSrU=r$) riuk 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)rolec2>[TU]XU5 X@lgr7)rr3r3)r1rrrr3rs r2r3Copyright.__init__s 6 r5c [U5[U5LagURUR:wagURUR:wagURUR:wagURUR:wagg)NFT)rrrrr3r:s r2r<Copyright.__eq__sh ;d4j ( :: $ ==ENN *    2 2 2 99 "r5)rXNN)rr0rrrr1r) rrrrrr3r<rrrs@r2rrsL!H#%&*+/ # )  r5rc ~\rSrSrSrSrSSSSSS S S S S S. r\R5r\R5r SSSSSS.S Sjjr Sr Sr S!SjrS"Sjr\S5r\R$S5r\S5r\R$S5r\S5r\R$S5r\S5r\S5rSrg)#ria 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) comcoacoscolcoclyrliblarlortrnNro)namenamesr3birthdeathc SUlU(aX0lOSUl/UlU(aU[U[5(aURR U5 O$URR [ U55 U(a_UHYn[U[5(aURR U5 M5URR [ U55 M[ /UlSUlSUlUb)[U[5(d [U5nOUnXlUb*[U[5(d [U5n OUn Xlggr7) _roler3_namesr\r rH _nationalityrPrQr ) r1rNrOr3rPrQkeywordsnbirthDSdeathDSs r2r3Contributor.__init__:s IDI#% $%% ""4( ""4:. a&&KK&&q)KK&&tAw/  )+&* &*  eZ00$U+ J  eZ00$U+ J r5c8URSUR3$)NrEr3rNrs r2rContributor._reprInternalis))Adii[))r5c>UR(dgUR$r)rNrs r2rUContributor.__str__lsyyyyr5c[U5[U5LagURUR:wag[UR5[UR5:wag[ [ UR5[ UR55H up#X#:wdM g UR UR :wagURUR:wagg)a >>> 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)rrSrKrTzipsortedrPrQ)r1r;rN otherNames r2r<Contributor.__eq__qsx ;d4j ( :: $ t{{ s5<<0 0"6$++#6u||8LMOD  N :: $ :: $r5cURcgURb0URRnURRnX- $[RR5URR- $)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)rPrQrnow)r1rqbs r2ageContributor.ageseN ::  :: ! ##A ##A5L$$((*TZZ-@-@@ @r5cVUR(a[URS5$g)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)rTr9rs r2rNContributor.names! ;;t{{1~& &r5cZ/UlURR[U55 gr7)rTrHr rs r2rNrks!  4;'r5cd/nURHnUR[U55 M U$)a 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'] )rTrHr9)r1rLrWs r2rOContributor.names s,"A JJs1v  r5c[R"U5(d[R"S5e/UlUH'nURR [ U55 M) g)Nz3.names must be a list -- do you mean .name instead?)r isIterablerrrTrHr )r1valuesrWs r2rOrn"sR  ((00EG G A KK  tAw 'r5cUR$)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' )rSrs r2r3Contributor.role+s0zzr5cUbXRR5;aXlgXR;aURUUlgXlgr7)roleAbbreviationsDictrqrSrs r2r3rsEsC =E%?%?%F%F%HHJ 00 033E:DJJr5cUR5nU[R;a[RU$[R"SU<35e)z Convert `abbreviation` to role name: >>> metadata.Contributor.abbreviationToRole('com') 'composer' >>> metadata.Contributor.abbreviationToRole('lib') 'librettist' zno such role: )r}rrurr) abbreviations r2abbreviationToRoleContributor.abbreviationToRoleNsO$))+ ;<< <44\B B00  013 3r5c[RH:nUR5[RUR5:XdM8Us $ [R"SU35e)zi Convert `roleName` to role abbreviation: >>> metadata.Contributor.roleToAbbreviation('composer') 'com' zNo such role: )rrur}rr)roleNamerole_ids r2roleToAbbreviationContributor.roleToAbbreviation`sV#88G~~;#D#DW#M#S#S#UU9,,~hZ-HIIr5)rTrUrSrPrQr3) rNstr | Text | NonerOzIterable[str | Text]r3rrPNone | DateSingle | strrQrr)rzdatetime.timedelta | None)rrrrrrrukeysroleAbbreviationsrq roleNamesr3rrUr<rhrrNrrOr3rrxr}rror5r2rrsb(I #"" .224%,,.I (,-/'+.2.2 -!$-!+-!% -! , -! , -!^* IZ/Af( [[(( * \\((2 [[33" J Jr5rc\rSrSrSrSrSrg)riqa( 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' creatorroN)rrrrrrrror5r2rrqs&Ir5rc\rSrSrSrSrSrg)r iz6 An object representation of imprint, or publication. c Xlgr7rV)r1rVs r2r3Imprint.__init__s r5rN)rrrrrr3rror5r2r r s !r5r cJ\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) TesticSSKJn URRS5nSUlUR UR S5 UR URS5 g)Nrmetadatazmy texten)r,r primitivesr r assertEqualrr)r1rr+s r2testText Test.testTextsJ$""'' 2  Y/ .r5cSSKJn URRSSS9nUR UR S5 UR UR S5 UR URS5 g)Nrrr:Gilles Binchoisr\r9)r,rrrrr3rrN)r1rr9s r2testContributorTest.testContributorsk$))55"6  )):6 .. > ))+<=r5cSSKJn URRSSS9nUR UR S5 UR UR S5 UR URS5 g)Nrrr:rr\r)r,rrrrr3rrN)r1rrs r2 testCreatorTest.testCreatorsg$%%--".  z2 **I6 '89r5cVSSKJn URRSSS9nURRSS9nUR UR S5 UR UR S5 UR UR S5 UR UR S5 g) Nrri3rY)rr#z1843?)rrZ)r,rrrrrr#)r1rdate1date2s r2testDate Test.testDates$##((dm(L##((g(6 T* -8 T* +6r5c*UR[S5 [SS9 SSS5 SH/upnUR[S5 [X2US9 SSS5 M1 UR[S5 [SS 9 SSS5 UR[S 5 [S S 9 SSS5 UR[S 5 [SS9 SSS5 UR[SSSS95 UR[SSS95 UR[SSS95 UR[SSSS95 g!,(df  GN#=f!,(df  GM4=f!,(df  N=f!,(df  N=f!,(df  N=f)NzMonth must be.*not 13 )r)) NN)rNN)rlrDN)rmN)rnrmizDay.*is not possible)rrrHour)r Minute=)r!Second)r"irmrn)rrrvrlrxryr)assertRaisesRegexrzrassertIsNotNone)r1rqrprrs r2testDateValueErrorTest.testDateValueErrors1  # #J0G H rNIGA! '' 4JK!!,LK  # #J 7 bM8  # #J 9 O:  # #J 9 O: Tt1"=> Tr23 T34 Tr"R@A-I HLK8 7 9 9 9 9s; D= E4 E" E3 F= E  E " E03 F Fc:SSKJn URRSS5nUR [ U5S5 UR [ UR5S5 UR URS5 UR URS/5 g)Nrr 2009/12/31rYru) r,rrr rr9rKrrr)r1r dateSingles r2testDateSingleTest.testDateSingles}$((33 -)  Z,7 Z--.2 .. > 44}oFr5c:SSKJn URRSS5nUR [ U5S5 UR UR S5 UR [UR5S5 UR URS/5 g)Nrrz 2001/12/31rzprior to 2001/12/31ru) r,rrr rr9rrKrr)r1r dateRelatives r2testDateRelativeTest.testDateRelatives|$**77 gN  \*,AB //9 \//0!4 66?r5c:SSKJn URRS5nUR [ U5S5 UR UR S5 UR URSS/5 UR [UR5S5 g)Nrr)r 2010/1/28z2009/12/31 to 2010/01/28rrm) r,rrrrr9rrrKr)r1r dateBetweens r2testDateBetweenTest.testDateBetween#s$))55 ')  [)+EF .. : 55d|D [../3r5c@SSKJn URR/SQS5nUR [ U5S5 UR UR S5 UR UR/SQ5 UR [UR5S5 g)Nrr)rrz 1894/1/28rz&2009/12/31 or 2010/01/28 or 1894/01/28)NNNr?) r,rrr rr9rrrKr)r1r dateSelections r2testDateSelectionTest.testDateSelection-s$ ++99 4   ]+A C 00$7 779KL ]00115r5roN)rrrrrrrrrrrrrrror5r2rrs2/ > : 7B2G@4 6r5r__main__)% __future__r__all__collections.abcrrtypingr-unittestr,rrrr Environment environLocalProtoM21Objectrrr r rr r rrrr TestCaser _DOC_ORDERr9rr/ ValueTypermainTestror5r2rs# % &&'<= ^7 ! !^D ZOG**ZOz&!&!ZB!=B!L? -? JO MO nE>7 ! !E>T77ziJ'((iJ\ k4!g$$!@m68  m6h    X&&&s* $ { *9 4S 8  z Tr5