rh.#lSSKJr SSKJrJr SSKrSSKr\R(aSSK J r /SQr \R"S5r SSjrSSjrSS jrSS jrSS jrSS jrSS jr\"5r\R.\4SSjj5r\R.SSj5r\S:XaSSKr\R8"5 gg)) annotations)Iterable CollectionN)Fraction) holdsTypeisNumisInt isListLike isIterableclassToClassStr getClassSet tempAttributesaveAttributes_TcN[U[5=(a USL=(a USL$)z Check if usrData is an integer and not True or False. >>> common.isInt(3) True >>> common.isInt(False) False >>> common.isInt(2.0) False TF) isinstanceintusrDatas S/home/james-whalen/.local/lib/python3.13/site-packages/music21/common/classTools.pyr r s% gs # Tt(; Tu@TTcFUS-nUSLaUSLagg![a gf=f)a. check if usrData is a music21 number (float, int, Fraction), return boolean and if True casts the value as a Rational number Differs from `isinstance(usrData, Rational)` which does not return True for `True, False`, and does not support Decimal Does not use `isinstance(usrData, Rational)` which is 2-6 times slower than calling this function (except in the case of Fraction, when it's 6 times faster, but that's rarer). (6 times slower on Py3.4, now only 2x slower in Python 3.10) Runs by adding 0 to the "number" -- so anything that implements add to a scalar works >>> common.isNum(3.0) True >>> common.isNum(3) True >>> common.isNum('three') False >>> common.isNum([2, 3, 4]) False True and False are NOT numbers: >>> common.isNum(True) False >>> common.isNum(False) False >>> common.isNum(None) False rTF) Exception)rdummys rrr.s8F!  $ 7%#7 s   c.[U[[45$)a5 Returns True if is a List or Tuple or their subclasses. Formerly allowed for set here, but that does not allow for subscripting (`set([1, 2, 3])[0]` is undefined). Differs from isinstance(collections.abc.Sequence()) in that we do not want Streams included even if __contains__, __reversed__, and count are added, and we do not want to include str or bytes. >>> common.isListLike([]) True >>> common.isListLike('sharp') False >>> common.isListLike((None, None)) True >>> common.isListLike({'a', 'b', 'c', 'c'}) False >>> common.isListLike(stream.Stream()) False )rlisttuplers rr r [s, ge} --rc[U[[45(ag[US5(aUR[ Laggg)a Returns True if is the object can be iter'd over and is NOT a string. Marks it as an Iterable for type checking. >>> common.isIterable([5, 10]) True >>> common.isIterable('sharp') False >>> common.isIterable((None, None)) True >>> common.isIterable(stream.Stream()) True Ranges are not iterators by python 3, but return True >>> common.isIterable(range(20)) True Classes are not iterable even if their instances are: >>> common.isIterable(stream.Stream) False * Changed in v7.3: Classes (not instances) are not iterable F__iter__T)rstrbyteshasattr __class__typers rr r ts<4'C<((w ##    $ rc[U5(dg[[U55n[X!5$![a gf=f)a Returns True if usrData is a Collection of type checkType. This reads an item from usrData, so don't use it on something where iterating destroys the type. >>> y = [1, 2, 3] >>> common.classTools.holdsType(y, int) True >>> common.classTools.holdsType(5, int) False >>> common.classTools.holdsType(['hello'], str) True Empty iterators hold the type: >>> common.classTools.holdsType([], float) True Note that a mixed collection holds whatever is first >>> common.classTools.holdsType((4, 'hello'), int) True >>> common.classTools.holdsType((4, 'hello'), str) False Works on sets with arbitrary order: >>> common.classTools.holdsType({2, 10}, int) True Intelligent collections will not have their position affected. >>> m = stream.Measure([note.Note('C'), note.Rest()]) >>> common.classTools.holdsType(m, note.GeneralNote) True >>> next(iter(m)) >>> r = range(1, 100) >>> common.classTools.holdsType(r, int) True >>> next(iter(r)) 1 * New in v9. FT)r nextiterr StopIteration)r checkTypefirsts rrrsC` g  T']#%++ s 2 ??c@[U5RSSS9SSS$)z Convert a class object to a class string. >>> common.classToClassStr(note.Note) 'Note' >>> common.classToClassStr(chord.Chord) 'Chord' .)maxsplitN)r rsplit)classObjs rr r s* x=  a  0 4Sb 99rc|Uc4URR5Vs/sHo"RPM nnO [U5nURR5nURR5Vs/sHo"RS-UR-PM nnX4-U-n[ U5nU$s snfs snf)aT Return the classSet for an instance (whether a Music21Object or something else). See base.Music21Object.classSet for more details. >>> p = pitch.Pitch() >>> cs = common.classTools.getClassSet(p) >>> cs frozenset(...) >>> pitch.Pitch in cs True >>> 'music21.pitch.Pitch' in cs True >>> 'Pitch' in cs True >>> object in cs True >>> 'object' in cs True >>> note.Note in cs False To save time (this IS a performance-critical operation), classNameTuple can be passed a tuple of names such as ('Pitch', 'object') that will save the creation time of this set. >>> cs2 = common.classTools.getClassSet(p, classNameTuple=('Pitch', 'ProtoM21Object')) >>> 'Pitch' in cs2 True Use base.Music21Object.classSet in general for music21Objects since it not only caches the result for each object, it caches the result for the whole class the first time it is run. r,)r#mro__name__r __module__ frozenset)instanceclassNameTuplex classNameList classObjList classListFQ classListclassSets rr r sD-5-?-?-C-C-EF-E-E F ^, %%))+L>> p = pitch.Pitch('C4') >>> p.midi 60 >>> with common.classTools.tempAttribute(p, 'nameWithOctave', 'D#5'): ... p.midi 75 >>> p.nameWithOctave 'C4' Setting to a new value is optional. For working with multiple attributes see :func:`~music21.classTools.saveAttributes`. * New in v7. N)getattrTEMP_ATTRIBUTE_SENTINELsetattr)obj attributenew_val tempStorages rrrs@*#)K--(-  , ,s!A5 AAAc'# 0nUHn[X5X#'M Sv UR5HupE[XU5 M g!UR5HupE[XU5 M f=f7f)a Save a number of attributes in an object and then restore them afterwards. >>> p = pitch.Pitch('C#2') >>> with common.classTools.saveAttributes(p, 'name', 'accidental'): ... p.step = 'E' ... p.accidental = pitch.Accidental('flat') ... p.nameWithOctave 'E-2' >>> p.nameWithOctave 'C#2' For storing and setting a value on a single attribute see :func:`~music21.classTools.tempAttribute`. * New in v7. N)rAitemsrC)rD attributeListrGrEkvs rrr,si&%'K" !(!8 # %%'DA CA (K%%'DA CA (sA0A&A0'A--A0__main__)rt.Anyreturnzt.TypeGuard[int])rrNrOz*t.TypeGuard[t.Union[float, int, Fraction]])rrNrOzt.TypeGuard[list | tuple])rrNrOzt.TypeGuard[Iterable])rrNr)ztype[_T]rOzt.TypeGuard[Collection[_T]])r2r$rOr )N)rEr )rJr rOzt.Generator[None, None, None]) __future__rcollections.abcrr contextlibtypingt TYPE_CHECKING fractionsr__all__TypeVarrr rr r rr r objectrBcontextmanagerrrr5music21mainTestrrr^s#0??" YYt_ U*Z.2 F6t :+\!( /F--8 > z r