website·Indexed 29 days ago
https://selcukes.github.io/docsAn open-source automation solution and testing library for Web, Desktop, Mobile, and API endpoints. Features include DataBind for parsing JSON, YML, XML, and CSV; ExcelMapper for .xlsx files; a Video Recorder for tests; and integration with TestNG, Extent Reports, and Selenoid Grid.
Selcukes is an open-source testing library designed for creating scalable automated tests across web, mobile, desktop applications, and API endpoints. Key capabilities include:
box-wrapper and card HTML structure. Note that Markdown is not supported inside these HTML blocks; use standard HTML tags for formatting.<div className="box-wrapper" markdown="1">
<div className="box box1 card">
<div className="container">
<h2>Box 1</h2>
<p>Box 1 things.</p>
<ul>
<li><a href="">Link 1</a></li>
<li><a href="">Link 2</a></li>
</ul>
</div>
</div>
<!-- Repeat for box2, box3, box4 -->
</div>PropertiesMapper throws a DataMapperException. This exception contains details about the failure and the underlying cause.ExcelMapper throws a DataMapperException. This exception contains details about the failure and the underlying cause.CsvMapper for parsing or writing files, be prepared to handle DataMapperException. This exception is thrown when an error occurs during file processing and contains details about the failure and the underlying cause.demo-<language> repositories using semantic version tags (e.g., docs-1.0) instead of branch names or commit hashes. This is achieved via a custom Docusaurus plugin.git tag -a -m 'reference for Selcukes documentation' docs-<version>
git push origin --tagsUse ExcelMapper.parse(Class<T> entityClass) to convert an Excel sheet into a stream of Java objects.
Mapping is configured via annotations on the entity class:
@DataFile: Specifies the fileName and sheetName. If fileName is omitted, it defaults to the SnakeCase of the class name with a .xlsx suffix. If sheetName is omitted, the first sheet is used.@Key: Maps a class field to a specific Excel column name using the name attribute. It also supports a format attribute for date parsing (e.g., MM-dd-yyyy).public class ReadExcelTest {
@Data
@DataFile(fileName = "TestData.xlsx", sheetName = "Yahoo")
static class TestData {
@Key(name = "First Name")
String firstName;
@Key(name = "Last Name")
String lastName;
@Key(name = "DOB", format = "MM-dd-yyyy")
LocalDate dob;
String location;
}
@Test
public void excelMapperTest() {
Stream<TestData> dataStream = ExcelMapper.parse(TestData.class);
dataStream.forEach(System.out::println);
}
}@Interpolate annotation on an entity class to substitute field values (e.g., ${DATE}) during parsing. To use a custom substitution logic, extend DefaultSubstitutor and override the replace(String strToReplace, String format) method, then specify the class in the @Interpolate annotation.public class FakerDataSubstitutor extends DefaultSubstitutor {
@Override
public String replace(String strToReplace, final String format) {
return FakerUtils.substitute(strToReplace);
}
}
// Usage in Entity
@Interpolate(substitutor = FakerDataSubstitutor.class)
@Data
@DataFile(fileName = "TestData.xlsx")
static class TestData {
@Key(name = "First Name")
String firstName;
}CsvMapper.parse() method to read a CSV file from a given Path and convert it into a DataTable<String, String>. You can use the default regex for parsing or provide a custom regex to handle specific CSV formats.// Method 1: Using Default Regex
Path filePath = Paths.get("path/to/your/file.csv");
DataTable<String, String> dataTable = CsvMapper.parse(filePath);
// Method 2: Using Custom Regex
Path filePath = Paths.get("path/to/file.csv");
DataTable<String, String> dataTable = CsvMapper.parse(filePath, CsvMapper.CSV_REGEX);When setup() is called, WebDriver Binaries performs the following steps:
google-chrome --version) to find the installed browser version.%temp%/webdrivers).webdriver.chrome.driver) to the path of the downloaded binary.To optimize performance, a resolution cache (version.properties) is used with a default Time-To-Live (TTL) of 1 hour, reducing the need for repeated shell commands or external network requests.