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.

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

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.8.4
File Size Uploaded Provenance Actions
toolium-3.8.4.tar.gz 101.4 kB Without provenance Details for toolium-3.8.4.tar.gz

Built distribution (wheel)

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

Total release size: 225.6 kB

Release files / toolium-3.8.4.tar.gz

Download URL toolium-3.8.4.tar.gz
Size 101.4 kB
Tags Source
SHA-256 checksum
How to use checksums
fcc531c583cb704eafcd7ddb110dda649f4b8a7310687edf728d26b0f63c68ff
BLAKE2b-256 checksum
How to use checksums
8d15b3af53c8498f081c79e838ff6a476550b53380f8fc01ac2742e21873d98b
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.8.4-py3-none-any.whl

Download URL toolium-3.8.4-py3-none-any.whl
Size 124.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ab52c646913b23d8624fa8e8e924219b32bff89861e512b5f528b498ce318ef8
BLAKE2b-256 checksum
How to use checksums
28fd2c0c1e33622a8e9e5c647a31fde7ccccd7050f18de98b96a6d9704cc84b2
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.8.4

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

3.8.4 This release

2 release files No 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