修改文档

This commit is contained in:
g1879 2022-03-04 10:35:53 +08:00
parent 1f60b2b833
commit b85f4a5aec
5 changed files with 26 additions and 23 deletions

View File

@ -27,7 +27,7 @@
* [🔨 cookies 的使用](使用方法\cookies的使用.md)
* [🔨 Drission 对象](使用方法\Drission对象.md)
* [🔨 对接 selenium 及 requests 代码](使用方法\对接selenium及requests代码.md)
* [🔨 使用其它浏览器](使用方法\使用其它浏览器.md)
* [🔨 使用其它系统或浏览器](使用方法\使用其它系统或浏览器.md)
* [🔨 DriverPage 和 SessionPage](使用方法\DriverPage和SessionPage.md)
* [🔨 打包程序](使用方法\打包程序.md)

View File

@ -30,8 +30,6 @@ selenium 缺乏对浏览器下载文件的有效管理,难以进行检测下
- file_exists若存在同名文件可选择`'rename'`,`'overwrite'`,`'skip'`方式处理,若选择重命名,会在文件名后面添加序号
- post_datapost 方式的数据,这个参数不为`None`时自动转成 post 方式
- show_msg是否显示下载信息和进度
- retry重试次数与页面对象的设置一致默认 3 次
- interval重试间隔时间与页面对象的设置一致默认 2 秒
- **kwargs连接参数与 requests 的一致
返回:下载是否成功(`bool`)和状态信息(成功时信息为文件路径)的元组,跳过时第一位返回 None
@ -79,8 +77,6 @@ urlhttps://www.baidu.com/img/flexible/logo/pc/result.png
- rename重命名文件可不写扩展名不输入则用网络文件原名
- file_exists若存在同名文件可选择`'rename'`,`'overwrite'`,`'skip'`方式处理,若选择重命名,会在文件名后面添加序号
- post_datapost 方式的数据,这个参数不为`None`时自动转成 post 方式
- retry重试次数与页面对象的设置一致默认 3 次
- interval重试间隔时间与页面对象的设置一致默认 2 秒
- **kwargs连接参数与 requests 的一致
返回:任务对象,可通过任务对象查看任务状态和结果
@ -116,6 +112,7 @@ print(mission.rate, mission.info)
参数:
- asyn是否异步进行
- keep任务全部完成后是否保持显示
返回None
@ -135,6 +132,8 @@ page.download.show()
.....
```
?> **Tips** <br> `keep`参数为`True`时,即使所有任务都已结束仍会一直打印进度,可以按`enter`结束。
## 等待任务结束
@ -205,13 +204,14 @@ page.download.size = 20
# 设置保存路径,设置后每个任务会使用这个路径,也可添加任务时单独设置
page.download.goal_path = r'D:\tmp'
# 设置重试次数,初始为3
# 设置重试次数,初始为继承 page 的 retry_times 属性
page.download.retry = 5
# 设置失败重试间隔,初始为5
# 设置失败重试间隔,初始为继承 page 的 retry_interval 属性
page.download.interval = 2
# 设置存在文件名冲突时的处理方式,可选 'skip', 'overwrite', 'rename'
page.download.file_exists = 'skip'
```
?> **Tips**<br> 重试次数和间隔在初始化时继承页面对象的`retry_times``retry_interval`属性,可用上面例子的方法对下载的重试次数和间隔进行设置,设置后不会影响页面对象的设置。

View File

@ -1,16 +0,0 @@
目前设置功能只支持 Chrome 浏览器,如要使用其它浏览器,可使用 selenium 原生方法创建 driver然后用 Drission 对象接收即可。
!> **注意:** <br>本库所有功能暂时只对 Chrome 做了完整测试。
```python
from selenium import webdriver
from DrissionPage import Drission, MixPage
# 用 selenium 原生代码创建 WebDriver 对象
driver = webdriver.Firefox()
# 把 WebDriver 对象传入 Drission 对象
dr = Drission(driver_or_options=driver)
page = MixPage(drission=dr)
page.get('https://www.baidu.com')
```

View File

@ -0,0 +1,17 @@
目前只在 Windows 系统 Chrome 浏览器上进行过完整功能测试,如要使用其它系统或浏览器,在启动和设置方面可能遇到问题。
这个时候可使用 selenium 原生方法创建 driver然后用 Drission 对象接收即可。
!> **注意:** <br>本库所有功能暂时只在 Chrome 上做了完整测试。
```python
from selenium import webdriver
from DrissionPage import Drission, MixPage
# 用 selenium 原生代码创建 WebDriver 对象
driver = webdriver.Firefox()
# 把 WebDriver 对象传入 Drission 对象
dr = Drission(driver_or_options=driver)
page = MixPage(drission=dr)
page.get('https://www.baidu.com')
```

View File

@ -21,6 +21,8 @@ from DrissionPage import MixPage
s 模式是无须初始化的,导入后就可以直接使用。
d 模式因为使用浏览器,须要配置浏览器和对应的 driver。
!> **注意:** <br> 这里介绍的方法只支持 Windows 系统,使用其它系统请查看 [使用其它系统或浏览器](使用方法\使用其它系统或浏览器.md) 章节。
## 自动配置方式
身为自动化工具DrissionPage 拥有自动识别电脑安装的 Chrome 版本并自动下载对应 chromedriver 功能。这时只要直接创建页面对象即可正常使用。