}Kg"dZddlmZddlmZmZmZmZmZddl Z ddl Z ddl Z ddl Z ddl mZddlmZddlZddlmZd d lmZgd Ze j.j1d ej2d Zej6eddZej:dd5Zej?e edejBd<dddej:dd5Z"e"jGd5Z$e jJe$Z&ddddddddddZ'e'Z( d dZ)d!dZ*dddddd d"dZ+d#dZ,d$d%dZ-y#1swYxYw#1swYQxYw#1swYUxYw)&z(Utility functions for dealing with files) annotations)ListOptionalUnionAnySetN) resources)Path)ParameterError)version) find_filesexampleex list_examples example_infoLIBROSA_DATA_DIRlibrosazhttps://librosa.org/data/audio/)base_urlregistryzlibrosa.util.example_dataz registry.txtversion_index.msgpackz index.jsonrF)hqc|tvrtd||rd}nd}ttj t|d|zS)aQRetrieve the example recording identified by 'key'. The first time an example is requested, it will be downloaded from the remote repository over HTTPS. All subsequent requests will use a locally cached copy of the recording. For a list of examples (and their keys), see `librosa.util.list_examples`. By default, local files will be cached in the directory given by `pooch.os_cache('librosa')`. You can override this by setting an environment variable ``LIBROSA_DATA_DIR`` prior to importing librosa: >>> import os >>> os.environ['LIBROSA_DATA_DIR'] = '/path/to/store/data' >>> import librosa Parameters ---------- key : str The identifier for the track to load hq : bool If ``True``, return the high-quality version of the recording. If ``False``, return the 22KHz mono version of the recording. Returns ------- path : str The path to the requested example file Examples -------- Load "Hungarian Dance #5" by Johannes Brahms >>> y, sr = librosa.load(librosa.example('brahms')) Load "Vibe Ace" by Kevin MacLeod (the example previously packaged with librosa) in high-quality mode >>> y, sr = librosa.load(librosa.example('vibeace', hq=True)) See Also -------- librosa.util.list_examples pooch.os_cache Unknown example key: z.hq.oggz.oggpath) __TRACKMAPr str __GOODBOYfetch)keyrexts V/home/alanp/www/video.onchill/myenv/lib/python3.12/site-packages/librosa/util/files.pyrr-sO\ *4SE:;;  yz#v6<= >>ctdtdttjD]#}|dk(r t|ddt|d%y)a=List the available audio recordings included with librosa. Each recording is given a unique identifier (e.g., "brahms" or "nutcracker"), listed in the first column of the output. A brief description is provided in the second column. See Also -------- util.example util.example_info zAVAILABLE EXAMPLESD--------------------------------------------------------------------pibble10 descN)printsortedrkeys)r"s r$rrjsS  (Ojoo'( (?  R:c?62345 )r%c*|tvrtd|tjt|ddz}t |d5}t |ddt|ddt d |D] }t | d d d y #1swYy xYw) aDisplay licensing and metadata information for the given example recording. The first time an example is requested, it will be downloaded from the remote repository over HTTPS. All subsequent requests will use a locally cached copy of the recording. For a list of examples (and their keys), see `librosa.util.list_examples`. By default, local files will be cached in the directory given by `pooch.os_cache('librosa')`. You can override this by setting an environment variable ``LIBROSA_DATA_DIR`` prior to importing librosa. Parameters ---------- key : str The identifier for the recording (see `list_examples`) See Also -------- librosa.util.example librosa.util.list_examples pooch.os_cache rrz.txtr10sr*r+sr'N)rr r r!openr,)r" license_filefdesclines r$rrs0 *4SE:;;??:c?6#:V#CDL lC E S JsOF3A678 hD $K ! s :B  BT)r#recursecase_sensitivelimitoffsetc|gd}nt|tr|g}t|}|s>|Dchc]}|j}}||Dchc]}|j c}z}t}|r-t j |D]}|t|d|z}n t||}t|} | j| |d} || d|} | Scc}wcc}w)a@Get a sorted list of (audio) files in a directory or directory sub-tree. Examples -------- >>> # Get all audio files in a directory sub-tree >>> files = librosa.util.find_files('~/Music') >>> # Look only within a specific directory, not the sub-tree >>> files = librosa.util.find_files('~/Music', recurse=False) >>> # Only look for mp3 files >>> files = librosa.util.find_files('~/Music', ext='mp3') >>> # Or just mp3 and ogg >>> files = librosa.util.find_files('~/Music', ext=['mp3', 'ogg']) >>> # Only get the first 10 files >>> files = librosa.util.find_files('~/Music', limit=10) >>> # Or last 10 files >>> files = librosa.util.find_files('~/Music', offset=-10) >>> # Avoid including search patterns in the path string >>> import glob >>> directory = '~/[202206] Music' >>> directory = glob.escape(directory) # Escape the special characters >>> files = librosa.util.find_files(directory) Parameters ---------- directory : str Path to look for files ext : str or list of str A file extension or list of file extensions to include in the search. Default: ``['aac', 'au', 'flac', 'm4a', 'mp3', 'ogg', 'wav']`` recurse : boolean If ``True``, then all subfolders of ``directory`` will be searched. Otherwise, only ``directory`` will be searched. case_sensitive : boolean If ``False``, files matching upper-case version of extensions will be included. limit : int > 0 or None Return at most ``limit`` files. If ``None``, all files are returned. offset : int Return files starting at ``offset`` within the list. Use negative values to offset from the end of the list. Returns ------- files : list of str The list of audio files. N)aacauflacm4amp3oggwavr) isinstancersetlowerupperoswalk __get_fileslistsort) directoryr#r6r7r8r9efilesetrGfiless r$rrsJ {? C e c(C "%&#Qqwwy#& 3'3a 3''eGGGI&D {47C0 0G'i- ME JJL &'NE fu  L%''s C Cc^tjjtjj|}t }|D]a}tjj |dtjj z|z}|t tj|z}c|S)z)Get a list of files in a single directory*)rFrabspath expanduserrCjoinextsepglob)dir_name extensionsmyfilessub_extglobstrs r$rHrH s{wwrww11(;>> librosa.cite("0.10.1") "https://doi.org/10.5281/zenodo.8252662" NrrbdevzVersion zC is not yet released and therefore does not yet have a citable DOI.z not found in the citation indexzhttps://doi.org/)librosa_versionr r!r2msgpackloadr )r version_datar4 version_indexs r$citercs.!??#:;L lD !U U+  "m# G  8G94w!xy y 8G94T!UV V mG45 66 " !s A66A?)r"rrboolreturnr)reNone)r"rrerf)rKUnion[str, os.PathLike[Any]]r#zOptional[Union[str, List[str]]]r6rdr7rdr8z Optional[int]r9intrez List[str])rVrgrWzSet[str])N)rz Optional[str]rer).__doc__ __future__rtypingrrrrrrFrUjsonr_ importlibr pathlibr pooch exceptionsr rr^__all__environgetos_cache __data_pathcreater rreg load_registryrrindexr2_fdescr`rrrrrrrHrcr%r$r|s/"22  &0 jjnn/ 1JK ELL;d  Y^^/@C CH%26I./A Y^^/>% CFTYYv&  ? %*6?r 6,!N,0 c+c )c c  c  c ccL $7kA@ ?>s0'EE/EEEE EE'