Metadata-Version: 1.2
Name: plaster_pastedeploy
Version: 0.1
Summary: A loader implementing the PasteDeploy syntax to be used by plaster.
Home-page: https://github.com/Pylons/plaster_pastedeploy
Author: Hunter Senft-Grupp
Author-email: huntcsg@gmail.com
License: UNKNOWN
Description: ===================
        plaster_pastedeploy
        ===================
        
        .. image:: https://img.shields.io/pypi/v/plaster_pastedeploy.svg
                :target: https://pypi.python.org/pypi/plaster_pastedeploy
        
        .. image:: https://img.shields.io/travis/Pylons/plaster_pastedeploy.svg
                :target: https://travis-ci.org/Pylons/plaster_pastedeploy
        
        ``plaster_pastedeploy`` is a plaster_ plugin that provides a ``plaster.Loader``
        that can parse ini files according to the standard set by PasteDeploy_. It
        supports the ``wsgi`` plaster protocol, implementing the
        ``plaster.protocols.IWSGIProtocol`` interface.
        
        Usage
        =====
        
        Applications should use ``plaster_pastedeploy`` to load settings from named
        sections in a configuration source (usually a file).
        
        - Please look at the documentation for plaster_ on how to integrate this
          loader into your application.
        
        - Please look at the documentation for PasteDeploy_ on the specifics of the
          supported INI file format.
        
        Most applications will want to use
        ``plaster.get_loader(uri, protocols=['wsgi'])`` to get this loader. It then
        exposes ``get_wsgi_app``, ``get_wsgi_app_settings``, ``get_wsgi_filter`` and
        ``get_wsgi_server``.
        
        .. code-block:: python
        
            import plaster
        
            loader = plaster.get_loader('development.ini', protocols=['wsgi'])
            # to get any section out of the config file
            settings = loader.get_settings('app:main')
        
            # to get settings for a WSGI app
            app_config = loader.get_wsgi_app_settings() # defaults to main
        
            # to get an actual WSGI app
            app = loader.get_wsgi_app() # defaults to main
        
            # to get a filter and compose it with an app
            filter = loader.get_wsgi_filter('filt')
            app = filter(app)
        
            # to get a WSGI server
            server = loader.get_wsgi_server() # defaults to main
        
            # to start the WSGI server
            server(app)
        
        Any ``plaster.PlasterURL`` options are forwarded as defaults to the loader.
        Some examples are below:
        
        - ``development.ini#myapp``
        
        - ``development.ini?http_port=8080#main``
        
        - ``ini+pastedeploy:///path/to/development.ini``
        
        - ``ini+pastedeploy://development.ini#foo``
        
        - ``egg:MyApp?debug=false#foo``
        
        .. _PasteDeploy: http://pastedeploy.readthedocs.io/en/latest/
        .. _plaster: http://docs.pylonsproject.org/projects/plaster/en/latest/
        
        
        0.1 (2017-03-27)
        ================
        
        - Initial release.
        
Keywords: plaster pastedeploy plaster_pastedeploy ini config egg
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
