-
Notifications
You must be signed in to change notification settings - Fork 13
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #34 from james-milligan/schema-readme
docs: Buf schema registry readme
- Loading branch information
Showing
1 changed file
with
18 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
# Flagd build spec | ||
|
||
## This repository is managed by OpenFeature | ||
|
||
This module contains the core types that developers can use for interacting with [flagd](https://github.com/open-feature/flagd). | ||
|
||
Internally flagd uses the connect protocol, meaning it is compatible with grpc interfaces. If your desired language has a supported plugin for generating connect stubs then it is reccomended to use these over grpc. | ||
|
||
The package contains a single `Service`, describing the 5 core `rpcs` for feature flag evaluation (`ResolveBoolean`, `ResolveString`, `ResolveFloat`, `ResolveInt` and `ResolveObject`) each with their type specific request and response objects(`ResolveXXXRequest` and `ResolveXXXResponse`). | ||
The final `rpc` on the `Service` is a streamed response named `EventStream`, this is used to pass internal events to the client, such as `configuration_change` and `provider_ready`. | ||
|
||
## Build options | ||
|
||
The core definitions are in the `schema.v1` package, and contains package name options for the following languages, as such these options may be excluded from build instructions: | ||
|
||
- Go: schema/service/v1 | ||
- Java: dev.openfeature.flagd.grpc | ||
- C#: OpenFeature.Flagd.Grpc |