Metadata-Version: 2.4
Name: user_agent
Version: 0.1.10
Summary: User-Agent generator
Home-page: https://github.com/lorien/user_agent
Download-URL: http://pypi.python.org/pypi/user_agent
Author: Gregory Petukhov
Author-email: lorien@lorien.name
Maintainer: Gregory Petukhov
Maintainer-email: lorien@lorien.name
License: MIT License
Keywords: user agent browser navigator
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.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: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP
License-File: LICENSE
License-File: AUTHORS.rst
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: summary

==========
user_agent
==========

.. image:: https://travis-ci.org/lorien/user_agent.png?branch=master
    :target: https://travis-ci.org/lorien/user_agent?branch=master

.. image:: https://ci.appveyor.com/api/projects/status/jbyd2b9dfq99fvs3
    :target: https://ci.appveyor.com/project/lorien/user-agent

.. image:: https://readthedocs.org/projects/user_agent/badge/?version=latest
    :target: http://user-agent.readthedocs.org


What is user_agent module for?
-------------------------------

This module is for generating random, valid web user agents:

* content of "User-Agent" HTTP headers
* content of `window.navigator` JavaScript object


Usage Example
-------------

.. code:: python

    >>> from user_agent import generate_user_agent, generate_navigator
    >>> from pprint import pprint
    >>> generate_user_agent()
    'Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 6.3; Win64; x64)'
    >>> generate_user_agent(os=('mac', 'linux'))
    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:36.0) Gecko/20100101 Firefox/36.0'
    >>> pprint(generate_navigator())
    {'app_code_name': 'Mozilla',
     'app_name': 'Netscape',
     'appversion': '5.0',
     'name': 'firefox',
     'os': 'linux',
     'oscpu': 'Linux i686 on x86_64',
     'platform': 'Linux i686 on x86_64',
     'user_agent': 'Mozilla/5.0 (X11; Ubuntu; Linux i686 on x86_64; rv:41.0) Gecko/20100101 Firefox/41.0',
     'version': '41.0'}
    >>> pprint(generate_navigator_js())
    {'appCodeName': 'Mozilla',
     'appName': 'Netscape',
     'appVersion': '38.0',
     'platform': 'MacIntel',
     'userAgent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:38.0) Gecko/20100101 Firefox/38.0'}


Command Line Usage
------------------

.. code:: shell

    $ ua
    Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:49.0) Gecko/20100101 Firefox/49.0

    $ ua -n chrome -e
    {
      "oscpu": "Linux i686 on x86_64", 
      "appName": "Netscape", 
      "appCodeName": "Mozilla", 
      "appVersion": "55.0.2909.25", 
      "platform": "X11; Linux i686 on x86_64", 
      "userAgent": "Mozilla/5.0 (X11; Linux i686 on x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2909.25 Safari/537.36"
    }


Installation
------------

.. code:: shell

    $ pip install -U user_agent


Documentation
-------------

Documentation is available at http://user-agent.readthedocs.org


Contribution
============

Use github to submit bug,fix or wish request: https://github.com/lorien/user_agent/issues

