Always get best user-agent
Project description
shadow-useragent
shadow-useragent
gives you access to the most commonly used UserAgents on the Internet, safe from outdated data.
Behold, the power of UserAgent:
>>> import shadow_useragent >>> ua = shadow_useragent.ShadowUserAgent() >>> ua.percent(0.05) 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.1 Safari/605.1.15' >>> ua.most_common 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/74.0.3729.169 Safari/537.36'
When you use our library, we register your User Agent, and update the frequency of use. The percent of use is thus dynamically updated, and never outdated. No more unused header that reveals your true identity, you are protected by the group.
Besides, you can rely on traditional features, like picking an header from outstanding IE browser family.
Feature Support
shadow-useragent
is the only safe, and updated user-agent package.
- UserAgent Percentage of Use
- Day-to-day Update
- Exhaustive UserAgents Family
- Elegant @property Methods
- Community-Based Package
shadow-useragent
supports Python 2.7 & 3.4–3.7, and runs great on PyPy.
Installation
To install shadow-useragent
, simply use pipenv (or pip, of course):
$ pip install shadow-useragent 👻
Never disappointed.
Documentation
Documentation is not available for now. Unlimited delivery coming soon.
Usage
import shadow_useragent ua = shadow_useragent.ShadowUserAgent() # Access user-agent per Percentage of Use ua = ua.percent(0.03) ua = ua.most_common # Access user-agent per Browser Family ua = ua.firefox ua = ua.chrome ua = ua.safari ua = ua.edge ua = ua.ie ua = ua.android ua = ua.ipad # Random Access ;) ua = ua.random ua = ua.random_nomobile # Mobile-UA excluded # If you want an Exhaustive list, you can play with uas = ua.get_uas() uas = ua.get_sorted_uas() # Sorted List per Percentage of Use >>> uas[0] { 'id':1, 'scraping_time':'2019-07-31T17:05:15Z', 'percent':9.6, 'useragent':'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.100 Safari/537.36', 'system':'Chrome 75.0 Win10', 'browser_family':'Chrome', 'browser_version_string':'75.0.3770', 'os_family':'Windows', 'os_version_string':'10', 'device_family':'Other', 'device_brand':None, 'device_model':None }
Notes
shadow-useragent
stores collected UAs in the folder of your pip packages: site-packages/shadow_useragent/data.
The UserAgents' list is automatically updated with a shadow call (mm) to the shadow-useragent API every 24 hours. If you want to force the update :
from shadow_useragent import ShadowUserAgent shadow_useragent = ShadowUserAgent() shadow_useragent.force_update()
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.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size shadow_useragent-0.0.17-py3-none-any.whl (11.2 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Filename, size shadow-useragent-0.0.17.tar.gz (11.0 kB) | File type Source | Python version None | Upload date | Hashes View |
Hashes for shadow_useragent-0.0.17-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3061970e45587528516ed0c3f9919bcc8a6d38eadeb4b0388c56984e7c98f77d |
|
MD5 | a4b37da15c8a6698250e90e31a2bed0a |
|
BLAKE2-256 | 2ce0c63f4a73e5a2832c1ec1475e6e23d2be136dfda409863fa5fc70c3c3707d |