Metadata-Version: 1.0
Name: plone.keyring
Version: 2.0
Summary: Manage secrets
Home-page: http://pypi.python.org/pypi/plone.keyring
Author: Plone Foundation
Author-email: plone-developers@lists.sourceforge.net
License: BSD
Description: Introduction
        ============
        
        *plone.keyring* contains a Zope utility that facilitates handling of
        secrets in an application. Secrets are very important in modern applications,
        which is why a shared tool to manage them is useful.
        
        plone.keyring contains two basic components:
        
        * a *keyring*: a data structures which contains one or more secrets.
        
        * a *key manager*: a utility which contains the available keyrings and
          provides some convenience methods to manage them
        
        
        Keyrings
        ========
        
        The keyring is the workhorse: it contains a set of secrets for a specific
        purpose. A ring has room for a fixed number of secrets which is set at
        creation time. The most recently added secret is considered to be the
        `current` secret and the one that should be used. Older secrets in the ring
        can be used to keep data generated with older secrets valid for a period of
        time.
        
        Key manager
        ===========
        
        The key manager is a container for the available keyrings. It always
        contains a default system keyring which is used when no other ring is
        explicitly requested.
        
        Installation
        ============
        
        You'll need to register a KeyManager as a persistent utility. On Zope2 with
        GenericSetup, this can be done by loading the included profile.
        
        Changelog
        =========
        
        2.0 - 2010-07-18
        ----------------
        
        - Update package information.
          [hannosch]
        
        
        2.0b1 - 2010-06-13
        ------------------
        
        * Added a meta.zcml to load the GenericSetup ZCML if installed.
          [hannosch]
        
        * Update license to BSD following board decision:
          http://lists.plone.org/pipermail/membership/2009-August/001038.html
          [elro]
        
        
        2.0a1 - 2009-11-13
        ------------------
        
        * Updated to use `zope.container` instead of `zope.app.container`.
          [hannosch]
        
        * Specify package dependencies.
          [hannosch]
        
        
        1.3 - unreleased
        ----------------
        
        * Add a conditional ZCML utility registration so this package can be used in
          pure Zope 2 applications easily.
          [MatthewWilkes]
        
        
        1.2 - May 8, 2008
        -----------------
        
        * Fix registration of the GenericSetup profile.
          [witsch]
        
        
        1.1 - May 2, 2008
        -----------------
        
        * Add an optional GenericSetup profile to register the KeyManager as utility.
          Required for plone.keyring on Plone 3.0.
          [mj]
        
        
        1.0 - April 21, 2008
        --------------------
        
        * No changes
          [wichert]
        
        
        1.0b1 - March 7, 2008
        ---------------------
        
        * Tweak the tests to better test the API.
          [witsch]
        
        
        1.0a1 - January 22, 2008
        ------------------------
        
        * Initial release
          [wichert]
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Zope2
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
