rhr&2SrSSKJr SSKJrJr SSKrSSKrSSKrSSK r SSK r SSK r SSK r SSK r SSKrSSKrSSKJr /SQr\R((a\R*"S5rSSjrSS .SS jjrS rSS jrSS jrSSjrSrSSjr\"SSS5SSj5r\ "S5\ "\!5\ "\"5\#\$\%\&\'\(\ RR\ \*\ RV\ RX\RZ\.1r/S SS.S!Sjjjr0S"Sjr1\2S:XaSSK3r3\3Rh"5 gg)#zO If it doesn't fit anywhere else in the common directory, you'll find it here! ) annotations)CallableIterableN) deprecated) flattenListgetMissingImportStr getPlatform macOSVersion sortModules pitchListuniquerunningInNotebookdefaultDeepcopycleanedFlatNotation_TcHUVVs/sH oHo"PM M snn$s snnf)z Flatten a list of lists into a flat list: >>> l = [[1, 2, 3], [4, 5], [6]] >>> common.flattenList(l) [1, 2, 3, 4, 5, 6] But not a list of lists-of-lists! >>> l2 = [[1, 2, 3], [4, 5], [6, [7, 8]]] >>> common.flattenList(l2) [1, 2, 3, 4, 5, 6, [7, 8]] ) originalListsublistitems M/home/james-whalen/.local/lib/python3.13/site-packages/music21/common/misc.pyrr2s$!- A WDD AA As)keyc[5n/nUH>nU(a U"U5nOUnXR;aMURU5 URU5 M@ U$)aq Return a List of unique items from an iterable, preserving order. (unlike casting to a set and back) (And why is this not already in Python?) >>> common.misc.unique([3, 2, 4, 3, 2, 5]) [3, 2, 4, 5] Works on any iterable, but order might not be preserved for sets, etc. >>> common.misc.unique(range(5)) [0, 1, 2, 3, 4] If key is a function then use that to get the value: >>> s = converter.parse('tinyNotation: c4 E d C f# e a') >>> common.misc.unique(s.recurse().notes, key=lambda n: n.name) [, , , , ] )setaddappend)rrseenoutelelKeys rr r CsP2 5D C GEE =   2 JcU(dg[U5S:XaUSn[R"SUS35$SRU5n[R"SUS35$) a Given a list of missing module names, returns a nicely-formatted message to the user that gives instructions on how to expand music21 with optional packages. >>> print(common.getMissingImportStr(['matplotlib'])) Certain music21 functions might need the optional package matplotlib; if you run into errors, install it by following the instructions at https://www.music21.org/music21docs/installing/installAdditional.html >>> print(common.getMissingImportStr(['matplotlib', 'numpy'])) Certain music21 functions might need these optional packages: matplotlib, numpy; if you run into errors, install them by following the instructions at https://www.music21.org/music21docs/installing/installAdditional.html Nrz:Certain music21 functions might need the optional package z; if you run into errors, install it by following the instructions at https://www.music21.org/music21docs/installing/installAdditional.html, z>Certain music21 functions might need these optional packages: z; if you run into errors, install them by following the instructions at https://www.music21.org/music21docs/installing/installAdditional.html)lentextwrapdedentjoin) modNameListms rrrms  [ Q  N#]^_]`aX [\ \ IIk "NqcRY \] ]r!c[R"5S:Xag[R"5S:Xag[RS:Xag[R$)a, Return the name of the platform, where platforms are divided between 'win' (for Windows), 'darwin' (for MacOS X), and 'nix' for (GNU/Linux and other variants). Does not discern between Linux/FreeBSD, etc. Lowercase names are for backwards compatibility -- this existed before the platform module. WindowswinDarwindarwinposixnix)platformsystemosnamerr!rr r s@I%  h & G wwr!c[5S:wag[S[R"5SR S555tpU(aUSOSn[ U5S:aUSOSnXU4$)z On a Mac returns the current version as a tuple of (currently 3) ints, such as: (10, 5, 6) for 10.5.6. On other systems, returns (0, 0, 0) r/)rrrc38# UHn[U5v M g7fN)int).0vs r macOSVersion..s)[:ZQ#a&&:Zsr.r#)r tupler2mac_versplitr%)majorminor_and_maintenanceminor maintenances rr r su} %*)[(:J:J:LQ:O:U:UVY:Z)[$[!E(= !! $1E.12G.H1.L'*RSK + &&r!c/n0nUHnX2UR'URn[R"U5n[R "US5n[R "U5nURXgUR45 M UR5 UR5 UVVVs/sH upgoUPM n nnnU $s snnnf)z Sort a list of imported module names such that most recently modified is first. In ties, last access time is used then module name Will return a different order each time depending on the last mod time ) __name____file__r4stattime localtimeasctimersortreverse) moduleListrN modNameToModmodfprJlastmodrMmodNameoutModss rr r s DL%(S\\" \\wwr{..a),,w' Ws||45  IIKLLNFJKd)B7G$dGK NLs0CcnSSRUVs/sHoRPM sn5-S-$s snf)z utility method that replicates the previous behavior of lists of pitches. May be moved in v8 or later to a common.testing or test.X module. [r$])r(nameWithOctave)pitchLxs rr r s3 f=f,,f=> > DD=s2 cV[RRRS:Xagg)a6 return bool if we are running under Jupyter Notebook (not IPython terminal) or Google Colabatory (colab). Methods based on: https://stackoverflow.com/questions/15411967/how-can-i-check-if-code-is-executed-in-the-ipython-notebook (No tests provided here, since results will differ depending on environment) OutStreamTF)sysstderr __class__rHrr!rrrs" zz$$ 3r!v9v10zuse runningInNotebook() insteadc[5$)z3 DEPRECATED in v9: use runningInNotebook() instead )rrr!rrunningUnderIPythonres  r!r)ignoreAttributesc @Uc0nURS5nUSSupEnU"U6nXq[U5'UR5HYupX;a[XxS5 M[ U 5[ ;a[XxU 5 M9[Xx[ R"X55 M[ U$)a Unfortunately, it is not possible to do something like:: def __deepcopy__(self, memo): if self._noDeepcopy: return self.__class__() else: copy.deepcopy(self, memo, ignore__deepcopy__=True) Or, else: return NotImplemented so that's what this is for:: def __deepcopy__(self, memo): if self._noDeepcopy: return self.__class__() else: return common.defaultDeepcopy(self, memo) Does a deepcopy of the state returned by `__reduce_ex__` for protocol 4. * Changed in v9: callInit is removed, replaced with ignoreAttributes. uses `__reduce_ex__` internally. N) __reduce_ex__iditemssetattrtype_IMMUTABLE_DEEPCOPY_TYPEScopydeepcopy) objmemorfrvfuncargsstatenewattrvalues rrrs2 |  1 B2AD +CCM{{}   # Ct $ %[5 5 Cu % Ct}}U9 : % Jr!c2[R"SSU5$)a% Returns a copy of the given string where each occurrence of a flat note specified with a 'b' is replaced by a '-'. music_str is a string containing a note specified (for example in a chord) Returns a new string with flats only specified with '-'. >>> common.cleanedFlatNotation('Cb') 'C-' z ([A-Ga-g])bz\1-)resub) music_strs rrr,s 66- 33r!__main__)rzIterable[Iterable[_T]]returnzlist[_T])rrrzCallable | Nonerlist)rstr)rztuple[int, int, int])rPzIterable[t.Any]rz list[object])rboolr8)rrzt.Anyrfz Iterable[str])r~rrr)5__doc__ __future__rcollections.abcrrrpr4r2r|r_r&rKtypestypingtweakrefmusic21.common.decoratorsr__all__ TYPE_CHECKINGTypeVarrrr rr r r r rrernEllipsisNotImplementedr9floatrcomplexbytesrCodeTyperangeBuiltinFunctionType FunctionTyperefpropertyrorrrHmusic21mainTestrr!rrs&#.   0 ?? 4B B"<@$T]>*'(0E" D%:;<  JX^ 4guc NND% u11 KK )PR))X 4 z r!