Repository¶

class audb.Repository(name, host, backend)[source]¶

Repository object.

It stores all information needed to address a repository: the repository name, host, and the backend name. With Repository.create_backend_interface() it also provides a method to create a backend interface to access the repository.

Parameters:

name (str) – repository name
host (str) – repository host
backend (str) – repository backend

Examples

>>> Repository("data-local", "/data", "file-system")
Repository('data-local', '/data', 'file-system')

eq()¶

Repository.__eq__(other)[source]¶

Compare two repository instances.

Parameters:: other – repository instance
Return type:: bool
Returns:: True if the string representation of the repositories matches

backend¶

Repository.backend¶: Repository backend name.

backend_registry¶

Repository.backend_registry = {'artifactory': <class 'audbackend.core.backend.artifactory.Artifactory'>, 'file-system': <class 'audbackend.core.backend.filesystem.FileSystem'>, 'minio': <class 'audbackend.core.backend.minio.Minio'>, 's3': <class 'audbackend.core.backend.minio.Minio'>}¶

Backend registry.

Holds mapping between registered backend names, and their corresponding backend classes.

create_backend_interface()¶

Repository.create_backend_interface()[source]¶

Create backend interface to access repository.

It wraps an audbackend.interface.Versioned interface around it. The files will then be stored with the following structure on the backend (shown by the example of version 1.0.0 of the emodb dataset):

emodb/1.0.0/db.yaml            <-- header
emodb/1.0.0/db.zip             <-- dependency table
emodb/attachment/1.0.0/...     <-- attachments
emodb/media/1.0.0/...          <-- media files
emodb/meta/1.0.0/...           <-- tables

When Repository.backend equals artifactory, it wraps an audbackend.interface.Maven interface around it. The files will then be stored with the following structure on the Artifactory backend (shown by the example of version 1.0.0 of the emodb dataset):

emodb/db/1.0.0/db-1.0.0.yaml   <-- header
emodb/db/1.0.0/db-1.0.0.zip    <-- dependency table
emodb/attachment/.../1.0.0/... <-- attachments
emodb/media/.../1.0.0/...      <-- media files
emodb/meta/.../1.0.0/...       <-- tables

The returned backend instance has not yet established a connection to the backend. To establish a connection, use the backend with a with statement, or use the open() and close() methods of the backend class. The backend is stored as the inside the backend attribute of the returned backend interface.

Return type:

type[Base]

Returns:

interface to repository

Raises:

ValueError – if an artifactory backend is requested in with a Python version that does not yet support it
ValueError – if a non-supported backend is requested

host¶

Repository.host¶: Repository host.

name¶

Repository.name¶: Repository name.

register()¶

classmethod Repository.register(backend_name, backend_class)[source]¶

Register backend class.

Adds an entry to the dictionary stored in the class variable Repository.backend_registry, mapping a backend name to an actual backend class.