code: def example(key: str, *, hq: bool = False) -> str:
      """Retrieve 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
      """
      if key not in __TRACKMAP:
          raise ParameterError(f"Unknown example key: {key}")
  
      if hq:
          ext = ".hq.ogg"
      else:
          ext = ".ogg"
  
      return str(__GOODBOY.fetch(__TRACKMAP[key]["path"] + ext))
  
file_path: librosa/librosa/util/files.py
imports: from __future__ import annotations
  from typing import List, Optional, Union, Any, Set
  import os
  import glob
  import json
  from importlib import resources
  from pathlib import Path
  import pooch
  from .exceptions import ParameterError
label_desc: Use image node_id 1 for calling a global function with example usage: example(key) and returns: str