GH-105: add initial excel files processing support

This update includes an initial experimental Excel files reader based on ZeroCell and Apache POI libraries.

Fixes #105

Author: sskorol

README.md

@@ -174,7 +174,7 @@ configurations {
     
 dependencies {
     agent 'org.aspectj:aspectjweaver:1.9.7'
-    implementation 'io.github.sskorol:test-data-supplier:1.9.5'
+    implementation 'io.github.sskorol:test-data-supplier:1.9.7'
 }
     
 test {
@@ -212,7 +212,7 @@ configurations {
     
 dependencies {
     agent 'org.aspectj:aspectjweaver:1.9.7'
-    implementation 'io.github.sskorol:test-data-supplier:1.9.5'
+    implementation 'io.github.sskorol:test-data-supplier:1.9.7'
 }
     
 compileJava {
@@ -301,9 +301,9 @@ public void supplyExternalData(final T data) {
 
 Check **io.github.sskorol.testcases** package for more examples.
 
-### JSON, CSV and YAML processors
+### JSON, CSV, YAML and XLSX processors
 
-Test data supplier supports JSON, CSV and YML data retrieval. Assuming you have the following resources:
+Test data supplier supports JSON, CSV, YML and XLSX data retrieval. Assuming you have the following resources:
 
 ```csv
 username,password
@@ -341,6 +341,13 @@ username,password
  password: '123'
 ```
 
+```csv
+USERNAME  PASSWORD
+admin     admin
+sskorol   password
+guest     123
+```
+
 You can now map Java entities to these data sources using **@Source** annotation, which accepts either local file name 
 or URL:
 
@@ -375,12 +382,28 @@ public class User {
 }
 ```
 
+```java
+@Data
+@NoArgsConstructor
+@Source(path = "users.xlsx")
+public class User {
+    @Column(name = "USERNAME", index = 0)
+    private String username;
+
+    @Column(name = "PASSWORD", index = 1)
+    private String password;
+}
+```
+
 In case if some Java field's name differs from its data source representation, you can assign a valid name via 
 **@FieldName** for CSV, **@SerializedName** for JSON and **@JsonProperty** for YML data type.
 
-Note that local data sources must be located in a classpath.
+Excel support is experimental. [ZeroCell](https://github.com/creditdatamw/zerocell) library based on [Apache POI](https://github.com/apache/poi) is used here to simplify corresponding files processing.
+So feel free to check their API and supported annotations. However, in terms of fields' mapping, you can use **Column**.
+
+Note that local data sources must be located in a classpath. You usually use **resources** folder for that.
 
-Then in **DataSupplier** you can call special **TestDataReader** builder to retrieve data from CSV, JSON or YML data source. 
+Then in **DataSupplier** you can call special **TestDataReader** builder to retrieve data from CSV, JSON, YML or XLSX data source. 
 See javadocs to get more details.
 
 ```java
@@ -404,6 +427,13 @@ public StreamEx<User> getUsers() {
 }
 ```
 
+```java
+@DataSupplier
+public StreamEx<User> getUsers() {
+    return use(XlsxReader.class).withTarget(User.class).read();
+}
+```
+
 If you want to specify custom source in runtime, you can remove **@Source** annotation and use **withSource** builder 
 method instead.
 
@@ -503,7 +533,7 @@ Note that in case if you want to manage **DataProviderTransformer** manually, yo
 
 ```groovy
 dependencies {
-    implementation 'io.github.sskorol:test-data-supplier:1.9.5:spi-off'
+    implementation 'io.github.sskorol:test-data-supplier:1.9.7:spi-off'
 }
 ```
 

build.gradle

@@ -45,7 +45,7 @@ dependencies {
     testAnnotationProcessor("org.projectlombok:lombok:${lombokVersion}")
     api("org.jooq:joor:0.9.14")
     api("org.testng:testng:7.4.0")
-    api('one.util:streamex:0.8.0')
+    api('one.util:streamex:0.8.1')
     api("io.vavr:vavr:0.10.4")
     api("org.aspectj:aspectjrt:${aspectjVersion}")
     // Don't update to 0.9.12 due to bugs
@@ -54,6 +54,7 @@ dependencies {
     api("com.google.code.gson:gson:2.8.9")
     api("com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:${jacksonVersion}")
     api("com.fasterxml.jackson.core:jackson-databind:${jacksonVersion}")
+    api("com.creditdatamw.labs:zerocell-core:0.5.1")
     testImplementation("org.assertj:assertj-core:3.11.1")
 }
 
@@ -79,7 +80,7 @@ jacocoTestReport {
 }
 
 tasks.named('wrapper') {
-    gradleVersion = '7.2'
+    gradleVersion = '7.3.3'
 }
 
 compileJava {
@@ -125,6 +126,7 @@ test {
                 '--add-opens', 'io.github.sskorol.testdatasupplier/io.github.sskorol.listeners=org.testng',
                 '--add-opens', 'io.github.sskorol.testdatasupplier/io.github.sskorol.testcases=org.jooq.joor',
                 '--add-opens', 'io.github.sskorol.testdatasupplier/io.github.sskorol.entities=org.jooq.joor',
+                '--add-opens', 'io.github.sskorol.testdatasupplier/io.github.sskorol.entities=zerocell.core',
                 '--add-opens', 'io.github.sskorol.testdatasupplier/io.github.sskorol.entities=com.fasterxml.jackson.databind',
                 '--add-opens', 'io.github.sskorol.testdatasupplier/io.github.sskorol.datasuppliers=org.jooq.joor',
                 '--add-opens', 'io.github.sskorol.testdatasupplier/io.github.sskorol.datasuppliers=org.testng',

gradle.properties

@@ -1,4 +1,4 @@
-version=1.9.6
+version=1.9.7
 systemProp.sonar.coverage.jacoco.xmlReportPaths=build/reports/jacoco/jacoco.xml
 systemProp.sonar.host.url=https://sonarcloud.io
 systemProp.sonar.organization=sskorol-github

gradle/wrapper/gradle-wrapper.jar

@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists