Toolium is a Python wrapper tool of Selenium, Playwright 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 recommended to use a virtualenv.
The main dependencies are:
Selenium: to test web applications in major browsers (Firefox, Chrome, Internet Explorer, Edge or Safari)
Playwright: to test web applications in major browsers (Firefox, Chrome, Edge or Safari) as an alternative to Selenium (Beta integration in toolium)
Appium-Python-Client: to test mobile applications (native, hybrid or web) in Android or iOS devices/emulators.
requests: to test APIs
You might need to adjust the Selenium and Appium-Python-Client versions in your project. In that case, follow the compatibility matrix
Using toolium-template
The easiest way to get 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.txtNow, just follow the 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 git@github.com:Telefonica/toolium-examples.git
$ cd toolium-examples
$ pip install -r requirements.txtNow, just follow the toolium-examples instructions to run the test examples.
Contributing
If you want to collaborate in Toolium development, feel free to fork it and create a pull request.
Then clone the repository and install the dependencies in your virtualenv:
$ git clone git@github.com:<your_github_user>/toolium.git
$ cd toolium
$ pip install -r requirements.txt
$ pip install -r requirements_dev.txtBefore submitting your changes, make sure the code follows the project’s style by running Ruff:
$ ruff check --fix . # Fix linting issues
$ ruff format . # Format codeThen run the unit tests:
$ python -m pytestFinally, 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 are available at ReadTheDocs.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file toolium-3.8.2.tar.gz.
File metadata
- Download URL: toolium-3.8.2.tar.gz
- Upload date:
- Size: 100.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5486fbe0932b6dd72dec0e5ea7a7ae90381dc67a0a463d7264c0ebeddc3269ed
|
|
| MD5 |
15aa21b839218b83cb0e090fbf607a3a
|
|
| BLAKE2b-256 |
17cd0bd14e5bf478e4ad2f75c2a7ce706b778d15e638ae8cb163c6ea46225141
|
File details
Details for the file toolium-3.8.2-py3-none-any.whl.
File metadata
- Download URL: toolium-3.8.2-py3-none-any.whl
- Upload date:
- Size: 123.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9782843429833730e19d2985563f8797192c535a8c5be7d556a009bf8b8116e4
|
|
| MD5 |
93bb906c711af23bd802c63ff08b5a1d
|
|
| BLAKE2b-256 |
f46d943f3ccbb6a61ed8adfb4ca5775f7c624e4f2a71209ba18378eb911faa4a
|
