pastedeploy help methods for repoze.what
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


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://
    cd repoze.what.plugins.config
    python 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::

    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 

* 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::

    use = repoze.who.plugins.basicauth:make_plugin
    realm = 'zbfg'

    use = repoze.who.plugins.htpasswd:make_plugin
    check_fn = repoze.who.plugins.htpasswd:plain_check
    filename = %(here)s/passwd

    use = repoze.what.plugins.ini:INIGroupAdapter
    filename = group.ini

    use = repoze.what.plugins.ini:INIPermissionsAdapter
    filename = permissions.ini

    request_classifier = repoze.who.classifiers:default_request_classifier
    challenge_decider = repoze.who.classifiers:default_challenge_decider
    remote_user_key = REMOTE_USER

    plugins = basicauth

    plugins = htpasswd

    plugins = basicauth

    group_adapters = ini_group
    permission_adapters = ini_permission