# ✨️ 概述
DrissionPage 是一个基于 python 的网页自动化工具。
它既能控制浏览器，也能收发数据包，还能把两者合而为一。
可兼顾浏览器自动化的便利性和 requests 的高效率。
它功能强大，内置无数人性化设计和便捷功能。
它的语法简洁而优雅，代码量少，对新手友好。
---
官方网站：[https://drissionpage.cn](https://drissionpage.cn)
<a href='https://gitee.com/g1879/DrissionPage/stargazers'><img src='https://gitee.com/g1879/DrissionPage/badge/star.svg?theme=dark' alt='star'></img></a> <a href='https://gitee.com/g1879/DrissionPage/members'><img src='https://gitee.com/g1879/DrissionPage/badge/fork.svg?theme=dark' alt='fork'></img></a>
项目地址：[gitee](https://gitee.com/g1879/DrissionPage) | [github](https://github.com/g1879/DrissionPage)
您的星星是对我最大的支持💖
---
支持系统：Windows、Linux、Mac
python 版本：3.6 及以上
支持浏览器：Chromium 内核浏览器(如 Chrome 和 Edge)，electron 应用
---
# 🛠 如何使用
**📖 使用文档：** [点击查看](https://g1879.gitee.io/drissionpagedocs)
**交流 QQ 群：** 636361957
---
# 💡 理念
简洁而强大！
---
# ☀️ 特性和亮点
作者经过长期实践，踩过无数坑，总结出的经验全写到这个库里了。
## 🎇 强大的自研内核
本库采用全自研的内核，内置无数实用功能，对常用功能作了整合和优化，对比 selenium，有以下优点：
- 无 webdriver 特征
- 无需为不同版本的浏览器下载不同的驱动
- 运行速度更快
- 可以跨`<iframe>`查找元素，无需切入切出
- 把`<iframe>`看作普通元素，获取后可直接在其中查找元素，逻辑更清晰
- 可以同时操作浏览器中的多个标签页，即使标签页为非激活状态，无需切换
- 可以直接读取浏览器缓存来保存图片，无需用 GUI 点击另存
- 可以对整个网页截图，包括视口外的部分（90以上版本浏览器支持）
- 可处理非`open`状态的 shadow-root
## 🎇 亮点功能
除了以上优点，本库还内置了无数人性化设计。
- 极简的语法规则。集成大量常用功能，代码更优雅
- 定位元素更加容易，功能更强大稳定
- 无处不在的等待和自动重试功能。使不稳定的网络变得易于控制，程序更稳定，编写更省心
- 提供强大的下载工具。操作浏览器时也能享受快捷可靠的下载功能
- 允许反复使用已经打开的浏览器。无须每次运行从头启动浏览器，调试超方便
- 使用 ini 文件保存常用配置，自动调用，提供便捷的设置，远离繁杂的配置项
- 内置 lxml 作为解析引擎，解析速度成几个数量级提升
- 使用 POM 模式封装，可直接用于测试，便于扩展
- 高度集成的便利功能，从每个细节中体现
- 还有很多细节，这里不一一列举，欢迎实际使用中体验：）
---
# 🖐🏻 免责声明
禁止将 DrissionPage 应用到任何可能会违反法律规定和道德约束的项目中。
友善使用 DrissionPage，遵守蜘蛛协议，禁止将 DrissionPage 用于任何可能有损他人的项目中。
如您选择使用 DrissionPage 即代表您遵守此协议，作者不承担任何由于您违反此协议带来任何的法律风险和损失。
同时，作者不对 DrissionPage 可能存在的缺陷导致的损失承担任何责任，一切后果由您承担。
---
# ☕ 请我喝咖啡
如果本项目对您有所帮助，不妨请作者我喝杯咖啡 ：）
Raw data
{
"_id": null,
"home_page": "https://gitee.com/g1879/DrissionPage",
"name": "DrissionPage",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "DrissionPage",
"author": "g1879",
"author_email": "g1879@qq.com",
"download_url": "https://files.pythonhosted.org/packages/68/85/b7ebd471a105d0bb1546254e6b4ad03ea44a34318f04ce174d1c7e974302/DrissionPage-4.0.4.21.tar.gz",
"platform": null,
"description": "# \u2728\ufe0f \u6982\u8ff0\r\n\r\nDrissionPage \u662f\u4e00\u4e2a\u57fa\u4e8e python \u7684\u7f51\u9875\u81ea\u52a8\u5316\u5de5\u5177\u3002\r\n\r\n\u5b83\u65e2\u80fd\u63a7\u5236\u6d4f\u89c8\u5668\uff0c\u4e5f\u80fd\u6536\u53d1\u6570\u636e\u5305\uff0c\u8fd8\u80fd\u628a\u4e24\u8005\u5408\u800c\u4e3a\u4e00\u3002\r\n\r\n\u53ef\u517c\u987e\u6d4f\u89c8\u5668\u81ea\u52a8\u5316\u7684\u4fbf\u5229\u6027\u548c requests \u7684\u9ad8\u6548\u7387\u3002\r\n\r\n\u5b83\u529f\u80fd\u5f3a\u5927\uff0c\u5185\u7f6e\u65e0\u6570\u4eba\u6027\u5316\u8bbe\u8ba1\u548c\u4fbf\u6377\u529f\u80fd\u3002\r\n\r\n\u5b83\u7684\u8bed\u6cd5\u7b80\u6d01\u800c\u4f18\u96c5\uff0c\u4ee3\u7801\u91cf\u5c11\uff0c\u5bf9\u65b0\u624b\u53cb\u597d\u3002\r\n\r\n---\r\n\r\n\u5b98\u65b9\u7f51\u7ad9\uff1a[https://drissionpage.cn](https://drissionpage.cn)\r\n\r\n<a href='https://gitee.com/g1879/DrissionPage/stargazers'><img src='https://gitee.com/g1879/DrissionPage/badge/star.svg?theme=dark' alt='star'></img></a> <a href='https://gitee.com/g1879/DrissionPage/members'><img src='https://gitee.com/g1879/DrissionPage/badge/fork.svg?theme=dark' alt='fork'></img></a>\r\n\r\n\u9879\u76ee\u5730\u5740\uff1a[gitee](https://gitee.com/g1879/DrissionPage) | [github](https://github.com/g1879/DrissionPage) \r\n\r\n\u60a8\u7684\u661f\u661f\u662f\u5bf9\u6211\u6700\u5927\u7684\u652f\u6301\ud83d\udc96\r\n\r\n--- \r\n\r\n\u652f\u6301\u7cfb\u7edf\uff1aWindows\u3001Linux\u3001Mac\r\n\r\npython \u7248\u672c\uff1a3.6 \u53ca\u4ee5\u4e0a\r\n\r\n\u652f\u6301\u6d4f\u89c8\u5668\uff1aChromium \u5185\u6838\u6d4f\u89c8\u5668(\u5982 Chrome \u548c Edge)\uff0celectron \u5e94\u7528\r\n\r\n---\r\n\r\n# \ud83d\udee0 \u5982\u4f55\u4f7f\u7528\r\n\r\n**\ud83d\udcd6 \u4f7f\u7528\u6587\u6863\uff1a** [\u70b9\u51fb\u67e5\u770b](https://g1879.gitee.io/drissionpagedocs)\r\n\r\n**\u4ea4\u6d41 QQ \u7fa4\uff1a** 636361957\r\n\r\n---\r\n\r\n# \ud83d\udca1 \u7406\u5ff5\r\n\r\n\u7b80\u6d01\u800c\u5f3a\u5927\uff01\r\n\r\n--- \r\n\r\n# \u2600\ufe0f \u7279\u6027\u548c\u4eae\u70b9\r\n\r\n\u4f5c\u8005\u7ecf\u8fc7\u957f\u671f\u5b9e\u8df5\uff0c\u8e29\u8fc7\u65e0\u6570\u5751\uff0c\u603b\u7ed3\u51fa\u7684\u7ecf\u9a8c\u5168\u5199\u5230\u8fd9\u4e2a\u5e93\u91cc\u4e86\u3002\r\n\r\n## \ud83c\udf87 \u5f3a\u5927\u7684\u81ea\u7814\u5185\u6838\r\n\r\n\u672c\u5e93\u91c7\u7528\u5168\u81ea\u7814\u7684\u5185\u6838\uff0c\u5185\u7f6e\u65e0\u6570\u5b9e\u7528\u529f\u80fd\uff0c\u5bf9\u5e38\u7528\u529f\u80fd\u4f5c\u4e86\u6574\u5408\u548c\u4f18\u5316\uff0c\u5bf9\u6bd4 selenium\uff0c\u6709\u4ee5\u4e0b\u4f18\u70b9\uff1a\r\n\r\n- \u65e0 webdriver \u7279\u5f81\r\n- \u65e0\u9700\u4e3a\u4e0d\u540c\u7248\u672c\u7684\u6d4f\u89c8\u5668\u4e0b\u8f7d\u4e0d\u540c\u7684\u9a71\u52a8\r\n- \u8fd0\u884c\u901f\u5ea6\u66f4\u5feb\r\n- \u53ef\u4ee5\u8de8`<iframe>`\u67e5\u627e\u5143\u7d20\uff0c\u65e0\u9700\u5207\u5165\u5207\u51fa\r\n- \u628a`<iframe>`\u770b\u4f5c\u666e\u901a\u5143\u7d20\uff0c\u83b7\u53d6\u540e\u53ef\u76f4\u63a5\u5728\u5176\u4e2d\u67e5\u627e\u5143\u7d20\uff0c\u903b\u8f91\u66f4\u6e05\u6670\r\n- \u53ef\u4ee5\u540c\u65f6\u64cd\u4f5c\u6d4f\u89c8\u5668\u4e2d\u7684\u591a\u4e2a\u6807\u7b7e\u9875\uff0c\u5373\u4f7f\u6807\u7b7e\u9875\u4e3a\u975e\u6fc0\u6d3b\u72b6\u6001\uff0c\u65e0\u9700\u5207\u6362\r\n- \u53ef\u4ee5\u76f4\u63a5\u8bfb\u53d6\u6d4f\u89c8\u5668\u7f13\u5b58\u6765\u4fdd\u5b58\u56fe\u7247\uff0c\u65e0\u9700\u7528 GUI \u70b9\u51fb\u53e6\u5b58\r\n- \u53ef\u4ee5\u5bf9\u6574\u4e2a\u7f51\u9875\u622a\u56fe\uff0c\u5305\u62ec\u89c6\u53e3\u5916\u7684\u90e8\u5206\uff0890\u4ee5\u4e0a\u7248\u672c\u6d4f\u89c8\u5668\u652f\u6301\uff09\r\n- \u53ef\u5904\u7406\u975e`open`\u72b6\u6001\u7684 shadow-root\r\n\r\n## \ud83c\udf87 \u4eae\u70b9\u529f\u80fd\r\n\r\n\u9664\u4e86\u4ee5\u4e0a\u4f18\u70b9\uff0c\u672c\u5e93\u8fd8\u5185\u7f6e\u4e86\u65e0\u6570\u4eba\u6027\u5316\u8bbe\u8ba1\u3002\r\n\r\n- \u6781\u7b80\u7684\u8bed\u6cd5\u89c4\u5219\u3002\u96c6\u6210\u5927\u91cf\u5e38\u7528\u529f\u80fd\uff0c\u4ee3\u7801\u66f4\u4f18\u96c5\r\n- \u5b9a\u4f4d\u5143\u7d20\u66f4\u52a0\u5bb9\u6613\uff0c\u529f\u80fd\u66f4\u5f3a\u5927\u7a33\u5b9a\r\n- \u65e0\u5904\u4e0d\u5728\u7684\u7b49\u5f85\u548c\u81ea\u52a8\u91cd\u8bd5\u529f\u80fd\u3002\u4f7f\u4e0d\u7a33\u5b9a\u7684\u7f51\u7edc\u53d8\u5f97\u6613\u4e8e\u63a7\u5236\uff0c\u7a0b\u5e8f\u66f4\u7a33\u5b9a\uff0c\u7f16\u5199\u66f4\u7701\u5fc3\r\n- \u63d0\u4f9b\u5f3a\u5927\u7684\u4e0b\u8f7d\u5de5\u5177\u3002\u64cd\u4f5c\u6d4f\u89c8\u5668\u65f6\u4e5f\u80fd\u4eab\u53d7\u5feb\u6377\u53ef\u9760\u7684\u4e0b\u8f7d\u529f\u80fd\r\n- \u5141\u8bb8\u53cd\u590d\u4f7f\u7528\u5df2\u7ecf\u6253\u5f00\u7684\u6d4f\u89c8\u5668\u3002\u65e0\u987b\u6bcf\u6b21\u8fd0\u884c\u4ece\u5934\u542f\u52a8\u6d4f\u89c8\u5668\uff0c\u8c03\u8bd5\u8d85\u65b9\u4fbf\r\n- \u4f7f\u7528 ini \u6587\u4ef6\u4fdd\u5b58\u5e38\u7528\u914d\u7f6e\uff0c\u81ea\u52a8\u8c03\u7528\uff0c\u63d0\u4f9b\u4fbf\u6377\u7684\u8bbe\u7f6e\uff0c\u8fdc\u79bb\u7e41\u6742\u7684\u914d\u7f6e\u9879\r\n- \u5185\u7f6e lxml \u4f5c\u4e3a\u89e3\u6790\u5f15\u64ce\uff0c\u89e3\u6790\u901f\u5ea6\u6210\u51e0\u4e2a\u6570\u91cf\u7ea7\u63d0\u5347\r\n- \u4f7f\u7528 POM \u6a21\u5f0f\u5c01\u88c5\uff0c\u53ef\u76f4\u63a5\u7528\u4e8e\u6d4b\u8bd5\uff0c\u4fbf\u4e8e\u6269\u5c55\r\n- \u9ad8\u5ea6\u96c6\u6210\u7684\u4fbf\u5229\u529f\u80fd\uff0c\u4ece\u6bcf\u4e2a\u7ec6\u8282\u4e2d\u4f53\u73b0\r\n- \u8fd8\u6709\u5f88\u591a\u7ec6\u8282\uff0c\u8fd9\u91cc\u4e0d\u4e00\u4e00\u5217\u4e3e\uff0c\u6b22\u8fce\u5b9e\u9645\u4f7f\u7528\u4e2d\u4f53\u9a8c\uff1a\uff09\r\n\r\n--- \r\n\r\n# \ud83d\udd90\ud83c\udffb \u514d\u8d23\u58f0\u660e\r\n\r\n\u7981\u6b62\u5c06 DrissionPage \u5e94\u7528\u5230\u4efb\u4f55\u53ef\u80fd\u4f1a\u8fdd\u53cd\u6cd5\u5f8b\u89c4\u5b9a\u548c\u9053\u5fb7\u7ea6\u675f\u7684\u9879\u76ee\u4e2d\u3002 \r\n\u53cb\u5584\u4f7f\u7528 DrissionPage\uff0c\u9075\u5b88\u8718\u86db\u534f\u8bae\uff0c\u7981\u6b62\u5c06 DrissionPage \u7528\u4e8e\u4efb\u4f55\u53ef\u80fd\u6709\u635f\u4ed6\u4eba\u7684\u9879\u76ee\u4e2d\u3002 \r\n\u5982\u60a8\u9009\u62e9\u4f7f\u7528 DrissionPage \u5373\u4ee3\u8868\u60a8\u9075\u5b88\u6b64\u534f\u8bae\uff0c\u4f5c\u8005\u4e0d\u627f\u62c5\u4efb\u4f55\u7531\u4e8e\u60a8\u8fdd\u53cd\u6b64\u534f\u8bae\u5e26\u6765\u4efb\u4f55\u7684\u6cd5\u5f8b\u98ce\u9669\u548c\u635f\u5931\u3002 \r\n\u540c\u65f6\uff0c\u4f5c\u8005\u4e0d\u5bf9 DrissionPage \u53ef\u80fd\u5b58\u5728\u7684\u7f3a\u9677\u5bfc\u81f4\u7684\u635f\u5931\u627f\u62c5\u4efb\u4f55\u8d23\u4efb\uff0c\u4e00\u5207\u540e\u679c\u7531\u60a8\u627f\u62c5\u3002\r\n\r\n--- \r\n\r\n# \u2615 \u8bf7\u6211\u559d\u5496\u5561\r\n\r\n\u5982\u679c\u672c\u9879\u76ee\u5bf9\u60a8\u6709\u6240\u5e2e\u52a9\uff0c\u4e0d\u59a8\u8bf7\u4f5c\u8005\u6211\u559d\u676f\u5496\u5561 \uff1a\uff09\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Python based web automation tool. It can control the browser and send and receive data packets.",
"version": "4.0.4.21",
"project_urls": {
"Homepage": "https://gitee.com/g1879/DrissionPage"
},
"split_keywords": [
"drissionpage"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4b61533904dac9516bd3aeac5d0c56d183ba5032276c6f80bb5704d593ddab9d",
"md5": "6cb028aff6ebce65128eb5163b2d4aeb",
"sha256": "96147449ffa70106d7768815612207d027db226e66663339b0c26a6cda80a9a6"
},
"downloads": -1,
"filename": "DrissionPage-4.0.4.21-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6cb028aff6ebce65128eb5163b2d4aeb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 178793,
"upload_time": "2024-03-31T09:31:54",
"upload_time_iso_8601": "2024-03-31T09:31:54.468824Z",
"url": "https://files.pythonhosted.org/packages/4b/61/533904dac9516bd3aeac5d0c56d183ba5032276c6f80bb5704d593ddab9d/DrissionPage-4.0.4.21-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6885b7ebd471a105d0bb1546254e6b4ad03ea44a34318f04ce174d1c7e974302",
"md5": "31d398297fd1caf676a59583fda1b663",
"sha256": "0d2a455f6429b1ee98a2294d682e1ae89fc3e11868d071b0ee690004cc6285e3"
},
"downloads": -1,
"filename": "DrissionPage-4.0.4.21.tar.gz",
"has_sig": false,
"md5_digest": "31d398297fd1caf676a59583fda1b663",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 137219,
"upload_time": "2024-03-31T09:31:58",
"upload_time_iso_8601": "2024-03-31T09:31:58.700022Z",
"url": "https://files.pythonhosted.org/packages/68/85/b7ebd471a105d0bb1546254e6b4ad03ea44a34318f04ce174d1c7e974302/DrissionPage-4.0.4.21.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-31 09:31:58",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "drissionpage"
}
JSON