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 開始，作業系統名稱區分大小寫！

You can also specify the type of platforms you want to use, you can do that via the platforms argument (default is ["desktop", "mobile", "tablet"] . This example will only return random user-agents from a mobile裝置:

 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 ????