Release 0.7.3

Add Request Response info in PostHookFailure

Signed-off-by: Gopal S Akshintala <[email protected]>

Author: overfullstack

README.adoc

@@ -18,7 +18,7 @@ endif::[]
 :pmtemplates: src/integrationTest/resources/pm-templates
 :imagesdir: docs/images
 :prewrap!:
-:revoman-version: 0.7.2
+:revoman-version: 0.7.3
 
 '''
 
@@ -38,15 +38,32 @@ image::manual-to-automation.png[Manual to Automation, align="center"]
 [.lead]
 It strikes a balance between _flexibility_
 provided by low-level tools like https://rest-assured.io/[**REST Assured**] or https://cucumber.io/[**Cucumber**] and _ease of use_
-provided by UI tools like https://www.postman.com/[**Postman**]
+provided by UI tools like https://www.postman.com/[**Postman**].
 
 image::hybrid-tool.png[]
 
+[.lead]
+The fundamental principle of this tool is
+to automate your Postman collection on JVM *without compromising on Manual testing*.
+Which means
+the collections used in JVM automation can be maintained
+to always be ready for Manually trying them out importing into Postman.
+
+== Why not use https://learning.postman.com/docs/collections/using-newman-cli/command-line-integration-with-newman[Newman] or https://learning.postman.com/docs/postman-cli/postman-cli-overview/#comparing-the-postman-cli-and-newman[Postman CLI]?
+
+* ReṼoman may be similar to Newman or Postman CLI when it comes to executing a Postman collection, but the _similarities end there_
+* Newman or Postman CLI are built for node and cannot be executed within a JVM. Even if you are able to run in some hacky way, there is no easy way to assert results.
+* ReṼoman is JVM first that lets you seamlessly integrate with your existing Java ecosystem. It lets you configure more — for example, the <<#_pre_step_and_post_step_hooks,Hooks>> feature lets you plug in your custom JVM code in-between the execution. 
+* ReṼoman has a strong emphasis on <<#_type_safety_with_flexible_json_pojo_marshallingserialization_and_unmarshallingdeserialization,Type-Safety>>, leveraging JVM strong types over JSON for writing assertions and custom code
+
+[.lead]
+Read more in the <<USP>>
+
 == Artifact
 
 [.lead]
 Maven
-[source,xml,subs=attributes+]
+[source,xml,subs=attributes+,tabsize=2]
 ----
 <dependency>
 	<groupId>com.salesforce.revoman</groupId>
@@ -737,12 +754,6 @@ You don't have to.
 This is a JVM-first tool,
 and you can interlace your TestUtils through <<#_plug_in_your_java_code_in_between_postman_execution,Pre-Step/Post-Step Hooks>>
 
-=== Why not use https://learning.postman.com/docs/collections/using-newman-cli/command-line-integration-with-newman[Newman] or https://learning.postman.com/docs/postman-cli/postman-cli-overview/#comparing-the-postman-cli-and-newman[Postman CLI]?
-
-* ReṼoman may be similar to Newman or Postman CLI when it comes to executing a Postman collection, but the _similarities end there_.
-* Newman or Postman CLI are built for node and cannot be executed within a JVM. Even if you are able to run in some hacky way, there is no easy way to assert results.
-* ReṼoman is JVM first that lets you configure a lot more, and gives you back a detailed report to assert in a typesafe way
-
 == 🙌🏼 Consume-Collaborate-Contribute
 
 * This link:CONTRIBUTING.adoc[CONTRIBUTING] doc has all the information to set up this library on your local and get hands-on.

buildSrc/src/main/kotlin/Config.kt

@@ -6,6 +6,6 @@
  * ************************************************************************************************
  */
 const val GROUP_ID = "com.salesforce.revoman"
-const val VERSION = "0.7.2"
+const val VERSION = "0.7.3"
 const val ARTIFACT_ID = "revoman"
 const val STAGING_PROFILE_ID = "1ea0a23e61ba7d"

src/integrationTest/java/com/salesforce/revoman/integration/pokemon/PokemonTest.java

@@ -141,8 +141,9 @@ public void accept(@NotNull StepReport stepReport, @NotNull Rundown rundown) {
 								.dynamicEnvironment(dynamicEnvironment)
 								.off());
 
-		assertThat(pokeRundown.firstUnIgnoredUnsuccessfulStepReport().failure)
-				.containsOnLeft(new PostStepHookFailure(RUNTIME_EXCEPTION));
+		final var postHookFailure = pokeRundown.firstUnIgnoredUnsuccessfulStepReport().failure;
+		assertThat(postHookFailure).containsLeftInstanceOf(PostStepHookFailure.class);
+		assertThat(postHookFailure.getLeft().getFailure()).isEqualTo(RUNTIME_EXCEPTION);
 		assertThat(pokeRundown.stepReports).hasSize(5);
 		assertThat(pokeRundown.mutableEnv)
 				.containsExactlyEntriesIn(

src/main/kotlin/com/salesforce/revoman/input/json/adapters/salesforce/CompositeResponse.kt

@@ -78,7 +78,7 @@ data class CompositeResponse(val compositeResponse: List<Response>) {
                   }
                   attributes = attributesJsonAdapter.fromJson(reader)
                 }
-                -1 -> recordBody[reader.nextName()] = reader.readJsonValue()!!
+                -1 -> recordBody[reader.nextName()] = reader.readJsonValue()
                 else -> throw AssertionError()
               }
             }

src/main/kotlin/com/salesforce/revoman/internal/exe/PostStepHook.kt

@@ -24,7 +24,7 @@ internal fun postStepHookExe(kick: Kick, pm: PostmanSDK): PostStepHookFailure? =
       runCatching(pm.currentStepReport.step, POST_STEP_HOOK) {
           postStepHook.accept(pm.currentStepReport, pm.rundown)
         }
-        .mapLeft { PostStepHookFailure(it) }
+        .mapLeft { PostStepHookFailure(it, pm.currentStepReport.requestInfo!!.get(), pm.currentStepReport.responseInfo!!.get()) }
     }
     .firstOrNull { it.isLeft() }
     ?.leftOrNull()

src/main/kotlin/com/salesforce/revoman/output/report/failure/HookFailure.kt

@@ -11,17 +11,22 @@ import com.salesforce.revoman.output.ExeType.POST_STEP_HOOK
 import com.salesforce.revoman.output.ExeType.PRE_STEP_HOOK
 import com.salesforce.revoman.output.report.TxnInfo
 import org.http4k.core.Request
+import org.http4k.core.Response
 
 sealed class HookFailure : ExeFailure() {
 
   data class PreStepHookFailure(
     override val failure: Throwable,
-    val requestInfo: TxnInfo<Request>,
+    @JvmField val requestInfo: TxnInfo<Request>,
   ) : HookFailure() {
     override val exeType = PRE_STEP_HOOK
   }
 
-  data class PostStepHookFailure(override val failure: Throwable) : HookFailure() {
+  data class PostStepHookFailure(
+    override val failure: Throwable,
+    @JvmField val requestInfo: TxnInfo<Request>,
+    @JvmField val responseInfo: TxnInfo<Response>,
+  ) : HookFailure() {
     override val exeType = POST_STEP_HOOK
   }
 }

src/main/kotlin/com/salesforce/revoman/output/report/failure/HttpStatusUnsuccessful.kt

@@ -13,8 +13,11 @@ import org.http4k.core.Request
 import org.http4k.core.Response
 
 data class HttpStatusUnsuccessful(
+  @JvmField
   val requestInfo: TxnInfo<Request>,
+  @JvmField
   val responseInfo: TxnInfo<Response>,
 ) {
+  @JvmField
   val exeType = HTTP_STATUS
 }

src/test/kotlin/com/salesforce/revoman/output/report/StepReportTest.kt

@@ -123,7 +123,7 @@ class StepReportTest {
         Right(requestInfo),
         null,
         Right(responseInfo),
-        PostStepHookFailure(RuntimeException("fakeRTE")),
+        PostStepHookFailure(RuntimeException("fakeRTE"), requestInfo, responseInfo),
         PostmanEnvironment(),
       )
     println(stepReportPostStepHookFailure)