A package to fetch get-user-agent strings
Project description
Get User Agent Pls
This Python package allows you to fetch the current user-agent strings for popular browsers. It uses web scraping to fetch the user-agent strings from the website useragentstring.com.
How it works
The package contains two main scripts:
-
get_user_agent_pls_scraper.py
: This script scrapes the user-agent strings for various browsers from useragentstring.com and saves them in a JSON file (user-agents.json
). The browsers it fetches the user-agent strings for are Edge, Chrome, Firefox, Safari, and GoogleBot. -
get_user_agent_pls.py
: This script fetches a user-agent string. If theUSER_AGENT_API_KEY
environment variable is not set, it uses the locally saveduser-agents.json
file. If the file doesn't exist, it callsget_user_agent_pls_scraper.py
to fetch and save the latest user agents. If theUSER_AGENT_API_KEY
environment variable is set, it uses the API to fetch the user-agent string.
How to use
- Install the package using
pip install get_user_agent_pls
. - Import the
fetch_user_agent
function from theget_user_agent_pls
module. - Call the function with the browser and operating system as arguments. The available options for the browser are "Edge", "Chrome", "Firefox", "Safari", and "GoogleBot". The operating system argument is currently not used. For example,
fetch_user_agent("chrome", "windows")
.
Example returned values:
- For Chrome: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.3"
- For Firefox: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:86.0) Gecko/20100101 Firefox/86.0"
- For Safari: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.0.3 Safari/605.1.15"
- For Edge: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.3 Edg/89.0.774.50"
- For GoogleBot: "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)"
Dependencies
The package requires the following Python libraries:
- requests
- beautifulsoup4
These can be installed using pip install -r requirements.txt
.
License
This package is licensed under the MIT License. See the LICENSE
file for more details.
Running the tests
To run the tests, navigate to the root directory of the project and run the following command:
make test
This will discover and run all the test cases in the test_user_agent.py
file. The unit tests create a user-agents.json
file if it does not exist before the tests run. If the file did not exist before the tests, it is removed after the tests complete.
Here is an example of successful unit tests:
$ make test
python -m unittest discover
..
----------------------------------------------------------------------
Ran 2 tests in 0.001s
OK
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for get_user_agent_pls-0.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8658a87cec9dd73f4d993db19449a8dfc5eaa0e8c2274b160a73ffc87c85906e |
|
MD5 | ee135b33913851ca1ca532de0beb6cf0 |
|
BLAKE2b-256 | 7d876bf294e4b4e09ed8828359412f0400ff006d7ddbe89ce4e9d66318e23e8b |