Metadata-Version: 1.0
Name: mobi.devices
Version: 1.1
Summary: Mobile Device detection library and wsgi middlewares
Home-page: http://mobi.infrae.com/
Author: Antonin Amand at Infrae
Author-email: info@infrae.com
License: BSD
Description: ============
        mobi.devices
        ============
        
        See documentation at http://mobi.infrae.com/
        
        ``mobi.devices`` is the set of tools to detect mobile user agents.
        It uses `WURFL database <http://wurfl.sourceforce.net>`_ as well as data from
        `MIT mobile project <http://m.mit.edu>`_.
        
        It also provides wsgi middlewares that can tag the request with some information
        about the devices performing the request.
        
        For best performance, please install **pytc**. It is not a package requirement
        since it is not available on all platforms.
        
        Paster example configuration::
        
        
        [app:yourapp]
        # This part describe your application
        # use = ...
        
        [filter:mobidevicedetection]
        # the entry point to use the classifier
        use = egg:mobi.devices#classifier
        # cache the classification on a client side cookie (default: true)
        cookie_cache = true
        # configure caching (see beaker documentation
        cache.type = ext:memcached
        cache.url = 127.0.0.1:11211
        cache.lock_dir = /tmp/mobicache
        # data directory *required*. make sure directory is writable
        # by the user that run the webserver
        var = /var/mobi/db
        # path to wurfl file. by default it uses the ones shipped with
        # this package. however you should use the latest one.
        wurfl_file = /var/mobi/wurfl.xml.gz
        
        [filter:mobirouter]
        use = egg:mobi.devices#router
        # redirect mobile devices that connect to infrae.com hostname
        # to m.infrae.com
        infrae.com = http://m.infrae.com/
        
        [pipeline:main]
        # This part configure the actual WSGI stack
        pipeline = mobidevicedetection mobirouter yourapp
        
        [server:main]
        # This is the configuration for paster web server.
        # It must have the same name as the pipeline
        use = egg:Paste#http
        host = 0.0.0.0
        port = 8080
        threadpool_workers = 7
        
        If you are using apache with rewrite rules that modify the path and
        you want the router to route on the original path, please add the
        following rule before any rewrite rule ::
        
        RewriteRule ^(.*)$ - [E=ORIGINAL_PATH:$1]
        RequestHeader set X_ORIGINAL_PATH %{ORIGINAL_PATH}e
        
        
        Changelog
        =========
        
        mobi.devices 1.1 (2010-12-20)
        -----------------------------
        - add original path http header handler to make router work with rewrite rules.
        - add simple router middleware.
        
        mobi.devices 1.0.1 (2010-09-14)
        -------------------------------
        
        - fix wurfl file configuration handling
        - fix missing import
        
        mobi.devices 1.0 (2010-09-13)
        -----------------------------
        
        - Add new engine for wurfl
        
        
        mobi.devices 1.0b1 (2010-07-14)
        -------------------------------
        
        - first release, see README.txt
        
        
Platform: UNKNOWN
