AnyHash is a library created to help with traversing and manipulation of
nested Hash structures.
Add this to your application's shard.yml:
dependencies:
any_hash:
github: sija/any_hash.crrequire "any_hash"AnyHash::JSON is ready-to-use JSON friendly version of Hash.
It takes care of casting immutable types to their mutable equivalents:
Tuple→ArrayNamedTuple→Hash
# possibly coming from `**options` argument, could be a `Hash` too
options = {
status: :published,
tags: {"crystal", "ruby", "sweet"},
context: {
user: {
id: 123,
}
}
}
# convert any Hash or NamedTuple to `AnyHash::JSON` via `Object#to_any_json`
options = options.to_any_json
# return underlying `Hash`
options.to_h # => {:status => :published, :tags => ["crystal", "ruby", "sweet"], :context => {:user => {:id => 123}}}
# access direct descendant value
options[:status] # => :published
options[:status].class # => Symbol
typeof(options[:status]) # => (Array(AnyHash::JSONTypes::Value) | Bool | Float32 | Float64 | Hash(String | Symbol, AnyHash::JSONTypes::Value) | Int16 | Int32 | Int64 | Int8 | Set(AnyHash::JSONTypes::Value) | String | Symbol | Time | UInt16 | UInt32 | UInt64 | UInt8 | Nil)
# access nested structures with key path
options[:context, :user, :id] # => 123
# `#[]` is an alias for `#dig`, same for `#[]?` -> `#dig?`
options[:context, :system, :os]? # => nil
options.dig?(:context, :system, :os) # => nil# `#[]=` works with single keys and key paths
options[:featured] = true
options[:context, :user, :role] = :editor
defaults = {
difficulty: :easy,
status: :draft,
featured: false,
tags: [] of String,
context: {} of Symbol => String
}
# merge defaults in-place
options.reverse_merge!(defaults)
# or return a copy with applied changes
settings = options.reverse_merge(defaults)
# merge nested structures
options.merge! context: {user: {email: "[email protected]"}}
# or single values
options.merge! id: 420AnyHash.define_new klass: :DegreesOfLogic,
key: Symbol | String,
value: Bool
DegreesOfLogic.new({ there: { are: { many: { truths: true, or: false }}}})Run specs with:
crystal spec
- Fork it ( https://github.com/sija/any_hash.cr/fork )
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create a new Pull Request
- sija Sijawusz Pur Rahnama - creator, maintainer