DrissionPage


NameDrissionPage JSON
Version 4.1.0.12 PyPI version JSON
download
home_pagehttps://DrissionPage.cn
SummaryPython based web automation tool. It can control the browser and send and receive data packets.
upload_time2024-11-13 08:14:57
maintainerNone
docs_urlNone
authorg1879
requires_python>=3.6
licenseBSD
keywords drissionpage
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # ✨️ 概述

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://DrissionPage.cn)

**交流 QQ 群：**  636361957

---

# 💡 理念

简洁而强大！

--- 

# ☀️ 特性和亮点

作者经过长期实践，踩过无数坑，总结出的经验全写到这个库里了。

## 🎇 强大的自研内核

本库采用全自研的内核，内置无数实用功能，对常用功能作了整合和优化，对比 selenium，有以下优点：

- 不基于 webdriver
- 无需为不同版本的浏览器下载不同的驱动
- 运行速度更快
- 可以跨 iframe 查找元素，无需切入切出
- 把 iframe 看作普通元素，逻辑更清晰
- 可同时操作多个标签页，无需切换
- 可以直接读取浏览器缓存保存图片，无需用 GUI 点击另存
- 可以对整个网页截图，包括视口外的部分
- 可处理非`open`状态的 shadow-root

## 🎇 亮点功能

除了以上优点，本库还内置了无数人性化设计。

- 极简的定位语法，查找元素更加容易
- 集成大量常用功能，代码更优雅，功能强大稳定
- 无处不在的等待和自动重试，使不稳定的网络变得易于控制，程序更稳定，编写更省心
- 提供强大的下载工具，操作浏览器时也能享受快捷可靠的下载功能
- 允许反复使用已经打开的浏览器，无需每次运行从头启动浏览器，调试方便
- 使用 ini 文件保存常用配置，自动调用，提供便捷的设置，远离繁杂的配置项
- 内置 lxml 作为解析引擎，解析速度成几个数量级提升
- 使用 POM 模式封装，可直接用于测试，便于扩展
- 高度集成的便利功能，从每个细节中体现
- 还有很多细节，这里不一一列举，欢迎实际使用中体验：D

--- 

# 🖐🏻 免责声明

禁止将 DrissionPage 应用到任何可能会违反法律规定和道德约束的项目中。  
友善使用 DrissionPage，遵守蜘蛛协议，禁止将 DrissionPage 用于任何可能有损他人的项目中。  
如您选择使用 DrissionPage 即代表您遵守此协议，作者不承担任何由于您违反此协议带来任何的法律风险和损失。  
同时，作者不对 DrissionPage 可能存在的缺陷导致的损失承担任何责任，一切后果由您承担。

---  

# ☕ 请我喝咖啡

作者是单人开发者，开发和写文档工作量较为繁重。

如果本项目对您有所帮助，不妨打赏一下作者 ：）

![](https://gitee.com/g1879/DrissionPageDocs/raw/master/static/img/code.jpg)

Raw data

            {
    "_id": null,
    "home_page": "https://DrissionPage.cn",
    "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/dc/35/538786d71633708769bfdb1bcf98670cb0999d7af1b4f64f77f5bd0bf879/DrissionPage-4.1.0.12.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://DrissionPage.cn)\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- \u4e0d\u57fa\u4e8e webdriver\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\u903b\u8f91\u66f4\u6e05\u6670\r\n- \u53ef\u540c\u65f6\u64cd\u4f5c\u591a\u4e2a\u6807\u7b7e\u9875\uff0c\u65e0\u9700\u5207\u6362\r\n- \u53ef\u4ee5\u76f4\u63a5\u8bfb\u53d6\u6d4f\u89c8\u5668\u7f13\u5b58\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\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\u5b9a\u4f4d\u8bed\u6cd5\uff0c\u67e5\u627e\u5143\u7d20\u66f4\u52a0\u5bb9\u6613\r\n- \u96c6\u6210\u5927\u91cf\u5e38\u7528\u529f\u80fd\uff0c\u4ee3\u7801\u66f4\u4f18\u96c5\uff0c\u529f\u80fd\u5f3a\u5927\u7a33\u5b9a\r\n- \u65e0\u5904\u4e0d\u5728\u7684\u7b49\u5f85\u548c\u81ea\u52a8\u91cd\u8bd5\uff0c\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\uff0c\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\uff0c\u65e0\u9700\u6bcf\u6b21\u8fd0\u884c\u4ece\u5934\u542f\u52a8\u6d4f\u89c8\u5668\uff0c\u8c03\u8bd5\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\uff1aD\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\u4f5c\u8005\u662f\u5355\u4eba\u5f00\u53d1\u8005\uff0c\u5f00\u53d1\u548c\u5199\u6587\u6863\u5de5\u4f5c\u91cf\u8f83\u4e3a\u7e41\u91cd\u3002\r\n\r\n\u5982\u679c\u672c\u9879\u76ee\u5bf9\u60a8\u6709\u6240\u5e2e\u52a9\uff0c\u4e0d\u59a8\u6253\u8d4f\u4e00\u4e0b\u4f5c\u8005 \uff1a\uff09\r\n\r\n![](https://gitee.com/g1879/DrissionPageDocs/raw/master/static/img/code.jpg)\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.1.0.12",
    "project_urls": {
        "Homepage": "https://DrissionPage.cn"
    },
    "split_keywords": [
        "drissionpage"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c5efdd8d3a9decb4ba9c06a25e4b01e9322bb54ca16b07ed95268ba2816ef3d5",
                "md5": "bea8d73780525b124c1616c79e4f2b8e",
                "sha256": "caf3aa18d2e9a9cf6116d9f82c7fe5652fa2bc7367f4780f9de6ea66e3929f8b"
            },
            "downloads": -1,
            "filename": "DrissionPage-4.1.0.12-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bea8d73780525b124c1616c79e4f2b8e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 247625,
            "upload_time": "2024-11-13T08:14:55",
            "upload_time_iso_8601": "2024-11-13T08:14:55.034001Z",
            "url": "https://files.pythonhosted.org/packages/c5/ef/dd8d3a9decb4ba9c06a25e4b01e9322bb54ca16b07ed95268ba2816ef3d5/DrissionPage-4.1.0.12-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "dc35538786d71633708769bfdb1bcf98670cb0999d7af1b4f64f77f5bd0bf879",
                "md5": "30a4ca1b5fe2e1aa6e2d2feac3d70cac",
                "sha256": "57d44614243bcc4cb5cf42e6d94a4cdf712a46b312ef89a5e47ab8e23ae1dcfd"
            },
            "downloads": -1,
            "filename": "DrissionPage-4.1.0.12.tar.gz",
            "has_sig": false,
            "md5_digest": "30a4ca1b5fe2e1aa6e2d2feac3d70cac",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 199079,
            "upload_time": "2024-11-13T08:14:57",
            "upload_time_iso_8601": "2024-11-13T08:14:57.066870Z",
            "url": "https://files.pythonhosted.org/packages/dc/35/538786d71633708769bfdb1bcf98670cb0999d7af1b4f64f77f5bd0bf879/DrissionPage-4.1.0.12.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-13 08:14:57",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "drissionpage"
}
g1879
Elapsed time: 2.50779s