Why YAML sucks?

heikkiket@programming.dev to Programming@programming.dev – 1 points –

I feel that Yaml sucks. I understand the need for such markup language but I think it sucks. Somehow it's clunky to use. Can you explain why?

66

You are viewing a single comment

Any language in which whitespace has syntactic value is intrinsically flawed.

Can't speak to your specific issues, but that's why yaml will always suck.

As a serialization format, agree 100%, but would Python really be better if it switched to braces?

Yes, I think so. The downside with Python comes when refactoring the code. There’s always this double checking if the code is correctly indented after the refactor. Sometimes small mistakes creep in.

It’s really hard to tell when Python code is incorrectly indented. It’s often still valid Python code, but you can’t tell if it’s wrong unless you know the intention of the code.

In order languages it’s always obvious when code is incorrectly indented. There’s no ambiguity.

Can address it by writing code that doesn't depend much on indentation, which also makes code more linear and easier to follow.

It’s only hard to tell indentation in Python when the code block gets longer than about a screen, which is usually a sign the code should be refactored into smaller methods.

Or a sign you should get a bigger screen 😂 (j/k)

People hate hearing that they are bad coders 😂

You and the other guy are saying to focus on writing code with less indentation and using smaller methods, and you both got downvoted.

I fully agree, small methods all the way, and when that's not possible it's time to refactor into possibility!

I think this is just familiarity. I never have issues with indentation, but when refactoring js I'm always like hey who's fucking brace is this

would Python really be better if it switched to braces?

Yes. A thousand times, yes.

Yes it would - look at optional braces for short if expressions in C family languages and why it's so discouraged in large projects. Terminating characters are absolutely worth the cost of an extra LoC

I started in C before moving on to C++, Java, Ruby and Python.

I’ve had more bugs from missing braces than from misaligned whitespace because the latter is far more obvious when looking at a block of code.

Compilation error or run time errors? One is a gift and the other is a curse.

False dichotomy. Optional braces are bad practice because they mislead the programmer that is adding an additional clause to the block.

This misleading behavior wouldn't happen in Python, as it would either be invalid syntax, or it would be part of the block.

Indentation problems are pretty obvious to the reader. Even more than missing or unbalanced braces.

That misleading behavior does happen in Python. The next programmer that comes along can’t tell if the original programmer fucked it up and didn’t unindent to put a statement outside of the block or if they meant to put it inside the block. I’ve debugged this one too many times and it takes hours each time because it’s impossible to see the bug at all!!

The misleading behavior is about what you expect to execute in the source code you're looking at vs what's actually executed.

What you describe is a logic ambiguity that can happen in any program / language.

I don’t agree. It’s a direct result of whitespace, which does not happen if you don’t use whitespace. For example it can happen in Java and kotlin, but only if you use if statements without braces, which you pretty much never see. If you do see it you know to look out for the exact issue I described. That’s not possible in Python, since there is no alternative.

They may be obvious to the reader but they may be impossible to see if tabs and spaces are mixed together.

Closing tokens are always clearer.

YAML sucks because, among other things, indenting it is not obvious.

In contrast, the only mistake of Python when it comes to whitespaces was allowing hard tabs, which makes it too easy to mix them if your editor is not configured.

Improper indentation stands out more than missing or unbalanced braces and it's really not an issue to delimit code blocks.

Hard tabs are the only accessible option though. If you care about developers with a different vision capability than yours, the only correct indentation choice is tabs.

If, because of bad vision, someone needs to crank the font size way up, it’s very possible that they might need to work with a tabstop of 3, 2, or even just 1 space.

With tabs, this is user configurable. With spaces it isn’t.

In any modern editor it is configurable with spaces too

What “it” is configurable? If the code is indented with 4 spaces, it is indented with 4 spaces. You can configure your editor to indent with 1 space if you want, but then your code is not going to respect the 4 spaces of indentation used by the rest of the code.

I repeat, the only accessible indentation option is using tabs. This is not an opinion because every other option forces extra painful steps for those with vision issues (including, but not limited to, having to reformat the source files to tabs so they can work on them and then reformat them back to using spaces in order to commit them)

I now use Scala 3, and very happy with syntactic whitespace (combined with an intelligent compiler)