Wrapper tool of Selenium and Appium libraries to test web and mobile applications in a single project
Project description
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
The requirements to install Toolium are Python 2.7 or 3.3+ and pip. If you use Python 2.7.9+, you don’t need to install pip separately.
Run pip install toolium to install the latest version from PyPi. It’s highly recommendable to use a virtualenv.
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
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 git@github.com:Telefonica/toolium-template.git
$ cd toolium-template
$ pip install -r requirements.txt
$ behave
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 git@github.com:Telefonica/toolium-examples.git
$ cd toolium-examples
$ pip install -r requirements.txt
Contributing
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 git@github.com:<your_github_user>/toolium.git
$ cd toolium
$ python setup.py test
Finally, before accepting your contribution, we need you to sign our Contributor License Agreement and send it to ruben.gonzalezalonso@telefonica.com.
Main Features
Documentation
Further information about features and fixes included in each release: CHANGELOG.
Complete library reference and documentation available at ReadTheDocs.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.