This repo contains metadata related to LaunchDarkly SDKs.
The data is intended for consumption by downstream products and services.
It also contains a Go module exposing the metadata for easier consumption by Go applications.
| Data Product | Description | Format |
|---|---|---|
| Database | Database containing data from which other products are derived. | sqlite3 |
| SDK Names | SDK friendly names for display. | JSON |
| SDK Releases | SDK major/minor releases with EOL dates. | JSON |
| SDK Types | SDK types for categorization. | JSON |
| SDK Languages | Programming languages associated with SDKs. | JSON |
| SDK Repos | SDK source repositories | JSON |
| SDK Features | SDK supported features | JSON |
| SDK Feature Info | Descriptions of SDK features | JSON |
| SDK Popularity | SDK popularity | JSON |
This repo contains an sqlite database containing a snapshot of SDK metadata fetched from individual repos.
It also contains JSON files that are derived from the database. These are intended for consumption by downstream products and services.
The JSON schemas for those products live in schemas.
Data products can be validated against the schemas using ./scripts/ci/check-json-schemas.sh on Linux.
Ensure that the JSON files are valid and formatted using ./scripts/ci/format-json.sh.
To quickly create basic metadata for a new repo, run ./scripts/add-repo.sh <launchdarkly/repo-name>. This will
clone the repo, check-in an .sdk_metadata.json file, and create a PR.
Some of the tooling lives in a Go module because it's too complex for a shell script.
The JSON products have an implicit 'v1' version at this time.
The sqlite database has no versioning policy and may change schemas at any time.
If any JSON schema needs a breaking change, then we should probably handle it like so:
- Add a new
products/v2directory andschemas/v2directory as needed - Update
./scripts/generate-products.shto generate the new data products, and also keep generating the old ones so they remain up-to-date. - Have new applications consume
/products/v2/whatever.json - Eventually, when/if all consumers have migrated, stop generating the old products. Don't delete them though, just in case something is intermittently using them that we've forgotten about.
The API Go module should follow semver:
- Patch for "bug fixes" to the JSON specs, or whenever metadata is updated in a backwards compatible way.
- Minor for new data products (necessitating a new embedded table in the module)
- Major for breaking changes to the API or data products. In the case of a major version, we need to append
a new suffix to the module like
v2.
- Changing the meaning of an existing field
- Changing the contents of an existing field in an incompatible way (like changing its type)
- Removing an existing field
- Probably other things that we haven't thought of
- Adding a new field
Consumers of SDK metadata include:
- LaunchDarkly Docs
- LaunchDarkly CLI
- LaunchDarkly internal service (G)
Are you a consumer? Add a link here to receive communications when new features/changes are coming.