Skip to main content

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

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.

Release history Release notifications | RSS feed

2.2.0

2 files

2.1.0

2 files

2.0.3

2 files

2.0.2

2 files

2.0.1

2 files

2.0.0

2 files

1.5.1

2 files

1.5.0

2 files

1.4.0

2 files

1.3.0

2 files

1.2.1

2 files

1.2.0

2 files

1.1.3

2 files

1.1.1

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

0.1.14

2 files

0.1.13

2 files

0.1.11

1 file

0.1.10

1 file

0.1.9

1 file

0.1.8

1 file

0.1.7

1 file

0.1.6

1 file

0.1.5

1 file

0.1.4

1 file

This release

0.1.3 This release

1 file

0.1.2

1 file

0.1.1

1 file

0.1.0

1 file

0.0.9

1 file

0.0.8

1 file

0.0.7

1 file

0.0.6

1 file

0.0.5

1 file

0.0.4

1 file

0.0.3

1 file

0.0.2

1 file

0.0.1

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page