Dtoolcore

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

This release introduces the concept of annotations. Annotations are per dataset
metadata. The difference between annotations and the existing README
descriptive metadata is that the former is easier to interact with
programmatically.

Added
^^^^^

- Added ``dtoolcore._BaseDataSet.put_annotation`` method
- Added ``dtoolcore._BaseDataSet.get_annotation`` method
- Added ``dtoolcore._BaseDataSet.list_annotation_names`` method
- Added ``dtoolcore.DtoolCoreKeyError`` class
- Added ``dtoolcore.DtoolCoreValueError`` class
- Added name validation to ``_BaseDataSet.put_overlay`` method


Fixed
^^^^^

- Made DiskStorageBroker.put_text more robust in cases of missing parent
directories

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

Added
^^^^^

- Added support for host name in file URI.

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

Added
^^^^^

- Added more debug logging

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

Added
^^^^^

- ``dtoolcore._BaseDataSet.base_uri`` property
- ``dtoolcore.storagebroker.BaseStorageBroker.generate_base_uri`` method
- ``dtoolcore.utils.DEFAULT_CACHE_PATH`` global helper variable

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

Helper functions for making it easier to update the dtool config file.

Added
^^^^^

- dtoolcore.utils.get_config_value_from_file
- dtoolcore.utils.write_config_value_to_file

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

Added
^^^^^

- Support for Windows! :)