Skip to content

Animenosekai/useragents

Repository files navigation

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!

PyPI version PyPI - Downloads PyPI - Python Version PyPI - Status GitHub - License GitHub Top language CodeQL Checks Badge Pytest 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

Tested automatically (CI) with Pytest on Python 2.7, Python 3.0 and Python 3.9

Installing

You can install it from PyPI with:

pip install 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

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

License

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

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages