Carioca

A collection of testing tools for Android that include flexible reporting capabilities

Motivation for these libraries:

1. I kept copying some of these classes around in multiple projects
2. Analysing the standard junit test reports when you have long UI tests gets frustrating
3. Consistent screen recording and screenshots across different screen resolutions
4. Flexible APIs for any test report format
5. No enforced inheritance in test classes unlike other testing libraries

Libraries currently available:

1. Instrumented test reports and Allure Plugin

   // Test reports for android tests
   androidTestImplementation "com.rubensousa.carioca:report-android:1.0.0-beta01"
   
   // DumpComposeHierarchyInterceptor
   androidTestImplementation "com.rubensousa.carioca:report-android-compose:1.0.0-beta01"
   
   // Optional: test reporting for tests with coroutines
   androidTestImplementation "com.rubensousa.carioca:report-android-coroutines:1.0.0-beta01"
   
   // Optional: libraries to build your own report formats
   androidTestImplementation "com.rubensousa.carioca:report-json:1.0.0-beta01"
   androidTestImplementation "com.rubensousa.carioca:report-runtime:1.0.0-beta01"
   

2. Instrumented tests with Hilt

   // Contains HiltFragmentScenario
   androidTestImplementation "com.rubensousa.carioca:hilt-fragment:1.0.0"
   
   // Contains createHiltComposeRule()
   androidTestImplementation "com.rubensousa.carioca:hilt-compose:1.0.0"
   
   // Contains an empty hilt activity that is required 
   // by both of the dependencies above
   debugImplementation "com.rubensousa.carioca:hilt-manifest:1.0.0"
   
   // Optional: default HiltTestRunner if you don't have your own
   androidTestImplementation "com.rubensousa.carioca:hilt-runner:1.0.0"
   

3. Junit4 rules

   testImplementation "com.rubensousa.carioca:junit4-rules:1.0.0-rc01"
   

License

Copyright 2024 Rúben Sousa

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.