robotframework-zoomba 2.4.0

Robot Framework mini-framework.

Zoomba

Introduction

Zoomba is a collection of libraries spanning GUI, REST API, SOAP API, Mobile, and Windows Desktop automation using Robot Framework. These libraries are extensions of existing libraries SeleniumLibrary, Requests, SudsLibrary, and AppiumLibrary.

Zoomba adds a significant amount of data validation support for REST and SOAP APIs, extends functionality for typical Web GUI automation, and extends AppiumLibrary functionality to support Windows desktop automation.

As a team beginning the journey of automation with Robot Framework - we found that there was some time spent ramping up our libraries and Zoomba aims to make that process easier for new projects.

See the Keyword Documentation for the API, SOAP, GUI, Mobile, or Desktop library for more specific information about the functionality.

Getting Started

The Zoomba library is easily installed using the setup.py file in the home directory. Simply run the following command to install Zoomba and it's dependencies:

pip install robotframework-zoomba

If you decide to pull the repo locally to make contributions or just want to play around with the code you can install Zoomba by running the following from the root directory:

pip install .

To access the keywords in the library simply add the following to your robot file settings (depending on what you need):

*** Settings ***
Library    Zoomba.APILibrary
Library    Zoomba.GUILibrary
Library    Zoomba.SOAPLibrary
Library    Zoomba.MobileLibrary
Library    Zoomba.DesktopLibrary

Additional Setup Information

If you plan to run Mobile or Windows desktop automation you will need to have a running appium server. To do so first have Node installed and then run the following:

npm install -g appium
appium

Alternatively Appium Desktop can be used.

For Windows automation we suggest installing and using the WinAppDriver without Appium as it seems to be much more stable.

Examples

Example tests can be found in the test directory.

Contributing

To make contributions please refer to the CONTRIBUTING guidelines.

Additionally if you run the following command new documentation will be generated on each commit :

git config core.hooksPath .githooks

Support

General Robot Framework questions should be directed to the community forum.

Contact the team at [e-mail] or create an issue with specific requests or questions regarding the Zoomba libraries!