https://github.com/epadronu/dwalin

Dwalin is a web automation library for Java. It’s a Selenide/Selenium-WebDriver wrapper inspired by Geb and its elder brother Balin.
https://github.com/epadronu/dwalin

Last synced: about 2 months ago
JSON representation

Dwalin is a web automation library for Java. It’s a Selenide/Selenium-WebDriver wrapper inspired by Geb and its elder brother Balin.

• Host: GitHub
• URL: https://github.com/epadronu/dwalin
• Owner: EPadronU
• License: apache-2.0
• Created: 2024-08-06T14:20:20.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-09-10T16:22:07.000Z (4 months ago)
• Last Synced: 2024-09-10T18:19:01.144Z (4 months ago)
• Language: Java
• Size: 839 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Dwalin

[![license](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg?style=flat)](http://www.apache.org/licenses/LICENSE-2.0)

## About the project

Dwalin is a web-automation library for Java. It's a [Selenide](https://selenide.org) /

[Selenium-WebDriver](https://www.selenium.dev/documentation/webdriver) wrapper inspired by

[Geb](https://www.gebish.org) and its elder brother

[Balin](https://github.com/EPadronU/balin).

Contrary to a framework, Dwalin is **lightweight** and **non-opinionated**. Additionally, its

supports the usage of the

[Page Component Object Model](https://gorillalogic.com/blog/test-automation-frameworks-page-object-model-vs-page-component-object-model)

design pattern, an extension of the well-known

[POM](https://www.guru99.com/page-object-model-pom-page-factory-in-selenium-ultimate-guide.html)

design pattern.

## Rationale

Geb, written in Groovy, is a fantastic library that lets users harness the power of the

Selenium-WebDriver API with ease. On the Java side, Selenide offers many of the same benefits as

Geb. As a software developer focused on web-based test automation, I've had the privilege of

working with both tools. This inspired me to create a smoother experience, leading to the

development of Balin in Kotlin a few years ago. Now, with Dwalin, I'm excited to bring what I've

learned from Balin into the Java world.

## Usage

[Sample tests](./src/test/java/com/github/epadronu/dwalin/SampleTests.java)

### Templates

The [dwalin-restassured-template](https://github.com/EPadronU/dwalin-restassured-template)

repository serves as a starting point for creating robust web automation projects in Java. The

template integrates powerful tools like REST Assured for API testing and the Allure Framework for

advanced reporting, all seamlessly tied together with the Dwalin library.

## Documentation

- [Java API](https://epadronu.github.io/dwalin/apidocs/index.html)

## Using the library in your project

### Maven

```xml

    io.github.epadronu

    dwalin

    0.2.1

```

### Gradle

```groovy

implementation 'io.github.epadronu:dwalin:0.2.1'

```

## Notes

This project has been conceived as a hobby and for personal use. Nonetheless, I don't dismiss the

possibility of making it a production-ready library if it gets to that point.

## License

Like Balin, Dwalin is released under version 2.0 of the [Apache License](LICENSE).