Metadata-Version: 2.1
Name: audb
Version: 1.2.6
Summary: Load and publish databases in audformat
Home-page: https://audeering.github.io/audb/
Author: Johannes Wagner, Hagen Wierstorf
Author-email: jwagner@audeering.com, hwierstorf@audeering.com
License: MIT
Project-URL: Documentation, https://audeering.github.io/audb/
Keywords: audio,data,annotation,mlops,machine learning
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering
Requires-Dist: audbackend (>=0.3.15)
Requires-Dist: audeer (>=1.18.0)
Requires-Dist: audformat (<2.0.0,>=0.14.1)
Requires-Dist: audiofile (>=1.0.0)
Requires-Dist: audobject (>=0.5.0)
Requires-Dist: audresample (>=0.1.6)
Requires-Dist: oyaml

====
audb
====

|tests| |coverage| |docs| |python-versions| |license|

**audb** manages your annotated media files.

Databases used in machine learning
should be easily exchangeable
and versioned for reproducibility.
**audb** allows both
as it stores all databases in a `common format`_
and manages different versions of a database.
Databases are stored in repositories
on local file systems
or Artifactory_ servers.

You can request resampling or remixing of audio content
and filter the downloaded data,
e.g. if you just want to download the test set.

Have a look at the installation_ and quickstart_ instructions.

.. _common format: https://audeering.github.io/audformat/
.. _Artifactory: https://jfrog.com/artifactory/
.. _installation: https://audeering.github.io/audb/install.html
.. _quickstart: https://audeering.github.io/audb/quickstart.html


.. badges images and links:
.. |tests| image:: https://github.com/audeering/audb/workflows/Test/badge.svg
    :target: https://github.com/audeering/audb/actions?query=workflow%3ATest
    :alt: Test status
.. |coverage| image:: https://codecov.io/gh/audeering/audb/branch/master/graph/badge.svg?token=drrULW8vEG
    :target: https://codecov.io/gh/audeering/audb/
    :alt: code coverage
.. |docs| image:: https://img.shields.io/pypi/v/audb?label=docs
    :target: https://audeering.github.io/audb/
    :alt: audb's documentation
.. |license| image:: https://img.shields.io/badge/license-MIT-green.svg
    :target: https://github.com/audeering/audb/blob/master/LICENSE
    :alt: audb's MIT license
.. |python-versions| image:: https://img.shields.io/pypi/pyversions/audb.svg
    :target: https://pypi.org/project/audb/
    :alt: audbs's supported Python versions

Changelog
=========

All notable changes to this project will be documented in this file.

The format is based on `Keep a Changelog`_,
and this project adheres to `Semantic Versioning`_.


Version 1.2.6 (2022-04-01)
--------------------------

* Changed: use emodb v1.2.0 for examples and tests
* Changed: depend on ``audobject>=0.5.0``
* Changed: depend on ``audformat>=0.14.0``
* Changed: depend on ``audeer>=1.18.0``
* Fixed: depend on ``audbackend>=0.3.15``
  to avoid the possibility of an error
  when requesting versions of a database
* Fixed: add full Windows support and tests
* Fixed: only create tmp folder when needed in ``audb.load()``
* Removed: ``include``/``exclude`` keyword arguments
* Removed: ``audb.get_default_cache_root()``


Version 1.2.5 (2022-02-23)
--------------------------

* Fixed: make moving of local files Windows compatible
* Fixed: create folder tree more efficiently when loading to cache


Version 1.2.4 (2022-02-07)
--------------------------

* Changed: depend on ``audformat>=0.13.3``
* Fixed: conversion of pickle protocol 5 files to pickle protocol 4 in cache


Version 1.2.3 (2022-02-01)
--------------------------

* Added: more examples to the API docstrings
* Changed: depend on ``audformat>=0.13.2``
* Changed: use pickle protocol-4 for caching dependencies


Version 1.2.2 (2022-01-03)
--------------------------

* Fixed: small improvements to API documentation
* Fixed: speed up ``audb.load_to()`` storing of CSV files


Version 1.2.1 (2021-11-18)
--------------------------

* Fixed: build documentation inside the release process with Python 3.8


Version 1.2.0 (2021-11-18)
--------------------------

* Added: support for Python 3.9
* Added: store file duration of the database
  in the duration cache of ``audformat.Database``
* Changed: ``audb.publish()`` now raises an error
  if a table contains duplicated index entries
* Fixed: several speed ups when loading or publishing a database
* Fixed: the ``root`` attribute of the returned database object
  from ``audb.load_to()`` does now point to the correct folder
  and not the temporal folder
* Removed: support for Python 3.6


Version 1.1.9 (2021-08-05)
--------------------------

* Added: ``name`` argument to ``audb.cached()``
  to limit search to given database name
* Changed: speedup ``audb.available()`` by 100%
* Changed: use ``audiofile.duration(..., sloppy=True)``
  for estimating durations for dependency files
* Fixed: ``audb.cached()`` for empty or missing shared cache


Version 1.1.8 (2021-08-03)
--------------------------

* Fixed: set ``bit_depth`` to ``0`` instead of ``None``
  for non SND formats in the dependency table


Version 1.1.7 (2021-08-03)
--------------------------

* Fixed: store metadata in dependency table for non SND formats
  like MP3 and MP4 files


Version 1.1.6 (2021-07-29)
--------------------------

* Added: documentation sub-section on database duration info
* Fixed: made compatible with future versions of ``pandas``
* Fixed: missing ``audb.Repository`` documentation


Version 1.1.5 (2021-05-26)
--------------------------

* Fixed: ``audb.load()`` raises now error for wrong keyword argument
* Fixed: look also in shared cache for partial loaded databases


Version 1.1.4 (2021-05-19)
--------------------------

* Fixed: version number shown in the documentation table of content


Version 1.1.3 (2021-05-18)
--------------------------

* Added: discussion of needed system packages for handling audio files
  in the documentation
* Changed: allow only to publish portable databases
* Fixed: macOS support by relying on new ``audresample`` version


Version 1.1.2 (2021-05-06)
--------------------------

* Added: ``audb.load_media()``
* Added: ``audb.load_table()``
* Added: documentation on how to configure access rights
  for shared cache folder
* Changed: speedup ``audb.Dependencies`` methods
* Changed: speedup ``audb.info`` functions
* Changed: ``audb.info`` uses cache as well
* Changed: use emodb 1.1.1 in documentation
* Changed: depend on ``audformat>=0.11.0``
* Fixed: allow ``audb.load()`` to work offline if database is cached


Version 1.1.1 (2021-04-30)
--------------------------

* Fixed: update removal version of deprecated stuff to 1.2.0


Version 1.1.0 (2021-04-29)
--------------------------

* Added: ``audb.Dependencies._remove()``
* Changed: ``audb.Dependencies`` internally uses ``pd.DataFrame`` instead of ``dict``
* Changed: store dependencies with pickle to speed up loading
* Changed: versions of the same flavor share dependency file
* Changed: if possible ``audb.load()`` copies tables and media files from other versions in the cache
* Changed: ``audb.Dependencies._add_media()`` is now private
* Changed: ``audb.Dependencies._add_meta()`` is now private
* Changed: ``audb.Dependencies.is_removed`` renamed to ``audb.Dependencies.removed``
* Fixed: ``audb.load()`` considers format when searching the cache
* Fixed: ``audb.load()`` considers format when resolving missing media
* Fixed: ``audb.available()`` correctly returns versions of the same database from multiple repositories
* Fixed: add missing link to ``emodb`` example repository
* Removed: ``audb.Dependencies.data``


Version 1.0.4 (2021-04-09)
--------------------------

* Changed: ``audb.Dependencies.bit_depth()`` now always returns an integer
* Changed: ``audb.Dependencies.channels()`` now always returns an integer
* Changed: ``audb.Dependencies.duration()`` now always returns a float
* Changed: ``audb.Dependencies.sampling_rate()`` now always returns an integer
* Fixed: ``audb.info.duration()`` for databases that contain files with a
  duration of 0s
* Fixed: remove dependency to ``fire`` package


Version 1.0.3 (2021-04-08)
--------------------------

* Fixed: docstring of ``audb.exists()`` falsely claimed that it was not
  returning a boolean
* Fixed: several typos in documentation


Version 1.0.2 (2021-04-07)
--------------------------

* Fixed: renamed ``latest_only`` argument of ``audb.available()``
  to ``only_latest`` as it was before


Version 1.0.1 (2021-04-07)
--------------------------

* Fixed: appearance of documentation TOC by requirering ``docutils<0.17``


Version 1.0.0 (2021-04-07)
--------------------------

* Added: first public release
* Added: ``audb.info.author()``
* Added: ``audb.info.license()``
* Added: ``audb.info.license_url()``
* Added: ``audb.info.organization()``
* Added: ``audb.Dependencies.archives`` property
* Added: section on publication in the documentation
* Added: introduction texts to documentation
* Changed: raise error for conversion of non-supported format
* Changed: ``audb.exists()`` to return bool
* Changed: rename ``audb.lookup_repository()`` to ``audb.repository()``
* Changed: one combined section on load in the documentation
* Fixed: data types in dataframe returned by ``audb.cached()``
* Fixed: support files stored in archives with nested folders
* Fixed: listing of cache entries
* Removed: command line interface
* Removed: ``audb.cached_databases()``
* Removed: ``audb.define`` module


Version 0.93.0 (2021-03-29)
---------------------------

* Added: ``complete`` column in ``audb.cached()``
* Added: ``previous_version`` argument to ``audb.publish()``
* Added: backward compatibility with ``audb <0.90``
* Changed: cache flavor path to name/version/flavor_id
* Changed: use open source releases of ``audbackend``,
  ``audobject``,
  and ``audresample``
* Changed: require ``audformat>=0.10.0``
* Changed: rename ``audb.load_original_to()`` to ``audb.load_to()``
* Changed: shorten flavor ID in cache
* Changed: filter operations and ``only_metadata`` no longer part
  of ``audb.Flavor``
* Deprecated: ``include`` and ``excldue`` arguments
* Fixed: looking for latest version across repositories
* Fixed: ``Flavor.destination`` for nested paths
* Fixed: allow for cross-backend dependencies for ``audb.publish()``
* Fixed: ``audb.remove_media()`` can now be called several times


Version 0.92.1 (2021-03-19)
---------------------------

* Changed: enforce ``mixdown=False`` for mono file flavors
* Fixed: global config file was missing in PyPI package


Version 0.92.0 (2021-03-09)
---------------------------

* Added: configuration file
* Changed: use external package for backend implementations


Version 0.91.0 (2021-02-19)
---------------------------

* Added: ``audb.Backend.latest_version()``
* Added: ``audb.Backend.create()``
* Added: ``audb.Backend.register()``
* Added: ``audb.lookup_repository()``
* Added: ``config.REPOSITORY_PUBLISH``
* Fixed: update ``fire`` dependency
* Fixed: remove ``config.GROUP_ID``
* Fixed: use ``sphinx>=3.5.1`` to fix inherited attributes
  in documentation


Version 0.90.3 (2021-02-01)
---------------------------

* Changed: define data types when reading dependency file


Version 0.90.2 (2021-01-28)
---------------------------

* Added: ``data-provate-local`` to the default repositories


Version 0.90.1 (2021-01-25)
---------------------------

* Fixed: CHANGELOG


Version 0.90.0 (2021-01-22)
---------------------------

* Added: initial release


.. _Keep a Changelog:
    https://keepachangelog.com/en/1.0.0/
.. _Semantic Versioning:
    https://semver.org/spec/v2.0.0.html


