3j ^ddlmZddlmZmZmZddlZGddeZGddeZGdd ee Z Gd d eZ Gd de ee Z Gdde Z Gdde ZGdde ZGdde ZGdde ZGdde Zedk(rddlZej*yy)) annotations)EnumEnumTypeIntEnumNceZdZfdZxZS) StrEnumMetact|tr||jjvryy t||S#t $rYywxYwNTF) isinstancestr __members__valuessuper __contains__ TypeError)clsitem __class__s A/DATA/.local/lib/python3.12/site-packages/music21/common/enums.pyrzStrEnumMeta.__contains__sO dC s--// 7'- -  sA A  A )__name__ __module__ __qualname__r __classcell__rs@rrrs   rceZdZdZdZy) ContainsMetaz This is a backport of the Python 3.12 `EnumType` class's contains method. This will be removed when Python 3.12 is the minimum version for music21. c4 ||y#t$rYywxYwr ) ValueError)rrs rrzContainsMeta.__contains__$s#  I  s  N)rrr__doc__rrrrrs  rrc2eZdZdZfdZedZxZS) ContainsEnumzL An IntEnum that allows "in" checks against the values of the enum. cPt|}tjdd|S)Nz(\d+)c>dt|jddS)N0xX)intgroup)ms rz'ContainsEnum.__repr__..3sBs1771:q.A*Br)r__repr__resub)selfvalrs rr-zContainsEnum.__repr__1s$g vvh BCHHrc||jvS)N)_value2member_map_)rr1s rhasValuezContainsEnum.hasValue5sc,,,,r)rrrr r- classmethodr4rrs@rr#r#-s"I--rr#) metaclassc>eZdZdZedZfdZdZdZxZ S) BooleanEnuma7 An enum that replaces a boolean, except the "is" part, and allows specifying multiple values that can specify whether they equate to True or False. Useful for taking an element that was previously True/False and replacing it in a backwards-compatible way with an Enum. >>> from music21.common.enums import BooleanEnum >>> class Maybe(BooleanEnum): ... YES = True ... NO = False ... MAYBE = 0.5 ... NOT_A_CHANCE = (False, 'not a chance') ... DEFINITELY = (True, 'of course!') >>> bool(Maybe.YES) True >>> bool(Maybe.NO) False >>> bool(Maybe.MAYBE) True >>> bool(Maybe.NOT_A_CHANCE) False >>> bool(Maybe.DEFINITELY) True >>> Maybe.MAYBE == 0.5 True >>> Maybe.NOT_A_CHANCE == 'not a chance' True >>> Maybe.NOT_A_CHANCE == False True >>> Maybe.NOT_A_CHANCE == True False >>> Maybe.NOT_A_CHANCE == 'not any chance' False >>> Maybe.DEFINITELY == 'of course!' True >>> Maybe.NOT_A_CHANCE == (False, 'not a chance') True cht|tr"t|dk(rt|dtryy)NrTF)r tuplelenbool)vs r is_bool_tuplezBooleanEnum.is_bool_tuplecs) a CFaKJqtT4Jrct||jrt| |S|j}||k(ry|j |r|d|ury|d|k(Sy)NTrr'F)r rr__eq__valuer?)r0otherr>rs rrAzBooleanEnum.__eq__js` eT^^ ,7>%( ( JJ :    "tu}Q45= rcp|j}|j|r|dSt|jS)Nr)rBr?r=)r0r>s r__bool__zBooleanEnum.__bool__vs1 JJ   a Q4KDJJrcPd|jjd|jdSN<.>rrnamer0s rr-zBooleanEnum.__repr__|&4>>**+1TYYKq99r) rrrr staticmethodr?rArEr-rrs@rr8r8:s,'P  :rr8ceZdZdZdZdZy)StrEnuma An enumeration where strings can equal the value, and strings can be found "in" the enum. See :class:`music21.common.enums.OffsetSpecial` for an example of how subclassing this would work. * Note: This class predates the equivalent StrEnum in Python 3.11 and the changes to Enum `__contains__` in 3.12. Once Python 3.12 is the minimum version of music21, this class will no longer be used internally and will eventually become deprecated (2027?) and removed (2030?). cPd|jjd|jdSrGrKrMs rr-zStrEnum.__repr__rNrc,t|jS)z >>> from music21.common.enums import OffsetSpecial >>> str(OffsetSpecial.AT_END) 'highestTime' )r rBrMs r__str__zStrEnum.__str__s 4::rN)rrrr r-rTr!rrrQrQs :rrQc<eZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zy ) ElementSearchz An enum representing the element search directions that can be provided to :meth:`~music21.base.Music21Object.getContextByClass`. getElementBeforegetElementAftergetElementAtOrBeforegetElementAtOrAftergetElementBeforeOffsetgetElementAfterOffsetgetElementAtOrBeforeOffsetgetElementAtOrAfterOffsetgetElementBeforeNotSelfgetElementAfterNotSelfallN)rrrr BEFOREAFTER AT_OR_BEFORE AT_OR_AFTER BEFORE_OFFSET AFTER_OFFSETAT_OR_BEFORE_OFFSETAT_OR_AFTER_OFFSETBEFORE_NOT_SELFAFTER_NOT_SELFALLr!rrrVrVsB F E)L'K,M*L64/O-N CrrVceZdZdZdZdZdZy) OffsetSpeciala An enum that represents special offsets. The enum `AT_END` is equal to the string 'highestTime' >>> from music21.common.enums import OffsetSpecial >>> OffsetSpecial.AT_END >>> 'highestTime' == OffsetSpecial.AT_END True >>> 'crazyOffset' in OffsetSpecial False >>> 6.0 in OffsetSpecial False >>> 'lowestOffset' in OffsetSpecial True >>> str(OffsetSpecial.AT_END) 'highestTime' * New in v7. * Note -- a previous note said that the 'highestTime' == OffsetSpecial.AT_END would be removed in v9 or an upcoming music21 release. Since then, Python has changed direction and in 3.11 added StrEnum to the standard library and in 3.12 allows for containment checks of strings in StrEnum (such as `'lowestOffset' in OffsetSpecial` returning True). Therefore there is no reason for music21 to ever remove this valuable and backwards compatible tool. highestTime lowestOffset highestOffsetN)rrrr AT_END LOWEST_OFFSETHIGHEST_OFFSETr!rrrnrns8F"M$NrrnceZdZdZdZdZdZy)GatherSpannersa An enumeration for how to gather missing spanners >>> from music21.common.enums import GatherSpanners Indicates all relevant spanners will be gathered: >>> GatherSpanners.ALL >>> bool(GatherSpanners.ALL) True Indicates no relevant spanners will be gathered: >>> GatherSpanners.NONE >>> bool(GatherSpanners.NONE) False Indicates only spanners where all of their members are in the excerpt will be gathered: >>> GatherSpanners.COMPLETE_ONLY >>> bool(GatherSpanners.COMPLETE_ONLY) True TF completeOnlyN)rrrr rlNONE COMPLETE_ONLYr!rrrvrvs6 C D"MrrvceZdZdZdZdZdZy)AppendSpannersa; An enumeration for how to append related spanners when appending objects to a written file. AppendSpanners.NORMAL means append the spanners that start with the object, then append the object, then append the spanners that end with the object. AppendSpanners.RELATED_ONLY means append the spanners that start with the object, then append the spanners that end with the object (i.e. do not append the object). AppendSpanners.NONE means do not append the related spanners at all (i.e. only append the object). * New in v9. normal related_onlynoneN)rrrr NORMAL RELATED_ONLYrxr!rrr{r{s F!L Drr{ceZdZdZdZdZy) OrnamentDelaya An enumeration for the delay in an ornament (e.g. a delayed turn). The delay for an ornament can be set to one of these values, or to an OffsetQL for a timed delay. OrnamentDelay.NO_DELAY means there is no delay (this is equivalent to setting delay to 0.0) OrnamentDelay.DEFAULT_DELAY means the delay is half the duration of the ornamented note. * New in v9. noDelay defaultDelayN)rrrr NO_DELAY DEFAULT_DELAYr!rrrrsH"MrrceZdZdZdZdZdZy) MeterDivisionzU Represents an indication of how to divide a TimeSignature * New in v7. fastslowr~N)rrrr FASTSLOWrxr!rrrrs D D Drr__main__) __future__renumrrrr.rrr#r8r rQrVrnrvr{rrrmusic21mainTestr!rrrs#((  (  8  -7l -C:$C:Lc4;4G$%G%D#[#BW$ #G #G zGr