3j dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl mZgdZej dZddZdddZej(ej*d Zd Zd Zd Zed k(rddlZej8yy)z Tools for working with files ) annotationsN)Music21Exception)readFileEncodingSafereadPickleGzipcdpreparePathClassesForUnpickling!restorePathClassesAfterUnpicklingrunSubprocessCapturingStderrc#Ktj} tj|dtj|y#tj|wxYww)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 E/DATA/.local/lib/python3.12/site-packages/music21/common/fileTools.pyrr&s= ))+C     sA!AA!AA!c8ttj|d5} |j}t j |} dddtS#t $r'}ttdt|z|d}~wwxYw#1swYHxYw)zf Read a gzip-compressed pickle file, uncompress it, unpickle it, and return the contents. rbzCannot load file N) rgzipopenreadpickleloads Exceptionr rstr)filePath pickledFile uncompressednewMdbes rrr9s $% 8T "k O&++-L\\,/F #&' M O . /"#6X#FGQ N  O # "s(B%A B &"BB  BBc tj|d|5}|j}|cdddS#1swYyxYw#t$rrddl}tj|d5}|j}|j |dxsd}t j||cdddcYS#1swYYyxYwwxYw)ao Slow, but will read a file of unknown encoding as safely as possible using the chardet package. Mostly obsolete in the utf-8 world of today, but useful for older code Let's try to load the `music21.common.__init__.py` file as ascii -- it has a copyright symbol near the top, so it won't load in Python3: >>> import os >>> c = str(common.getSourceFilePath() / 'common' / '__init__.py') >>> f = open(c, encoding='ascii') >>> 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 Windows or unknown encoding. This will load it as safely as possible. >>> data = common.readFileEncodingSafe(c) >>> data[83:106] 'Name: common.py' 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[83:106] 'Name: common.py' It worked! Note that trying lots of encodings is slow enough when the first guess is wrong that the firstGuess should be set to something reasonable like 'utf-8' or 'ascii'. r)encodingNrrr"ascii)iorrUnicodeDecodeErrorchardetdetectcodecsdecode)r firstGuessthisFiledatar&thisFileBinary dataBinaryr"s rrrMsL 7 WWXsZ 8H==?D9 8 8 7 WWXt $',,.J~~j1*=HH==X6% $ $7s@A6 A?AA#B=%>B/# B=/B9 4B=9B=) posixPath windowsPathcddlm}|}|dk(rtjt_ytjt_y)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#//%//crddlm}|}|dk(rtdt_ytdt_y)z0 After unpickling, leave pathlib alone. rr2r4r/r0N)r5r3_storedPathlibClassesr6r8r7r9s rr r s00}H51+>3MBr;c$tj|dd}|jdk7r=|j} ddl}|j |j d}t|y#t$r |j dd }Yt|wxYw) zk 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,FJj!! Gs%A&&BB__main__)rzstr | pathlib.Pathreturnzt.Any)zutf-8)rPr)__doc__ __future__rr( contextlibrr$r6rr rDtypingtmusic21.exceptions21r__all__contextmanagerrrrr8r7r=rr r __name__music21mainTestr;rr]s#   1  $(/7f'.&7&7H[H[\ 0 C"( zGr;