https://github.com/emancu/toml-rb
A parser for TOML using Citrus library.
https://github.com/emancu/toml-rb
Keywords from Contributors
sinatra grape rubygems static-code-analysis rubocop code-formatter rack ruby-gem activerecord oauth2-server
Last synced: about 2 hours ago
JSON representation
Repository metadata
A parser for TOML using Citrus library.
- Host: GitHub
- URL: https://github.com/emancu/toml-rb
- Owner: emancu
- License: mit
- Created: 2013-02-24T16:56:27.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2026-10-09T23:05:50.000Z (about 1 month ago)
- Last Synced: 2026-10-09T23:34:34.446Z (about 1 month ago)
- Language: Ruby
- Size: 433 KB
- Stars: 124
- Watchers: 3
- Forks: 40
- Open Issues: 1
- Releases: 36
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
README.md

toml-rb
A pure Ruby TOML parser and dumper with no runtime dependencies.
toml-rb implements TOML 1.1.0 and passes all toml-test v2.2.0 decoder tests for that version.
Installation
$ gem install toml-rb
Or add this line to your Gemfile:
gem "toml-rb", "~> 6.0"
Parser Usage
require 'toml-rb'
# From a file!
path = File.join(File.dirname(__FILE__), 'path', 'to', 'file')
TomlRB.load_file(path)
# From a stream!
stream = <<-EOS
title = "wow!"
[awesome]
you = true
others = false
EOS
TomlRB.parse(stream)
# => {"title"=>"wow!", "awesome"=>{"you"=>true, "others"=>false}}
# You want symbols as your keys? No problem!
TomlRB.load_file(path, symbolize_keys: true)
# Works the same for TomlRB.parse
# Local datetimes, dates and times are subclasses of Time. Offset datetimes are Time.
times = <<-EOS
odt = 1979-05-27T07:32:00Z
ldt = 1979-05-27T07:32:00
ld = 1979-05-27
lt = 07:32:00
EOS
TomlRB.parse(times).transform_values(&:class)
# => {"odt"=>Time, "ldt"=>TomlRB::LocalDateTime, "ld"=>TomlRB::LocalDate, "lt"=>TomlRB::LocalTime}
Dumper Usage
require 'toml-rb'
# Simple example
TomlRB.dump( simple: true)
# => "simple = true\n"
# Complex example
hash = {
"title"=>"wow!",
"awesome"=> {
"you"=>true,
"others"=>false
}
}
TomlRB.dump(hash)
# => "title = \"wow!\"\n[awesome]\nothers = false\nyou = true\n"
Conformance
toml-rb is exercised against the official
toml-test conformance suite for both
TOML 1.0.0 and TOML 1.1.0. The harness lives in:
tool/toml-test-decoder— toml-test decoder shim..github/workflows/conformance.yml— CI workflow (per-version matrix)..github/toml-test-skip-1.0.txtand.github/toml-test-skip-1.1.txt—
skip-lists of toml-test names for each spec version.
The TOML 1.1.0 skip-list is empty. The TOML 1.0.0 skip-list has 9 tests with
documents that TOML 1.0.0 forbids and TOML 1.1.0 allows. toml-rb accepts
TOML 1.1.0 syntax and has no option to select the spec version, so these tests
fail. CI runs toml-test with -skip-must-err, so the run fails when a skipped
test passes.
Contributing
- Fork it
- Create your feature branch
git checkout -b my-new-feature - Add tests and commit your changes
git commit -am 'Add some feature' - Run tests
$ rake - Push the branch
git push origin my-new-feature - Create new Pull Request
License
MIT License
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Owner metadata
- Name: Emiliano Mancuso
- Login: emancu
- Email: emiliano.mancuso@gmail.com
- Kind: user
- Description:
- Website:
- Location: London
- Twitter: emancu
- Company: @surgeventures
- Icon url: https://avatars.githubusercontent.com/u/56375?v=4
- Repositories: 60
- Last ynced at: 2026-11-10T15:09:53.525Z
- Profile URL: https://github.com/emancu
GitHub Events
Total
- Create event: 13
- Delete event: 9
- Fork event: 1
- Issue comment event: 4
- Issues event: 5
- Pull request event: 9
- Pull request review comment event: 1
- Push event: 21
- Release event: 1
- Watch event: 8
Last Year
- Create event: 8
- Delete event: 7
- Pull request event: 2
- Push event: 16
- Watch event: 1
Committers metadata
Last synced: 1 day ago
Total Commits: 373
Total Committers: 33
Avg Commits per committer: 11.303
Development Distribution Score (DDS): 0.306
Commits in past year: 49
Committers in past year: 4
Avg Commits per committer in past year: 12.25
Development Distribution Score (DDS) in past year: 0.122
| Name | Commits | |
|---|---|---|
| Emiliano Mancuso | e****o@g****m | 259 |
| tonchis | l****y@g****m | 38 |
| timcolonel | t****n@o****m | 16 |
| Raimonds Simanovskis | r****s@g****m | 9 |
| yassun | y****v@o****m | 8 |
| Jānis Vanags | j****s@g****m | 5 |
| Sgt_Sinky | 1****g | 3 |
| James White | d****e@g****m | 3 |
| Grey Baker | g****l@g****m | 3 |
| Vincent Gao | g****0@g****m | 2 |
| Artem Ignatyev | a****v@r****t | 2 |
| Bernard Lambeau | b****u@g****m | 2 |
| Shan-Yung Yang | s****g@r****m | 2 |
| Tim Smith | t****h@c****o | 2 |
| Alex Yang | a****9@g****m | 1 |
| Andrew Nesbitt | a****z@g****m | 1 |
| sjh9714 | 1****4 | 1 |
| jakecoffman | j****e@j****m | 1 |
| dreid | d****d@p****m | 1 |
| Tim Meusel | t****m@b****e | 1 |
| Stefan Sundin | g****t@s****m | 1 |
| Sigurd Ljødal | s****d@l****o | 1 |
| Ryan Fortman | r****n@p****m | 1 |
| Rolands Bondars | r****s@e****m | 1 |
| ReadmeCritic | f****t@g****m | 1 |
| Ole Reifschneider | m****l@o****e | 1 |
| Nicolas Leger | n****r | 1 |
| Nagesh A T | 7****p | 1 |
| Katsuhiko YOSHIDA | c****d@g****m | 1 |
| Jānis Liepa | j****a@e****m | 1 |
| and 3 more... | ||
Committer domains:
- eazybi.com: 2
- 4angle.com: 1
- yandex.ru: 1
- ole-reifschneider.de: 1
- parchment.com: 1
- ljodal.no: 1
- stefansundin.com: 1
- bastelfreak.de: 1
- pilot.com: 1
- jakecoffman.com: 1
- chef.io: 1
- rayark.com: 1
- riskmethods.net: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 74
Total pull requests: 104
Average time to close issues: 2 months
Average time to close pull requests: 13 days
Total issue authors: 34
Total pull request authors: 31
Average comments per issue: 1.7
Average comments per pull request: 0.8
Merged pull request: 94
Bot issues: 0
Bot pull requests: 0
Past year issues: 23
Past year pull requests: 36
Past year average time to close issues: about 2 months
Past year average time to close pull requests: about 9 hours
Past year issue authors: 3
Past year pull request authors: 4
Past year average comments per issue: 0.48
Past year average comments per pull request: 0.17
Past year merged pull request: 35
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- emancu (23)
- rsim (11)
- bararchy (5)
- AxelAtS (4)
- znz (2)
- kplimack (1)
- tsudoko (1)
- amon-sha (1)
- jakobs (1)
- funzoneq (1)
- markhallen (1)
- thavaahariharangit (1)
- dannystaple (1)
- Jefffrey (1)
- alvaromorales (1)
Top Pull Request Authors
- emancu (60)
- rsim (5)
- yassun4dev (4)
- jva (3)
- greysteil (2)
- timotheeguerin (2)
- shanyungyang (2)
- gaoflow (2)
- gogainda (2)
- tatzyr (1)
- bastelfreak (1)
- sjh9714 (1)
- rodzhers (1)
- ukalwa (1)
- jakecoffman (1)
Top Issue Labels
- enhancement (15)
- bug (10)
- wontfix (3)
Top Pull Request Labels
- hacktoberfest-accepted (1)
Package metadata
- Total packages: 12
-
Total downloads:
- rubygems: 153,054,127 total
- Total docker downloads: 875,560,538
- Total dependent packages: 63 (may contain duplicates)
- Total dependent repositories: 1,524 (may contain duplicates)
- Total versions: 96
- Total maintainers: 1
gem.coop: toml-rb
A TOML 1.1.0 parser and dumper.
- Homepage: https://github.com/emancu/toml-rb
- Documentation: http://www.rubydoc.info/gems/toml-rb/
- Licenses: MIT
- Latest release: 6.0.0 (published about 2 months ago)
- Last Synced: 2026-11-16T14:41:10.392Z (1 day ago)
- Versions: 43
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 76,525,217 Total
- Docker Downloads: 437,780,269
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.17%
- Docker downloads count: 0.271%
- Downloads: 0.41%
- Maintainers (1)
rubygems.org: toml-rb
A TOML 1.1.0 parser and dumper.
- Homepage: https://github.com/emancu/toml-rb
- Documentation: http://www.rubydoc.info/gems/toml-rb/
- Licenses: MIT
- Latest release: 6.0.0 (published about 2 months ago)
- Last Synced: 2026-11-16T18:04:33.093Z (1 day ago)
- Versions: 43
- Dependent Packages: 63
- Dependent Repositories: 1,524
- Downloads: 76,528,910 Total
- Docker Downloads: 437,780,269
-
Rankings:
- Docker downloads count: 0.335%
- Dependent packages count: 0.453%
- Downloads: 0.496%
- Dependent repos count: 0.792%
- Average: 1.947%
- Forks count: 4.188%
- Stargazers count: 5.42%
- Maintainers (1)
ubuntu-20.04: ruby-toml-rb
- Homepage: http://github.com/emancu/toml-rb
- Licenses: mit
- Latest release: 1.0.0-2 (published 9 months ago)
- Last Synced: 2026-08-28T07:32:24.962Z (3 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
debian-13: ruby-toml-rb
- Homepage: https://github.com/emancu/toml-rb
- Documentation: https://packages.debian.org/trixie/ruby-toml-rb
- Licenses: mit
- Latest release: 2.2.0-1 (published 9 months ago)
- Last Synced: 2026-09-16T12:30:11.863Z (2 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
debian-11: ruby-toml-rb
- Homepage: http://github.com/emancu/toml-rb
- Documentation: https://packages.debian.org/bullseye/ruby-toml-rb
- Licenses: mit
- Latest release: 1.0.0-2 (published 9 months ago)
- Last Synced: 2026-03-14T07:19:07.580Z (8 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
debian-10: ruby-toml-rb
- Homepage: http://github.com/emancu/toml-rb
- Documentation: https://packages.debian.org/buster/ruby-toml-rb
- Licenses: mit
- Latest release: 1.0.0-2 (published 9 months ago)
- Last Synced: 2026-03-14T03:02:25.666Z (8 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
ubuntu-23.04: ruby-toml-rb
- Homepage: https://github.com/emancu/toml-rb
- Licenses: mit
- Latest release: 2.2.0-1 (published 9 months ago)
- Last Synced: 2026-08-22T05:30:28.303Z (3 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
ubuntu-23.10: ruby-toml-rb
- Homepage: https://github.com/emancu/toml-rb
- Licenses: mit
- Latest release: 2.2.0-1 (published 9 months ago)
- Last Synced: 2026-09-06T06:30:42.088Z (2 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
ubuntu-24.10: ruby-toml-rb
- Homepage: https://github.com/emancu/toml-rb
- Licenses: mit
- Latest release: 2.2.0-1 (published 9 months ago)
- Last Synced: 2026-03-09T18:23:34.265Z (8 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
ubuntu-22.04: ruby-toml-rb
- Homepage: https://github.com/emancu/toml-rb
- Licenses: mit
- Latest release: 2.1.0-1 (published 9 months ago)
- Last Synced: 2026-03-13T23:40:29.204Z (8 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
debian-12: ruby-toml-rb
- Homepage: https://github.com/emancu/toml-rb
- Documentation: https://packages.debian.org/bookworm/ruby-toml-rb
- Licenses: mit
- Latest release: 2.2.0-1 (published 9 months ago)
- Last Synced: 2026-03-13T23:47:39.208Z (8 months ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Dependencies
- minitest ~> 5.7 development
- rake >= 0 development
- standard ~> 1.4 development
- citrus ~> 3.0, > 3.0
- actions/checkout v2 composite
- github/codeql-action/analyze v1 composite
- github/codeql-action/autobuild v1 composite
- github/codeql-action/init v1 composite
- actions/checkout v2 composite
- ruby/setup-ruby v1 composite
- actions/checkout v4 composite
- actions/setup-go v5 composite
- ruby/setup-ruby v1 composite
Score: 29.07630203629617