mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
修改文档
This commit is contained in:
parent
1f60b2b833
commit
b85f4a5aec
@ -27,7 +27,7 @@
|
|||||||
* [🔨 cookies 的使用](使用方法\cookies的使用.md)
|
* [🔨 cookies 的使用](使用方法\cookies的使用.md)
|
||||||
* [🔨 Drission 对象](使用方法\Drission对象.md)
|
* [🔨 Drission 对象](使用方法\Drission对象.md)
|
||||||
* [🔨 对接 selenium 及 requests 代码](使用方法\对接selenium及requests代码.md)
|
* [🔨 对接 selenium 及 requests 代码](使用方法\对接selenium及requests代码.md)
|
||||||
* [🔨 使用其它浏览器](使用方法\使用其它浏览器.md)
|
* [🔨 使用其它系统或浏览器](使用方法\使用其它系统或浏览器.md)
|
||||||
* [🔨 DriverPage 和 SessionPage](使用方法\DriverPage和SessionPage.md)
|
* [🔨 DriverPage 和 SessionPage](使用方法\DriverPage和SessionPage.md)
|
||||||
* [🔨 打包程序](使用方法\打包程序.md)
|
* [🔨 打包程序](使用方法\打包程序.md)
|
||||||
|
|
||||||
|
@ -30,8 +30,6 @@ selenium 缺乏对浏览器下载文件的有效管理,难以进行检测下
|
|||||||
- file_exists:若存在同名文件,可选择`'rename'`,`'overwrite'`,`'skip'`方式处理,若选择重命名,会在文件名后面添加序号
|
- file_exists:若存在同名文件,可选择`'rename'`,`'overwrite'`,`'skip'`方式处理,若选择重命名,会在文件名后面添加序号
|
||||||
- post_data:post 方式的数据,这个参数不为`None`时自动转成 post 方式
|
- post_data:post 方式的数据,这个参数不为`None`时自动转成 post 方式
|
||||||
- show_msg:是否显示下载信息和进度
|
- show_msg:是否显示下载信息和进度
|
||||||
- retry:重试次数,与页面对象的设置一致,默认 3 次
|
|
||||||
- interval:重试间隔时间,与页面对象的设置一致,默认 2 秒
|
|
||||||
- **kwargs;连接参数,与 requests 的一致
|
- **kwargs;连接参数,与 requests 的一致
|
||||||
|
|
||||||
返回:下载是否成功(`bool`)和状态信息(成功时信息为文件路径)的元组,跳过时第一位返回 None
|
返回:下载是否成功(`bool`)和状态信息(成功时信息为文件路径)的元组,跳过时第一位返回 None
|
||||||
@ -79,8 +77,6 @@ url:https://www.baidu.com/img/flexible/logo/pc/result.png
|
|||||||
- rename:重命名文件,可不写扩展名,不输入则用网络文件原名
|
- rename:重命名文件,可不写扩展名,不输入则用网络文件原名
|
||||||
- file_exists:若存在同名文件,可选择`'rename'`,`'overwrite'`,`'skip'`方式处理,若选择重命名,会在文件名后面添加序号
|
- file_exists:若存在同名文件,可选择`'rename'`,`'overwrite'`,`'skip'`方式处理,若选择重命名,会在文件名后面添加序号
|
||||||
- post_data:post 方式的数据,这个参数不为`None`时自动转成 post 方式
|
- post_data:post 方式的数据,这个参数不为`None`时自动转成 post 方式
|
||||||
- retry:重试次数,与页面对象的设置一致,默认 3 次
|
|
||||||
- interval:重试间隔时间,与页面对象的设置一致,默认 2 秒
|
|
||||||
- **kwargs;连接参数,与 requests 的一致
|
- **kwargs;连接参数,与 requests 的一致
|
||||||
|
|
||||||
返回:任务对象,可通过任务对象查看任务状态和结果
|
返回:任务对象,可通过任务对象查看任务状态和结果
|
||||||
@ -116,6 +112,7 @@ print(mission.rate, mission.info)
|
|||||||
参数:
|
参数:
|
||||||
|
|
||||||
- asyn:是否异步进行
|
- asyn:是否异步进行
|
||||||
|
- keep:任务全部完成后是否保持显示
|
||||||
|
|
||||||
返回:None
|
返回: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'
|
page.download.goal_path = r'D:\tmp'
|
||||||
|
|
||||||
# 设置重试次数,初始为3
|
# 设置重试次数,初始为继承 page 的 retry_times 属性
|
||||||
page.download.retry = 5
|
page.download.retry = 5
|
||||||
|
|
||||||
# 设置失败重试间隔,初始为5
|
# 设置失败重试间隔,初始为继承 page 的 retry_interval 属性
|
||||||
page.download.interval = 2
|
page.download.interval = 2
|
||||||
|
|
||||||
# 设置存在文件名冲突时的处理方式,可选 'skip', 'overwrite', 'rename'
|
# 设置存在文件名冲突时的处理方式,可选 'skip', 'overwrite', 'rename'
|
||||||
page.download.file_exists = 'skip'
|
page.download.file_exists = 'skip'
|
||||||
```
|
```
|
||||||
|
|
||||||
|
?> **Tips:**<br> 重试次数和间隔在初始化时继承页面对象的`retry_times`和`retry_interval`属性,可用上面例子的方法对下载的重试次数和间隔进行设置,设置后不会影响页面对象的设置。
|
||||||
|
@ -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')
|
|
||||||
```
|
|
17
docs/使用方法/使用其它系统或浏览器.md
Normal file
17
docs/使用方法/使用其它系统或浏览器.md
Normal 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')
|
||||||
|
```
|
@ -21,6 +21,8 @@ from DrissionPage import MixPage
|
|||||||
s 模式是无须初始化的,导入后就可以直接使用。
|
s 模式是无须初始化的,导入后就可以直接使用。
|
||||||
d 模式因为使用浏览器,须要配置浏览器和对应的 driver。
|
d 模式因为使用浏览器,须要配置浏览器和对应的 driver。
|
||||||
|
|
||||||
|
!> **注意:** <br> 这里介绍的方法只支持 Windows 系统,使用其它系统请查看 [使用其它系统或浏览器](使用方法\使用其它系统或浏览器.md) 章节。
|
||||||
|
|
||||||
## 自动配置方式
|
## 自动配置方式
|
||||||
|
|
||||||
身为自动化工具,DrissionPage 拥有自动识别电脑安装的 Chrome 版本并自动下载对应 chromedriver 功能。这时只要直接创建页面对象即可正常使用。
|
身为自动化工具,DrissionPage 拥有自动识别电脑安装的 Chrome 版本并自动下载对应 chromedriver 功能。这时只要直接创建页面对象即可正常使用。
|
||||||
|
Loading…
x
Reference in New Issue
Block a user