33

cross-posted from: https://programming.dev/post/1743099

.yaml, .toml, etc?

top 46 comments
sorted by: hot top controversial new old
[-] silent_squirrel@feddit.de 33 points 1 year ago
[-] glibg10b@lemmy.ml 27 points 1 year ago

There is no best. It depends on the application

[-] doomkernel@sopuli.xyz 4 points 1 year ago
[-] balls_expert@lemmy.blahaj.zone 2 points 1 year ago
[-] glibg10b@lemmy.ml 7 points 1 year ago

Some applications don't have enough config entries to warrant support for nested entries

Some applications need variable-length data, and some even variable-length lists

Some applications don't care about having fast read/write times or a small memory footprint and can do with more complex formats that require the use of third-party libraries

Some embedded applications (e.g. AVR) don't have access to a whole lot of libraries

[-] JackbyDev@programming.dev 16 points 1 year ago

The one already being used by the project.

Yup. If I have to pick one for a new project, I'll go with TOML unless there's a reason to pick something else. I like that it's simple, while also having a bunch of features for when the project grows.

[-] JackbyDev@programming.dev 5 points 1 year ago

Pretty much same here. With Spring stuff I still use YAML because TOML doesn't have first class support yet. If TOML is an option I don't have to go too far out of my way for them I go for it.

YAML has too many foot guns. It's still less annoying to read and write than JSON though. Properties files are okay but there doesn't seem to be an agreed upon spec, so for edge cases it can be confusing.

[-] sugar_in_your_tea@sh.itjust.works 3 points 1 year ago* (last edited 1 year ago)

Yup, YAML is a terrible data format, but for a configuration format that you completely control, it works well. Your parser only needs to be good enough to read the configs you create.

Likewise, JSON is a pretty bad config format due to strictness in the syntax (no optional commas, excessive quotes, etc), but it's pretty good data format because it's pretty easy to parse.

TOML is like YAML, but it has fewer corner cases so it's pretty easy to learn completely.

Though anything is superior when it's already the status quo on a project.

[-] JackbyDev@programming.dev 1 points 1 year ago

I don't know dude, with YAML treating the word no as a Boolean and having like 6 types of multi line strings I'm really inclined to disagree with the "fewer corner cases" part. It's like waaaaaaaay less corner cases. Imagine pasting the ISO abbreviation for a country as a Boolean value.

[-] igorlogius@lemmy.world 13 points 1 year ago* (last edited 1 year ago)
[-] csolisr@communities.azkware.net 4 points 1 year ago

Agreed. YAML is a pain to edit manually, to ensure that all the tabulation is correct and the parser does not choke. JSON is passable, but you must be mindful about the brackets. XML is too verbose and duplicative. INI files are just good enough.

That's why I like TOML. It's basically INI, but it has more structural features if you need them. Most of the TOML files I use look just like ini files.

[-] exu@feditown.com 3 points 1 year ago

YAML is fine if you use a formatter. JSON's ok to read but a pain to write imo. INI if it's simple.

[-] sylver_dragon@lemmy.world 12 points 1 year ago

A well documented one.

[-] argv_minus_one@beehaw.org 11 points 1 year ago

JSON is overly verbose and doesn't allow comments. Please do not use it for anything that humans frequently need to read or write.

YAML is a syntactic minefield. Please do not use it for anything ever.

[-] Sir_Simon_Spamalot@lemmy.my.id 1 points 1 year ago

How is it syntatic minefield? I find it at least more reasonable than XML. The comment feature is nice to have.

[-] nubbucket@beehaw.org 3 points 1 year ago

yaml is susceptible to things like the Norway problem: https://www.bram.us/2022/01/11/yaml-the-norway-problem/

There's also a lot of stuff that can go wrong with deserialisation that make it a tricky dependency for security purposes. I like how yaml looks and it's obviously much better than XML, but it had those potential problems

[-] SorteKanin@feddit.dk 9 points 1 year ago

Definitely not yaml. It's spec is horrible.

Toml is pretty nice though.

[-] richieadler@lemmy.myserv.one 11 points 1 year ago

I hate table definitions in TOML with a passion.

I like YAML. I guess that's because I don't need to build parsers for it. What's your worst complain about it?

[-] SorteKanin@feddit.dk 13 points 1 year ago
[-] JonnyRobbie@lemmy.world 4 points 1 year ago

Thie essentially boikls down to "quote yur shit". Yes, it can be frustrating if a language superficially allows you to use unqoted strings with the promise that it will inteligently interprets that. It's like parentheses in arithmetics. If you are not sure or if you are not competent in a language enough to predict the order of operations, use parentheses. The same with strings and quotes in yaml.

[-] SorteKanin@feddit.dk -2 points 1 year ago

... or just use another tool where you don't even have to think about this problem.

[-] richieadler@lemmy.myserv.one 1 points 1 year ago

I get that JSON is intuitive and a huge improvement over XML, but I still find it verbose.

[-] richieadler@lemmy.myserv.one 4 points 1 year ago

Very educational.

[-] Lettuceeatlettuce@lemmy.ml 6 points 1 year ago

.ini has never let me down.

[-] flambonkscious@sh.itjust.works 4 points 1 year ago

It's a bit janky with spaces and things, but the simplicity is insane!

[-] Lettuceeatlettuce@lemmy.ml 2 points 1 year ago
[-] Frederic@beehaw.org 5 points 1 year ago

I'd say a file that you can open with a simple text editor is convenient, so it can be a simple .conf/.ini, more complex are .xml/.yaml that you can still edit in vim/nano but can be cumbersome.

But as others say, it all depends on your app...

[-] notthebees@reddthat.com 2 points 1 year ago

Toml is about the same as ini files at least with what I've worked with

[-] drwho@beehaw.org 4 points 1 year ago

Not XML. Not binary-only (looking at you, Solaris).

Personally, I like .ini-style config files, but I'm weird that way.

[-] GissaMittJobb@lemmy.ml 3 points 1 year ago

Toml is kind of ini++, though, isn't it.

[-] drwho@beehaw.org 1 points 1 year ago

I don't know. Never really thought about TOML.

[-] GissaMittJobb@lemmy.ml 2 points 1 year ago

Check out the spec sometime. It's basically ini with some stuff added on top.

It's quite nice when you need something that parses into some kind of map, while being human readable.

[-] ksynwa@lemmygrad.ml 3 points 1 year ago

I really dislike when indentation is a part of the syntax (like in YAML). Apart from that it depends on the requirements of the project.

How able Lua?

It's a programming language, so you can do fancy stuff, or you can just use it as a regular key value file. You can also safely enable/disable features so you only need to allow the subset of Lua that you need.

It works really well for things like editor configuration (see neovim), and it's especially nice if you already use Lua as a plugin language or something.

[-] jollyrogue@lemmy.ml 1 points 1 year ago

UCL and HCL are interesting, but YAML is more widely supported.

[-] Lanthanae@lemmy.blahaj.zone 1 points 1 year ago

nix

This post was sponsored by NixOS gang

(jokes aside, json is king. Yaml is a pain in the ass)

[-] hellishharlot@programming.dev 1 points 1 year ago
[-] static_caster@programming.dev 1 points 1 year ago* (last edited 1 year ago)

If you use protobuf/gRPC anywhere in your application, text format protobuf. Writes like JSON, but with a clear schema, a parser that already exists in most languages, and has comments.

[-] Andy@programming.dev 1 points 1 year ago

https://nestedtext.org/

It’s like yaml but simple, consistent, untyped, and you never need to escape any characters, ever.

Types and validation aren’t going to be great unless they’re in the actual code anyway.

[-] dmoonfire@kbin.social 0 points 1 year ago

Overall, JSON5 (having comments and end-of-line commas is a big reason I got into YAML).

I suffer with YAML, but use it pretty heavily. It also has the * and & operators which I use fairly heavily, and it fits well with the Markdown + YAML I use, but I hate that whitespace indenting with a passion.

Occasionally, I look at Nickle (https://github.com/tweag/nickel) and KDL (https://kdl.dev/) and I get really tempted, just haven't made that jump.

[-] AntiOutsideAktion@hexbear.net 0 points 1 year ago
[-] BitSound@lemmy.world 0 points 1 year ago
[-] JonnyRobbie@lemmy.world 2 points 1 year ago

Meh, at that point, you may as well use python.

[-] BitSound@lemmy.world 1 points 1 year ago

I like Python and use it a lot, but Dhall has several guarantees that Python doesn't. If you hand someone clever a Python interpreter, they can and will find a way to run rm -rf / or what-have-you, no matter what safeguards you put in place. Dhall also guarantees that it will terminate, which is pretty useful if you're embedding it in something else. In Python you could pretty easily accidentally or purposefully get into a while True loop.

this post was submitted on 15 Aug 2023
33 points (94.6% liked)

Technology

34973 readers
136 users here now

This is the official technology community of Lemmy.ml for all news related to creation and use of technology, and to facilitate civil, meaningful discussion around it.


Ask in DM before posting product reviews or ads. All such posts otherwise are subject to removal.


Rules:

1: All Lemmy rules apply

2: Do not post low effort posts

3: NEVER post naziped*gore stuff

4: Always post article URLs or their archived version URLs as sources, NOT screenshots. Help the blind users.

5: personal rants of Big Tech CEOs like Elon Musk are unwelcome (does not include posts about their companies affecting wide range of people)

6: no advertisement posts unless verified as legitimate and non-exploitative/non-consumerist

7: crypto related posts, unless essential, are disallowed

founded 5 years ago
MODERATORS