parameters: (filename, extract_dir, progress_filter=default_filter,
      drivers=None
  )
docstring: Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat``
  
      `progress_filter` is a function taking two arguments: a source path
      internal to the archive ('/'-separated), and a filesystem path where it
      will be extracted.  The callback must return the desired extract path
      (which may be the same as the one passed in), or else ``None`` to skip
      that file or directory.  The callback can thus be used to report on the
      progress of the extraction, as well as to filter the items extracted or
      alter their extraction paths.
  
      `drivers`, if supplied, must be a non-empty sequence of functions with the
      same signature as this function (minus the `drivers` argument), that raise
      ``UnrecognizedFormat`` if they do not support extracting the designated
      archive type.  The `drivers` are tried in sequence until one is found that
      does not raise an error, or until all are exhausted (in which case
      ``UnrecognizedFormat`` is raised).  If you do not supply a sequence of
      drivers, the module's ``extraction_drivers`` constant will be used, which
      means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that
      order.
docstring_summary: Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat``
docstring_tokens: Unpack filename to extract_dir or raise UnrecognizedFormat
function: def unpack_archive(filename, extract_dir, progress_filter=default_filter,
      drivers=None
  ):
      """Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat``
  
      `progress_filter` is a function taking two arguments: a source path
      internal to the archive ('/'-separated), and a filesystem path where it
      will be extracted.  The callback must return the desired extract path
      (which may be the same as the one passed in), or else ``None`` to skip
      that file or directory.  The callback can thus be used to report on the
      progress of the extraction, as well as to filter the items extracted or
      alter their extraction paths.
  
      `drivers`, if supplied, must be a non-empty sequence of functions with the
      same signature as this function (minus the `drivers` argument), that raise
      ``UnrecognizedFormat`` if they do not support extracting the designated
      archive type.  The `drivers` are tried in sequence until one is found that
      does not raise an error, or until all are exhausted (in which case
      ``UnrecognizedFormat`` is raised).  If you do not supply a sequence of
      drivers, the module's ``extraction_drivers`` constant will be used, which
      means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that
      order.
      """
      for driver in drivers or extraction_drivers:
          try:
              driver(filename, extract_dir, progress_filter)
          except UnrecognizedFormat:
              continue
          else:
              return
      else:
          raise UnrecognizedFormat(
              "Not a recognized archive type: %s" % filename
          )
function_tokens: def unpack_archive ( filename , extract_dir , progress_filter = default_filter , drivers = None ) : for driver in drivers or extraction_drivers : try : driver ( filename , extract_dir , progress_filter ) except UnrecognizedFormat : continue else : return else : raise UnrecognizedFormat ( "Not a recognized archive type: %s" % filename )