This repository contains a docker image to support the gherkin suites in the OpenFeature specification.
The flagd-testbed container is a docker image built on flagd, which essentially just adds a simple set of flags for the purposes of testing OpenFeature SDKs.
testing-flags.json contains a set of flags consistent with the evaluation feature.
change-flag.sh runs in the test container generates a file changing-flag.json, which contains a flag that changes once every seconds, allowing to easily test change events.
See the flagd docs for more information on flagd.
The sync-testbed_ container is a docker image built on conforming to the sync.proto - a grpc which flagd or flagd in-process providers can use as a sync-source. It features an identical set of flags to the flagd-testbed container
For details on the sync-testbed, see sync/README.me
The gherkin/ dir includes a set of gherkin tests that define expected behavior associated with the configurations defined in the flagd-testbed (see flags/). Combined with the flagd-provider for the associated SDK and the flagd-testbed, these comprise a complete integration test suite.
Included suites:
flagd.feature includes tests relevant to flagd and all flagd providers:
- default value (zero-value) handling (some proto3 implementations handle these inconsistently).
- basic event handling
flagd-json-evaluator.feature includes tests relevant to flagd and in-process providers:
- custom JSONLogic operators (
starts_with,ends_with,fractional,sem_ver) - evaluator reuse via
$ref
The Gherkin files structure can be linted using gherkin-lint. The following commands require Node.js 10 or later.
- npm install
- npm run gherkin-lint