Metadata-Version: 2.1
Name: alt-fake-useragent
Version: 0.2.1
Summary: A Fixed and Updated Alternative for fake-useragent
Home-page: https://github.com/MrBotDeveloper/Fake-UserAgent-Alternate
Author: botmakerdeveloper@gmail.com
Author-email: botmakerdeveloper@gmail.com
License: UNKNOWN
Keywords: user,agent,user agent,useragent,fake,alternate fake useragent,fake user agent,fixed fake useragent,python requests
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: AUTHORS.md

# Alternate Fake UserAgent

| Module Name | Description |
| :----: | :----: |
| alt-fake-useragent | Up to date and Fixed version of `fake-useragent` which is a simple useragent faker with real world database |

[![image](https://img.shields.io/pypi/v/alt-fake-useragent.svg)](https://pypi.org/project/alt-fake-useragent/)

## Features

  - Grabs up to date `useragent` from
    [useragentstring.com](http://useragentstring.com/)
  - Randomize with real world statistic via
    [w3schools.com](https://www.w3schools.com/browsers/browsers_stats.asp)

### Installation

``` shell
pip install alt-fake-useragent
```

### Usage

``` python
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

ua.mobile
# Mozilla/5.0 (Android 2.2; Windows; U; Windows NT 6.1; en-US) AppleWebKit/533.19.4 (KHTML, like Gecko) Version/5.0.3 Safari/533.19.4

ua.desktop
# Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_6; de-de) AppleWebKit/533.20.25 (KHTML, like Gecko) Version/5.0.4 Safari/533.20.27

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

### Notes

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

If You want to update saved database just:

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

If You don't want cache database or no writable file system:

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

Sometimes, [useragentstring.com](http://useragentstring.com/) or
[w3schools.com](https://www.w3schools.com/browsers/browsers_stats.asp)
changes their html, or down, in such case `fake-useragent` uses
[heroku](https://fake-useragent.herokuapp.com/browsers/0.1.8) fallback

If You don't want to use hosted cache server (version 0.1.5 added)

``` python
from fake_useragent import UserAgent
ua = UserAgent(use_cache_server=False)
```

In very rare case, if hosted cache server and sources will be
unavailable `fake-useragent` wont be able to download data: (version
0.1.3 added)

``` python
from fake_useragent import UserAgent
ua = UserAgent()

# Traceback (most recent call last):
#   ...
# fake_useragent.errors.FakeUserAgentError

# You can catch it via

from fake_useragent import FakeUserAgentError

try:
    ua = UserAgent()
except FakeUserAgentError:
    pass
```

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

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

You can completely disable ANY annoying exception with adding
`fallback`: (version 0.1.4 added)

``` python
import fake_useragent

ua = fake_useragent.UserAgent(fallback='Your favorite Browser')
# in case if something went wrong, one more time it is REALLY!!! rare case
ua.random == 'Your favorite Browser'
```

Want to control location of data file? (version 0.1.4 added)

``` python
import fake_useragent

# I am STRONGLY!!! recommend to use version suffix
location = '/home/user/fake_useragent%s.json' % fake_useragent.VERSION

ua = fake_useragent.UserAgent(path=location)
ua.random
```

If you need to safe some attributes from overriding them in UserAgent by
`__getattr__` method use `safe_attrs` you can pass there attributes
names. At least this will prevent you from raising FakeUserAgentError
when attribute not found.

For example, when using fake\_useragent with
[injections](https://github.com/tailhook/injections) you need to:

``` python
import fake_useragent

ua = fake_useragent.UserAgent(safe_attrs=('__injections__',))
```

Please, do not use if you don't understand why you need this. This is
magic for rarely extreme case.

### Experiencing issues???

Make sure that You using latest version\!\!\!

``` shell
pip install -U fake-useragent
```

Check version via python console: (version 0.1.4 added)

``` python
import fake_useragent

print(fake_useragent.VERSION)
```

And You are always welcome to post
[issues](https://github.com/hellysmile/fake-useragent/issues)

Please do not forget mention version that You are using

### Tests

``` console
pip install tox
tox
```

### Changelog

  -   - 0.2.1 December 8, 2021
        
          - Added mobile and desktop selectors

  -   - 0.2.0 December 6, 2021

          - Fixed all Known Bugs 🐛
          - **Bug 🐛 Fixed :** `Error occurred during loading data.`

  -   - 0.1.11 October 4, 2018
        
          - moved <span class="title-ref">s3 + cloudfront</span>
            fallback to <span class="title-ref">heroku.com</span>, cuz
            someone from Florida did \~25M requests last month

  -   - 0.1.10 February 11, 2018
        
          - Minor fix docs <span class="title-ref">cloudfront</span> url

  -   - 0.1.9 February 11, 2018
        
          - fix `w3schools.com` renamed
            <span class="title-ref">IE/Edge</span> to
            <span class="title-ref">Edge/IE</span>
          - moved <span class="title-ref">heroku.com</span> fallback to
            <span class="title-ref">s3 + cloudfront</span>
          - stop testing Python3.3 and pypy

  -   - 0.1.8 November 2, 2017
        
          - fix `useragentstring.com` `Can't connect to local MySQL
            server through socket`

  -   - 0.1.7 April 2, 2017
        
          - fix broken README.rst

  -   - 0.1.6 April 2, 2017
        
          - fixes bug `use_cache_server` do not affected anything
          - [w3schools.com](https://www.w3schools.com/browsers/browsers_stats.asp)
            moved to `https`
          - `verify_ssl` options added, by default it is `True`
            (`urllib.urlopen` ssl context for Python 2.7.9- and 3.4.3-
            is not supported)

  -   - 0.1.5 February 28, 2017
        
          - added `ua.edge` alias to Internet Explorer
          - w3schools.com starts displaying `Edge` statistic
          - Python 2.6 is not tested anymore
          - `use_cache_server` option added
          - Increased `fake_useragent.settings.HTTP_TIMEOUT` to 5
            seconds

  -   - 0.1.4 December 14, 2016
        
          - Added custom data file location support
          - Added `fallback` browser support, in case of unavailable
            data sources
          - Added alias `fake_useragent.FakeUserAgent` for
            `fake_useragent.UserAgent`
          - Added alias `fake_useragent.UserAgentError` for
            `fake_useragent.FakeUserAgentError`
          - Reduced `fake_useragent.settings.HTTP_TIMEOUT` to 3 seconds
          - Started migration to new data file format
          - Simplified a lot 4+ years out of date code
          - Better thread/greenlet safety
          - Added verbose logging
          - Added `safe_attrs` for prevent overriding by `__getattr__`

  -   - 0.1.3 November 24, 2016
        
          - Added hosted data file, when remote services is unavailable
          - Raises `fake_useragent.errors.FakeUserAgentError` in case
            when there is not way to download data
          - Raises `fake_useragent.errors.FakeUserAgentError` instead of
            `None` in case of unknown browser
          - Added `gevent.sleep` support in `gevent` patched environment
            when trying to download data


### Authors

You can visit [authors
page](https://github.com/MrBotDeveloper/Fake-UserAgent-Alternate/blob/master/AUTHORS)


