fake useragent下载 - fake useragent源代码下载

fake useragent

Python

2.0.2

下载

测试和部署 fake-useragent 绒毛短绒代码QL

假用户代理

具有真实世界数据库的最新简单用户代理伪造者。

特征

数据是从 Intoli LLC 预先下载和后处理的，并且数据是包本身的一部分
数据由广泛的浏览器代理和各种浏览器组成
检索用户代理字符串（两种类型： desktop 、 tablet和/或mobile UA）
检索用户代理 Python 字典（又名对象），其中包含useragent 、 percent 、 type 、 device_brand 、 browser 、 browser_version 、 os 、 os_version和platform等字段
支持Python 3.x

安装

pip install fake-useragent

或者，如果您安装了多个 Python / pip 版本，请使用pip3 ：

pip3 install fake-useragent

用法

下面是简单的用法示例，另请参阅本自述文件的后续章节以了解更高级的用法：

 from fake_useragent import UserAgent
ua = UserAgent ()

# Get a random browser user-agent string
print ( ua . random )
# Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:132.0) Gecko/20100101 Firefox/132.0

# Or get user-agent string from a specific browser
print ( ua . chrome )
# Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36
print ( ua . google )
# Mozilla/5.0 (iPhone; CPU iPhone OS 18_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) GSA/343.0.695551749 Mobile/15E148 Safari/604.1
print ( ua [ 'Chrome' ])
# Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36
print ( ua . firefox )
# Mozilla/5.0 (Android 14; Mobile; rv:133.0) Gecko/133.0 Firefox/133.0
print ( ua . ff )
# Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:132.0) Gecko/20100101 Firefox/132.0
print ( ua . safari )
# Mozilla/5.0 (iPhone; CPU iPhone OS 17_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Mobile/15E148 Safari/604.1 Ddg/17.6
print ( ua . opera )
# Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36 OPR/114.0.0.0
print ( ua . edge )
# Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0

附加用途

自 v1.2.0 以来 fake-useragent 现在提供的附加功能。

如果您想指定自己的浏览器列表，可以通过browsers参数来完成（默认为： ["Google", "Chrome", "Firefox", "Edge", "Opera"," Safari", "Android", "Yandex Browser", "Samsung Internet", "Opera Mobile", "Mobile Safari", "Firefox Mobile", "Firefox iOS", "Chrome Mobile", "Chrome Mobile iOS", "Mobile Safari UI/WKWebView", "Edge Mobile", "DuckDuckGo Mobile", "MiuiBrowser", "Whale", "Twitter", "Facebook", "Amazon Silk"] ）。
此示例将仅从 Edge 和 Chrome 返回随机用户代理：

 from fake_useragent import UserAgent
ua = UserAgent ( browsers = [ 'Edge' , 'Chrome' ])
ua . random

注意： Fakeuser-agent 已知浏览器：Chrome、Edge、Firefox、Safari、Opera、Android、Opera Mobile、Mobile Safari、Firefox Mobile、Firefox iOS、Chrome Mobile、Chrome Mobile iOS 等（再次参见上面的完整列表）。
注意#2：从 fakeuser-agent v2.0.0 开始，浏览器名称区分大小写！

如果您想指定自己的操作系统，可以通过os参数来完成（默认为： ["Windows", "Linux", "Ubuntu", "Chrome OS", "Mac OS X", "Android", "iOS"] ）。
在此示例中，您只会取回 Linux 用户代理：

 from fake_useragent import UserAgent
ua = UserAgent ( os = 'Linux' )
ua . random

注意：从 fakeuser-agent v2.0.0 开始，操作系统名称区分大小写！

您还可以指定要使用的平台类型，可以通过platforms参数来执行此操作（默认为["desktop", "mobile", "tablet"] 。此示例仅从移动设备返回随机用户代理设备：

 from fake_useragent import UserAgent
ua = UserAgent ( platforms = 'desktop' )
ua . random

如果您想返回更新的用户代理字符串，您可以使用min_version参数（默认值为： 0.0 ，意味着所有用户代理都将匹配）。
在此示例中，您仅获得最低版本为 120.0 的用户代理：

 from fake_useragent import UserAgent
ua = UserAgent ( min_version = 120.0 )
ua . random

为了向后兼容，仍然可以使用min_percentage参数指定最小使用百分比。但是，当前的用户代理列表不包含此统计信息。因此所有用户代理都将匹配。

提示：当然，您可以根据自己的喜好组合所有这些参数！

用户代理 Python 字典

从版本 1.3.0 开始，我们现在还为您提供以下“get”属性，它们返回 UA 的整个 Python 字典，而不仅仅是用户代理字符串：

警告原始 JSON 对象（在 Python 字典中）将“按原样”返回。这意味着，这个数据结构将来可能会改变！
请注意，下面的这些“获取”属性将来可能不会返回相同的键/值对。如果您想使用稳定的接口，请使用ua.random或如上所述的类似方法。

 from fake_useragent import UserAgent
ua = UserAgent ()

# Random user-agent dictionary (object)
ua . getRandom
# {'percent': 0.8, 'useragent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.76', 'system': 'Edge 116.0 Win10', 'browser': 'edge', 'version': 116.0, 'os': 'win10'}

# More get properties:
ua . getFirefox
# {'percent': 0.3, 'useragent': 'Mozilla/5.0 (Windows NT 10.0; rv:109.0) Gecko/20100101 Firefox/118.0', 'system': 'Firefox 118.0 Win10', 'browser': 'firefox', 'version': 118.0, 'os': 'win10'}
ua . getChrome
ua . getSafari
ua . getEdge

# And a method with an argument.
# This is exactly the same as using: ua.getFirefox
ua . getBrowser ( 'firefox' )

笔记

您可以使用fallback参数覆盖后备字符串，在极少数情况下会失败：

 from fake_useragent import UserAgent

ua = UserAgent ( fallback = 'your favorite Browser' )
# in case if something went wrong, one more time it is REALLY!!! rare case
ua . random == 'your favorite Browser'

如果您尝试使用未知浏览器：

 from fake_useragent import UserAgent
ua = UserAgent ()
print ( ua . unknown )
#Error occurred during getting browser: randm, but was suppressed with fallback.
#Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 Edg/122.0.0.0

如果您需要通过__getattr__方法保护某些属性免于在 UserAgent 中覆盖它们，请使用safe_attrs您可以向那里传递属性名称。至少这会阻止您在找不到属性时引发 FakeUserAgentError 。

例如，当使用带有injections <https://github.com/tailhook/injections>时，您需要：

 from fake_useragent import UserAgent

ua = UserAgent ( safe_attrs = ( '__injections__' ,))

如果您不明白为什么需要这个，请不要使用。这对于罕见的极端情况来说是神奇的。

遇到问题？

确保您使用的是最新版本！

pip install --upgrade fake-useragent

或者，如果这不起作用，请尝试安装最新的软件包版本，如下所示（ 2.0.1是一个示例，请检查 PyPi 上的最新版本）：

pip install fake-useragent==2.0.1

通过 Python 控制台检查版本：

 import fake_useragent

print ( fake_useragent . __version__ )

并且随时欢迎您发布问题。

请不要忘记提及您正在使用的版本。

对于开发人员

用户代理数据

我们从 user-agents.net 检索的用户代理数据。数据以 JSONlines 格式存储。文件位于： src/fake_useragent/data目录中。

我们目前正在开发一个新的自动化脚本（请参阅问题＃333），以从 user-agents.net 获取用户代理脚本并偶尔更新用户代理。

数据 JSON 文件是 Python 包的一部分，请参阅 pyproject.toml。了解有关数据文件支持的更多信息。

Python虚拟环境

我们鼓励在安装 Pip 包之前使用 Python 虚拟环境，如下所示：

python -m virtualenv env
source env/bin/activate

本地安装

pip install -e .

测试

pip install -r requirements.txt
tox

棉绒

使用 ruff 修复导入：

pip install -r requirements.txt
ruff check --select= " I " --fix .

修复黑色代码格式错误：

pip install -r requirements.txt
black .

注意：当 ruff v1.0 发布时，我们很可能完全转向ruff而不是black 。

变更日志

2.0.1
- 将 require-python 添加到 toml 配置
2.0.0 2024 年 12 月 4 日
- 切换到新的数据源（再次）
- 可能的浏览器选项： "Google", "Chrome", "Firefox", "Edge", "Opera"," Safari", "Android", "Yandex Browser", "Samsung Internet", "Opera Mobile", "Mobile Safari", "Firefox Mobile", "Firefox iOS", "Chrome Mobile", "Chrome Mobile iOS", "Mobile Safari UI/WKWebView", "Edge Mobile", "DuckDuckGo Mobile", "MiuiBrowser", "Whale", "Twitter", "Facebook", "Amazon Silk"
- 可能的操作系统选项： "Windows", "Linux", "Ubuntu", "Chrome OS", "Mac OS X", "Android", "iOS"
- 可能的类型选项： "desktop", "mobile", "tablet"
- 更新 fake.py 以处理新的数据键/值对象
- 更新了自述文件
- 将 browsers.json 重命名为 browsers.jsonl。以及其他重构。
1.5.1 2024年3月16日
- 删除用户代理字符串中的尾随空格
1.5.0 2024 年 3 月 8 日
- 迁移到新的用户代理数据源（感谢@BoudewijnZwart），向后兼容的API。
- 将所有 pip 包依赖项更新到最新的稳定版本
1.4.0 2023 年 11 月 24 日
- 更新所有 PIP 包
- 支持Python 3.12（感谢@vladkens）
- 修复缓存抓取器中的包冲突
- 改进 ruff CLI 调用
1.3.0 2023 年 10 月 2 日
- 引入新的ua.getRandom 、 ua.getFirefox 、 ua.getChrome 、 ua.getSafari 。还有一个通用方法： ua.getBrowser(..) （例如getBrowser('firefox') ）
  - 上面的这些新属性允许您检索整个原始 Python 字典，而不仅仅是 UA 字符串。
  - 这些属性将来可能会返回不同的键/值对！
- 修复os参数 'windows' 以检查win10和win7值（之前仅检查win10 ），从而返回更多 UA
- 改进的用户代理抓取工具（现在也再次包含 Safari 浏览器）
- 更新了 browsers.json 数据文件
1.2.1 2023年8月2日
- min_percentage检查的小改进
- 更新所有 Pip 包依赖项
1.2.0 2023 年 8 月 2 日
- 更新了浏览器用户代理数据
- 允许对浏览器、操作系统和使用百分比进行过滤
- 更新缓存抓取器以获取用户代理字符串的新数据源
- 调整了代码以使用新的 JSON 数据格式
- 参数use_external_data=True和verify_ssl被删除。如果您使用这些参数，只需在代码中将其删除即可！
1.1.3 2023年3月20日
- 更新依赖项
1.1.2 2023年2月8日
- 安全修复
1.1.1 2022年12月4日
- 删除用户代理字符串中的空格，这是一个补丁版本
1.1.0 2022 年 11 月 26 日
- 添加pkg_resource作为尝试检索本地 JSON 数据文件的后备机制
1.0.1 2022 年 11 月 10 日
- 添加importlib-metadata和importlib-resources作为依赖项
- 检查有关 importlib 资源的特定 Python 版本（python v3.10 或更高版本）以使files()正常工作
- importlib_metadata现在也应该适用于 3.8 之前的 Python 版本
- 删除过时的MANIFEST.in文件
1.0.0 2022 年 11 月 17 日
- 将 JSON Lines 数据文件作为 Python 包的一部分，在本地检索数据
  - 使用package-data支持扩展myproject.toml文件
- 删除集中式缓存服务器实施
- 进行真正的单元测试，运行可靠、快速、独立且无需互联网连接
0.1.14 2022年11月5日
- 使用现代 Python >=3.7 语法提高代码质量标准
- 迁移到pyproject.toml构建系统格式+语法检查
- 将其他分类器添加到 toml 文件
- 改进的tox.ini文件
- 使用 pip 缓存改进 GitHub Actions 作业
- 以及各种小修复
0.1.13 2022 年 10 月 21 日
- 实现browsers参数，允许您覆盖要使用的浏览器名称
- 修复 Internet Explorer 和 Edge 的浏览器列表
- 不再依赖 w3schools.com
- 清理数据（临时）文件格式
- 更新后备缓存服务器 URL / 使用 JSON Lines 作为文件格式
- 迁移到 GitHub Actions 而不是 Travis
- 使用black Python 格式化程序支持 Flake
0.1.12 2022 年 3 月 31 日
- 分叉的
0.1.11 2018 年 10 月 4 日
- 将s3 + cloudfront后备移至heroku.com ，因为来自佛罗里达州的某人上个月发出了约 2500 万个请求
0.1.10 2018 年 2 月 11 日
- 小修复文档cloudfront url
0.1.9 2018年2月11日
- 修复w3schools.com将IE/Edge重命名为Edge/IE
- 将heroku.com后备移动到s3 + cloudfront
- 停止测试Python3.3和pypy
0.1.8 2017年11月2日
- 修复useragentstring.com Can't connect to local MySQL server through socket
0.1.7 2017年4月2日
- 修复损坏的 README.rst
0.1.6 2017年4月2日
- 修复了use_cache_server不影响任何内容的错误
- w3schools.com <https://www.w3schools.com/browsers/browsers_stats.asp> _ 已移至https
- 添加了verify_ssl选项，默认情况下为True （不支持 Python 2.7.9- 和 3.4.3- 的urllib.urlopen ssl 上下文）
0.1.5 2017 年 2 月 28 日
- 向 Internet Explorer 添加了ua.edge别名
- w3schools.com 开始显示Edge统计数据
- Python 2.6 不再进行测试
- 添加了use_cache_server选项
- 将fake_useragent.settings.HTTP_TIMEOUT增加到 5 秒
0.1.4 2016年12月14日
- 添加了自定义数据文件位置支持
- 添加了fallback浏览器支持，以防数据源不可用
- 为fake_useragent.FakeUserAgent添加别名fake_useragent.UserAgent
- 为fake_useragent.FakeUserAgentError添加了别名fake_useragent.UserAgentError
- 将fake_useragent.settings.HTTP_TIMEOUT减少到 3 秒
- 开始迁移到新的数据文件格式
- 大大简化了 4 年多前的过时代码
- 更好的线程/greenlet 安全性
- 添加了详细日志记录
- 添加了safe_attrs以防止被__getattr__覆盖
0.1.3 2016年11月24日
- 添加托管数据文件，当远程服务不可用时
- 如果无法下载数据，则会引发fake_useragent.errors.FakeUserAgentError
- 如果浏览器未知，则引发fake_useragent.errors.FakeUserAgentError而不是None
- 尝试下载数据时，在gevent修补环境中添加了gevent.sleep支持
xxx xxxxxxx xx, xxxx
- xxxxx ????