Deprecate audbackend.Repository (#220)

audbackend/core/repository.py

@@ -1,3 +1,6 @@
+import warnings
+
+
 class Repository:
     r"""Repository object.
 
@@ -7,15 +10,20 @@ class Repository:
     host,
     and backend.
 
+    .. Warning::
+
+        ``audbackend.Repository`` is deprecated
+        and will be removed in version 2.2.0.
+        If an application requires
+        repository objects,
+        that assign string names to backends,
+        they should be provided by the application.
+
     Args:
         name: repository name
         host: repository host
         backend: repository backend
 
-    Examples:
-        >>> Repository("data-local", "/data", "file-system")
-        Repository('data-local', '/data', 'file-system')
-
     """
 
     def __init__(
@@ -31,6 +39,9 @@ def __init__(
         self.backend = backend
         r"""Repository backend."""
 
+        message = "Repository is deprecated and will be removed with version 2.2.0."
+        warnings.warn(message, category=UserWarning, stacklevel=2)
+
     def __repr__(self):  # noqa: D105
         return (
             f"Repository("

tests/test_repository.py

@@ -0,0 +1,16 @@
+import pytest
+
+import audbackend
+
+
+def test_repository():
+    name = "name"
+    host = "host"
+    backend = "backend"
+    msg = "Repository is deprecated and will be removed with version 2.2.0."
+    with pytest.warns(UserWarning, match=msg):
+        repo = audbackend.Repository(name, host, backend)
+    assert repo.name == name
+    assert repo.host == host
+    assert repo.backend == backend
+    assert repo.__repr__() == f"Repository('{name}', '{host}', '{backend}')"