rpaframework 10.0.2

A collection of tools and libraries for RPA

Table of Contents

• Introduction

• Libraries

• Installation

• Example

• Support and contact

• Contributing

• License

Introduction

RPA Framework is a collection of open-source libraries and tools for Robotic Process Automation (RPA), and it is designed to be used with both Robot Framework and Python. The goal is to offer well-documented and actively maintained core libraries for Software Robot Developers.

Learn more about RPA at Robocorp Documentation.

The project is:

• 100% Open Source

• Sponsored by Robocorp

• Optimized for Robocorp Cloud and Robocorp Lab

• Accepting external contributions

Links

• Homepage: https://www.github.com/robocorp/rpaframework/

• Documentation: https://rpaframework.org/

• PyPI: https://pypi.org/project/rpaframework/

• Release notes: https://rpaframework.org/releasenotes.html

---

---

Libraries

The RPA Framework project currently includes the following libraries:

Archive	Archiving TAR and ZIP files
Browser.Selenium	Control browsers and automate the web
Browser.Playwright	Newer way to control browsers
Cloud.AWS	Use Amazon AWS services
Cloud.Azure	Use Microsoft Azure services
Cloud.Google	Use Google Cloud services
Crypto	Common hashing and encryption operations
Database	Interact with databases
Desktop	Cross-platform desktop automation
Desktop.Clipboard	Interact with the system clipboard
Desktop.OperatingSystem	Read OS information and manipulate processes
Desktop.Windows	Automate Windows desktop applications
Dialogs	Request user input during executions
Email.Exchange	E-Mail operations (Exchange protocol)
Email.ImapSmtp	E-Mail operations (IMAP & SMTP)
Excel.Application	Control the Excel desktop application
Excel.Files	Manipulate Excel files directly
FileSystem	Read and manipulate files and paths
FTP	Interact with FTP servers
HTTP	Interact directly with web APIs
Images	Manipulate images
JSON	Manipulate JSON objects
Notifier	Notify messages using different services
Outlook.Application	Control the Outlook desktop application
PDF	Read and create PDF documents
Robocloud.Items	Use the Robocloud Work Items API
Robocloud.Secrets	Use the Robocloud Secrets API
Salesforce	Salesforce operations
SAP	Control SAP GUI desktop client
Tables	Manipulate, sort, and filter tabular data
Tasks	Control task execution
Twitter	Twitter API interface
Word.Application	Control the Word desktop application

Installation

If you already have Python and pip installed, you can use:

pip install rpaframework

To install all extra packages, you can use:

pip install rpaframework[aws,cv]

Other packages that can be installed separately are:

pip install rpaframework-dialogs (included in the rpaframework by default)

pip install rpaframework-google

pip install rpaframework-pdf (included in the rpaframework by default)

pip install rpaframework-recognition

Note

Python 3.6 or higher is required

Example

After installation the libraries can be directly imported inside 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}

The libraries are also available inside 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)

Support and contact

• rpaframework.org for library documentation

• Robocorp Documentation for guides and tutorials

• #rpaframework channel in Robot Framework Slack if you have open questions or want to contribute

• Robocorp Forum for discussions about RPA

• Communicate with your fellow Software Robot Developers and Robocorp experts at Robocorp Developers Slack

Contributing

Found a bug? Missing a critical feature? Interested in contributing? Head over to the Contribution guide to see where to get started.

License

This project is open-source and licensed under the terms of the Apache License 2.0.