DrissionPage/README.md

137 lines
4.7 KiB
Markdown
Raw Normal View History

2023-01-29 18:39:38 +08:00
# ✨️ 概述
2023-01-08 23:10:54 +08:00
DrissionPage 是一个基于 python 的网页自动化工具。
2023-02-19 23:56:45 +08:00
它既能控制浏览器,也能收发数据包,还能把两者合而为一。
2023-01-08 23:10:54 +08:00
可兼顾浏览器自动化的便利性和 requests 的高效率。
它功能强大,内置无数人性化设计和便捷功能。
它的语法简洁而优雅,代码量少,对新手友好。
2021-04-16 10:46:46 +08:00
2023-02-14 11:39:15 +08:00
---
<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 及以上
2023-01-29 18:39:38 +08:00
支持浏览器Chromium 内核浏览器(如 Chrome 和 Edge
2022-01-15 01:06:06 +08:00
2023-02-14 11:39:15 +08:00
---
2023-02-14 11:39:15 +08:00
**📖 使用文档:** [点击查看](http://g1879.gitee.io/drissionpagedocs)
2023-02-19 23:56:45 +08:00
**交流 QQ 群:** 897838127
2021-04-16 10:46:46 +08:00
2023-02-14 11:39:15 +08:00
---
2023-01-08 23:10:54 +08:00
# 📕 背景
2021-04-16 10:46:46 +08:00
2023-02-19 23:56:45 +08:00
用 requests 做数据采集面对要登录的网站时要分析数据包、JS 源码构造复杂的请求往往还要应付验证码、JS 混淆、签名参数等反爬手段,门槛较高,开发效率不高。
2023-01-08 23:10:54 +08:00
使用浏览器,可以很大程度上绕过这些坑,但浏览器运行效率不高。
2023-02-19 23:56:45 +08:00
因此,这个库设计初衷,是将它们合而为一,同时实现“写得快”和“跑得快”。能够在不同须要时切换相应模式,并提供一种人性化的使用方法,提高开发和运行效率。
除了合并两者,本库还以网页为单位封装了常用功能,提供非常简便的操作和语句,使用户可减少考虑细节,专注功能实现。 以简单的方式实现强大的功能,使代码更优雅。
以前的版本是对 selenium 进行重新封装实现的。从 3.0 开始,作者另起炉灶,对底层进行了重新开发,摆脱对 selenium 的依赖,增强了功能,提升了运行效率。
2021-04-16 10:46:46 +08:00
2023-02-14 11:39:15 +08:00
---
2023-01-08 23:10:54 +08:00
# 💡 理念
简洁!易用 !方便!
2023-02-14 11:39:15 +08:00
---
2023-01-08 23:10:54 +08:00
# ☀️ 特性和亮点
作者经过长期实践,踩过无数坑,总结出的经验全写到这个库里了。
2022-11-12 22:17:19 +08:00
2023-01-08 23:10:54 +08:00
## 🎇 强大的自研内核
本库采用全自研的内核,内置了 N 多实用功能,对常用功能作了整合和优化,对比 selenium有以下优点
2022-11-12 22:17:19 +08:00
- 无 webdriver 特征,不会被网站识别
- 无需为不同版本的浏览器下载不同的驱动
- 运行速度更快
- 可以跨`<iframe>`查找元素,无需切入切出
2022-11-12 22:17:19 +08:00
- 把`<iframe>`看作普通元素,获取后可直接在其中查找元素,逻辑更清晰
2022-11-12 22:17:19 +08:00
2023-01-08 23:10:54 +08:00
- 可以同时操作浏览器中的多个标签页,即使标签页为非激活状态,无需切换
2022-11-12 22:17:19 +08:00
2023-01-08 23:10:54 +08:00
- 可以直接读取浏览器缓存来保存图片,无需用 GUI 点击另存
2022-11-12 22:17:19 +08:00
- 可以对整个网页截图包括视口外的部分90以上版本浏览器支持
- 可处理非`open`状态的 shadow-root
2023-01-08 23:10:54 +08:00
## 🎇 亮点功能
2021-04-16 10:46:46 +08:00
2023-01-08 23:10:54 +08:00
除了以上优点,本库还内置了无数人性化设计。
2021-04-16 10:46:46 +08:00
2023-01-08 23:10:54 +08:00
- 极简的语法规则。集成大量常用功能,代码更优雅
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 定位元素更加容易,功能更强大稳定
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 无处不在的等待和自动重试功能。使不稳定的网络变得易于控制,程序更稳定,编写更省心
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 提供强大的下载工具。操作浏览器时也能享受快捷可靠的下载功能
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 允许反复使用已经打开的浏览器。无须每次运行从头启动浏览器,调试超方便
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 使用 ini 文件保存常用配置,自动调用,提供便捷的设置,远离繁杂的配置项
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 内置 lxml 作为解析引擎,解析速度成几个数量级提升
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 使用 POM 模式封装,可直接用于测试,便于扩展
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 高度集成的便利功能,从每个细节中体现
2023-01-09 16:39:11 +08:00
2023-01-08 23:10:54 +08:00
- 还有很多细节,这里不一一列举,欢迎实际使用中体验:)
2023-02-14 11:39:15 +08:00
---
2023-02-19 23:56:45 +08:00
# 🌟 特性演示
2023-02-19 23:56:45 +08:00
[点击查看](http://g1879.gitee.io/drissionpagedocs/2_features/2_features_demos/2_compare_with_selenium/)
2021-04-16 10:46:46 +08:00
2023-02-14 11:39:15 +08:00
---
2023-02-19 23:56:45 +08:00
# 🛠 使用文档
2021-04-16 10:46:46 +08:00
2022-01-15 01:06:06 +08:00
[点击跳转到使用文档](http://g1879.gitee.io/drissionpage)
2021-04-16 10:46:46 +08:00
2023-02-14 11:39:15 +08:00
---
2023-01-08 23:10:54 +08:00
# 🔖 版本历史
2021-04-16 10:46:46 +08:00
2023-02-14 11:39:15 +08:00
[点击查看版本历史](http://g1879.gitee.io/drissionpagedocs/10_history/)
---
2021-04-16 10:46:46 +08:00
2022-01-17 23:55:54 +08:00
# 🖐🏻 免责声明
2022-01-28 14:38:46 +08:00
请勿将 DrissionPage 应用到任何可能会违反法律规定和道德约束的工作中,请友善使用 DrissionPage遵守蜘蛛协议不要将 DrissionPage 用于任何非法用途。如您选择使用 DrissionPage
即代表您遵守此协议,作者不承担任何由于您违反此协议带来任何的法律风险和损失,一切后果由您承担。
2021-04-16 10:46:46 +08:00
2023-02-14 11:39:15 +08:00
---
2022-01-17 23:55:54 +08:00
# ☕ 请我喝咖啡
2022-01-04 10:59:58 +08:00
如果本项目对您有所帮助,不妨请作者我喝杯咖啡
2023-02-14 11:41:26 +08:00
![](http://g1879.gitee.io/drissionpagedocs/imgs/code.jpg)