This release is a pre-release and may not be stable for production use.
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. 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.