.yaml, .toml, etc?
It depends what you need your configuration file to be:
Need a well defined easy to understand concrete configuration file?
- Use
.toml
. It was made to be both human and computer friendly while taking special attention to avoid the pitfalls commonly found in other configuration files by explicitly stating expected types around commonly confused areas.
Need a simple to implement configuration file?
- Use
.json
. It’s famous for being so simple it’screator“discoverer” could define it on a business card.
Need an abstract configuration file for more complicated setups?
- Use
.ncl
. Nickle allows you to define functions so that you can generate/compute the correct configuration by changing a few variables/flags.
- Use
JSON by a mile. I hate the YAML plague, it’s some of the most unintuitive syntax I’ve seen and yet it’s everywhere in DevOps/SysOps.
GitHub Actions and Azure DevOps had me hating on YAML pretty quickly
Yeah, any language in which whitespace count is semantically significant can go suck fat nards.
I mean, a valid JSON is a valid YAML
I hate that you’re correct lmao
The only thing that really annoys me about JSON is that it doesn’t allow comments.
JSON5, bay-beee
A lot of good answers but I would add one note:
- use a format that supports comments, and JSON is not one of those…
deleted by creator
How do you comment multiple properties separately?
deleted by creator
Don’t worry, I wouldn’t do things like this in JSON. Nevertheless, it can be very useful to have comments along with configuration values, for example to explain the actual values (not their purpose) and why they were chosen. That’s information you can’t add to the code which processes the values.
Whatever. Comments are helpful, which makes pure JSON a poor choice. JSON5 or JSON-C are better, but linting and static analysis are important to every form of code, so make sure that what you use for that will understand your syntax.
My current preference is generally TOML, but I’ve started dabbling with custom HCL2 DSLs. (I write a lot of Go and Terraform.)
It really depends. I usually prefer json. It’s easily understandable from humans and from machines, it doesn’t depends on indentation and above everything else I like it very much 🤣
No reason to go beyond simple key-value format like dotenv or just env variables. If you need more structure then maybe you are confusing configuration with state and this is not really the same thing.
.ini
ducks
Yaml for me, I really like it. And the fact that every valid JSON is also a valid YAML is nice.
Please do not use YAML. It’s a syntactic minefield. It also doesn’t allow tab indentation, which is supremely irritating.
The one with a validator provided to the user.