Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/golemhq/golem

A complete test automation tool
https://github.com/golemhq/golem

automation selenium selenium-webdriver testing testing-framework webdriver

Last synced: about 2 months ago
JSON representation

A complete test automation tool

Awesome Lists containing this project

README 

        
# Golem - Test Automation



[![Tests](https://github.com/golemhq/golem/actions/workflows/run-tests.yml/badge.svg?branch=master)](https://github.com/golemhq/golem/actions/workflows/run-tests.yml?query=branch:master)

[![Documentation Status](https://readthedocs.org/projects/golem-framework/badge/?version=latest)](https://golem-framework.readthedocs.io/en/latest/?badge=latest)

[![Join the chat at https://gitter.im/golem-framework/golem](https://badges.gitter.im/golem-framework/golem.svg)](https://gitter.im/golem-framework/golem?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)



Golem is a test framework and a complete tool for browser automation.

Tests can be written with code in Python, codeless using the web IDE, or both.



![Execution Report Demo](https://raw.githubusercontent.com/golemhq/resources/master/img/demo_report_running_execution.gif)



**Tests can be written with the web app**



    




**But, they are still Python code**



    




## Batteries Included



* Multi-user web IDE

* Extended classes for [WebDriver](https://golem-framework.readthedocs.io/en/latest/golem_public_api/webdriver-class.html) and [WebElement](https://golem-framework.readthedocs.io/en/latest/golem_public_api/webelement-class.html)

* More than 200 self documenting [Actions](https://golem-framework.readthedocs.io/en/latest/golem-actions.html)

* [Webdriver-manager](https://github.com/golemhq/webdriver-manager) utility

* Built in parallel test support

* Reporting engine







**Golem is still in beta!**. Read the changelog before upgrading.







## Screen Captures



**Report Dashboard**



    




**Execution Report**



    




**Test Execution Detail**



    




## Installation



Golem works with Python 3.6+



```

pip install golem-framework

```



Read the full installation guide here: [https://golem-framework.readthedocs.io/en/latest/installation.html](https://golem-framework.readthedocs.io/en/latest/installation.html)



## Quick Start



**Create a test directory anywhere in your machine**



```

golem-admin createdirectory 

```



**Download the latest webdriver executables**



```

cd 

webdriver-manager update

``` 



Webdriver executables are downloaded to the *drivers* folder. For more information check [this page](https://golem-framework.readthedocs.io/en/latest/browsers.html) of the documentation.



**Start the Web Module**



```

golem gui

```



The Web Module can be accessed at http://localhost:5000/



By default, the following user is available: username: *admin* / password: *admin*



**Run a Test From Console**



```

golem run  

golem run  

```



Args:



* -b | --browsers: a list of browsers, by default use defined in settings.json or Chrome

* -p | --processes: run in parallel, default 1 (not parallel)

* -e | --environments: a list of environments, the default is none

* -t | --tags: filter tests by tags



## Documentation



[https://golem-framework.readthedocs.io/](https://golem-framework.readthedocs.io/)



## Questions



If you have any question please use the [Gitter channel](https://gitter.im/golem-framework/golem).



## Contributing



If you found a bug or want to contribute code please read the [contributing guide](https://github.com/golemhq/golem/blob/master/CONTRIBUTING.md).



## License



[MIT](https://tldrlegal.com/license/mit-license)



## Credits



Logo based on ["to believe"](https://www.toicon.com/icons/feather_believe) by Shannon E Thomas, [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)