Deep Struct

A library to access nested hashes and arrays in an object oriented way.

Requires Ruby 1.9.3 or higher

data = [
  { one: 1, two: 2 },
  { "array": [ "string", "another"] },
  { "nested": [ { "name" => "Sue" } ] },
]

deep_struct = DeepStruct.from_data(data)

deep_struct[0].one               # => 1
deep_struct[0].two               # => 2
deep_struct[1].array             # => ["string", "another"]
deep_struct[2].nested.first.name # => "Sue"

Note that DeepStruct does its best to return nested DeepStruct objects, even when accessed through contained arrays. It accomplishes this by returning DeepStruct::Array or DeepStruct::Hash objects.

DeepStruct can also load data files from the filesystem:

DeepStruct.from_file("./data.json")
DeepStruct.from_file("./data.yaml")

# Gemfile
gem "deep_struct"

Please submit them via github issues.

If you have any suggestions on how to improve DeepStruct please suggest them through the issues system.

In order to work on DeepStruct you first need to fork and clone the repo. Please do any work on a dedicated branch and rebase against master before sending a pull request.

No submissions will be accepted without specs.

Copyright (c) 2009-2012 Thunderbolt Labs. See LICENSE for details.