j dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl mZgdZejdZdd ZdddZejejdZdZdZdZedkrddlZejdSdS)z Tools for working with files ) annotationsN)Music21Exception)readFileEncodingSafereadPickleGzipcdpreparePathClassesForUnpickling!restorePathClassesAfterUnpicklingrunSubprocessCapturingStderrc#Ktj} tj|dVtj|dS#tj|wxYw)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 /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/common/fileTools.pyrr&sT )++C     s AAfilePathstr | pathlib.Pathreturnt.Anycnttj|d5} |}t j|}n@#t $r3}ttdt|z|d}~wwxYw dddn #1swxYwYt|S)zf Read a gzip-compressed pickle file, uncompress it, unpickle it, and return the contents. rbzCannot load file N) rgzipopenreadpickleloads Exceptionr rstr)r pickledFile uncompressednewMdbes rrr9s $%%% 8T " " Ok O&++--L\,//FF O O O . / / /"#6X#FGGQ N  O  O O O O O O O O O O O O O O O&''' Ms4B(AB B .BB  BB #B utf-8rc tj|d|5}|}|cdddS#1swxYwYdS#t$r}ddl}tj|d5}|}||dpd}t j||cdddcYS#1swxYwYYdSwxYw)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 rrrMssL 7 WXsZ 8 8 8 H==??D                   777 WXt $ $ 7',,..J~~j11*=HH=X66 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 77sVA < A AA AA #C,AC2 CC CC CC) posixPath windowsPathcddlm}|}|dkrtjt_dStjt_dS)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.miscr7pathlib WindowsPath PosixPathr7platforms rrrsN 0/////{}}H5#/%/cddlm}|}|dkrtdt_dStdt_dS)z0 After unpickling, leave pathlib alone. rr6r8r3r4N)r9r7_storedPathlibClassesr:r<r;r=s rr r sR0/////{}}H51+>3MBr?c"tj|dd}|jdkrl|j} ddl}||d}n'#t$r|dd }YnwxYwt|dS) 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_bytesrL stderr_strs rr r s #'8UZ[[[#q(()/  G MMM%,,V-H-HV[-H-\-\]]JJ! G G G%,,WX,FFJJJ Gj!!!)(s-A!A=<A=__main__)rrrr)r#)rr)__doc__ __future__rr, contextlibrr(r:rr rHtypingtmusic21.exceptions21r__all__contextmanagerrrrr<r;rArr r __name__music21mainTestr?rr`sh#"""""   111111    $(/7/7/7/7/7f'.&7H[\\ 0 0 0 C C C"""( zNNNGr?