Awesome

`useragents`

A Python module which does one thing: giving you a random User-Agent Header

Do not worry about sticking with a single user-agent for you HTTP requests ever again!

Code Size Repo Size Issues

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

You will need to have Python installed on your computer to use this software

According to Vermin, Python 3.0 or higher is needed to use pyuseragents even if it does work on Python 2.

Always check if your Python version works with pyuseragents before using it in production

Tested manually on Python 2.7 and Python 3.9 and Python 3.12.2

Tested automatically (CI) with Pytest on CPython 3.7.17, 3.8.18, 3.9.19, 3.10.14, 3.11.9, 3.12.3, 3.13.0-beta.1, on PyPy 3.9 and on GraalPy 24.0

Installing

You can install it from PyPI with:

pip install --upgrade pyuseragents

You can check if you successfully installed it by printing out its version:

python -c "import pyuseragents; print(pyuseragents.__version__)"
# output:
pyuseragents v1.0.5

List of User-Agents

The list of User-Agents headers has been crawled from various sources.

They are all available in the pyuseragents/data/list.py file.

The list being in a python module means that it will be preloaded by Python in memory for performance reasons.

Usage

>>> import pyuseragents
>>> headers = {
    "User-Agent": pyuseragents.random(),
    "Content-Type": "application/json",
    "and so on..."
}
>>> pyuseragents.random()
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.113 Safari/537.36"

Deployment

This module should be stable but might contain bugs with edge-cases.

Feel free to use it in production if you feel like it is suitable for your production and report any issue under the "Issues" section of the GitHub repository.

Built With

No dependency is needed for this module

Authors

Anime no Sekai - Initial work - Animenosekai

License

This project is licensed under the MIT License - see the LICENSE file for details