{"id":14978878,"url":"https://github.com/telefonica/toolium","last_synced_at":"2025-05-15T16:08:09.750Z","repository":{"id":2344192,"uuid":"44657820","full_name":"Telefonica/toolium","owner":"Telefonica","description":"Wrapper tool of Selenium and Appium libraries to test web and mobile applications in a single project","archived":false,"fork":false,"pushed_at":"2025-03-06T08:22:18.000Z","size":4684,"stargazers_count":117,"open_issues_count":1,"forks_count":64,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-31T21:43:52.817Z","etag":null,"topics":["cdco","dir-cto","org-cdo","srv-qa"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Telefonica.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-10-21T06:47:42.000Z","updated_at":"2025-03-30T00:42:13.000Z","dependencies_parsed_at":"2023-11-17T16:37:46.088Z","dependency_job_id":"8f638e75-802f-4f58-910c-75d1f50e81c0","html_url":"https://github.com/Telefonica/toolium","commit_stats":{"total_commits":688,"total_committers":39,"mean_commits":"17.641025641025642","dds":"0.16133720930232553","last_synced_commit":"8f3b145c84d8fb479a881bd054bd452dce62e9c1"},"previous_names":[],"tags_count":66,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Telefonica%2Ftoolium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Telefonica%2Ftoolium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Telefonica%2Ftoolium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Telefonica%2Ftoolium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Telefonica","download_url":"https://codeload.github.com/Telefonica/toolium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247737770,"owners_count":20987718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cdco","dir-cto","org-cdo","srv-qa"],"created_at":"2024-09-24T13:58:34.303Z","updated_at":"2025-04-07T22:05:22.309Z","avatar_url":"https://github.com/Telefonica.png","language":"Python","readme":"Toolium\n=======\n\n|Build Status| |Coverage Status| |CodeClimate| |Documentation Status|\n\nToolium is a Python wrapper tool of Selenium, Playwright and Appium libraries to test web and mobile applications in a single\nproject. It provides a way of choosing and configuring the driver through a configuration file, implements a Page Object\npattern and includes a simple visual testing solution.\n\n.. |Build Status| image:: https://github.com/Telefonica/toolium/workflows/build/badge.svg?branch=master\n   :target: https://github.com/Telefonica/toolium/actions?query=branch%3Amaster\n.. |Documentation Status| image:: https://readthedocs.org/projects/toolium/badge/?version=latest\n   :target: http://toolium.readthedocs.org/en/latest\n.. |Coverage Status| image:: https://coveralls.io/repos/Telefonica/toolium/badge.svg?branch=master\u0026service=github\n   :target: https://coveralls.io/github/Telefonica/toolium?branch=master\n.. |CodeClimate| image:: https://api.codeclimate.com/v1/badges/3e5773b2e5272b546f8a/maintainability\n   :target: https://codeclimate.com/github/Telefonica/toolium/maintainability\n\nGetting Started\n---------------\n\nRun ``pip install toolium`` to install the latest version from `PyPi \u003chttps://pypi.org/project/toolium\u003e`_. It's\nhighly recommendable to use a virtualenv.\n\nThe main dependencies are:\n\n- `Selenium \u003chttp://docs.seleniumhq.org/\u003e`_: to test web applications in major browsers (Firefox, Chrome, Internet\n  Explorer, Edge or Safari)\n- `Playwright \u003chttps://playwright.dev/\u003e`_: to test web applications in major browsers (Firefox, Chrome, Edge or Safari)\n  as an alternative to Selenium (Beta integration in toolium)\n- `Appium-Python-Client \u003chttps://github.com/appium/python-client\u003e`_: to test mobile applications (native, hybrid or web)\n  in Android or iOS devices/emulators.\n- `requests \u003chttp://docs.python-requests.org\u003e`_: to test APIs\n\nYou might need to adjust the Selenium and Appium-Python-Client versions in your project.\nIn that case follow the `compatibility matrix \u003chttps://github.com/appium/python-client?tab=readme-ov-file#compatibility-matrix\u003e`_\n\n**Using toolium-template**\n\nThe easiest way of getting started is to clone `toolium-template \u003chttps://github.com/Telefonica/toolium-template\u003e`_\nproject, run the example test and add your own tests and configuration.\n\n.. code:: console\n\n    $ git clone git@github.com:Telefonica/toolium-template.git\n    $ cd toolium-template\n    $ pip install -r requirements.txt\n\nNow, just follow `toolium-template instructions \u003chttps://github.com/Telefonica/toolium-template#running-tests\u003e`_ to know\nhow to start your testing project.\n\n**Running toolium-examples**\n\nYou can also clone `toolium-examples \u003chttps://github.com/Telefonica/toolium-examples\u003e`_ to get more examples about how\nto use the library to test web, Android or iOS applications, in different scenarios.\n\n.. code:: console\n\n    $ git clone git@github.com:Telefonica/toolium-examples.git\n    $ cd toolium-examples\n    $ pip install -r requirements.txt\n\nNow, just follow `toolium-examples instructions \u003chttps://github.com/Telefonica/toolium-examples#running-tests\u003e`_ to run\nthe examples of the tests.\n\nContributing\n------------\n\nIf you want to collaborate in Toolium development, feel free of `forking it \u003chttps://github.com/Telefonica/toolium\u003e`_\nand asking for a pull request.\n\nDon't forget to run unit tests:\n\n.. code:: console\n\n    $ git clone git@github.com:\u003cyour_github_user\u003e/toolium.git\n    $ cd toolium\n    $ pip install -r requirements.txt\n    $ pip install -r requirements_dev.txt\n    $ python -m pytest\n\nFinally, before accepting your contribution, we need you to sign our\n`Contributor License Agreement \u003chttps://raw.githubusercontent.com/telefonicaid/Licensing/master/ContributionPolicy.txt\u003e`_\nand send it to ruben.gonzalezalonso@telefonica.com.\n\nMain Features\n-------------\n\n- `Choosing driver through a configuration file \u003c/docs/driver_configuration.rst\u003e`_\n- `Page Object pattern \u003c/docs/page_objects.rst\u003e`_\n- `BDD integration \u003c/docs/bdd_integration.rst\u003e`_\n- `Visual testing solution \u003c/docs/visual_testing.rst\u003e`_\n- `Tests result analysis \u003c/docs/tests_result_analysis.rst\u003e`_\n\nDocumentation\n-------------\n\nFurther information about features and fixes included in each release: `CHANGELOG \u003c/CHANGELOG.rst\u003e`_.\n\nComplete library reference and documentation available at `ReadTheDocs \u003chttp://toolium.readthedocs.org\u003e`_.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelefonica%2Ftoolium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelefonica%2Ftoolium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelefonica%2Ftoolium/lists"}