fake-useragent

info:: Up to date simple useragent faker with real world database

https://img.shields.io/coveralls/hellysmile/fake-useragent.svg

https://img.shields.io/pypi/dm/fake-useragent.svg

https://img.shields.io/pypi/v/fake-useragent.svg

Disclaimer

As of November 2016, useragentstring.com is down, version 0.1.3 uses hosted data to keep library working.

Features

grabs up to date useragent from useragentstring.com
randomize with real world statistic via w3schools.com

Installation

pip install fake-useragent

Usage

from fake_useragent import UserAgent
ua = UserAgent()

ua.ie
# Mozilla/5.0 (Windows; U; MSIE 9.0; Windows NT 9.0; en-US);
ua.msie
# Mozilla/5.0 (compatible; MSIE 10.0; Macintosh; Intel Mac OS X 10_7_3; Trident/6.0)'
ua['Internet Explorer']
# Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 6.1; Trident/4.0; GTB7.4; InfoPath.2; SV1; .NET CLR 3.3.69573; WOW64; en-US)
ua.opera
# Opera/9.80 (X11; Linux i686; U; ru) Presto/2.8.131 Version/11.11
ua.chrome
# Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.2 (KHTML, like Gecko) Chrome/22.0.1216.0 Safari/537.2'
ua.google
# Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/537.13 (KHTML, like Gecko) Chrome/24.0.1290.1 Safari/537.13
ua['google chrome']
# Mozilla/5.0 (X11; CrOS i686 2268.111.0) AppleWebKit/536.11 (KHTML, like Gecko) Chrome/20.0.1132.57 Safari/536.11
ua.firefox
# Mozilla/5.0 (Windows NT 6.2; Win64; x64; rv:16.0.1) Gecko/20121011 Firefox/16.0.1
ua.ff
# Mozilla/5.0 (X11; Ubuntu; Linux i686; rv:15.0) Gecko/20100101 Firefox/15.0.1
ua.safari
# Mozilla/5.0 (iPad; CPU OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5355d Safari/8536.25

# and the best one, random via real world browser usage statistic
ua.random

Notes

fake-useragent store collected data at your os temp dir, like /tmp

if you want to update saved database just

from fake_useragent import UserAgent
ua = UserAgent()
ua.update()

if you dont want cache database or no writable file system:

from fake_useragent import UserAgent
ua = UserAgent(cache=False)

In very rare case fake-useragent can not download data (version 0.1.3 added)

from fake_useragent import UserAgent
ua = UserAgent()
# Traceback (most recent call last):
#   ...
# fake_useragent.errors.FakeUserAgentError

If You will try to get unknown browser (version 0.1.3 added)

from fake_useragent import UserAgent
ua = UserAgent()
ua.best_browser
# Traceback (most recent call last):
#   ...
# fake_useragent.errors.FakeUserAgentError

Tests

pip install tox
tox

Changelog

0.1.3 November 24, 2016
- Raises fake_useragent.FakeUserAgentError in case when there is not way to download data
- Raises fake_useragent.FakeUserAgentError instead on None in case of unknown browser
- Added gevent.sleep support in gevent patched environment when trying to download data
X.X.X xxxxxxx xx, xxxx
- xxxxx ?????

Release files for fake-useragent 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fake-useragent 0.1.3
File	Size	Uploaded
fake-useragent-0.1.3.tar.gz	9.3 kB	Nov 24, 2016	Details

Release files / fake-useragent-0.1.3.tar.gz

Download URL	fake-useragent-0.1.3.tar.gz
Size	9.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`e47e804ca213c92e1e7e1dc052b56c26f97bc617b55f6423a2997644f95c6de8`
BLAKE2b-256 checksum How to use checksums	`d662fb4f2af4783a51248002c950ed92efcb8772955281e7e9e93c6bbb7b8ef2`
Upload date	Nov 24, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No