Py-nestedtext

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

- Move the test cases to a submodule.

.. note::

When cloning the *NestedText* repository you should use the --recursive
flag to get the *official_tests* submodule::

git clone --recursive https://github.com/KenKundert/nestedtext.git

When updating an existing repository, you need to initialize the
submodule after doing a pull::

git submodule update --init --remote tests/official_tests

This only need be done once.

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

- Treat CR LF, CR, or LF as a line break.
- Always quote keys that start with a quote.

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

- Add ability to specify return type of :func:`load` and :func:`loads`.
- Quoted keys are now less restricted.
- Empty dictionaries and lists are rejected by :func:`dump` and
:func:`dumps` except as top-level object if *default* argument is
specified as 'strict'.

.. warning::

Be aware that this version is not fully backward compatible. Unlike
previous versions, this version allows you to restrict the type of the
return value of the :func:`load` and :func:`loads` functions, and the
default is 'dict'. The previous behavior is still supported, but you
must explicitly specify `top='any'` as an argument.

This change results in a simpler return value from :func:`load` and
:func:`loads` in most cases. This substantially reduces the chance of
coding errors. It was noticed that it was common to simply assume that
the top-level was a dictionary when writing code that used these
functions, which could result in unexpected errors when users
hand-create the input data. Specifying the return value eliminates this
type of error.

There is another small change that is not backward compatible. The
source argument to these functions is now a keyword only argument.

-----------------
- Production release.

-----------------
- Added :func:`load` and :func:`dump`.
- Eliminated *NestedTextError.get_extended_codicil*.

-----------------
- allow user to manage duplicate keys detected by :func:`loads`.