Dtoolcore

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

Fixed
^^^^^

- Actually fixed defect where using ``DTOOL_NUM_PROCESSES`` > 1 resulted in a
cPickle.PicklingError on some storage brokers. Multiprocessing is now only
used if the storage broker supports it.

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

Fixed
^^^^^

- Fixed defect where using ``DTOOL_NUM_PROCESSES`` > 1 resulted in
a cPickle.PicklingError on some storage brokers. Multiprocessing
is now only used if the storage broker supports it.

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

Added
^^^^^

- dtoolcore.DataSetCreator.put_readme() method
- dtoolcore.DataSetCreator.put_annotation() method

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

Release with utilities to make it easier to create datasets using the Python API.

Added
^^^^^

- dtoolcore.create_proto_dataset() helper function
- dtoolcore.create_derived_proto_dataset() helper function
- dtoolcore.DataSetCreator helper context manager class
- dtoolcore.DerivedDataSetCreator helper context manager class

Fixed
^^^^^

- Made dtoolcore.DiskStorageBroker.put_item more Windows compatible
- Made dtoolcore.DiskStorageBroker.get_item_abspath more Windows compatible

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

Added
^^^^^

- Ability to use multiple processes (cores) to generate item properties for
manifest files in parallel. Set the environment variable
``DTOOL_NUM_PROCESSES`` to specify the number of processes to use.

Fixed
^^^^^

- Included .dtool/annotations directory in DiskStorageBroker self description file

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

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