Skosprovider

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

- A provider can now receive a dataset keyword containing a dict. If present,
this :class:`dict` needs to have a `uri` attribute.
- Update some requirements.

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

- Allow marking a note as containing HTML. (17)
- Add languages attribute to :class:`skosprovider.skos.ConceptScheme` to make it
possible to track what languages are being used in a thesaurus. (19)
- Add a sources attribute to :class:`~skosprovider.skos.ConceptScheme`,
:class:`~skosprovider.skos.Collection` and
:class:`~skosprovider.skos.Concept`. Every source is an object that currently
only has one attribute, a citation. This looks like a good universal common
denominator. Just as with notes, a citation may contain HTML. (20, 24)
- Add sorting to :meth:`skosprovider.providers.VocabularyProvider.get_all`,
:meth:`skosprovider.providers.VocabularyProvider.find`,
:meth:`skosprovider.providers.VocabularyProvider.get_top_concepts`,
:meth:`skosprovider.providers.VocabularyProvider.get_top_display`,
:meth:`skosprovider.providers.VocabularyProvider.get_children_display`.
Sorting can be done on `id`, `label` or `sortlabel`. The last option makes it
possible to introduce arbitrary sorting for concepts, eg. to sort periods
chronologically. The sort order can be specified with the `sort_order`
parameter. (21)
- Remove :func:`skosprovider.providers.VocabularyProvider.expand_concept` that
was deprecated since `0.2.0`.
- Fixed a bug with :func:`skosprovider.skos.dict_to_label` and
:func:`skosprovider.skos.dict_to_note` that would assign `None` instead of
`und` as the language for labels and notes that have no language.
- Improved checking for valid URIs with e.g.
:class:`skosprovider.skos.ConceptScheme`. This was causing weird issues with
registering a provider to the :class:`skosprovider.registry.Registry`. (27)

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

- When a :class:`skosprovider.providers.DictionaryProvider` reads a dictionary
containing a :term:`URI` and that URI's None, generate a URI. (12)
- Upgrade to the newest version of language-tags, this fixes a showstopping bug
on Windows machines. (16)
- Added an examples folder with a script that demonstrates the API using a
DictionaryProvider.
- Added a wheel config file.

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

Release 0.5.1 was a brown-paper-bag release due to some mucking about with pypi.

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

- Make it possible to pass a language tag to
:meth:`skosprovider.registry.Registry.find` that will be passed on to all
relevant registered providers. This determines in what language the
labels of the returned concepts will displayed. (10) [dieuska]
- Make it possible to pass a language tag to
:meth:`skosprovider.registry.Registry.get_all` that will be passed to all
registered providers. This determines in what language the
labels of the returned concepts will displayed.
- Fixed some errors with the :func:`skosprovider.utils.dict_dumper`. It didn't
dump the `matches` or the `subordinate_arrays` of concepts.
- Wrote some new documentation on what a provider is and how to use it. Some
other documentation work as well such as documenting the `language` parameter
in the API better.

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

- Changed the default language from `None` to the official IANA language code
`und` (undetermined). This is a minor BC break for users dealing with labels
that have not been assigned a language.
- Added a :class:`~skosprovider.exceptions.ProviderUnavailableException`
to let a provider signal that an underlying backend is not available.