Metadata-Version: 1.1
Name: pyramid_useragent
Version: 0.2
Summary: HTTP User-Agent parser for Pyramid
Home-page: https://bitbucket.org/pior/pyramid_useragent
Author: Pior Bastida, Ludia Inc
Author-email: pior@pbastida.net
License: BSD-derived (http://www.repoze.org/LICENSE.txt)
Description: pyramid_useragent
        =================
        
        
        Project Info
        ------------
        
        Provides an HTTP User-Agent parser for the
        `Pyramid <http://docs.pylonsproject.org>`_ web framework.
        
        * Documentation: http://pyramid-useragent.readthedocs.org/
        * PyPI: https://pypi.python.org/pypi/pyramid_useragent
        * Bitbucket: https://bitbucket.org/pior/pyramid_useragent
        * |droneio|
        
        .. |droneio| image:: https://drone.io/bitbucket.org/pior/pyramid_useragent/status.png
           :target: https://drone.io/bitbucket.org/pior/pyramid_useragent
           :alt: Tests on drone.io
        
        Setup
        -----
        
        Once `pyramid_useragent` is installed, you typically use the ``config.include``
        mechanism to include it into your Pyramid project's configuration. In your
        Pyramid project's ``__init__.py``:
        
        .. code-block:: python
        
           config = Configurator(.....)
           config.include('pyramid_useragent')
        
        Alternately, instead of using the Configurator's ``include`` method, you can
        activate Pyramid by changing your application's ``.ini`` file, use the
        following line:
        
        .. code-block:: ini
        
           pyramid.includes = pyramid_useragent
        
        
        Usage
        -----
        
        .. code-block:: python
        
            def parsed(request):
                ua = request.user_agent_parsed  # I'am reified!
        
                name_of_first_component = ua.maincomponent.name
                version_of_first_component = ua.maincomponent.version
                comments_of_first_component = ua.maincomponent.comments
        
                name_of_third_component = ua.components.values()[2].name
        
                if request.user_agent_parsed.maincomponent.name == 'Links':
                    return "Did you really use Links?"
                else:
                    return ua.components.values()
        
        
        Tests and Docs
        --------------
        
        .. code-block:: python
        
           pip install -e .[testing]
           nosetests
        
        .. code-block:: python
        
           pip install -e .[docs]
           cd docs
           make html
        
        
        
        0.1
        ---
        
        - Initial release.
        
Keywords: web wsgi pylons pyramid user-agent
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Framework :: Pyramid
