ruby_collections 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c0462986d07093cf4ecca10470680ebbafcda8d9
-  data.tar.gz: f722323cd43f7b4d5f4abb4301dfd2fb9ae57fd5
+  metadata.gz: 34ab0c58c7947f07aa41aedecd63bb6cb93891da
+  data.tar.gz: bc4baeb4df6f7b1bcaeb0932791c449dbfa48382
 SHA512:
-  metadata.gz: 5a78827b01c0fd4fc5fd2908d5f668d35f341236dce3fbd5018ce652c332fe5da1976fa47d4c730e81fadd50109b1a787a8f1f87a6e9e04acd4bc9d2a83d300a
-  data.tar.gz: 96b622b4028421d8624f3536e9a2d36d6540f6b0de02a5f8b7ee387d7330e895508dcb5d2ded53ff82b058b6c41ebf430651ff2c670870e1bfc30667476d945a
+  metadata.gz: f019fb61c75a57552a9442e1ef97f735f9329c02c5fb5e5e5b6390ae8aa3aac772a29be1908b7deef5b46237fe80554e8de026a45c842b673c79912651f34b24
+  data.tar.gz: c9b8b9192ef07cc1f53b2d39cd0db21d108d7d479041a4831665789f7dbf9c4c64847cd7314d9c6d30ed5f64d990366e39858fa01666621f31398e41fa8a2935

data/README.md

@@ -1,6 +1,6 @@
 # RubyCollections
 
-Welcome to ruby_collections gem. This gem will provide you with an easy access to common data structures to be used in ruby language.
+Welcome to ruby_collections gem. This gem will provide you with an easy access to common data structures to be used in Ruby Language.
 
 ## Installation
 
@@ -20,7 +20,7 @@ Or install it yourself as:
 
 ## Usage
 
-Supported Data Structures: Max Heap, Min Heap, Stack, LinkedList, Deque
+Supported Data Structures: Max Heap, Min Heap, Stack, LinkedList, Deque, UnionFind
 
 ### RubyCollections::MaxHeap
 
@@ -156,6 +156,30 @@ list.remove_last # list: [10, 2]
 
 ```
 
+### RubyCollections::UnionFind
+
+```ruby
+
+# initialization takes an array argument. each element should have a to_s method defined which should return uniq val
+
+uf = RubyCollections::UnionFind.new (1..8).to_a 
+
+uf.union(1,3) # joins 1 and 3 and returns the leader
+
+uf.union(5,6) # joins 5 and 6 and returns the leader
+
+uf.union(2,4) # joins 2 and 4 and returns the leader
+
+uf.union(1,7) # joins 1 and 7 and returns the leader
+
+uf.find(7) # leader of the cluster containing 7
+
+uf.to_a  # => [[1, 3, 7], [2, 4], [5, 6], [8]] i.e. returns array of all clusters
+
+uf.cluster(1) # => [1, 3, 7] i.e. returns all elements in same cluster as of 1
+
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/ruby_collections/collections.rb

@@ -2,4 +2,5 @@ require "ruby_collections/max_heap"
 require "ruby_collections/min_heap"
 require "ruby_collections/stack"
 require "ruby_collections/linked_list"
-require "ruby_collections/deque"
+require "ruby_collections/deque"
+require "ruby_collections/union_find"

data/lib/ruby_collections/deque.rb

@@ -2,6 +2,9 @@ require 'securerandom'
 module RubyCollections
   class Deque
 
+    #TODO: implement iterator
+    #TODO: implement to_a
+
     def initialize
       @hash = {size: 0, front: {data: nil, next: :rear, prev: nil}, 
               rear: {data: nil, next: nil, prev: :front}}

data/lib/ruby_collections/linked_list.rb

@@ -2,6 +2,9 @@ module RubyCollections
   class LinkedList
     attr_accessor :size, :top
 
+    #TODO: implement iterator
+    #TODO: implement to_a
+
     def initialize
       @size = 0
       @top = nil

data/lib/ruby_collections/stack.rb

@@ -1,6 +1,9 @@
 module RubyCollections
   class Stack
 
+    #TODO: implement iterator
+    #TODO: implement to_a
+
     def initialize(arr = [])
       @arr = arr
     end

data/lib/ruby_collections/union_find.rb

@@ -0,0 +1,62 @@
+module RubyCollections
+  class UnionFind
+    def initialize(arr)
+      @leadership_hash = {}; @count = {}; @orig_val = {}
+      arr.each   {|elem| set_hash(elem, elem); set_size(elem, 0); @orig_val[elem.to_s] = elem}
+    end
+
+    def find(elem)
+      elem = get_hash(elem) while get_hash(elem) != elem
+      return elem
+    end
+
+    def union(elem1, elem2)
+      leader1 = find(elem1)
+      leader2 = find(elem2)
+      unless leader1 == leader2
+        size(leader1) > size(leader2) ? set_hash(leader2, leader1) : set_hash(leader1, leader2)
+      end
+    end
+
+    def to_a
+      hash.keys.each do |key|
+        leader = find(key)
+        uf_hash[leader.to_s] = uf_hash.fetch(leader.to_s, []) << @orig_val[key]
+      end
+      uf_hash.values
+    end
+
+    def cluster(elem)
+      leader = find(elem)
+      cluster = []
+      hash.keys.each {|key| cluster << @orig_val[key] if find(key) == leader}
+      cluster
+    end
+
+    private
+
+    def set_hash(key, value)
+      @leadership_hash[key.to_s] = value
+    end
+
+    def get_hash(key)
+      @leadership_hash[key.to_s]
+    end
+
+    def hash
+      @leadership_hash
+    end
+
+    def size(elem)
+      @count[elem.to_s]
+    end
+
+    def set_size(elem, val)
+      @count[elem.to_s] = val
+    end
+
+    def uf_hash
+      @uf_hash ||= {}
+    end
+  end
+end

data/lib/ruby_collections/version.rb

@@ -1,3 +1,3 @@
 module RubyCollections
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_collections
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Vikash Vikram
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-04-10 00:00:00.000000000 Z
+date: 2015-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -63,6 +63,7 @@ files:
 - lib/ruby_collections/max_heap.rb
 - lib/ruby_collections/min_heap.rb
 - lib/ruby_collections/stack.rb
+- lib/ruby_collections/union_find.rb
 - lib/ruby_collections/version.rb
 - ruby_collections.gemspec
 homepage: https://github.com/vikashvikram/ruby_collections