Toolium
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
Metadata
2 maintainers
Release files for toolium 3.8.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| toolium-3.8.3.tar.gz | 100.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| toolium-3.8.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 223.3 kB
Release files / toolium-3.8.3.tar.gz
| Download URL | toolium-3.8.3.tar.gz |
|---|---|
| Size | 100.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
13a2c1216203e688155f53d40084b573ad8404a917db73a94e90f0ec4145bfa8
|
|
BLAKE2b-256 checksum How to use checksums |
728a8e5d4cf8023f83b9c0e89821defbf75024eaad197e66de90e381be56f440
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.4
|
Release files / toolium-3.8.3-py3-none-any.whl
| Download URL | toolium-3.8.3-py3-none-any.whl |
|---|---|
| Size | 123.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fdc4863c759c10068d8e64eafe356e84ab3fe93e4d9be6e55590ed1704f4fda3
|
|
BLAKE2b-256 checksum How to use checksums |
a19711d3bd4aa0e18ed18413d0da680656e5fc6e8db64140c6e002caaf1b35f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.4
|
