Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.

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

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.dev0
File Size Uploaded Provenance Actions
toolium-3.9.0.dev0.tar.gz 101.9 kB Without provenance Details for toolium-3.9.0.dev0.tar.gz

Built distribution (wheel)

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

Total release size: 226.7 kB

Release files / toolium-3.9.0.dev0.tar.gz

Download URL toolium-3.9.0.dev0.tar.gz
Size 101.9 kB
Tags Source
SHA-256 checksum
How to use checksums
a2d7c6e29ee5defaa5b42861ed789555bee620c4101e80ca97e9163d7cb64450
BLAKE2b-256 checksum
How to use checksums
2fea6467a84b6d4f7bc51580b3f4e1c64ce84cf645025ebe9dff05333b0137d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.0

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

Download URL toolium-3.9.0.dev0-py3-none-any.whl
Size 124.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
49c9b544126912f7b1c2b6968f3ffbd730ca795f183c32cefa193167040b80e4
BLAKE2b-256 checksum
How to use checksums
eadfe98e6cc5c4f85a476b44f5b8dfcf404046b6b4cdbdc662d3f055e26cc103
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.0

Security for toolium 3.9.0.dev0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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

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