Лаконічні та елегантні автоматизовані тести? Безболісний (майже) тестовий стек для UI веб-додатків? Більше часу, щоб випити кави/пограти у Cuphead/ подивитись у порожнечу? Ми поговоримо про Lombok, Vavr, Owner, чому вам варто використовувати готові рішення та як зробити тести більш лаконічними та читабельними. Вам знадобиться Vaper та/або гіроборд.

1. SCULPT! YOUR! TESTS!
Taras Oleksyn

2.  4+ years of test automation experience
(in company, freelance)
 Enjoys building simple and elegant
solutions
 Has beautiful eyes

3. READABILITY
more than 70% of a developers time is spend
reading and understanding code*
*https://blogs.msdn.microsoft.com/peterhal/2006/01/04/what-do-programmers-really-do-anyway-aka-part-2-of-the-yardstick-saga/

4.  Tuning your language
extension libraries
new features
 Readable web UI test stack
 Sculpting! Your! Tests!
WE’LL TALK:

5. LOMBOK
both beautiful island in Indonesia and
awesome Java extension library
https://projectlombok.org/

6. TYPE INFERENCE
automatic deduction of the data type of an
expression

7. LOCAL VARIABLE TYPE INFERENCE
boolean isRemoteEnabled = true;
final String browser = getProperty("browser", "FIREFOX");
final ArrayList<ProductType> productTypeList = new ArrayList<>();
var isRemoteEnabled = true;
val browser = getProperty("browser", "FIREFOX");
val productTypeList = new ArrayList<ProductType>();

8. TYPE INFERENCE
val – final local variable
var – non-final local variable
works on:
local variables
loop scope variables
https://habrahabr.ru/post/280075/
http://openjdk.java.net/jeps/286

9. POJO
public AutomationEngineer(String name,
boolean likesToBuildFrameworks,
boolean hatesBDD) {
this.name = name;
this.likesToBuildFrameworks = likesToBuildFrameworks;
this.hatesBDD = hatesBDD;
}
public class AutomationEngineer {
…
private final String name;
private final boolean likesToBuildFrameworks;
private final boolean hatesBDD;

10. public String getName() {return name;}
public boolean hatesBDD() { return hatesBDD; }
public boolean likesToBuildFrameworks() { … }
@Override
public boolean equals(Object o) { … }
@Override
public int hashCode() { … }
@Override
public String toString() { … }
}
POJO

11. LOMBOK
public class AutomationEngineer {
private final String name;
private final boolean likesToBuildFrameworks;
private final boolean hatesBDD;
}
@Data

12. public enum State {
ALABAMA("AL", 1),
ALASKA("AK", 2),
ARIZONA("AZ", 3),
CALIFORNIA("CA", 4);
private final String shortName;
private final int stateIndex;
}
LOMBOK
State(String shortName, int stateIndex) {
this.shortName = shortName;
this.stateIndex = stateIndex;
}
public String getShortName() { return shortName; }
public int getStateIndex() { return stateIndex; }
}
@Getter
@RequiredArgsConstructor

13. EXTENSION METHOD
a method added to an object after the original
object was compiled

14. EXTENSION METHOD
new ChromeDriver()
.getClickableElement(By.id("some_id"))
.click();
new ChromeDriver()
.findElement(By.id("some_id"))
.click();

15. EXTENSION METHOD
public class WebElementExtension {
public static WebElement getClickableElement(WebDriver driver, By by){
return new WebDriverWait(driver, 30)
.until(ExpectedConditions.elementToBeClickable(by));
}
}
@ExtensionMethod(WebElementExtension.class)
public class ExtensionMethodExample {
@Test
void testDriverExtension(){
new ChromeDriver()
.getClickableElement(By.id("some_id"))
.click();
}
}

16. LOMBOK
@Value
@Builder
@Accessors
@UtilityClass
…

17. VAVR (EX JAVASLANG)
functional library for Java 8+ to reduce the amount
of code and to increase the robustness
http://blog.vavr.io/

18. PATTERN MATCHING
act of checking a given sequence for the
presence of the constituents of some pattern
http://cr.openjdk.java.net/~briangoetz/amber/pattern-match.html

19. PLAIN JAVA
public void filterUsersBy(UserType user) {
WebElement userLocator;
switch (user) {
case ADMIN:
userLocator = adminUserLocator; break;
case MEMBER:
userLocator = memberUserLocator; break;
case VENDOR:
userLocator = vendorUserLocator; break;
default:
userLocator = superAdminLocator; break;
}
select(userLocator);
click(filterButton);
}

20. public void filterUsersBy(UserType user) {
val userLocator = Match(user).of(
Case($(ADMIN), adminUserLocator),
Case($(MEMBER), memberUserLocator),
Case($(VENDOR), vendorUserLocator),
Case($(), superAdminLocator)
);
select(userLocator);
click(filterButton);
}
VAVR

21. public void doActionFor(UserType user) {
Match(user).of(
Case(isIn(ADMIN, SUPER_ADMIN), obj -> run(this::selectAdminUser)),
Case($(MEMBER), obj -> run(this::selectMemberUser)),
Case($(), obj -> {throw new SomeException("Invalid user: “ + obj);})
);
}
VAVR

22. OWNER
library for getting rid of the boilerplate code in
properties based configuration
http://owner.aeonbits.org/

23. PROPERTY
BrowserSetting.properties:
browserName=firefox
version=57
platform=LINUX
javascriptEnabled=true
acceptSslCerts=false
isRemote=true

24. public interface BrowserSetting extends Config {
String browserName();
String version();
Platform platform();
boolean isRemote();
boolean javascriptEnabled();
boolean acceptSslCerts();
}
OWNER
BrowserSetting.properties:
browserName=firefox
version=57
platform=WINDOWS
isRemote=true
javascriptEnabled=true
acceptSslCerts=false

25. OWNER
browserSetting.browserName();
browserSetting.platform();
browserSetting.version();
browserSetting.isRemote();
browserSetting.javascriptEnabled();
browserSetting.acceptSslCerts();
val browserSetting = ConfigFactory.create(BrowserSetting.class);

26. OWNER
@Key("browser.name")
@DefaultValue("FIREFOX")
@HotReload
@Sources({
"file:BrowserSetting.properties",
"classpath:BrowserSetting.properties"})
…
@

27. public List<Product> getProductsFor(ProductCategory category) {
return filteredProducts;
}
JAVA
List<WebElement> products = getVisibleElementsFor(productsLocator);
List<Product> filteredProducts = new ArrayList<>();
for (WebElement productElement : products) {
String productName = productElement.getText();
String productCategory = getCategoryFrom(productName);
}
if (productCategory.equals(category)) {
Product product = new Product(productName);
filteredProducts.add(product);
}

28. public List<Product> getProductsFor(ProductCategory category) {
return getVisibleElementsFor(productsLocator)
.stream()
.map(WebElement::getText)
.filter(productName ->
getCategoryFrom(productName).equals(category))
.map(Product::new)
.collect(toList());
}
JAVA 8

30. Gradle
TestNG
Selenide Allure AssertJ
DSL layer
Selenium Grid/Selenoid
TO GO STACK
API

31. SELENIDE
WebDriverManager
ThreadLocal static instance
SelenideElement
built-in smart waits
file uploads
…
maintain browser drivers
manage WebDriver
instance
UI mapping
wait strategies
assertions
…

32. ASSERTJ
void verifyAddingApplicant() {
…
assertTrue("John Smith".equals(applicant.getName()),
"Failed to update applicant name");
…
assertTrue(applicantsTable.getRecordsCount() == 1,
“Applicants table has more than 1 record");
}
void verifyAddingApplicant() {
…
assertThat(applicant).hasName(“John Smith“);
…
assertThat(applicantsTable).hasRecords(1);
}

33. CUSTOM ASSERT
public class ApplicantAssert
extends AbstractAssert<ApplicantAssert, ApplicantInfo> {
public ApplicantAssert(ApplicantInfo actual) {
super(actual, ApplicantAssert.class);
}
public static ApplicantAssert assertThat(ApplicantInfo actual) {
return new ApplicantAssert(actual);
}
public ApplicantAssert hasName(String name) {
...
}
}

34. SCULPTING! YOUR! TESTS!
extending language with libraries
using new language features
using ready solutions
building concise DSL

35. void testAddingApplicant() {
final ApplicantInfo applicant = getApplicantInfo();
final EducationInfo education = getEducationInfo();
applicantsPage
.startAddingApplicant()
.fillAllFieldsWith(applicant)
.startAddingInfo(ApplicantInfoType.EDUCATION)
.fillAllFieldsWith(education)
.saveApplicant();
assertTrue(applicantsPage.getApplicantAddedMessage().isDisplayed(),
"Failed to add new applicant");
}
1
2
3

36. final ApplicantInfo applicant = getApplicantInfo();
final EducationInfo education = getEducationInfo();
assertThat(applicantsPage).applicantAdded();
applicantsPage
.startAddingApplicant()
.fillAllFieldsWith(applicant)
.startAddingInfo(ApplicantInfoType.EDUCATION)
.fillAllFieldsWith(education)
.saveApplicant();
assertTrue(applicantsPage
.getApplicantAddedMessage().isDisplayed(),
"Failed to add new applicant");
val applicant = getApplicantInfo();
val education = getEducationInfo();
applicantsPage
.add(applicant)
.addInfo(education)
.saveApplicant();

37. void testAddingApplіcant() {
val applicant = getApplicantInfo();
val education = getEducationInfo();
applicantsPage
.add(applicant)
.addInfo(education)
.saveApplicant();
assertThat(applicantsPage).applicantAdded();
}

38. void testAddingApplicant() {
final ApplicantInfo applicant = getApplicantInfo();
final EducationInfo education = getEducationInfo();
applicantsPage
.startAddingApplicant()
.fillAllFieldsWith(applicant)
.startAddingInfo(ApplicantInfoType.EDUCATION)
.fillAllFieldsWith(education)
.saveApplicant();
assertTrue(applicantsPage.getApplicantAddedMessage().isDisplayed(),
"Failed to add new applicant");
}

39. ADVANTAGES ?
decreased code base
increased code readability
time saved for adding actual value
…

40. DOWNSIDES ?
learning curve
complexity increases
external risks
…

41. Thank You!

42. HOW TO PRONOUNCE ?
[SUITE] pronounced like
Jason[JSON]
[LINUX] pronounced
sweet
pronounced like the name
[leenooks]