rhX(SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK Jr /SQr\R S5rSSjrSSSjjr\R(\R*S .rS rS rS r\S :XaSSKr\R8"5 gg)z Tools for working with files ) annotationsN)Music21Exception)readFileEncodingSafereadPickleGzipcdpreparePathClassesForUnpickling!restorePathClassesAfterUnpicklingrunSubprocessCapturingStderrc## [R"5n[R"U5 Sv [R"U5 g![R"U5 f=f7f)z Useful for a temporary cd for use in a `with` statement: with cd('/Library/'): os.system(make) will switch temporarily, and then switch back when leaving. N)osgetcwdchdir) targetDircwds R/home/james-whalen/.local/lib/python3.13/site-packages/music21/common/fileTools.pyrr's< ))+C     sA%A A% A""A%cH[5 [R"US5nUR5n[R "U5nSSS5 [5 W$![ a'n[5 [S[U5-5UeSnAff=f!,(df  NN=f)zZ Read a gzip-compressed pickle file, uncompress it, unpickle it, and return the contents. rbzCannot load file N) rgzipopenreadpickleloads Exceptionr rstr)filePath pickledFile uncompressednewMdbes rrr:s $% 8T "k O&++-L\\,/F #&' M O . /"#6X#FGQ N  O # "s(B&A B)"B  BB B!c[R"USUS9nUR5nUsSSS5 $!,(df  g=f![a} SSKn[R"US5nUR5nUR U5S=(d Sn[ R"Xg5sSSS5 s$!,(df  g=ff=f)ax Slow, but will read a file of unknown encoding as safely as possible using the chardet package. Let's try to load this file as ascii -- it has a copyright symbol at the top, so it won't load in Python3: >>> import os >>> c = str(common.getSourceFilePath() / 'common' / '__init__.py') >>> #_DOCS_SHOW f = open(c) >>> #_DOCS_SHOW data = f.read() Traceback (most recent call last): UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position ...: ordinal not in range(128) That won't do! now I know that it is in utf-8, but maybe you don't. Or it could be an old humdrum or Noteworthy file with unknown encoding. This will load it safely. >>> data = common.readFileEncodingSafe(c) >>> data[0:30] '# -*- coding: utf-8 -*-\n# ----' Well, that's nothing, since the first guess here is utf-8, and it's right. So let's give a worse first guess: >>> data = common.readFileEncodingSafe(c, firstGuess='SHIFT_JIS') # old Japanese standard >>> data[0:30] '# -*- coding: utf-8 -*-\n# ----' It worked! Note that this is slow enough if it gets it wrong that the firstGuess should be set to something reasonable like 'ascii' or 'utf-8'. r)encodingNrrr"ascii)iorrUnicodeDecodeErrorchardetdetectcodecsdecode)r firstGuessthisFiledatar&thisFileBinary dataBinaryr"s rrrNsH 7 WWXsZ 8H==?D9 8 8 7 WWXt $',,.J~~j1*=HH==6% $ $ $7sCA4 A AAA%C *AB9- C 9 C C C ) posixPath windowsPathcSSKJn U"5nUS:Xa[R[lg[R[lg)z When we need to unpickle a function that might have relative paths (like some music21 stream options), Windows chokes if the PosixPath is not defined, but usually can still unpickle easily. r getPlatformwinN)music21.common.miscr3pathlib WindowsPath PosixPathr3platforms rrrs2 0}H5#//%//ctSSKJn U"5nUS:Xa[S[lg[S[lg)z( After unpickling, leave pathlib alone. rr2r4r/r0N)r5r3_storedPathlibClassesr6r8r7r9s rr r s00}H51+>3MBr;c[R"USSS9nURS:wa:URnSSKnUR UR SS95n[U5eg![a UR SSS 9nN(f=f) z_ Run a subprocess command, capturing stderr and only show the error if an exception is raised. TF)capture_outputcheckrN) do_setlocaler#ignore)errors) subprocessrun returncodestderrlocaler)getpreferredencodingr%IOError)subprocessCommandcompleted_process stderr_bytesrH stderr_strs rr r s #'8UZ[##q()//  G %,,V-H-HV[-H-\]Jj!!)" G%,,WX,FJ Gs"A""A?>A?__main__)rzstr | pathlib.Pathreturnzt.Any)zutf-8)rPr)__doc__ __future__rr( contextlibrr$r6rr rDtypingtmusic21.exceptions21r__all__contextmanagerrrrr8r7r=rr r __name__music21mainTestr;rr]s#   1  $(-7b'.&7&7H[H[\ 0 C"( z r;