.. -*- coding: utf-8; mode: rst; indent-tabs-mode: nil; -*-

..
.. Valid tags: breaking, feature, bugfix, misc, test, doc
..

.. _changelog:

Changelog
=========

Pre-1.0 Series
--------------

.. changelog::
   :version: 0.7.dev1
   :released: unreleased

   .. change::
      :tags: breaking, feature

      The associations from filename extensions to parsers are
      :py:mod:`fnmatch` style patterns now.

      Calling :py:func:`configmix.set_loader` prepends to the currently
      defined associations and therefore gets the highest priority.

   .. change::
      :tags: feature

      :py:func:`configmix.load` and :py:func:`configmix.safe_load` got a
      keyword argument `defaults` that allow the provision of an already
      existing default configuration wheter all additional configuration
      settings are merged into.


.. changelog::
   :version: 0.6
   :released: 2019-03-14

   .. change::
      :tags: breaking, feature

      Reimplement :py:func:`configmix.safe_merge` do to a deepcopy of all
      source configurations when merging. Previously is was sort of a
      shallow copy.

   .. change::
      :tags: breaking, feature

      The default file encoding when reading INI style files with
      :py:func:`configmix.ini.load` is now "UTF-8". Previously it was
      undefined and therefore dependent on the user's locale.

      An `encoding` keyword argument can be specified explicitely now.

   .. change::
      :tags: breaking, feature

      Allow comment-like key-value pairs with configuration keys starting
      with ``__doc`` or ``__comment``.

   .. change::
      :tags: misc

      Use the filesystem encoding where appripriate.

   .. change::
      :tags: doc

      Begin the documentation with `Sphinx <http://www.sphinx-doc.org>`_

   .. change::
      :tags: test

      Begin formal unittests

   .. change::
      :tags: feature

      Build a tree of configuration settings from INI files

   .. change::
      :tags: feature

      Allow JSON formatted files as configuration files also (suffix ".json").

   .. change::
      :tags: feature

      Allow custom configuration filename extensions and custom loaders that
      can handle custom configuration file syntax styles.


.. changelog::
   :version: 0.5
   :released: 2016-04-19

   .. change::
      :tags: feature

      First really used release.