Open Menu
AllLocalCommunitiesAbout
lotide
AllLocalCommunitiesAbout
Login

Everything about TOML format - Orchard Dweller

⁨48⁩ ⁨likes⁩

Submitted ⁨⁨9⁩ ⁨months⁩ ago⁩ by ⁨ruffsl@programming.dev⁩ to ⁨programming@programming.dev⁩

https://www.youtube.com/watch?v=n9mGk8_tQtM

  • Visualizer:
    • toml-to-json.orchard.blog
  • Code:
    • github.com/orcharddweller/tom…
  • TOML spec:
    • toml.io/en/v1.0.0
source

Comments

Sort:hotnewtop
  • NewPerspective@lemmy.world ⁨9⁩ ⁨months⁩ ago

    TOML and YAML both have the problem that if you receive an incomplete document, there’s a decent chance you can’t tell. JSON doesn’t have that because of the closing curly.

    source
    • AMDmi3@lemmy.world ⁨9⁩ ⁨months⁩ ago

      That’s not a problem of a format and should be handled by transport or storage.

      source
      • Turun@feddit.de ⁨9⁩ ⁨months⁩ ago

        It very much is an aspect of the format. You may deem it unimportant, but it’s a feature that is missing from toml and yaml.

        source
        • -> View More Comments
      • NewPerspective@lemmy.world ⁨9⁩ ⁨months⁩ ago

        What about processes that terminate before writing the whole thing? You can’t protect against everything. Blame other processes all you want but the language spec allows for confusion.

        source
        • -> View More Comments
    • suy@programming.dev ⁨9⁩ ⁨months⁩ ago

      Doesn’t YAML have a (seldom used) feature of a start and end of document marker? The “YAML frontmatter” that a few markdown documents have, uses this.

      source
    • EmergMemeHologram@startrek.website ⁨9⁩ ⁨months⁩ ago

      On the other hand, I hate that with JSON you can only surge one document per file.

      Some programs allow you to omit the outside braces, others require it.

      But I do hate toml, and I don’t much like yaml either (why are there like 8 whitespace permutations?!)

      source
      • Azzk1kr@feddit.nl ⁨9⁩ ⁨months⁩ ago

        What’s wrong with TOML? I personally think it’s great for configuration purposes.

        source
        • -> View More Comments
    • RubberElectrons@lemmy.world ⁨9⁩ ⁨months⁩ ago

      Good point, I’d been interested in using toml

      source
  • xmunk@sh.itjust.works ⁨9⁩ ⁨months⁩ ago

    I really don’t understand why people still insist on prohibiting trailing commas anywhere. The syntax is interesting but it looks like defining an array of objects would be needlessly difficult.

    source
    • eager_eagle@lemmy.world ⁨9⁩ ⁨months⁩ ago

      but… trailing commas are ok in TOML.

      The double square bracket is for an array of tables. A regular array looks “normal”: toml.io/en/v1.0.0#array

      source
  • brettvitaz@programming.dev ⁨9⁩ ⁨months⁩ ago

    Every time I have reached for TOML I have ended up using JSON. The first reason is that Python standard library can read but not write TOML, which is generally useless for me. The second reason is all values are strings. The third reason is TOML does not add any benefit over JSON. It’s not that much easier to read and IMO JSON is easier to write by hand because the syntax rules are completely obvious.

    source
    • eager_eagle@lemmy.world ⁨9⁩ ⁨months⁩ ago

      TOML is mainly for humans to write, certainly not a good choice if you’re programmatically writing files - comments and formatting would be lost.

      source
      • brettvitaz@programming.dev ⁨9⁩ ⁨months⁩ ago

        So it’s good for things that don’t change, or things you have to change by hand, which gives it almost zero utility for any project that I’ve worked on.

        source
        • -> View More Comments
      • Flipper@feddit.de ⁨9⁩ ⁨months⁩ ago

        It all depends on the library you use. Rust has you covered with toml_edit. It is what is used for all the cargo commands editing the Cargo.toml file.

        source
  • rutrum@lm.paradisus.day ⁨9⁩ ⁨months⁩ ago

    Just gonna throw out HJSON as another alternative: hjson.github.io

    I thinks a great idea but I have never seen it used in the wild, unforunately.

    source
  • matcha_addict@lemy.lol ⁨9⁩ ⁨months⁩ ago

    Why would one pick toml over yaml?

    source
    • corsicanguppy@lemmy.ca ⁨9⁩ ⁨months⁩ ago

      Xkcd 927?

      source
      • gornius@lemmy.world ⁨9⁩ ⁨months⁩ ago

        What?

        It’s simple and readable. You literally put somebody that has never coded in their life, show them the YAML file and they will probably get it.

        In Toml there are too many ways to do the same thing, which I don’t like. Also unless you know it deeply, you have no idea how the underlying data structure is going to look.

        source
        • -> View More Comments
      • matcha_addict@lemy.lol ⁨9⁩ ⁨months⁩ ago

        Yaml is already pretty popular, so I don’t think 927 applies here. It’s actually more common in newer projects than toml.

        Which begs the question, should I go with the flow or is there good reason to go with toml?

        source
    • eager_eagle@lemmy.world ⁨9⁩ ⁨months⁩ ago

      XML < YAML < TOML

      noyaml.com

      source
    • jkrtn@lemmy.ml ⁨9⁩ ⁨months⁩ ago

      Perhaps they’re Norwegian.

      source
    • Lmaydev@programming.dev ⁨9⁩ ⁨months⁩ ago

      Significant whitespace is the devil’s play thing.

      source
  • Fisherswamp@programming.dev ⁨9⁩ ⁨months⁩ ago

    The code link is cut off for me

    source
    • NostraDavid@programming.dev ⁨9⁩ ⁨months⁩ ago

      github.com/orcharddweller/toml-to-json

      source
  • QuazarOmega@lemy.lol ⁨9⁩ ⁨months⁩ ago

    I like the syntax so much, but I’m so missing variables like the ones in ConfigParser’s .ini format, I wish there was a good format where they’re actually standard

    source
  • mrh@mander.xyz ⁨9⁩ ⁨months⁩ ago

    I’ll never understand why we don’t just use s-expressions.

    source