rpaframework

RPA 框架项目介绍

项目概况

RPA 框架是一套面向机器人流程自动化（RPA）的开源库和工具的集合，旨在辅以 Robot Framework 和 Python 使用。该项目的目标是为软件机器人开发者提供良好文档支持和积极维护的核心库。

RPA 框架由 Robocorp 赞助，并专为 Robocorp 的 Control Room 和 Developer Tools 优化。项目是 100% 开源的，并接受外部贡献。

项目特点

开放性: 项目完全开源，方便开发者查阅和贡献。
文档支持: 项目拥有全面的文档，给予开发者充分的指南和支持。
广泛的库支持: 提供适配多种任务需求的多类库。
社区参与: 欢迎并支持外部开发者贡献和参与项目进展。

包和库

RPA 框架核心由多个包组成，包括：

rpaframework-assistant
rpaframework-aws
rpaframework-core
rpaframework-google
rpaframework-hubspot
rpaframework-openai
rpaframework-pdf
rpaframework-recognition
rpaframework-windows

其中，rpaframework-core 和 rpaframework-recognition 是支撑包，并不单独包含任何库。

项目包含丰富的库资源，例如：

Archive: 用于处理 TAR 和 ZIP 文件。
Browser.Selenium 和 Browser.Playwright: 提供不同的方式控制浏览器进行网页自动化。
Email.Exchange 和 Email.ImapSmtp: 提供邮件操作能力（支持多种协议）。
Excel.Application 和 Excel.Files: 分别用于控制 Excel 桌面应用和直接操作 Excel 文件。
PDF: 读取和创建 PDF 文档。

这些库涵盖了自动化任务的各个方面，包括云服务、桌面自动化、数据库操作和文件操作等。

安装方法

通常情况下，推荐通过 Robocorp 的开发工具使用 conda.yaml 进行安装。基本步骤如下：

channels:
  - conda-forge
dependencies:
  - python=3.9.16
  - pip=22.1.2
  - pip:
    - rpaframework==24.1.2
    - robotframework-browser==17.2.0

对于不同需求的包也可以单独安装，比如 rpaframework-aws、rpaframework-pdf、rpaframework-windows 等。

使用示例

在 Robot Framework 中可以直接导入库：

*** Settings ***
Library    RPA.Browser.Selenium

*** Tasks ***
Login as user
    Open available browser    https://example.com
    Input text    id:user-name    ${USERNAME}
    Input text    id:password     ${PASSWORD}

在 Python 中库使用示例如下：

from RPA.Browser.Selenium import Selenium

lib = Selenium()
lib.open_available_browser("https://example.com")
lib.input_text("id:user-name", username)
lib.input_text("id:password", password)