NestedHashHelper

NestedHashHelper gem's aim is to make your life easier in dealing with nested hashes . If you have been working with Rails , You must have noted that You are dealing with nested hashes ( like params from the front end) a lot .

There are various methods added in the official Ruby code to handle nested hashes , but still it lacks lots of common and useful methods . NestedHashHelper aims to help you with those , so that you can deal with hashes easily in your application .

Development has just begun and is active and we will fix bugs , enhance functionality of existing methods and develop new methods in the upcoming version.

Usage

1) deep_except(*excluded_keys)

This method extends the functionality of except method of ruby hash to nested hash. pass any number of keys to delete them from the hash . Just pass the immediate key and not the entire key path in the hash .

Syntax

  a = {:name => "vivek" , :age => 22}  
  a.deep_except(:name)  
  output ==> {:age => 22}  

  a = {:user => {:name => "vivek" , :age => 22 , :phone => 3333}}  
  a.deep_except(:phone , :age)  
  output ==> {:user => {:name => "vivek"}}  

2) deep_delete_empty

This method deletes all the keys whose value is either empty or nil .

Syntax

   a =  {:user => {:name => "" , :age => 22 , :phone => 3333}}    
   a.deep_delete_empty  
   output ==> {:user => {:age => 22 , :phone => 3333}}  

3) find_depth

This method finds the depth of your nested hash.

Syntax

  a = {:user => {:name => {:last_name => "Vivek"}}}  
  a.find_depth  
  output ==> 3  

4) find_deep_intersection

This method returns intersection of two nested Hashes.

Syntax

   a = {:user => {:name => "vivek" , :age => 22 , :phone => 3333}}  
   b = {:user => {:name => "rakesh" , :age => 22 , :phone => 3333}}  
   a.find_deep_intersection(b)  
   output ==> {:user => {:age => 22 , :phone => 3333}}  

5) find_deep_keys

This method return all the parent keys of the corresponding value.

Syntax

   a = {:gh => {:jj => {:pop => "bbb" , :olo => "ooooo"}} , :pp => "ooooo"}  
   a.find_deep_keys("ooooo")  
   output ==> [:gh , :jj , :olo]  

Installation

Add this line to your application's Gemfile:

gem 'nested_hash_helper'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install nested_hash_helper

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Do Contribute if you come across any bugs / any important feature you feel is essential.

Bug reports and pull requests are welcome on GitHub at https://github.com/vivek3894/nested_hash_helper.

License

The gem is available as open source under the terms of the MIT License.