Thank you very much for contributing to this project. Any issues and pull requests following these guidelines are welcome.
There's a code of conduct. TLDR: be respectful.
Vendor specific details are intentionally not included in this module in order to be lightweight and agnostic. If there are changes needed to enable vendor specific behaviour in code or other extension points, check out the spec.
Install dependencies with go get ./...
We value having as few runtime dependencies as possible. The addition of any dependencies requires careful consideration and review.
Any contributions are expected to include unit tests. These can be validated with make test or the automated github workflow will run them on PR creation.
The go version in the go.mod is the currently supported version of go.
When writing a test to cover a spec requirement use the test naming convention TestRequirement_x_y_z where x_y_z is the numbering of the spec requirement (e.g. spec requirement 1.1.1 demands a test with name TestRequirement_1_1_1). Also include the description of the test requirement as a comment of the test.
Run unit tests with make test.
The continuous integration runs a set of gherkin e2e tests.
If you'd like to run them locally, first pull the test-harness git submodule
git submodule update --init --recursive
and run tests with,
make e2e-test
Go supports fuzzing natively as of 1.18.
The fuzzing suite is implemented as an integration of go-sdk.
The fuzzing tests are found in ./integration/evaluation_fuzz_test.go.
To execute a fuzzing test, run the following
go test -fuzz=FuzzBooleanEvaluation ./e2e/evaluation_fuzz_test.go
substituting the name of the fuzz as appropriate.
This repo uses Release Please to release packages. Release Please set up a running PR that tracks all changes for the library components, and maintains the versions according to conventional commits, generated when PRs are merged. When Release Please PR is merged, any changed artifacts will be published.
We hold regular meetings which you can see here.
We are also present in the #openfeature channel in the CNCF slack.