Keyring

===

* Update readme to include how-to use with Linux
non-graphical environments.

===

* Issue 197: Add ``__version__`` attribute to keyring module.

===

* Issue 117: Removed all but the preferred keyring backends
for each of the major desktop platforms:

- keyring.backends.kwallet.DBusKeyring
- keyring.backends.OS_X.Keyring
- keyring.backends.SecretService.Keyring
- keyring.backends.Windows.WinVaultKeyring

All other keyrings
have been moved to a new package, `keyrings.alt
<https://pypi.python.org/pypi/keyrings.alt>`_ and
backward-compatibility aliases removed.
To retain
availability of these less preferred keyrings, include
that package in your installation (install both keyring
and keyrings.alt).

As these keyrings have moved, any keyrings indicated
explicitly in configuration will need to be updated to
replace "keyring.backends." with "keyrings.alt.". For
example, "keyring.backends.file.PlaintextKeyring"
becomes "keyrings.alt.file.PlaintextKeyring".

=====

* Issue 194: Redirect away from docs until they have something
more than the changelog. Users seeking the changelog will
want to follow the `direct link
<https://pythonhosted.org/keyring/history.html>`_.

===

* Issue 117: Added support for filtering which
backends are acceptable. To limit to only loading recommended
keyrings (those with priority >= 1), call::

keyring.core.init_backend(limit=keyring.core.recommended)

===

* Pull Request 190: OS X backend now exposes a ``keychain``
attribute, which if set will be used by ``get_password`` when
retrieving passwords. Useful in environments such as when
running under cron where the default keychain is not the same
as the default keychain in a login session. Example usage::

keyring.get_keyring().keychain = '/path/to/login.keychain'
pw = keyring.get_password(...)