diff --git a/docs/_sidebar.md b/docs/_sidebar.md index 9d205c4..d2e5256 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -27,7 +27,7 @@ * [🔨 cookies 的使用](使用方法\cookies的使用.md) * [🔨 Drission 对象](使用方法\Drission对象.md) * [🔨 对接 selenium 及 requests 代码](使用方法\对接selenium及requests代码.md) - * [🔨 使用其它浏览器](使用方法\使用其它浏览器.md) + * [🔨 使用其它系统或浏览器](使用方法\使用其它系统或浏览器.md) * [🔨 DriverPage 和 SessionPage](使用方法\DriverPage和SessionPage.md) * [🔨 打包程序](使用方法\打包程序.md) diff --git a/docs/使用方法/下载文件.md b/docs/使用方法/下载文件.md index e73b940..93a4246 100644 --- a/docs/使用方法/下载文件.md +++ b/docs/使用方法/下载文件.md @@ -30,8 +30,6 @@ selenium 缺乏对浏览器下载文件的有效管理,难以进行检测下 - file_exists:若存在同名文件,可选择`'rename'`,`'overwrite'`,`'skip'`方式处理,若选择重命名,会在文件名后面添加序号 - post_data:post 方式的数据,这个参数不为`None`时自动转成 post 方式 - show_msg:是否显示下载信息和进度 -- retry:重试次数,与页面对象的设置一致,默认 3 次 -- interval:重试间隔时间,与页面对象的设置一致,默认 2 秒 - **kwargs;连接参数,与 requests 的一致 返回:下载是否成功(`bool`)和状态信息(成功时信息为文件路径)的元组,跳过时第一位返回 None @@ -79,8 +77,6 @@ url:https://www.baidu.com/img/flexible/logo/pc/result.png - rename:重命名文件,可不写扩展名,不输入则用网络文件原名 - file_exists:若存在同名文件,可选择`'rename'`,`'overwrite'`,`'skip'`方式处理,若选择重命名,会在文件名后面添加序号 - post_data:post 方式的数据,这个参数不为`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:**
`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:**
重试次数和间隔在初始化时继承页面对象的`retry_times`和`retry_interval`属性,可用上面例子的方法对下载的重试次数和间隔进行设置,设置后不会影响页面对象的设置。 diff --git a/docs/使用方法/使用其它浏览器.md b/docs/使用方法/使用其它浏览器.md deleted file mode 100644 index beff2a0..0000000 --- a/docs/使用方法/使用其它浏览器.md +++ /dev/null @@ -1,16 +0,0 @@ -目前设置功能只支持 Chrome 浏览器,如要使用其它浏览器,可使用 selenium 原生方法创建 driver,然后用 Drission 对象接收即可。 - -!> **注意:**
本库所有功能暂时只对 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') -``` \ No newline at end of file diff --git a/docs/使用方法/使用其它系统或浏览器.md b/docs/使用方法/使用其它系统或浏览器.md new file mode 100644 index 0000000..104810e --- /dev/null +++ b/docs/使用方法/使用其它系统或浏览器.md @@ -0,0 +1,17 @@ +目前只在 Windows 系统 Chrome 浏览器上进行过完整功能测试,如要使用其它系统或浏览器,在启动和设置方面可能遇到问题。 +这个时候可使用 selenium 原生方法创建 driver,然后用 Drission 对象接收即可。 + +!> **注意:**
本库所有功能暂时只在 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') +``` \ No newline at end of file diff --git a/docs/入门指南/快速上手.md b/docs/入门指南/快速上手.md index 7846ac4..f595459 100644 --- a/docs/入门指南/快速上手.md +++ b/docs/入门指南/快速上手.md @@ -21,6 +21,8 @@ from DrissionPage import MixPage s 模式是无须初始化的,导入后就可以直接使用。 d 模式因为使用浏览器,须要配置浏览器和对应的 driver。 +!> **注意:**
这里介绍的方法只支持 Windows 系统,使用其它系统请查看 [使用其它系统或浏览器](使用方法\使用其它系统或浏览器.md) 章节。 + ## 自动配置方式 身为自动化工具,DrissionPage 拥有自动识别电脑安装的 Chrome 版本并自动下载对应 chromedriver 功能。这时只要直接创建页面对象即可正常使用。