module Tomlrb

Constants

VERSION

Public Class Methods

load_file(path, **options) click to toggle source

Reads a file content and parses it into its Ruby data structure

@param path [String] the path to the file @param options [Hash] the options hash @option options [Boolean] :symbolize_keys (false) whether to return the keys as symbols or strings @return [Hash] the Ruby data structure represented by the input

# File lib/tomlrb.rb, line 37
def self.load_file(path, **options)
  # By default Ruby sets the external encoding of an IO object to the
  # default external encoding. The default external encoding is set by
  # locale encoding or the interpreter -E option.
  tmp = File.read(path, :encoding=>'utf-8')
  Tomlrb.parse(tmp, options)
end

parse(string_or_io, **options) click to toggle source

Parses a valid TOML string into its Ruby data structure

@param string_or_io [String, StringIO] the content @param options [Hash] the options hash @option options [Boolean] :symbolize_keys (false) whether to return the keys as symbols or strings @return [Hash] the Ruby data structure represented by the input

# File lib/tomlrb.rb, line 18
def self.parse(string_or_io, **options)
  io = string_or_io.is_a?(String) ? StringIO.new(string_or_io) : string_or_io
  scanner = Scanner.new(io)
  parser = Parser.new(scanner, options)
  begin
    handler = parser.parse
  rescue Racc::ParseError => e
    raise ParseError, e.message
  end

  handler.output
end