Skip to main content

Up to date simple useragent faker with real world database

Project description

fake-useragent

info:

Up to date simple useragent faker with real world database

https://img.shields.io/travis/hellysmile/fake-useragent.svg 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

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 ?????

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fake-useragent-0.1.3.tar.gz (9.3 kB view details)

Uploaded Source

File details

Details for the file fake-useragent-0.1.3.tar.gz.

File metadata

File hashes

Hashes for fake-useragent-0.1.3.tar.gz
Algorithm Hash digest
SHA256 e47e804ca213c92e1e7e1dc052b56c26f97bc617b55f6423a2997644f95c6de8
MD5 6960800d05e34fd475921c1b71ebe32e
BLAKE2b-256 d662fb4f2af4783a51248002c950ed92efcb8772955281e7e9e93c6bbb7b8ef2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page