Metadata-Version: 1.0
Name: repoze.what.plugins.config
Version: 0.2.1
Summary: pastedeploy help methods for repoze.what.
Home-page: http://github.com/jdinuncio/repoze.what.plugins.config/tree/master
Author: Jose Dinuncio
Author-email: jdinunci@uc.edu.ve
License: BSD-derived (see http://www.repoze.org/LICENSE.txt)
Description: repoze.what.plugins.config -- repoze.what with pasterconfig
        ===========================================================
        
        .. topic:: Overview
        
          ``repoze.what.plugins.config`` allows you to configure ``repoze.who`` and 
          ``repoze.what`` using ``pastedeploy``. repoze.who and repoze.what are 
          WSGI middleware frameworks for authentication and authorization, 
          respectively. ``paster`` and ``pastedeploy`` allows you to configure your WSGI 
          application via INI files.
        
        
        Installing repoze.what.plugins.config
        =====================================
        
        You can install repoze.what.plugins.config using git::
        
            git clone git://github.com/jdinuncio/repoze.what.plugins.config.git
            cd repoze.what.plugins.config
            python setup.py install
        
        
        Using repoze.what.plugins.config
        ================================
        
        ``repoze.what.plugins.config`` offers a config entry point for pastedeploy to
        instantiate a ``repoze.who+repoze.what`` middleware. You can use it 
        as a filter in the paster INI file::
        
            [filter:what]
            use = egg:repoze.what.plugins.config#config
            config_file = %(here)s/what.ini
            who_config_file = %(here)s/who.ini
        
        The ``what.ini`` file has the same format of a who INI file, with the following 
        additions:
        
        * You can define what plugins.
        * There is a special section ``what`` with  ``group_adapters`` and 
          ``permission_adapters`` entries.
        
        You can combine who.ini and what.ini in one file. If you decide to do this,
        remember that a ``repoze.what`` modprovider will be implicitly added to
        your ``repoze.who`` configuration.
        
        Example of use
        ==============
        
        Here is a valid what.ini config file::
        
            [plugin:basicauth]
            use = repoze.who.plugins.basicauth:make_plugin
            realm = 'zbfg'
        
            [plugin:htpasswd]
            use = repoze.who.plugins.htpasswd:make_plugin
            check_fn = repoze.who.plugins.htpasswd:plain_check
            filename = %(here)s/passwd
        
            [plugin:ini_group]
            use = repoze.what.plugins.ini:INIGroupAdapter
            filename = group.ini
        
            [plugin:ini_permission]
            use = repoze.what.plugins.ini:INIPermissionsAdapter
            filename = permissions.ini
        
            [general]
            request_classifier = repoze.who.classifiers:default_request_classifier
            challenge_decider = repoze.who.classifiers:default_challenge_decider
            remote_user_key = REMOTE_USER
        
            [identifiers]
            plugins = basicauth
        
            [authenticators]
            plugins = htpasswd
        
            [challengers]
            plugins = basicauth
        
            [what]
            group_adapters = ini_group
            permission_adapters = ini_permission
        
        
        
Keywords: wsgi repoze what paste paster pastedeploy
Platform: UNKNOWN
