Popularity
2.7
Stable
Activity
0.0
Stable
149
4
37

Description

A sane configuration format from @mojombo. This is far superior to YAML and JSON because it doesn't suck. Really it doesn't.

Code Quality Rank: L4
Monthly Downloads: 82,388
Programming language: Ruby
License: MIT License
Tags: Configuration     Parsers     Toml     File Formats    
Latest version: v0.3.0

TOML alternatives and similar gems

Based on the "Parsers" category.
Alternatively, view TOML alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of TOML or a related project?

Add another 'Parsers' Gem

README

TOML

A sane configuration format from @mojombo. More information here: https://github.com/mojombo/toml

This is far superior to YAML and JSON because it doesn't suck. Really it doesn't.

Usage

Add to your Gemfile:

gem "toml", "~> 0.3.0"

It's simple, really.

content = <<-TOML

# Hello, this is an example.
[things]
other = "things"
what = 900000

TOML

parser = TOML::Parser.new(content).parsed
# => { "things" => { "other" => "things", "what" => 900000 } }

You can also use the same API as YAML if you'd like:

TOML.load("thing = 9")
# => {"thing" => 9}

TOML.load_file("my_file.toml")
# => {"whatever" => "keys"}

There's also a beta feature for generating a TOML file from a Ruby hash. Please note this will likely not give beautiful output right now.

hash = {
  "integer" => 1,
  "float" => 3.14159,
  "true" => true,
  "false" => false,
  "string" => "hi",
  "array" => [[1], [2], [3]],
  "key" => {
    "group" => {
      "value" => "lol"
    }
  }
}
doc = TOML::Generator.new(hash).body
# doc will be a string containing a proper TOML document.

Contributors

Written by Jeremy McAnally (@jm) and Dirk Gadsden (@dirk) based on TOML from Tom Preston-Werner (@mojombo).