Metadata-Version: 2.0
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)
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
Requires-Dist: pyramid (>=1.4)
Provides-Extra: docs
Requires-Dist: Sphinx; extra == 'docs'
Requires-Dist: docutils; extra == 'docs'
Provides-Extra: testing
Requires-Dist: nose; extra == 'testing'
Requires-Dist: mock; extra == 'testing'
Requires-Dist: coverage; extra == 'testing'
Requires-Dist: nosexcover; extra == 'testing'
Requires-Dist: yanc; extra == 'testing'

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.


