github.com/Azure/aad-pod-identity@v1.8.17/CONTRIBUTING.md (about) 1 # Contributing 2 3 ## CLA 4 5 The AAD Pod Identity project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit [https://cla.microsoft.com](https://cla.microsoft.com). 6 7 When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. 8 9 ## Test Standard 10 11 ### Unit tests 12 13 Unit tests focus on testing individual units and components of aad-pod-identity and they don't require any additional services to execute. They should be fast and great for getting the first signal on whether the implementation works or not. To run unit tests: 14 15 ```bash 16 make unit-test 17 ``` 18 19 In most cases, pull requests should include an adequate amount of unit tests such that the code coverage of the pull request may not lessen the code coverage of the main branch. 20 21 ### End-to-end tests 22 23 End-to-end testing tests whether the flow of aad-pod-identity from start to finish is behaving as expected. Following guidelines should be followed when developing E2E tests: 24 25 - Use the aad-pod-identity e2e test framework. 26 27 - Define test spec reflecting real user workflow, e.g. [creation of AzureIdentity, AzureIdentityBinding and a pod that consumes the identity](https://github.com/Azure/aad-pod-identity/blob/5c9c5e541d6612c31af4d09dc0ec7654388cc076/test/e2e/single_identity_test.go#L33-L96). 28 29 See [test/e2e/README.md](./test/e2e/README.md) on how to run the aad-pod-identity e2e test suite locally.