Audeer

--------------------------

* Added: support for Python 3.13
* Added: support for ``tar``,
``tar.bz2``,
``tar.xz``
archives in
``audeer.create_archive()``,
``audeer.extract_archive()``,
and ``audeer.extract_archives()``
* Fixed: avoid deprecation warnings
in Python>=3.12
by using the ``"tar"`` filter
when extracting tar archives
* Removed: support for Python 3.8

--------------------------

* Added: ``audeer.script_dir()``
which returns the directory
of the file where it was called,
or the current working directory
when called in an interactive session

--------------------------

* Fixed: make estimation of remaining time
in ``audeer.progress_bar()``
less erratic

--------------------------

* Added: ``audeer.unique()``,
which returns unique values
in the order they appear in a sequence
* Added: ``maximum_refresh_time`` argument
to ``audeer.progress_bar()``
and ``audeer.run_tasks()``,
which can be used
to force an update interval
of the progress bar
* Fixed: documentation of return value
of ``audeer.run_tasks()``

--------------------------

* Added: ``follow_symlink`` keyword argument
to ``audeer.path()``
with default value ``False``
* Added: ``follow_symlink`` keyword argument
to ``audeer.rmdir()``
with default value ``True``
* Changed: ``audeer.path()`` does no longer
uses ``os.path.realpath()``,
but ``os.path.abspath()``.
This means it does no longer convert symlinks
to the real path,
but returns the path to the symlink.
This provides a speed up of ``audeer.path()``
up to 6x
as it no longer requires a disk operation.
The old behavior of ``audeer.path()``
can be achieved by calling
``audeer.path(..., follow_symlink=True)``.
The output of the following functions
is also affected by this change
if a symlink is part of their input path:
``audeer.common_directory()``,
``audeer.download_url()``,
``audeer.list_dir_names()``,
``audeer.list_file_names()``,
``audeer.mkdir()``,
``audeer.touch()``
* Changed: the ``files`` argument of ``audeer.create_archive()``
can no longer include symbolic links
that are located outside of ``root``
* Fixed: ``audeer.basename_wo_ext()``,
``audeer.file_extension()``,
and ``audeer.replace_file_extension()``
are no longer affected by existing files and symlinks,
but rely only on the provided input string

---------------------------

* Added: ``audeer.move()``
which can move files and folders
and should be used instead of ``audeer.move_file()``
* Added: ``*paths`` argument to
``audeer.mkdir()``,
``audeer.rmdir()``,
and ``audeer.touch()``.
Instead of writing ``audeer.mkdir(os.path.join("a", "b"))``,
you can now write ``audeer.mkdir("a", "b")``