https://github.com/gopatchy/bkl
Layered Configuration Language
https://github.com/gopatchy/bkl
configuration deployment devops json k8s kubernetes sre toml yaml
Last synced: 19 days ago
JSON representation
Layered Configuration Language
- Host: GitHub
- URL: https://github.com/gopatchy/bkl
- Owner: gopatchy
- License: apache-2.0
- Created: 2023-07-01T02:04:47.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-01T16:42:02.000Z (2 months ago)
- Last Synced: 2025-12-04T05:55:25.709Z (2 months ago)
- Topics: configuration, deployment, devops, json, k8s, kubernetes, sre, toml, yaml
- Language: Go
- Homepage: https://bkl.gopatchy.io/
- Size: 23.1 MB
- Stars: 10
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [bkl](https://bkl.gopatchy.io/)
bkl (short for Baklava because it has layers) is a templating configuration language without the templates. It's designed to be simple to read and write with obvious behavior.
Write your configuration in your favorite format: [JSON](https://json.org/), [YAML](https://yaml.org/), or [TOML](https://toml.io/). Layer configurations on top of each other, even from different file formats. Use filenames to define the inheritance. Have as many layers as you like. bkl merges your layers together with sane default behavior that you can override. Export your results in any supported format for human or machine consumption. Use the CLI directly or in scripts or automate with the [library](https://pkg.go.dev/github.com/gopatchy/bkl).
[](https://pkg.go.dev/github.com/gopatchy/bkl)
[](https://github.com/gopatchy/bkl/)
[](https://discord.gg/TyDAmqkz3m)
## Example
### service.yaml
```yaml
addr: 127.0.0.1
name: myService
port: 8080
```
### service.test.toml
```toml
port = 8081
```
### Run it!
```console
$ bkl service.test.toml
addr = '127.0.0.1'
name = 'myService'
port = 8081
```
bkl knows that `service.test.toml` inherits from `service.yaml` by the filename pattern (override with `$parent`) and uses filename extensions to determine formats.
## Install
```console
$ go install github.com/gopatchy/bkl/...@latest
```
Verify that `~/go/bin` is in your `$PATH`.
You can also download binaries directly [here](https://github.com/gopatchy/bkl/releases).
## Links
* [Language documentation including examples](https://bkl.gopatchy.io/)
* [Golang library reference](https://pkg.go.dev/github.com/gopatchy/bkl)
* [Support (Discord)](https://discord.gg/TyDAmqkz3m)
* [Bug and feature request tracking (GitHub)](https://github.com/gopatchy/bkl/issues)
* [Source code (GitHub)](https://github.com/gopatchy/bkl/)
* [Downloads & release notes (GitHub)](https://github.com/gopatchy/bkl/releases)
* [Container images (GitHub)](https://github.com/gopatchy/bkl/pkgs/container/bkl)