Audbackend

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

* Added: support for Python 3.11
* Fixed: ensure execution time of
``audbackend.interface.Maven.ls()``
is independent of repository size
on all backends

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

* Added: ``audbackend.interface`` sub-module
including an backend interface base class
``audbackend.interface.Base``,
and the three interfaces
``audbackend.interface.Maven``,
``audbackend.interface.Unversioned``,
``audbackend.interface.Versioned``
* Added: ``audbackend.backend`` sub-module
including the backend base class
``audbackend.backend.Base``,
and the two backends
``audbackend.backend.Artifactory``,
``audbackend.backend.FileSystem``
* Added: ``audbackend.backend.*.copy_file()``
and ``audbackend.interface.*.copy_file()``
methods
to copy a file on the backend
* Added: ``audbackend.backend.*.move_file()``
and ``audbackend.interface.*.move_file()``
methods
to move a file on the backend
* Added: ``validate=False`` argument to the
``copy_file()``,
``get_archive()``,
``get_file()``,
``move_file()``,
``put_archive()``,
``put_file()``
methods in ``audbackend.backend.*``
and ``audbackend.interface.*``.
If ``True``
the checksum of the resulting file is checked
* Added: ``audbackend.backend.*.create()``
and ``audbackend.backend.*.delete()``
class methods
to create or delete a repository
on a backend
* Added: ``audbackend.backend.*.open()``
and ``audbackend.backend.*.close()``
methods
to connect to a backend,
or disconnect from a backend
* Added: ``audbackend.backend.Artifactory.get_authentication()``
to get the current Artifactory username, password
from the configuration file/environment variable
* Added: ``authentication`` argument
to ``audbackend.backend.Artifactory``
and ``audbackend.backend.Base``
* Added: ``audbackend.backend.Artifactory.path()``
returning an ``artifactory.ArtifactoryPath`` object
* Added: ``audbackend.backend.Artifactory.authentication``
attribute,
holding the current authentication object,
e.g. user, password tuple
* Fixed: all backend methods now raise a ``ValueError``,
if a backend path ends on ``"/"``
with the exception of ``ls()``,
``split()``
and ``join()``,
as those methods support sub-paths as argument
* Deprecated: ``audbackend.create()``,
use ``audbackend.backend.*.create()`` instead
* Deprecated: ``audbackend.delete()``,
use ``audbackend.backend.*.delete()`` instead
* Deprecated: ``audbackend.register()``,
as we no longer use alias names
for backends
* Deprecated: ``audbackend.access()``,
instantiate and open a backend instead
* Deprecated: ``audbackend.Repository``,
as we no longer use alias names
for backends
* Removed: ``audbackend.Artifactory``
and ``audbackend.FileSystem``,
use
``audbackend.backend.Artifactory``
and ``audbackend.backend.FileSystem``
instead
* Removed: ``audbackend.available()``

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

* Added: support for accessing
remote and virtual repositories
on Artifactory
* Fixed: match the ``pattern`` argument
of ``audbackend.Backend.ls()``
to file basenames
* Fixed: typo in raises section
of the docstring
of ``audbackend.exists()``

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

* Added: ``regex`` argument
to ``audbackend.Backend._use_legacy_file_structure()``
to support providing regex pattern
in the ``extensions`` argument
* Changed: depend on ``dohq-artifactory>=0.9.0``

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

* Added:
``audbackend.Backend.access()``,
``audbackend.Backend.available()``,
``audbackend.Backend.date()``,
``audbackend.Backend.delete()``,
``audbackend.Backend.owner()``
* Added:
``audbackend.FileSystem._use_legacy_file_structure()``
to support file structure of existing repositories
* Added: ``audbackend.BackendError`` class to capture errors raised by backend
* Added: ``pattern`` argument to ``audbackend.Backend.ls()``
* Added: docstring examples and usage section
* Changed: ``audbackend.create()`` raises error if repository exists
(``audbackend.access()`` should be used instead)
* Changed: ``audbackend.Backend.get_archive()``
and ``audbackend.Backend.put_archive()``
support same archive types as ``audeer.create_archive()``
* Changed: ``audbackend.Backend.get_file()``
skips operation if file with same checksum exists on local file system
* Changed: ``audbackend.Backend.get_file()`` uses a temporary directory
to avoid corrupted files if operation is interrupted
* Changed: ``audbackend.Backend.get_file()``
and ``audbackend.Backend.put_file()`` raise ``IsADirectoryError``
* Changed: ``audbackend.put_archive()`` raises ``NotADirectoryError``
* Changed: make ``files`` an optional argument of
``audbackend.Backend.put_archive()``
* Changed: ``audbackend.Backend.put_file()``
passes checksum to implementation to avoid re-calculation
* Changed: ``audbackend.Backend.join()`` and ``audbackend.Backend.split()``
check for invalid characters
* Changed: ``audbackend.Backend.ls()`` returns list of ``(path, ext, version)``
* Changed: ``audbackend.Backend.ls()`` accepts full path
* Changed: calculate checksum with ``audeer.md5()``
* Changed: file structure on ``audbackend.FileSystem``
and ``audbackend.Artifactory`` from
``/sub/file/1.0.0/file-1.0.0.txt``
to
``/sub/1.0.0/file.txt``
* Changed: remove ``ext`` argument
* Changed: path on backend must start with ``"/"``
* Changed: version must be non-empty and may not contain invalid characters
* Changed: option to install only specific backends
and their dependencies
* Removed:
``audbackend.Backend.glob()``,
``audbackend.Backend.path()``
* Removed: support for ``Python 3.7``
* Removed: dependency on ``audfactory``

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

* Fixed: support ``dohq_artifactory.exception.ArtifactoryException``
which was introduced in ``dohq_artifactory>=0.8``
and is raised instead of a HTTP request error