j&dZddlmZddlmZmZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZgdZddlmZejrejdZd+d Zdd d,dZdZd-dZd.dZd/dZdZed0dZd0dZd0d Z e!de!e"e!e#e$e%e&e'e(e)e j*e!e+e j,e j-ej.e/hZ0d1d!d"d2d'Z1d3d)Z2e3d*krddl4Z4e4j5dSdS)4zO 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_T originalListIterable[Iterable[_T]]returnlist[_T]cd|DS)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]] cg|] }|D]}| Sr).0sublistitems /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/common/misc.py zflattenList..?s% A A AW A AD A A A Ar)rs rrr1s B A A A AAr)keyrrCallable | Nonelistct}g}|D]A}|r ||}n|}||vr||||B|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 rrrBsn2 55D C  CGGEEE D==   2 Jrc|sdSt|dkr |d}tjd|dSd|}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  ]t [  Q   N [^_ [ [ [\\ \ IIk " " \q \ \ \]] ]rstrctjdkrdStjdkrdStjdkrdStjS)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)platformsystemosnamerrrr r sMI%%u   h & &x G  uwrtuple[int, int, int]ctdkrdStdtjddD^}}|r|dnd}t |dkr|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) r8)rrrc34K|]}t|VdSN)int)rvs r zmacOSVersion..s()[)[Q#a&&)[)[)[)[)[)[rr.r+)r tupler;mac_versplitr-)majorminor_and_maintenanceminor maintenances rr r s}}  y%*)[)[(:J:L:LQ:O:U:UVY:Z:Z)[)[)[$[$[!E !(= D !! $ $1E.12G.H.H1.L.L'**RSK 5+ &&r moduleListIterable[t.Any] list[object]cfg}i|D]r}||j<|j}tj|}t j|d}t j|}||||jfs|| fd|D}|S)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 c(g|]\}}}|Srr)rlastmodasctimemodName modNameToMods rrzsortModules..s%KKK)B'7|G$KKKr) __name____file__r=stattime localtimerUr%sortreverse) rNr]modfprZrTrUoutModsrWs @rrrs DL66%( S\" \wr{{.a)),w'' Wgs|45555IIKKKLLNNNKKKKdKKKG NrcLddd|DzdzS)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,cg|] }|j Sr)nameWithOctave)rxs rrzpitchList..s===A,===r])r0)pitchLs rr r s/ ==f===>> > DDrboolcFtrdStrdSdS)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)runningInJupyterOrColabrunningInMarimorrrr r s/  t   turc6tjjjdkS)N OutStream)sysstderr __class__rXrrrrkrks :  (K 77rcddtjvrdStdS)NmarimoF)romodules __import__running_in_notebookrrrrlrls.s{""u h   3 3 5 55rr)ignoreAttributesobjt.Anyrw Iterable[str]c z|i}|d}|dd\}}}||}||t|<|D]g\}} ||vrt||dt | t vrt||| Ct||t j| |h|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) rxmemorwrvfuncargsstatenewattrvalues rrrs2 |  1  B2A2D$ $+CDCM{{}};; e # # # Ct $ $ $ $ %[[5 5 5 Cu % % % % Ct}UD99 : : : : Jr music_strc.tjdd|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)rs rrr-s 6- 3 33r__main__)rrrr)rrrr rr!)rr3)rr?)rNrOrrP)rrirB)rxryrwrz)rr3rr3)6__doc__ __future__rcollections.abcrrrr=r;rror.r[typestypingtweakref__all__ functoolsr TYPE_CHECKINGTypeVarrrrr r r rr r rkrlrEllipsisNotImplementedrCfloatricomplexbytesr3CodeTyperangeBuiltinFunctionType FunctionTyperefpropertyrrrrXmusic21mainTestrrrrs~#"""""........      ? 4B BBBB"<@$$$$$$T]]]<*''''(0EEE"88886666  DJJX^ 4 4guc ND% u1 K )PR))))))X 4 4 4 4 zNNNGr