Revert "Add audbackend.checksum() (#245)"

This reverts commit 1d0c713.

audbackend/__init__.py

@@ -3,7 +3,6 @@
 from audbackend.core.backend.base import Base as Backend  # legacy
 from audbackend.core.backend.filesystem import FileSystem  # legacy
 from audbackend.core.errors import BackendError
-from audbackend.core.utils import checksum
 from audbackend.core.repository import Repository
 
 # Import optional backends (legacy)

audbackend/core/backend/base.py

@@ -69,12 +69,12 @@ def _assert_equal_checksum(
 
         """
         if path_is_local:
-            checksum = utils.checksum(path)
+            checksum = audeer.md5(path)
         else:
             checksum = self.checksum(path)
 
         if path_ref_is_local:
-            checksum_ref = utils.checksum(path_ref)
+            checksum_ref = audeer.md5(path_ref)
         else:
             checksum_ref = self.checksum(path_ref)
 
@@ -569,7 +569,7 @@ def get_file(
             msg = f"Permission denied: '{dst_path}'"
             raise PermissionError(msg)
 
-        if not os.path.exists(dst_path) or utils.checksum(dst_path) != self.checksum(
+        if not os.path.exists(dst_path) or audeer.md5(dst_path) != self.checksum(
             src_path
         ):
             # get file to a temporary directory first,
@@ -1042,7 +1042,7 @@ def put_file(
         elif os.path.isdir(src_path):
             raise utils.raise_is_a_directory(src_path)
 
-        checksum = utils.checksum(src_path)
+        checksum = audeer.md5(src_path)
 
         # skip if file with same checksum already exists
         if not self.exists(dst_path) or self.checksum(dst_path) != checksum:

audbackend/core/backend/filesystem.py

@@ -32,7 +32,7 @@ def _checksum(
     ) -> str:
         r"""MD5 checksum of file on backend."""
         path = self._expand(path)
-        return utils.checksum(path)
+        return audeer.md5(path)
 
     def _collapse(
         self,

audbackend/core/interface/versioned.py

@@ -78,7 +78,7 @@ def checksum(
         Examples:
             >>> file = "src.txt"
             >>> import audeer
-            >>> audbackend.checksum(file)
+            >>> audeer.md5(file)
             'd41d8cd98f00b204e9800998ecf8427e'
             >>> interface.put_file(file, "/file.txt", "1.0.0")
             >>> interface.checksum("/file.txt", "1.0.0")

audbackend/core/utils.py

@@ -5,8 +5,6 @@
 import re
 import time
 
-import audeer
-
 from audbackend.core.errors import BackendError
 
 
@@ -106,62 +104,6 @@ def check_version(version: str) -> str:
     return version
 
 
-def checksum(file: str) -> str:
-    r"""Checksum of file.
-
-    This function is used by backends
-    to get the checksum of local files,
-    using :func:`audeer.md5`.
-
-    An exception are parquet files,
-    for which their ``"hash"`` metadata entry
-    is used as checksum,
-    if the entry is available
-    and pyarrow_ is installed.
-
-    .. _pyarrow: https://arrow.apache.org/docs/python/index.html
-
-    Args:
-        file: file path with extension
-
-    Returns:
-        MD5 checksum of file
-
-    Raises:
-        FileNotFoundError: if ``file`` does not exist
-
-    Examples:
-        >>> checksum("src.txt")
-        'd41d8cd98f00b204e9800998ecf8427e'
-        >>> import audformat
-        >>> import pandas as pd
-        >>> import pyarrow as pa
-        >>> import pyarrow.parquet as pq
-        >>> df = pd.DataFrame([0, 1], columns=["a"])
-        >>> hash = audformat.utils.hash(df, strict=True)
-        >>> hash
-        '9021a9b6e1e696ba9de4fe29346319b2'
-        >>> parquet_file = audeer.path("file.parquet")
-        >>> table = pa.Table.from_pandas(df)
-        >>> table = table.replace_schema_metadata({"hash": hash})
-        >>> pq.write_table(table, parquet_file, compression="snappy")
-        >>> checksum(parquet_file)
-        '9021a9b6e1e696ba9de4fe29346319b2'
-
-    """
-    ext = audeer.file_extension(file)
-    if ext == "parquet":
-        try:
-            import pyarrow.parquet as parquet
-
-            metadata = parquet.read_schema(file).metadata or {}
-            if b"hash" in metadata:
-                return metadata[b"hash"].decode()
-        except ModuleNotFoundError:
-            pass
-    return audeer.md5(file)
-
-
 def date_format(date: datetime.datetime) -> str:
     return date.strftime("%Y-%m-%d")
 

docs/api-src/audbackend.rst

@@ -31,4 +31,7 @@ and functions are available.
 
     BackendError
     Repository
-    checksum
+    access
+    create
+    delete
+    register

docs/conf.py

@@ -42,7 +42,6 @@
 autodoc_inherit_docstrings = False  # disable docstring inheritance
 intersphinx_mapping = {
     "audeer": ("https://audeering.github.io/audeer/", None),
-    "audformat": ("https://audeering.github.io/audformat/", None),
     "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
     "python": ("https://docs.python.org/3/", None),
 }

tests/bad_file_system.py

@@ -1,3 +1,5 @@
+import audeer
+
 import audbackend
 
 
@@ -14,7 +16,7 @@ def put_file(
         verbose: bool = False,
     ):
         r"""Put file on backend."""
-        checksum = audbackend.checksum(src_path)
+        checksum = audeer.md5(src_path)
         audbackend.core.utils.call_function_on_backend(
             self._put_file,
             src_path,