3jddlmZgdZddlZddlmZddlZddlZddlZddl Z ejde ejzZ ddZddZdd Zdd Zdd Zddd Zedd  ddZedd  ddZe ddZe ddZdd  ddZGdde j*Zedk(rddlZej2eyy)) annotations)getRootFilePathgetSourceFilePathgetMetadataCacheFilePathgetCorpusFilePathgetCorpusContentDirs relativepath cleanpathN)overload StrOrPath)boundc tjtjtj }|j j }d|jDcgc]}|jc}vrtd||Scc}w)z Get the music21 directory that contains source files such as note.py, etc. This is not the same as the outermost package development directory. streamz(cannot find expected music21 directory: ) pathlibPathinspectgetfilerresolveparentiterdirnameFileNotFoundError)fpThis fpMusic21xs E/DATA/.local/lib/python3.12/site-packages/music21/common/pathTools.pyrr!s~ \\'//*;< = E E GF $$I (9(9(;<(;1(;<<6yk B    =s$B c"tdz dz S)z Get the stored music21 directory that contains the corpus metadata cache. >>> fp = common.getMetadataCacheFilePath() >>> fp.name == '_metadataCache' and fp.parent.name == 'corpus' True corpus_metadataCache)rrrr1s   ),< <>> fp = common.getCorpusFilePath() >>> fp.name == 'corpus' and fp.parent.name == 'music21' True r)rr)music21rcorpora CoreCorpusmanualCoreCorpusPathrrr)r coreCorpuss rrr<sH**,J&&. "X-- << 77 88r!ct}g}d}ttj|D]<}|j dr|j dr'||vr,|j |>t|S)a" Get all dirs that are found in the CoreCorpus that contain content; that is, exclude dirs that have code or other resources. >>> fp = common.getCorpusContentDirs() >>> fp # this list will be fragile, depending on composition of dirs ['airdsAirs', 'bach', 'beach', 'beethoven', 'chopin', 'ciconia', 'corelli', 'cpebach', 'demos', 'essenFolksong', 'handel', 'haydn', 'johnson_j_r', 'joplin', 'josquin', 'leadSheet', 'liliuokalani', 'luca', 'lusitano', 'miscFolk', 'monteverdi', 'mozart', 'nottingham-dataset', 'oneills1850', 'palestrina', 'ryansMammoth', 'schoenberg', 'schubert', 'schumann_clara', 'schumann_robert', 'theoryExercises', 'trecento', 'verdi', 'weber', 'webern'] Make sure that all corpus data has a directoryInformation tag in CoreCorpus. >>> cc = corpus.corpora.CoreCorpus() >>> failed = [] >>> di = [d.directoryName for d in cc.directoryInformation] >>> for f in fp: ... if f not in di: ... failed.append(f) >>> failed [] )z license.txtr __pycache__)z.pyz.pyc.)rsortedoslistdirendswith startswithappend) directoryNameresult excludedNamesfilenames rrrKsw:&'M FM 2::m45   _ -    %   &  h6 &>r!c2t}|j}|S)a Return the root directory for music21 -- outside the music21 namespace which has directories such as "dist", "documentation", "music21" >>> fp = common.getRootFilePath() >>> #_DOCS_SHOW fp PosixPath('/Users/florencePrice/git/music21') )rr)rfpParents rrr|s"#IH Or!cXddl}|dk(r|Stjj||S)a A cross-platform wrapper for `os.path.relpath()`, which returns `path` if under Windows, otherwise returns the relative path of `path`. This avoids problems under Windows when the current working directory is on a different drive letter from `path`. rNWindows)platformr,pathrelpath)r:startr9s rr r s)9 77??4 ''r!) returnPathlibcyNr r:r=s rr r r!cyr?r r@s rr r rAr!cyr?r r@s rr r rAr!cyr?r r@s rr r rAr!ct|tjrt|}|d}n|d}tj j |}tj j|}tj j|stj j|}tj j|}|s|Stj|S)a Normalizes the path by expanding ~user on Unix, ${var} environmental vars (is this a good idea?), expanding %name% on Windows, normalizing path names (Windows turns backslashes to forward slashes), and finally if that file is not an absolute path, turns it from a relative path to an absolute path. v5 -- returnPathlib -- None (default) does not convert. False, returns a string, True, returns a pathlib.Path. TF) isinstancerrstrr,r: expandusernormpathisabsabspath expandvarsr@s rr r s$ %4y   M   77  d #D 77  D !D 77== wwt$ 77  d #D  ||D!!r!ceZdZdZy)TestcXt}|j|tjyr?)rassertIsInstancerr)selffps rtestGetSourcePathzTest.testGetSourcePaths   b',,/r!N)__name__ __module__ __qualname__rSr r!rrNrNs0r!rN__main__)return pathlib.Path)rXz list[str]r?)r:r r<z str | NonerXzStrOrPath | str)r:rYr=t.Literal[None]rXrY)r:rGr=rZrXrG)r:str | pathlib.Pathr=zt.Literal[True]rXrY)r:r[r=zt.Literal[False]rXrG)r:r[r=z bool | NonerXr[) __future__r__all__typingtr rr,runittestTypeVarrGrr rrrrrr r TestCaserNrTr#mainTestr r!rrdsC#   AIIkW\\)9 :   = 9.b  ( /3,8D  /3,8;  ,1=  -25  *."&"2B":08  0  zGTr!