diff --git a/docs/MixPage使用方法/简介.md b/docs/MixPage使用方法/简介.md new file mode 100644 index 0000000..3c13963 --- /dev/null +++ b/docs/MixPage使用方法/简介.md @@ -0,0 +1,15 @@ +本库 3.0 以前的版本是对 selenium 进行重新封装实现的。 + +其页面对象为`MixPage`和`DriverPage`,对应于新版的`WebPage`和`ChromiumPage`。 + +经过几年的使用,旧版已相当稳定。但由于依赖 selenium,功能开发受到较大制约,且 selenium 有其特征,容易被网站识别,故开发了新版`WebPage`取代之。 + +新版于旧版使用方法基本一致,但新版功能更多更强,且部分方法或属性名称有修改。 + +目前旧版开发已冻结,为兼容以前的项目,除了修复 bug,旧版不会再有功能上的修改。 + +有兴趣的读者可以了解一下。 + +其结构图如下: + +![](https://gitee.com/g1879/DrissionPage/raw/master/docs/imgs/mixpage.jpg) diff --git a/docs/README.md b/docs/README.md index 608c3da..eaa2fb8 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,3 +1,5 @@ +# + DrissionPage 是一个基于 python 的网页自动化工具。 它既能控制浏览器,也能收发数据包,甚至能把两者合而为一, diff --git a/docs/_sidebar.md b/docs/_sidebar.md index a6b2ba9..973e8c8 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -2,73 +2,74 @@ * [☀️ 2 特性和亮点](#) - * [💖 2.1 贴心设计](特性和亮点\贴心设计.md) - * [🌟 2.2 特性演示](#) - * [⭐ 与 requests 对比](特性和亮点\特性演示\与requests代码对比.md) - * [⭐ 与 selenium 对比](特性和亮点\特性演示\与selenium代码对比.md) - * [⭐ 模式切换](特性和亮点\特性演示\模式切换.md) - * [⭐ 获取并打印元素属性](特性和亮点\特性演示\获取并打印元素属性.md) - * [⭐ 下载文件](特性和亮点\特性演示\下载文件.md) + * [💖 2.1 贴心设计](特性和亮点\贴心设计.md) + * [🌟 2.2 特性演示](#) + * [⭐ 与 requests 对比](特性和亮点\特性演示\与requests代码对比.md) + * [⭐ 与 selenium 对比](特性和亮点\特性演示\与selenium代码对比.md) + * [⭐ 模式切换](特性和亮点\特性演示\模式切换.md) + * [⭐ 获取并打印元素属性](特性和亮点\特性演示\获取并打印元素属性.md) + * [⭐ 下载文件](特性和亮点\特性演示\下载文件.md) -* [🧭 2 入门指南](#) +* [🧭 3 入门指南](#) - * [🌏 2.1 基本概念](入门指南\基本概念.md) - * [🌏 2.2 安装和导入](入门指南\安装和导入.md) - * [🌏 2.3 准备工作](入门指南\准备工作.md) - * [🌏 2.4 上手示例](#) - * [🌐 控制浏览器](入门指南\上手示例\控制浏览器.md) - * [🌐 收发数据包](入门指南\上手示例\收发数据包.md) - * [🌐 模式切换](入门指南\上手示例\模式切换.md) + * [🌏 3.1 基本概念](入门指南\基本概念.md) + * [🌏 3.2 安装和导入](入门指南\安装和导入.md) + * [🌏 3.3 准备工作](入门指南\准备工作.md) + * [🌏 3.4 上手示例](#) + * [🌐 控制浏览器](入门指南\上手示例\控制浏览器.md) + * [🌐 收发数据包](入门指南\上手示例\收发数据包.md) + * [🌐 模式切换](入门指南\上手示例\模式切换.md) -* [🛠 3 使用方法](#) +* [🛠 4 使用方法](#) - * [🔨 3.0 简介](WebPage使用方法\3.0简介.md) - * [🔨 3.1 创建页面对象](WebPage使用方法\3.1创建页面对象.md) - * [🔨 3.2 访问网页](WebPage使用方法\3.2访问网页.md) - * [🔨 3.3 查找元素](WebPage使用方法\3.3查找元素.md) - * [🔨 3.4 获取元素信息](WebPage使用方法\3.4获取元素信息.md) - * [🔨 3.5 元素操作](WebPage使用方法\3.5元素操作.md) - * [🔨 3.6 获取网页信息](WebPage使用方法\3.6获取网页信息.md) - * [🔨 3.7 页面操作](WebPage使用方法\3.7页面操作.md) - * [🔨 3.8 标签页操作](WebPage使用方法\3.8标签页操作.md) - * [🔨 3.9 iframe操作](WebPage使用方法\3.9iframe操作.md) - * [🔨 3.10 动作链](WebPage使用方法\3.10动作链.md) + * [🔨 4.0 简介](WebPage使用方法\3.0简介.md) + * [🔨 4.1 创建页面对象](WebPage使用方法\3.1创建页面对象.md) + * [🔨 4.2 访问网页](WebPage使用方法\3.2访问网页.md) + * [🔨 4.3 查找元素](WebPage使用方法\3.3查找元素.md) + * [🔨 4.4 获取元素信息](WebPage使用方法\3.4获取元素信息.md) + * [🔨 4.5 元素操作](WebPage使用方法\3.5元素操作.md) + * [🔨 4.6 获取网页信息](WebPage使用方法\3.6获取网页信息.md) + * [🔨 4.7 页面操作](WebPage使用方法\3.7页面操作.md) + * [🔨 4.8 标签页操作](WebPage使用方法\3.8标签页操作.md) + * [🔨 4.9 iframe操作](WebPage使用方法\3.9iframe操作.md) + * [🔨 4.10 动作链](WebPage使用方法\3.10动作链.md) -* [📝 4 启动配置](#) +* [📝 5 启动配置](#) - * [🗒️ 4.1 概述](启动配置\概述.md) - * [🗒️ 4.2 浏览器启动配置](启动配置\浏览器启动配置.md) - * [🗒️ 4.3 Session 启动配置](启动配置\Session启动配置.md) - * [🗒️ 4.4 使用配置文件](启动配置\使用配置文件.md) + * [🗒️ 5.1 概述](启动配置\概述.md) + * [🗒️ 5.2 浏览器启动配置](启动配置\浏览器启动配置.md) + * [🗒️ 5.3 Session 启动配置](启动配置\Session启动配置.md) + * [🗒️ 5.4 使用配置文件](启动配置\使用配置文件.md) -* [🧰 5 进阶使用](#) +* [🧰 6 进阶使用](#) - * [⚙️ 5.1 打包程序](进阶使用\打包程序.md) - * [⚙️ 5.2 监听浏览器网络](进阶使用\监听浏览器网络.md) - * [⚙️ 5.3 下载文件](进阶使用\下载文件.md) + * [⚙️ 6.1 打包程序](进阶使用\打包程序.md) + * [⚙️ 6.2 监听浏览器网络](进阶使用\监听浏览器网络.md) + * [⚙️ 6.3 下载文件](进阶使用\下载文件.md) -* [🛠 6 旧版使用方法](#) +* [🛠 7 旧版使用方法](#) - * [🔨 6.1 创建页面对象](MixPage使用方法\创建页面对象.md) - * [🔨 6.2 访问网页](MixPage使用方法\访问网页.md) - * [🔨 6.3 查找页面元素](MixPage使用方法\查找页面元素.md) - * [🔨 6.4 获取元素信息](MixPage使用方法\获取元素信息.md) - * [🔨 6.5 元素操作](MixPage使用方法\元素操作.md) - * [🔨 6.6 获取网页信息](MixPage使用方法\获取网页信息.md) - * [🔨 6.7 页面操作](MixPage使用方法\页面操作.md) - * [🔨 6.8 cookies 的使用](MixPage使用方法\cookies的使用.md) - * [🔨 6.9 Drission 对象](MixPage使用方法\Drission对象.md) - * [🔨 6.10 对接 selenium 及 requests 代码](MixPage使用方法\对接selenium及requests代码.md) - * [🔨 6.11 使用其它系统或浏览器](MixPage使用方法\使用其它系统或浏览器.md) - * [🔨 6.12 DriverPage 和 SessionPage](MixPage使用方法\DriverPage和SessionPage.md) + * [🔨 7.0 简介](MixPage使用方法\简介.md) + * [🔨 7.1 创建页面对象](MixPage使用方法\创建页面对象.md) + * [🔨 7.2 访问网页](MixPage使用方法\访问网页.md) + * [🔨 7.3 查找页面元素](MixPage使用方法\查找页面元素.md) + * [🔨 7.4 获取元素信息](MixPage使用方法\获取元素信息.md) + * [🔨 7.5 元素操作](MixPage使用方法\元素操作.md) + * [🔨 7.6 获取网页信息](MixPage使用方法\获取网页信息.md) + * [🔨 7.7 页面操作](MixPage使用方法\页面操作.md) + * [🔨 7.8 cookies 的使用](MixPage使用方法\cookies的使用.md) + * [🔨 7.9 Drission 对象](MixPage使用方法\Drission对象.md) + * [🔨 7.10 对接 selenium 及 requests 代码](MixPage使用方法\对接selenium及requests代码.md) + * [🔨 7.11 使用其它系统或浏览器](MixPage使用方法\使用其它系统或浏览器.md) + * [🔨 7.12 DriverPage 和 SessionPage](MixPage使用方法\DriverPage和SessionPage.md) -* [⚡️ 7 示例和技巧](#) +* [⚡️ 8 示例和技巧](#) - * [🌠 自动登录码云](示例和技巧\自动登录码云.md) - * [🌠 采集猫眼电影TOP100榜](示例和技巧\采集猫眼电影TOP100榜.md) - * [🌠 下载星巴克产品图片](示例和技巧\下载星巴克产品图片.md) - * [🌠 下载豆瓣图书封面图片](示例和技巧\下载豆瓣图书封面图片.md) - * [🌠 多线程操作多标签页](示例和技巧\多线程操作多标签页.md) + * [🌠 自动登录码云](示例和技巧\自动登录码云.md) + * [🌠 采集猫眼电影TOP100榜](示例和技巧\采集猫眼电影TOP100榜.md) + * [🌠 下载星巴克产品图片](示例和技巧\下载星巴克产品图片.md) + * [🌠 下载豆瓣图书封面图片](示例和技巧\下载豆瓣图书封面图片.md) + * [🌠 多线程操作多标签页](示例和技巧\多线程操作多标签页.md) * [🔖 9 版本历史](版本历史.md) diff --git a/docs/入门指南/上手示例/gitee_1.jpg b/docs/imgs/gitee_1.jpg similarity index 100% rename from docs/入门指南/上手示例/gitee_1.jpg rename to docs/imgs/gitee_1.jpg diff --git a/docs/入门指南/上手示例/gitee_2.jpg b/docs/imgs/gitee_2.jpg similarity index 100% rename from docs/入门指南/上手示例/gitee_2.jpg rename to docs/imgs/gitee_2.jpg diff --git a/docs/imgs/mixpage.jpg b/docs/imgs/mixpage.jpg new file mode 100644 index 0000000..3930da2 Binary files /dev/null and b/docs/imgs/mixpage.jpg differ diff --git a/docs/入门指南/上手示例/控制浏览器.md b/docs/入门指南/上手示例/控制浏览器.md index af1d91d..5a1380a 100644 --- a/docs/入门指南/上手示例/控制浏览器.md +++ b/docs/入门指南/上手示例/控制浏览器.md @@ -8,7 +8,7 @@ 打开网址,按`F12`,我们可以看到页面元素如下: -![](gitee_1.jpg) +![](https://gitee.com/g1879/DrissionPage/raw/master/docs/imgs/gitee_1.jpg) 用户名输入框`id`为`'user_login'`,密码输入框`id`为`'user_password'`,登录按钮`value`为`'登 录'`。 diff --git a/docs/入门指南/上手示例/收发数据包.md b/docs/入门指南/上手示例/收发数据包.md index 9d49219..2aeffb3 100644 --- a/docs/入门指南/上手示例/收发数据包.md +++ b/docs/入门指南/上手示例/收发数据包.md @@ -10,7 +10,7 @@ 打开网址,按`F12`,我们可以看到页面元素如下: -![](gitee_2.jpg) +![](https://gitee.com/g1879/DrissionPage/raw/master/docs/imgs/gitee_2.jpg) 从 html 代码中可以看到,所有开源项目的标题都是`class`属性为`'title project-namespace-path'`的``元素。我们可以遍历这些``元素,获取它们的信息。 diff --git a/docs/入门指南/准备工作.md b/docs/入门指南/准备工作.md index 4c4356b..b2b42a8 100644 --- a/docs/入门指南/准备工作.md +++ b/docs/入门指南/准备工作.md @@ -36,7 +36,11 @@ from DrissionPage.easy_set import set_paths set_paths(chrome_path=r'这里修改为您的Chrome浏览器exe文件路径', check_version=False) ``` -执行这段代码会记录您电脑的 Chrome 浏览器路径到配置文件。现在,请重新执行上一步的代码,如果正确访问了百度,说明已经设置完成。 +执行这段代码会记录您电脑的 Chrome 浏览器路径到配置文件。 + +## 📍 重试控制浏览器 + +现在,请重新执行第二步的代码,如果正确访问了百度,说明已经设置完成。 # ✔️ 说明 diff --git a/docs/入门指南/安装和导入.md b/docs/入门指南/安装和导入.md index fc7c4d4..8ef6464 100644 --- a/docs/入门指南/安装和导入.md +++ b/docs/入门指南/安装和导入.md @@ -1,14 +1,12 @@ # ✔️ 安装 -## 📍 安装 - 请使用 pip 安装 DrissionPage: ```shell pip install DrissionPage ``` -## 📍 升级 +# ✔️ 升级 ```shell pip install DrissionPage --upgrade