docs: def clean(path: str) -> str:
      """
      Cleans the specified path by expanding shorthand elements, redirecting to
      the real path for symbolic links, and removing any relative components to
      return a complete, absolute path to the specified location.
  
      :param path:
          The source path to be cleaned
      """
  
      if not path or path == '.':
          path = os.curdir
  
      if path.startswith('~'):
          path = os.path.expanduser(path)
  
      return os.path.realpath(os.path.abspath(path))