Skip to main content

Wrapper tool of Selenium and Appium libraries to test web and mobile applications in a single project

Project description

Build Status Coverage Status CodeClimate Documentation Status

Toolium is a Python wrapper tool of Selenium and Appium libraries to test web and mobile applications in a single project. It provides a way of choosing and configuring the driver through a configuration file, implements a Page Object pattern and includes a simple visual testing solution.

Getting Started

Run pip install toolium to install the latest version from PyPi. It’s highly recommendable to use a virtualenv. The minimal python version to use Toolium is Python 3.6.

The main dependencies are:

  • Selenium: to test web applications in major browsers (Firefox, Chrome, Internet Explorer, Edge, Safari, Opera)

  • Appium-Python-Client: to test mobile applications (native, hybrid or web) in Android or iOS devices/emulators.

  • requests: to test APIs

Using toolium-template

The easiest way of getting started is to clone toolium-template project, run the example test and add your own tests and configuration.

$ git clone
$ cd toolium-template
$ pip install -r requirements.txt

Now, just follow toolium-template instructions to know how to start your testing project.

Running toolium-examples

You can also clone toolium-examples to get more examples about how to use the library to test web, Android or iOS applications, in different scenarios.

$ git clone
$ cd toolium-examples
$ pip install -r requirements.txt

Now, just follow toolium-examples instructions to run the examples of the tests.


If you want to collaborate in Toolium development, feel free of forking it and asking for a pull request.

Don’t forget to run unit tests:

$ git clone<your_github_user>/toolium.git
$ cd toolium
$ python test

Finally, before accepting your contribution, we need you to sign our Contributor License Agreement and send it to

Main Features


Further information about features and fixes included in each release: CHANGELOG.

Complete library reference and documentation available at ReadTheDocs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

toolium-2.6.3.tar.gz (75.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page