Popularity
2.2
Growing
Activity
0.0
Stable
123
4
29

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: 122,305
Programming language: Ruby
License: MIT License
Tags: Configuration     Parsers     Toml     File Formats    
Latest version: v0.2.0

TOML alternatives and similar gems

Based on the "Parsers" category

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.0.3"

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).