1# Goldens Files For Integration Test 2 3This folder contains goldens files that are expected to be generated from Java Microgenerator 4against different APIs. For example `redis` folder has all the Java source files in the generated 5Redis client library. They are all actual Java files, but used as goldens. 6 7## Purpose 8 9When running integration test for the Java Microgenerator using the below command, 10the goldens files in this folder will be used to compare with the actual generated Java source 11files. 12If they are not identical, then the integration test will fail. 13 14```sh 15bazelisk test //test/integration:redis 16``` 17 18## How To Update Goldens 19 20If the actual generated Java source files are not identical with the goldens files, and we want to 21update the goldens using source files. Run the command below to overwrite the goldens files 22in `redis` folder. 23 24```sh 25bazelisk run //test/integration:update_redis 26``` 27 28## Adding new integration tests 29 30If you are adding a new API for integration testing, be sure to add it in the `BUILD.bazel` under 31the `Integration Test Rules` and add the `java_gapic_test` rules for the new API under 32the `API Library Rules` section. 33 34You need to manually create a new directory for your new API under the `test/integration/goldens` 35with the same name you've used for the `Integration Test Rules`. Then when you run the command to 36update goldens (above), it will automatically create the goldens needed. 37