rand-useragent 0.2.0

Description:

randuseragent 0.2.0

rand-useragent
An up-to-date simple random user-agent with real world database.
The collections of user-agent data is pre-downloaded from
techblog.willshouse.com.
Installation
$ pip install rand-useragent

Usage
Simple usage example, see below for more examples:
from rand_useragent import randua

# Get a random browser user-agent string
print(randua())


If you want to specify your own browser list, you can do that via the browsers
argument (default is: ["chrome", "edge", "firefox", "safari"]).
This example will only return random useragents from Edge and Chrome:
from rand_useragent import randua

# Get a random browser user-agent string
print(randua(browsers=["edge", "chrome"]))


If you want to specify your own operating systems,
you can do that via the os argument (default is: ["windows", "mac os x", "linux"]).
In this example you will only get Linux useragents back:
from rand_useragent import randua

# Get a random browser user-agent string
print(randua(os=["linux"]))


If you want to return more popular useragent strings, you can play with the min_percent
argument (default is: 0.0, meaning all useragents will match).
In this example you get only useragents that have a minimum usage percentage of 10.0% (or higher):
from rand_useragent import randua

# Get a random browser user-agent string
print(randua(min_percent=10.0))


You can override the fallback string using the fallback parameter, in very rare cases something failed:
from rand_useragent import randua

# If something went wrong
print(
randua(
fallback="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"
)
)

Development
Since GitHub Actions is unable to reach willshouse.com and has Cloudflare protection.
We can run the script below to automatically scrape the user-agent strings from the external data source.
The script will copy the JSONlines file to the src/rand_useragent/data directory.
Execute:
$ ./scripts/update-data.sh

The data JSON file is part of the Python package,
see pyproject.toml.
Read more about Data files support.


rand-useragent is a BSD licensed code.