rhSSKJr /SQrSSKrSSKJr SSKrSSKrSSKrSSK r \R"S\ \R-S9r SSjrSSjrSS jrSS jrSS jrSSS jjr\SS .SSjj5r\SS .SSjj5r\SSj5r\SSj5rSS .SSjjr"SS\ R*5r\S:XaSSKr\R2"\5 gg)) annotations)getRootFilePathgetSourceFilePathgetMetadataCacheFilePathgetCorpusFilePathgetCorpusContentDirs relativepath cleanpathN)overload StrOrPath)boundc,[R"[R"[55R 5nUR R nSUR5Vs/sHo"RPM sn;a[SU35eU$s snf)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 R/home/james-whalen/.local/lib/python3.13/site-packages/music21/common/pathTools.pyrr"s| \\'//*;< = E E GF $$I (9(9(;<(;1(;<<6yk B    =s&Bc"[5S- 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)rrrr2s   ),< <>> fp = common.getCorpusFilePath() >>> fp.name == 'corpus' and fp.parent.name == 'music21' True r)rr)music21rcorpora CoreCorpusmanualCoreCorpusPathrrr)r coreCorpuss rrr=sH**,J&&. "X-- << 77 88r!c[5n/nSn[[R"U55HKnUR S5(aMUR S5(aM3X2;aM:UR U5 MM [U5$)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 rrrLs{:&'M FM 2::m45   _ - -    % %   &  h6 &>r!c2[5nURnU$)z 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!cXSSKnUS:XaU$[RRX5$)z 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!) returnPathlibcgNr r:r=s rr r r!cgr?r r@s rr r rAr!cgr?r r@s rr r rAr!cgr?r r@s rr r rAr!c[U[R5(a[U5nUcSnOUcSn[R R U5n[R RU5n[R RU5(d[R RU5n[R RU5nU(dU$[R"U5$)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!c\rSrSrSrSrg)TestcX[5nURU[R5 gr?)rassertIsInstancerr)selffps rtestGetSourcePathTest.testGetSourcePaths   b',,/r!r N)__name__ __module__ __qualname____firstlineno__rT__static_attributes__r r!rrNrNs0r!rN__main__)return pathlib.Path)r\z list[str]r?)r:r r<z str | Noner\zStrOrPath | str)r:r]r=t.Literal[None]r\r])r:rGr=r^r\rG)r:str | pathlib.Pathr=zt.Literal[True]r\r])r:r_r=zt.Literal[False]r\rG)r:r_r=z bool | Noner\r_) __future__r__all__typingtr rr,runittestTypeVarrGrr rrrrrr r TestCaserNrVr#mainTestr r!rrhs?#   IIkW\\)9 :   = 9.b  ( /3,8D  /3,8;  ,1=  -25  *."&"2B":08  0  z Tr!