Nestedtext

-----------------
- Added ability to disable support for inlines using *dialect* argument to
:func:`load()` and :func:`loads()`.
- Added :func:`get_keys()`, :func:`get_value()`, :func:`get_line_numbers()`, and
:func:`get_location()`.
- Deprecated :func:`get_value_from_keys()`, :func:`get_lines_from_keys()`,
:func:`get_original_keys()`, and :func:`join_keys()`.
- Added *offset* argument to :meth:`Location.as_line()`.
- Add ability to specify *source* to :func:`load()`.
- Clarified policy on white space in inline strings.

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

- De-duplicating with the *on_dup* argument to :func:`loads` now works well for
error reporting with keymaps.
- The *map_keys* argument has been added to :func:`dump` and :func:`dumps`.

.. warning::

The *sort_keys* argument to :func:`dump` and :func:`dumps` has changed.
When passing a call-back function to *sort_keys*, that call-back function
now has a second argument, *parent_keys*. In addition, the first argument
has changed. It is now a tuple with three members rather than two, with the
new and leading member being the mapped key rather than the original key.

.. warning::

The state passed to the *on_dup* functions of :func:`dump` and :func:`dumps`
no longer contains the value associated with the duplicate key.

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

- Minor refinements and fixes.

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

- Improved the *on_dup* parameter to :meth:`load` and :meth:`loads`.
- Added *strict* argument to :func:`join_keys`.

.. warning::

Be aware that the new version of the *on_dup* parameter is not compatible
with previous versions.

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

- Add *normalize_key* argument to :meth:`load` and :meth:`loads`.
- Added utility functions for operating on keys and keymaps:

- :func:`get_value_from_keys`
- :func:`get_lines_from_keys`
- :func:`get_original_keys`
- :func:`join_keys`

- None passed as key is now converted to an empty string rather than "None".

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

- Add circular reference detection and reporting.