ReVoman | A Template-Driven API automation tool for JVM

- The majority of JVM SaaS applications are REST-based and [API-first](https://www.postman.com/api-first/).
- But to write [API automation](https://www.postman.com/api-platform/api-test-automation/), we either have low-level tools like[REST Assured](https://rest-assured.io/) which are specific to a service or domain and are rigid to reuse, extend and difficult to maintain. Or tools like Postman which don't live with the code and need altogether a different skill set to write and maintain.
- Reimagine API automation with a tool that strikes a balance between flexibility and ease of use, by letting you plug postman collections into your JVM programs/tests
- ReVoman is an Open-source template-driven API automation tool for JVM (Java/Kotlin) from the API-first SaaS company Salesforce.
- A traditional Integration test when migrated to use ReVoman has 89% low-code, more transparent and has low Cognitively complexity

Resources
---------

- Repo with Documentation: [sfdc.co/revoman](https://sfdc.co/revoman)

Transcript

1. Get Started With a Multi-line Title A Template-Driven API automation tool for JVM Gopal S Akshintala | Lead MTS ReṼoman 🦹 (Rev-Woman)
2. Gopal S Akshinta l Lead Developer, Salesforce @GopalAkshintala overfullstack.github.io
3. aPI First @GopalAkshintala
4. aPI automation @GopalAkshintala
5. QA Dev @GopalAkshintala
6. mul-T-verse E2E FTests MANUAL @GopalAkshintala
7. Alien Automation Frameworks @GopalAkshintala
8. Lead Jr. Dev Code walk- through But what’s that shadowy place over there That’s Automation Wild West Tests @GopalAkshintala
9. May have relatively less emphasis on Test design Specific to a Service or Domain Rigid to reuse, extend & difficult to maintain May deviate from real end-user interaction Wild West Tests @GopalAkshintala
10. Prod Code Test Code Cognitive Complexity @GopalAkshintala
11. Let’s Solve the problem with another Framework⁉ 🤷 @GopalAkshintala
12. Universal API Automation tool? Balance between strictness and flexibility Low Code and Low Cognitive Complexity Augment manual Persona testing @GopalAkshintala
13. @GopalAkshintala Source: https://www.postman.com/state-of-api/api-global-growth/#most-popular-apis
14. @GopalAkshintala Postman Templates
15. FTests & E2E Tests with Postman templates @GopalAkshintala
16. ReVoman (Rev-Woman) ⚡ ⚡ @GopalAkshintala
17. REST Assured Postman @GopalAkshintala
18. @GopalAkshintala UX
19. @GopalAkshintala UX Manual testing Automation on JVM
20. Ecosystem fitment Programming language Dev Experience Configurability CI/CD Integrable Reporting Detailing and Transparency Ease of Assertion Version Control UI Modularity Maintainability Extensibility @GopalAkshintala UX
21. Template-Driven-Testing ReVoman @GopalAkshintala
22. final var rundown = ReVoman.revUp( ) Rev up @GopalAkshintala { }
23. final var rundown = ReVoman.revUp( ) aPI @GopalAkshintala Kick.configure() …… .off())
24. Kick.configure() .templatePaths(List.of(" ... ", " ... ")) .hooks( pre( ... ), post( ... )) .globalCustomTypeAdapters() .globalSkipTypes() .environmentPaths(Set.of(" ... ", " ... ")) .dynamicEnvironment(Map.of(" ... ", " ... ")) .customDynamicVariables() .haltOnAnyFailure() /* OR */ .haltOnFailureOfTypeExcept() .skipSteps() .runOnlySteps() .off()); // Kick-off .requestConfig(unmarshallRequest())) .hooks( pre( ... ), post( ... )) .responseConfig(unmarshallResponse()) @GopalAkshintala .nodeModulesRelativePath(" ... ")
25. Custom JSON <—> POJO marshalling/ serialization and unmarshalling/ deserialization through Moshi adapters No need to add extra Annotations on POJO Ignore legacy types from marshalling/ unmarshalling JSON <—> POJO Type Safety @GopalAkshintala
26. Step Execution ⛹ @GopalAkshintala
27. Failure Hierarchy @GopalAkshintala
28. Rundown( stepReports: List<StepReport>, mutableEnv: PostmanEnvironment<Any?>) StepReport( step: Step, requestInfo: Either<RequestFailure, TxInfo<Request > > ?, preHookFailure: PreHookFailure?, responseInfo: Either<ResponseFailure, TxInfo<Response >> ?, postHookFailure: PostHookFailure?, envSnapshot: PostmanEnvironment<Any?>) Rundown @GopalAkshintala
29. Tax {} Persist Order Price Tax Core Recipe: Place Quote/Order 🏷 💲 (Async) (Async) @GopalAkshintala
30. Low-code Just for 1 ITest @GopalAkshintala
31. Ecosystem fitment Programming language Dev Experience Configurability CI/CD Integrable Reporting Detailing and Transparency Ease of Assertion Version Control UI Modularity Maintainability Extensibility Checklist ✅ ReVoman @GopalAkshintala
32. Postman Templates hooked to automation, always stay up-to-date Find a template for every feature right in your VCS, very handy for Q3 during Release Blitz More Perks 🙌 @GopalAkshintala
33. API metrics and Analytics Payload generation Support other popular template formats Flow control using YAML config The Future 🔮 ReVoman (Rev-Woman) @GopalAkshintala
34. ReVoman (Rev-Woman) open Source @GopalAkshintala
35. sfdc.co/revoman-slack Consume-Collab-Contribute 🙌 1-1 Support 1-1 Mentorship @GopalAkshintala
36. Demo Test PQE2ETest ReVoman (Rev-Woman) Co-ordinates com.salesforce.revoman:revoman Git Repo sfdc.co/revoman 🎴Slide deck bit.ly/revoman-deck @GopalAkshintala
37. @GopalAkshintala