jxddlmZgdZddlmZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl m Z e jd ZGd d e jZGd d e jZGddeZGddeZGddeZGddeZGdde jZGddeZGdde jZGddeZGdde jZGd d!ejZeeeeeeeefZeejzezZ eezezeze!zZ"e#d"krddl Z e j$edSdS)#) annotations) Contributor CopyrightCreatorDate DateBetween DatePrimitive DateRelative DateSelection DateSingleImprintText ValueType)IterableN)common) environment) exceptions21)prebasezmetadata.primitivesc eZdZdZdZdZdZddddddddddddd d/dZd0dZdZ d1dZ dZ e d Z d2d"Zd3d&Zd4d(Zd5d+Zed,Zed-Zed.ZdS)6ra 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 secondErrorrint | str | Nonerr r!r"r#int | float | str | Noner$ str | Noner%r&r'r(r)c ||||\}}||||\}}|| ||\}} || ||\}} || ||\}} || ||\}} |||||||tjtdz||_tjtdz||_tjtdz||_tjtdz||_tjtdz||_ tjtdz||_ ||_ ||_ | |_ | |_| |_| |_d|_dS)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 /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/metadata/primitives.py__init__z Date.__init__Zs   1"..t44OD)  !3 $ 0 0 7 7 E: ?x/ ,,S11MC   1"..t44OD)  +"5"&"2"26":": FK  +"5"&"2"26":": FK t5cV\bcccF3t8T** VCHe,, 6#d(C((F3t8T** fSXv.. fSXv.. $-$."* #,%0%0MreturnboolcBt|t|kSNstrr5others r6__eq__z Date.__eq__s4yyCJJ&&r8c g}|j|j |jd}nd}t|jD]\}}||krnt jtt||}t jtt||dz}|| dx|dkrd}nd}||z}||t |z }t|}| |d |dd } t|d kr#| d d |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# enumerater4r1r2r>getattrappendr errorToSymboljoinlen) r5msg breakIndexiattrvalueerrorfmtsubouts r6__str__z Date.__str__sR 9 !49LJJJ 00  GAtJF3d 3 344EF3dWn = =>>E} 4    6>>!CC!CEk$4--e444C#hh 3hhs2A2w s88a<< 3#abb'*** *C r8rTint | float | strtuple[int, str | None]cd}t|tr|j|jz|jz}d}|D] }||vr|}n ||jvr||d}d}nC||jvr||d}d}n!||jvr||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) isinstancer>approximateSymbolsuncertainSymbolspriorTimeSymbolsreplacefloatr3)r5rT uncertaintysymfoundchars r6r/zDate._stripErrors&!% eS ! ! ))D,AADDYYCE  3;; EE/// eR00+ $/// eR00) $/// eR00( e 5zz;&&r8ctfd}dksdkrtdd1dksdks#|rtddd||d ks|d krtd ||d ks|d krtd ||d ks|d krtddSdS)NcZdvrdkp dkodkpdkodkoduodzS)N)rH rH)mdyr rrs r6 month_failz%Date._sanityCheck..month_failsZm+9r T /sRxT RsbyRT5ER$QR( Ur8 z$Month must be between 1 and 12, not .rpzDay 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)r5rrr r!r"r#rws ``` r6r0zDate._sanityChecks. U U U U U U U  %!))urzzLELLLMM M ?b77$E3)E)E$MCMMUMMMNN N  TBYY<== =  6A::">?? ?  6A::">?? ?  r8c|tjdzvrtjdS|tjdzvrtjdSdS)z Convert an error string (approximate, uncertain) into a symbol. >>> metadata.Date.errorToSymbol('approximate') '~' >>> metadata.Date.errorToSymbol('uncertain') '?' )r^r)r_N)lowerrrbrc)rTs r6rMzDate.errorToSymbols` ;;==D36FF F F*1- - ;;==D1NB B B(+ + C Br8 DateParseTypec"t|tjr||nt|tr||nzt|t r#|t|nBt|t r||ntj d|| |j |j |j |j|j|jdS)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)radatetime loadDatetimer>loadStrr3r loadOtherrMetadataExceptionr0rrr r!r"r#r5rTs r6loadz Date.loads( eX. / / O   e $ $ $ $ s # # O LL     s # # O LLU $ $ $ $ t $ $ O NN5 ! ! ! !01Me1M1MNN N ty #yT[  R R R R Rr8dtdatetime.datetimeNonec|jD]7}t||r%t||}|dvrt|||8dS)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)r4hasattrrKsetattr)r5rrSrTs r6rzDate.loadDatetime%s^N / /Dr4   /D)) ))D$...  / /r8r@c |jD]e}t||St||t|||dz}t||t||t||fdS)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' NrE)r4rKr)r5r@rS errorAttrs r6rzDate.loadOther;sN H HDud##/dGE4$8$8999 7N 5),,8D)WUI-F-FGGG  H Hr8dateStrr>c>g}g}|dd}|dd}|dD]P}|dkrd\}}n||\}}||||Qt t |jD]d}t ||krOt||j|||||%t||j|dz||edS) 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) rIrG r]rF)NNNrE)resplitr/rLrangerOr4r)r5rpost postErrorchunkrTrUrRs r6rz Date.loadStrOs+4 "$& //#s++//#r**]]3'' $ $E}}) uu#//66 u KK      U # # # #s4>**++ M MA4yy1}}dnQ/a999Q<+D$."3g"=y|LLL  M Mr8cg}|jD]8}t||}|n#|t|9t 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) )r4rKrLr3r)r5rrSrTs r6rz Date.datetime}s^,N $ $DD$''E} KKE # # # # $''r8c4|j|j|jdSdS)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 NTFr!r"r#r5s r6hasTimez Date.hasTimes& I !;*;*45r8cF|jD]}t||dzdSdS)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 rENTF)r4rK)r5rSs r6hasErrorz Date.hasErrors:0N  DtTG^,,8tt9ur8)rr*rr*r r*r!r*r"r*r#r+r$r,r%r,r&r,r'r,r(r,r)r,r9r:)rTrZr9r[)rTr)rrr9r)r@rr9r)rr>r9r)__name__ __module__ __qualname____doc__rbrcrdr7rArYr/r0 staticmethodrMrrrrpropertyrrrrsr8r6rr/s""H$!+ '+'+%)&*(,.2'+(,&*'+)-)-,N,N,N,N,N,N^''''%%%P''''''''R@@@. , ,\ ,RRRRB////,HHHH(*M*M*M*M\((X(@X&Xr8rc~eZdZdZdddZddZdd Zd Zed Z ed Z e j d Z dS)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. certain relevancer>c>g|_d|_g|_||_dSNr])_data _relevance_dataUncertaintyr)r5rs r6r7zDatePrimitive.__init__s%!#  13"r8r9r:ct|t|uo/|j|jko|j|jko|j|jkS)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 r6rAzDatePrimitive.__eq__sTT d5kk): ek1:-1GG:%/9 ;r8c t|Sr<r=rs r6 _reprInternalzDatePrimitive._reprInternal4yyr8ct|jdkrdSt|jdkrt|jdStd|jDS)Nrr]rxc,g|]}t|Srsr=).0rus r6 z)DatePrimitive.__str__..s3331A333r8)rOrr>rs r6rYzDatePrimitive.__str__s` tz??a  2 __ ! !tz!}%% %33 33344 4r8c&|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)rrrs r6rzDatePrimitive.datetimes"z!}%%r8c|jS)z The relevance attribute takes one of three values, `'certain'`, `'approximate'`, or `'uncertain'`. rrs r6rzDatePrimitive.relevance r8c|dvr*||_g|_|j|dStjd|)N)rr^r_1Relevance value is not supported by this object: )rrrLrrrs r6rzDatePrimitive.relevance"s] ; ; ;#DO$&D !  ! ( ( / / / / /0MEMMOO Or8N)r)rr>r)r9r>) rrrrr7rArrYrrrsetterrsr8r6r r s#####;;;;"555&&X&$XOOOOOr8r c4eZdZdZd d fd ZdZd dZxZS) 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' r]rdatarctt|||dSr<superr7 _prepareDatar5rr __class__s r6r7zDateSingle.__init__D5 ### $r8c6t|jdS)Nr)r>rrs r6rYzDateSingle.__str__Hs4:a=!!!r8cg|_|jg|_|jt |jd|dS)9 Assume a string is supplied as argument rN)rrrrLrrr5rs r6rzDateSingle._prepareDataKsR  !% 0 $&&!!! 1 4     r8)r]rrr)rrrrr7rYr __classcell__rs@r6r r .so*       """ ! ! ! ! ! ! ! !r8r cneZdZdZd d fd ZfdZedZejd Zd d Z 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' r]afterrrctt|||dSr<rrs r6r7zDateRelative.__init__ns5 ### $r8c|j}t}|dkrd|zS|dkr|dzS|dkr|dzSd|zS)Npriorz prior to onorbeforez or earlier onorafterz or laterzafter )rrrY)r5rdsrs r6rYzDateRelative.__str__usg N WW__   <<# # ,   % % +   # #b= r8c|jS)z The relevance attribute takes one of four values, `'prior'`, `'after'`, or `'onorbefore'` or `'onorafter'`. rrs r6rzDateRelative.relevancerr8c|dkrd}|dvrtjd|||_dS)Nbeforer)rrrrr)rrrrrs r6rzDateRelative.relevances\ H  E ;;== M M M0MEMMOO O++--r8cg|_dg|_|jt|jd|dS)rNr)rrrLrrrs r6rzDateRelative._prepareDatasO  !% $&&!!! 1 4     r8)r]rr) rrrrr7rYrrrrrrs@r6r r [s$        ! ! ! ! !X((( ! ! ! ! ! ! ! !r8r cjeZdZdZd d fd ZdZd dZed Zej d ZxZ 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?/--' rsbetweenrIterable[DateParseType]ctt|||dSr<rrs r6r7zDateBetween.__init__rr8cg}|jD]$}|t|%d|S)Nz to )rrLr>rNr5rPrus r6rYzDateBetween.__str__sE  A JJs1vv    {{3r8cg|_g|_|D]Y}t}|||j||jdZdS)zK Assume a list of dates as strings is supplied as argument NrrrrrLr5rpartrus r6rzDateBetween._prepareDatat " / /DA FF4LLL J  a  ! ( ( . . . .  / /r8c|jS)zT The relevance attribute takes only one value: `'between'`. rrs r6rzDateBetween.relevance r8cN|dkrtjd|||_dS)Nrrrrrrs r6rzDateBetween.relevances; I  0MEMMOO Or8)rsrrr) rrrrr7rYrrrrrrs@r6rrs(           / / / /X       r8rcreZdZdZdZ d d fd ZdZd d Zed Z e j d Z 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. Frsorrrctt|||dSr<rrs r6r7zDateSelection.__init__ s7 ### $r8cg}|jD]$}|t|%d|jd|S)Nr)rrLr>rrNrs r6rYzDateSelection.__str__sT  A JJs1vv    %4?%%%**3///r8cg|_g|_|D]Y}t}|||j||jdZdS)zL Assume a list of dates as strings is supplied as argument. Nrrs r6rzDateSelection._prepareDatarr8c|jS)z[ The relevance attribute takes only two values: `'or'` or `'and'`. rrs r6rzDateSelection.relevance(rr8cJ|dvrtjd|||_dS)N)randrrrs r6rzDateSelection.relevance0s;  % %0MEMMOO Or8)rsrr) rrrrisSingler7rYrrrrrrs@r6r r s<H 24       000 / / / /X       r8r czeZdZdZ ddd Zd Zd ZddZdZe dZ e j dZ dZ dS)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' r]Nr str | Textlanguager, isTranslated bool | NoneencodingSchemect|tr2|j|_|j|_|j|_|j|_dS||_||_||_||_dSr<)rarr _languagerr)r5rrrrs r6r7z Text.__init__Lsh dD ! ! 1#':DJ'+~DN+/+rs r6rYz Text.__str___sV dj% ( ( #:$$W-- -  C ( ( #: tz?? "r8c t|Sr<r=rs r6rzText._reprInternalgrr8r9r:ct|t|urdS|j|jkrdS|j|jkrdS|j|jkrdS|j|jkrdSdS)a >>> 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 r6rAz Text.__eq__jsy2 ;;d4jj ( (5 : $ $5 =EN * *5   2 2 25  %"6 6 65tr8ct|t|urtS|j|j|j|jf|j|j|j|jfkS)z@ Allows for alphabetically sorting two elements )rNotImplementedrrrrr?s r6__lt__z Text.__lt__sX ;;d4jj ( (! ! Z(94;N O{ENE,>@TU V r8c|jS)z Set the language of the Text stored within. >>> myText = metadata.Text('my text') >>> myText.language = 'en' >>> myText.language 'en' rrs r6rz Text.languages ~r8c||_dSr<rrs r6rz Text.languages r8c^ddlm}|t||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)music21r prependArticler>r)r5r s r6getNormalizedArticlezText.getNormalizedArticles4" !     ""3t99dn===r8)r]NNN)rrrr,rrrr,r) rrrrr7rYrrArrrrr rsr8r6rr=s  #%&*+/,0 11111&#######L      X __ >>>>>r8rc:eZdZdZ ddddfd ZddZxZS)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 r]N)rolerrrr,rrc\t|||||_dSr<)rr7r)r5rrrrrs r6r7zCopyright.__init__s, x666 r8r9r:ct|t|urdS|j|jkrdS|j|jkrdS|j|jkrdS|j|jkrdSdS)NFT)rrrrrr?s r6rAzCopyright.__eq__su ;;d4jj ( (5 : $ $5 =EN * *5   2 2 25 9 " "5tr8)r]NN)rrrr,rrr)rrrrr7rArrs@r6rrs{!!H#%&*+/         r8rc eZdZdZdZddddddd d d d d ZeZeZ ddddddd)dZ dZ dZ d*dZ d+d Zed!Zejd"Zed#Zejd$Zed%Zejd&Zed'Zed(ZdS),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) comcoacoscolcoclyrliblarlortrnNrs)namenamesrbirthdeathr'str | Text | Noner(Iterable[str | Text]rr)None | DateSingle | strr*c d|_|r||_nd|_g|_|rWt|tr|j|n'|jt ||r\|D]Y}t|tr|j|2|jt |Zg|_d|_d|_|.t|tst|}n|}||_|0t|tst|} n|} | |_dSdSr<) _roler_namesrarrL _nationalityr)r*r ) r5r'r(rr)r*keywordsnbirthDSdeathDSs r6r7zContributor.__init__;sd  DIIDI#%  /$%% / ""4(((( ""4::...  0 0 0a&&0K&&q))))K&&tAww////(*&* &*  eZ00 $U++ DJ  eZ00 $U++ DJJJ  r8c$|jd|jS)NrIrr'rs r6rzContributor._reprInternaljs)))di)))r8c"|jsdS|jSr)r'rs r6rYzContributor.__str__msy 2yr8r9r:ct|t|urdS|j|jkrdSt|jt|jkrdSt t |jt |jD]\}}||krdS|j|jkrdS|j|jkrdSdS)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/rOr0zipsortedr)r*)r5r@r' otherNames r6rAzContributor.__eq__rsx ;;d4jj ( (5 : $ $5 t{  s5<00 0 05"6$+#6#6u|8L8LMM  OD)y  uu! : $ $5 : $ $5tr8datetime.timedelta | Nonec|jdS|j|jj}|jj}||z Stj|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*rnow)r5rubs r6agezContributor.agesVN : 4 : ! #A #Aq5L$((**TZ-@@ @r8cH|jrt|jdSdS)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)r0r>rs r6r'zContributor.names' ; t{1~&& &4r8cbg|_|jt|dSr<)r0rLrrs r6r'zContributor.names-  4;;'''''r8cbg}|jD]$}|t|%|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'] )r0rLr>)r5rPr3s r6r(zContributor.names s:"  A JJs1vv     r8ctj|stjdg|_|D])}|jt |*dS)Nz3.names must be a list -- do you mean .name instead?)r isIterablerrr0rLr)r5valuesr3s r6r(zContributor.names#sp (( G0EGG G  ( (A K  tAww ' ' ' ' ( (r8c|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 r6rzContributor.role,s 0zr8c|||jvr ||_dS||jvr|j||_dS||_dSr<)roleAbbreviationsDictrGr/rs r6rzContributor.roleFsW =ET%?%F%F%H%HHHDJJJ d0 0 03E:DJJJDJJJr8c|}|tjvrtj|Stjd|)z Convert `abbreviation` to role name: >>> metadata.Contributor.abbreviationToRole('com') 'composer' >>> metadata.Contributor.abbreviationToRole('lib') 'librettist' zno such role: )rrrJrr) abbreviations r6abbreviationToRolezContributor.abbreviationToRoleOsQ$))++ ;< < <4\B B011133 3r8ctjD]@}|tj|kr|cSAtjd|)z Convert `roleName` to role abbreviation: >>> metadata.Contributor.roleToAbbreviation('composer') 'com' zNo such role: )rrJrrr)roleNamerole_ids r6roleToAbbreviationzContributor.roleToAbbreviationash#8  G~~;#DW#M#S#S#U#UUUV,-Hh-H-HIIIr8) r'r+r(r,rr+r)r-r*r-r)r9r=)rrrrrrJkeysroleAbbreviationsrG roleNamesr7rrYrArArr'rr(rrrMrQrsr8r6rrs(I #""  .2244%,,..I (,-/'+.2.2 -!-!-!-!-!-!^*** IIIIZ/A/A/A/AfX( [(([( X* \((\(X2 [[33\3" J J\ J J Jr8rceZdZdZdZdS)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)rrrrrrsr8r6rrrs&IIIr8rceZdZdZdZdS)r z> An object representation of imprint, or publication. c ||_dSr<)r2)r5r2s r6r7zImprint.__init__s   r8N)rrrrr7rsr8r6r r s-!!!!!r8r cDeZdZdZdZdZdZdZdZdZ dZ d Z d S) Testcddlm}|jd}d|_||jd||jddS)Nrmetadatazmy texten)r r] primitivesrr assertEqualrr)r5r]r s r6testTextz Test.testTextsg$$$$$$"'' 22  Y/// .....r8cddlm}|jdd}||jd||jd||jddS)Nrr\rGilles Binchoisr7r)r r]r_rr`rrr')r5r]rs r6testContributorzTest.testContributors$$$$$$)55"6   ):666 . >>> )+<=====r8cddlm}|jdd}||jd||jd||jddS)Nrr\rrcr7rV)r r]r_rr`rrr')r5r]rVs r6 testCreatorzTest.testCreators$$$$$$%--".   z222 *I666 '899999r8cXddlm}|jdd}|jd}||jd||jd||jd||jddS) Nrr\i3r^)rr$z1843?)rr_)r r]r_rr`rr$)r5r]date1date2s r6testDatez Test.testDates$$$$$$#((dm(LL#((g(66 T*** -888 T*** +66666r8c|td5tddddn #1swxYwYdD]K\}}}|td5t|||dddn #1swxYwYL|td5td dddn #1swxYwY|td 5td dddn #1swxYwY|td 5tddddn #1swxYwY|tddd|tdd|tdd|tddddS)NzMonth must be.*not 13 )r)) NN)rNN)rprHN)rqN)rrrqizDay.*is not possible)rrr Hour)r!Minute=)r"Second)r#irqrr)rr ryrpr{r|r)assertRaisesRegexr}rassertIsNotNone)r5rurtrvs r6testDateValueErrorzTest.testDateValueErrors  # #J0G H H   rNNNN                - -GAq! '' 4JKK - -!1!,,,, - - - - - - - - - - - - - - - # #J 7 7   bMMMM                 # #J 9 9   OOOO                 # #J 9 9   OOOO                Tt1"===>>> Tr222333 T333444 Tr"R@@@AAAAAsU9=='BB B -C  CC0D  DD3EEEcLddlm}|jdd}|t |d|t |jd||jd||j dgdS)Nrr\ 2009/12/31r^rx) r r]r_r r`r>rOrrr)r5r] dateSingles r6testDateSinglezTest.testDateSingles$$$$$$(33 -))  Z,777 Z-..222 . >>> 4}oFFFFFr8cLddlm}|jdd}|t |d||jd|t|jd||j dgdS)Nrr\z 2001/12/31rzprior to 2001/12/31rx) r r]r_r r`r>rrOrr)r5r] dateRelatives r6testDateRelativezTest.testDateRelatives$$$$$$*77 gNN  \**,ABBB /999 \/00!444 6?????r8cLddlm}|jd}|t |d||jd||jddg|t|j ddS)Nrr\)ry 2010/1/28z2009/12/31 to 2010/01/28rrq) r r]r_rr`r>rrrOr)r5r] dateBetweens r6testDateBetweenzTest.testDateBetween$s$$$$$$)55 '))  [))+EFFF . ::: 5d|DDD [.//33333r8cRddlm}|jgdd}|t |d||jd||jgd|t|j ddS)Nrr\)ryrz 1894/1/28rz&2009/12/31 or 2010/01/28 or 1894/01/28)NNNrC) r r]r_r r`r>rrrOr)r5r] dateSelections r6testDateSelectionzTest.testDateSelection.s$$$$$$ +99 4 4 4    ]++A C C C 0$777 79K9K9KLLL ]011155555r8N) rrrrardrfrjrwr{r~rrrsr8r6rZrZs/// > > > : : : 7 7 7BBB2GGG@@@444 6 6 6 6 6r8rZ__main__)% __future__r__all__collections.abcrrtypingr1unittestr rrrr Environment environLocalProtoM21Objectrr r r rr rrrrr TestCaserZ _DOC_ORDERr>rr3rrmainTestrsr8r6rs#"""""   %$$$$$ '{&'<== ^^^^^7 !^^^D ZOZOZOZOZOG*ZOZOZOz&!&!&!&!&!&!&!&!ZB!B!B!B!B!=B!B!B!L? ? ? ? ? -? ? ? JO O O O O MO O O nE>E>E>E>E>7 !E>E>E>T77777777ziJiJiJiJiJ'(iJiJiJ\ k4!!!!!g$!!!@m6m6m6m6m68 m6m6m6h    X&&s* $ { *9 4S 8  zNNNGTr8