Metadata-Version: 2.1
Name: fake_user_agent
Version: 2.3.9
Summary: Randomly generate a valid useragent for faking a browser.
Keywords: python,browser,useragent,User-Agent,header
Author-email: Kate Wang <kate.wang2018@gmail.com>
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: MIT License
Requires-Dist: lxml
Requires-Dist: aiohttp
Project-URL: Source, https://github.com/KateWang2016/fake_user_agent

Randomly generate a valid useragent for faking a browser.

Supported browsers are: "chrome", "edge", "firefox", "safari", and "opera" (case insensitive).

## As a binary
```bash
fakeua                       # randomize a useragent (using cache by default)
fakeua [browser]             # randomize a useragent of a specified browser
fakeua [browser] --debug     # randomize a useragent in debug mode
fakeua [browser] --nocache   # randomize a useragent by fetching the web
fakeua [browser] --cache     # randomize a useragent by using cache other than the default one
fakeua --load   <cache_path> # load up-to-date useragent versions as cache to specified file path
fakeua --remove <cache_path> # remove cache at specified file path
fakeua --version             # print the current version of the program
```

## As a library
```python
# No error handling is needed.
# The following functions return a valid randomized useragent definitely.
# Resort to a fixed useragent in the event of an error when reading cache
# to avoid breaking the caller. In such case, turn on logging debug mode to inspect.
# `CACHE_FILE` defaults to `$HOME/.cache/fakeua/fake_useragent.json`.
# a different cache file is supported, which can be generated by:
# 1. running on terminal: fakeua --load <cache_path>
# 2. calling in script: `await dump(cache_path)`

# For non-async caller:
from fake_user_agent import user_agent
ua = user_agent(browser=None, use_cache=True, cache_path=CACHE_FILE)

# For async caller:
from fake_user_agent import aio_user_agent
ua = await aio_user_agent(browser=None, use_cache=True, cache_path=CACHE_FILE)
```

## Install & Uninstall
```bash
pip install fake_user_agent
pip uninstall -r requirements.txt -y
rm -rf $HOME/.cache/fakeua

# within the project
make install
make uninstall
make clean_cache
```

