Skip to main content

Toolium

Build Status Coverage Status CodeClimate Documentation Status

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. Toolium requires Python 3.11 or later.

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.txt

Now, 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.txt

Now, 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.txt

Before submitting your changes, make sure the code follows the project’s style by running Ruff:

$ ruff check --fix .    # Fix linting issues
$ ruff format .         # Format code

Then run the unit tests:

$ python -m pytest

Finally, before accepting your contribution, we need you to sign our Contributor License Agreement and send it to ruben.gonzalezalonso@telefonica.com.

If you are a maintainer, see RELEASING.md for the steps to publish a new release.

Main Features

Documentation

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

Complete library reference and documentation are available at ReadTheDocs.

Metadata

Release files for toolium 3.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for toolium 3.9.0
File Size Uploaded Provenance Actions
toolium-3.9.0.tar.gz 102.6 kB With provenance Details for toolium-3.9.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for toolium 3.9.0
File Interpreter ABI Platform Actions
toolium-3.9.0-py3-none-any.whl Python 3 none any Details for toolium-3.9.0-py3-none-any.whl

Total release size: 226.4 kB

Release files / toolium-3.9.0.tar.gz

Download URL toolium-3.9.0.tar.gz
Size 102.6 kB
Tags Source
SHA-256 checksum
How to use checksums
918db6556f3888b98bb7e4190357ea31f05d608ee8a9e84ec8f869ca4e9b533d
BLAKE2b-256 checksum
How to use checksums
da33994fc5bdbf790946a0c3933ec8cf785998512090ccb5d954dd1a0c99b75d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / toolium-3.9.0-py3-none-any.whl

Download URL toolium-3.9.0-py3-none-any.whl
Size 123.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
815fd1af740e3167e6013c08a34183d08585114a82628ad619112623cc41f98e
BLAKE2b-256 checksum
How to use checksums
82ad127923a003873e20d81dbb655abfb48a14b8ff5255c802b9b00cf4dd98d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for toolium 3.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for toolium-3.9.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.9.0 This release

2 release files Full provenance

0.11.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page