Hacker News new | ask | show | jobs
by SushiHippie 1048 days ago
Is there a reason, why the __pyproject__ variable is not a dict but a toml string?
4 comments

I think they do kind of answer that under the "Why not use (possibly restricted) Python syntax?".

I understand their reasoning to be that it would require other tools to know how to parse python. Which is much more difficult than parsing toml

Ah okay, I read this but I've understood it in another way. I thought they meant using multiple variables could become a problem. But I guess it makes some sense to not parse the python ast tree but to parse with a regex.
It's probably because pyproject.toml is the direction in which the python ecosystem is going.

On that note, I will never understand why they chose .toml instead of just json or yaml..

> On that note, I will never understand why they chose .toml instead of just json or yaml..

https://peps.python.org/pep-0518/#other-file-formats

Thanks this also gave another reason why they didn't use a dict for configuration https://peps.python.org/pep-0518/#python-literals
YAML is only fun when you're not tripping in the numerous landmines in the way: https://noyaml.com/
I think "easy for humans to edit" is where I mostly disagree with. To this day I have not worked with anyone that understood the .toml format.
Hey. I think I understand the .toml format. What do you want to know?
How much time have you spent towards TOML vs -- say -- YAML?

More editable than JSON and far simpler than YAML.

---

The Rust ecosystem also uses TOML.

YAML is one of the most ambiguous formats out there, and definitely an overkill for what's needed to describe metadata.

JSON - not the most convenient to use for human beings, too much quoting, not too git friendly because of disallowed trailing commas, etc.

TOML sits somewhere inbetween, easy to write but the spec is very short; also being used in Rust and a few other places.

Yes, but you can write a pyproject toml file also as a python dictionary.

Instead of:

[project] requires-python = ">=3.11" dependencies = [ "requests<3", "rich", ]

You could write:

{ "project": { "requires-python":">=3.11", "dependencies" : [ "requests<3", "rich" ] }

No way !

Gotta think carefully about this... Might upset some coworkers

Maybe because then you can just inline a pyproject text without any extra effort and the existing tooling for pyproject parsing can work in both cases?
Yeah copying a pyproject.toml seems like a valid case. But I'd guess that the toml will be parsed to something like a dict anyway after reading the file/string.
It does seem like over-complicating things for a dynamic language not to use itself as the standard configuration format.