3j&dZddlmZddlmZmZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZgdZddlmZej(rej*dZddZdd dd Zd Zdd Zdd ZddZdZeddZddZddZ e!de!e"e!e#e$e%e&e'e(e)e jTe!e+e jXe jZej\e/hZ0dddddZ1d dZ2e3dk(rddl4Z4e4jjyy)!zO If it doesn't fit anywhere else in the common directory, you'll find it here! ) annotations)CallableIterableN) cleanedFlatNotationdefaultDeepcopy flattenListgetMissingImportStr getPlatform macOSVersion pitchListrunningInNotebook sortModulesunique)cache_Tc@|Dcgc] }|D]}| c}}Scc}}w)a" 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 @/DATA/.local/lib/python3.12/site-packages/music21/common/misc.pyrr1s$!- A WDD AA As)keyct}g}|D]6}|r ||}n|}||vr|j||j|8|S)a 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 rrrBsR2 5D C GEE D=   2 Jc|syt|dk(r|d}tjd|dSdj|}tjd|dS) 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 rr r ls  [ Q  N#]^_]`aX [\ \ IIk "NqcRY \] ]r!ctjdk(rytjdk(rytjdk(rytjS)aH 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!ctdk7rytdtjdj dD^}}|r|dnd}t |dkDr|dnd}|||fS)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/)rrrc32K|]}t|ywN)int).0vs r zmacOSVersion..s)[:ZQ#a&:Zsr.r#)r tupler2mac_versplitr%)majorminor_and_maintenanceminor maintenances rr r sz} %*)[(:J:J:LQ:O:U:UVY:Z)[$[!E !(= !! $1E.12G.H1.L'*RSK 5+ &&r!cg}i}|D]}}|||j<|j}tj|}t j |d}t j |}|j|||jf|j|j|Dcgc] \}}}|| } }}}| Scc}}}w)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) moduleListrM modNameToModmodfprIlastmodrLmodNameoutModss rrrs DL%( S\\" \\wwr{..a),,w' Wgs||45  IIKLLNFJKd)B'7|G$dGK NLs-Ccjddj|Dcgc]}|jc}zdzScc}w)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 s5 f=fA,,f=> > DD=s0 c0trytryy)aW return bool if we are running under Jupyter Notebook (not IPython terminal) or Google Colabatory (colab) or Marimo. 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) TF)runningInJupyterOrColabrunningInMarimorr!rr r s   r!cPtjjjdk(S)N OutStream)sysstderr __class__rGrr!rr]r]s ::   ( (K 77r!cZdtjvrytdjS)NmarimoF)ramodules __import__running_in_notebookrr!rr^r^s%s{{" h  3 3 55r!r)ignoreAttributesc <|i}|jd}|dd\}}}||}||t|<|jD]W\}} ||vrt||dt | t vrt||| 7t||t j| |Y|S)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) objmemorirvfuncargsstatenewattrvalues rrrs2 |  1 B2AD$ +CDCM{{} e # # Ct $ %[5 5 Cu % Ct}}UD9 : % Jr!c0tjdd|S)aA 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])rOzIterable[t.Any]rz list[object])rboolr8)ruzt.Anyriz Iterable[str])rrrr)6__doc__ __future__rcollections.abcrrrsr4r2rrar&rJtypestypingtweakref__all__ functoolsr TYPE_CHECKINGTypeVarrrrr r r rr r r]r^rqEllipsisNotImplementedr9floatrcomplexbytesrCodeTyperangeBuiltinFunctionType FunctionTyperefpropertyrrrrrGmusic21mainTestrr!rrs #.    ?? 4B B"<@$T]<*'(0E"86  JX^ 4guc NND% u11 KK )PR)X 4 zGr!