OpenFeature specification
Go to file
renovate[bot] 969e11c4d5
chore(deps): update dependency python to 3.13 (#332)
This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [python](https://redirect.github.com/actions/python-versions) |
uses-with | minor | `3.12` -> `3.13` |

---

### Release Notes

<details>
<summary>actions/python-versions (python)</summary>

###
[`v3.13.6`](https://redirect.github.com/actions/python-versions/releases/tag/3.13.6-16792117939):
3.13.6

[Compare
Source](https://redirect.github.com/actions/python-versions/compare/3.13.5-15601068749...3.13.6-16792117939)

Python 3.13.6

###
[`v3.13.5`](https://redirect.github.com/actions/python-versions/releases/tag/3.13.5-15601068749):
3.13.5

[Compare
Source](https://redirect.github.com/actions/python-versions/compare/3.13.4-15433317575...3.13.5-15601068749)

Python 3.13.5

###
[`v3.13.4`](https://redirect.github.com/actions/python-versions/releases/tag/3.13.4-15433317575):
3.13.4

[Compare
Source](https://redirect.github.com/actions/python-versions/compare/3.13.3-14344076652...3.13.4-15433317575)

Python 3.13.4

###
[`v3.13.3`](https://redirect.github.com/actions/python-versions/releases/tag/3.13.3-14344076652):
3.13.3

[Compare
Source](https://redirect.github.com/actions/python-versions/compare/3.13.2-13708744326...3.13.3-14344076652)

Python 3.13.3

###
[`v3.13.2`](https://redirect.github.com/actions/python-versions/releases/tag/3.13.2-13708744326):
3.13.2

[Compare
Source](https://redirect.github.com/actions/python-versions/compare/3.13.1-13437882550...3.13.2-13708744326)

Python 3.13.2

###
[`v3.13.1`](https://redirect.github.com/actions/python-versions/releases/tag/3.13.1-13437882550):
3.13.1

[Compare
Source](https://redirect.github.com/actions/python-versions/compare/3.13.0-13707372259...3.13.1-13437882550)

Python 3.13.1

###
[`v3.13.0`](https://redirect.github.com/actions/python-versions/releases/tag/3.13.0-13707372259):
3.13.0

[Compare
Source](https://redirect.github.com/actions/python-versions/compare/3.12.11-15433310049...3.13.0-13707372259)

Python 3.13.0

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **Rebasing**: Whenever PR is behind base branch, or you tick the
rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update
again.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/).
View the [repository job
log](https://developer.mend.io/github/open-feature/spec).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0MS42MC40IiwidXBkYXRlZEluVmVyIjoiNDEuNjAuNCIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsicmVub3ZhdGUiXX0=-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2025-08-10 17:36:49 +00:00
.github/workflows chore(deps): update dependency python to 3.13 (#332) 2025-08-10 17:36:49 +00:00
specification docs: clarify evaluation context in hook requirements (#330) 2025-08-04 15:46:28 -04:00
tools fix: typo in specification_parser (#288) 2025-01-02 10:23:19 -05:00
.gitignore docs: include STATIC and CACHED in provider reasons (#166) 2022-12-19 16:22:55 -05:00
.markdown-link-check-config.json Link check. 2022-05-27 16:49:50 -07:00
.markdownlint.yml chore: clarify eval details funcs/structs (#209) 2023-09-26 09:19:11 -04:00
.prettierrc.yaml No line wrapping 2022-05-31 15:46:27 -04:00
.specignore parser: add support for .specignore file 2022-05-06 11:10:50 -04:00
CODEOWNERS Add a codeowner, set TSC as the spec owner. (#308) 2025-05-13 17:01:37 -04:00
LICENSE Use Apache License v2 in the repository 2022-02-11 14:14:40 +01:00
Makefile fix: links and link checks (#172) 2023-01-12 12:04:32 -05:00
README.md docs: improve spec readme (#232) 2024-01-16 17:29:03 -05:00
package-lock.json chore(deps): update dependency prettier to v3.6.2 (#322) 2025-06-30 14:02:44 +00:00
package.json chore(deps): update dependency markdownlint-cli to ^0.44.0 (#291) 2025-04-24 11:21:40 -04:00
renovate.json chore: improve Renovate config (#231) 2024-01-16 08:56:35 -05:00
specification.json feat: add point 1.6.2, 2.5.3 about shutdown details (#323) 2025-07-16 09:25:26 -04:00

README.md

OpenFeature Logo

OpenFeature Specification

Roadmap Contributing Slack CII Best Practices

OpenFeature is an open specification that provides a vendor-agnostic, community-driven API for feature flagging that works with your favorite feature flag management tool or in-house solution.

This repository describes the requirements and expectations for OpenFeature.

Design Principles

The OpenFeature specification must be designed with:

  • compatibility with existing feature flag offerings.
  • simple, understandable APIs.
  • vendor agnosticism.
  • language agnosticism.
  • low/no dependency.
  • extensibility.

SDKs and Client Libraries

The project aims to provide a unified API and SDK feature flag evaluation across popular technology stacks. The OpenFeature SDK provides a mechanism for interfacing with an external evaluation engine in a vendor agnostic way; it does not itself handle the flag evaluation logic.

An up-to-date SDK compatibility overview can be found here.

Tooling

This specification complies with RFC 2119 and seeks to conform to the W3C QA Framework Guidelines.

In accordance with this, some basic tooling (donated graciously by Diego Hurtado) has been employed to parse the specification and output a JSON structure of concise requirements, highlighting the particular RFC 2119 verb in question.

To parse the specification, simply type make. Please review the generated JSON files, which will appear as siblings to any of the markdown files in the /specification folder.

Style Guide

  • Use code blocks for examples.
    • Code blocks should be pseudocode, not any particular language, but should be vaguely "Java-esque".
  • Use conditional requirements for requirements that only apply in particular situations, such as particular languages or runtimes.
  • Use "sentence case" enclosed in ticks (`) when identifying entities outside of code blocks (ie: evaluation details instead of EvaluationDetails).
  • Do not place line breaks into sentences, keep sentences to a single line for easier review.
  • String literals appearing outside of code blocks should be enclosed in both ticks (`) and double-quotes (") (ie: "PARSE_ERROR").
  • Use "Title Case" for all titles.
  • Use the imperative mood and passive voice.