array_extend 1.0.0 → 1.1.0

data/README.md

@@ -18,30 +18,39 @@ Or install it yourself as:
 
 ## Usage
 
-* after(val)
+### after
 
 Return the value after the one pass in argument
 
 Demo
 
+```ruby
 	["hello", "world"].after("hello")	#=> "world"
 	["hello", "world"].after("world")	#=> nil
 	["hello", "world"].after("none")		#=> nil
+```
 
 Code
 
+```ruby
 	def after val
     	self[index(val) + 1] if self.include? val
 	end
+```
 
 
-* stealth_delete! *vals
-* stealth_delete *vals
+### stealth_delete
 
 Delete value(s) passed by, but return the array instead of the deleted value
 
+```ruby
+	stealth_delete! *vals
+	stealth_delete *vals
+```
+
 Demo
 
+```ruby
 	["ruby", "the", "programmer", "best", "friend"].stealth_delete! "ruby"
 	#=> ["the", "programmer", "best", "friend"] 
 	
@@ -50,15 +59,99 @@ Demo
 	
 	["ruby", "the", "programmer", "best", "friend"].stealth_delete! "hello"
 	#=> ["ruby", "the", "programmer", "best", "friend"]
+```
 
 Code
 
+```ruby
 	def stealth_delete! *vals
 	  vals.each do |val|
 	    delete val
 	  end
 	  return self
 	end
+```
+
+
+
+### tautology?
+
+Return true if all elements in array are presents. Usefull to check if all passed_by args are -really- presents for example. 
+
+Demo
+
+```ruby
+	[true, true, true].tautology?						#=> true
+	[true, false, true].tautology?						#=> false
+	[1, 2, "hello", "world", {:one => 1}].tautology?	#=> true
+	[1, 2, nil, "hello"].tautology?						#=> false
+	[1, 2, [], {}].tautology?							#=> false
+```
+
+Code
+
+```ruby
+	def tautology?
+  		self.inject(true){ |res, elt| res && elt.present? }
+	end
+```
+
+
+### compact_by
+
+Allow to compact, only by one side (right or left). Usefull to delete nil values to the end of an array
+BTW : I use here the rails "blank?" method, instead of the ruby "nil?" that is used in array#compact!
+
+```ruby
+	compact_by! side
+	compact_by side
+```
+
+Arguments : 'side' must be in %w{right left}
+
+Demo
+
+```ruby
+	
+	[nil, nil, "hello", "world", nil].compact_by :right
+	#=> [nil, nil, "hello", "world"]
+	
+	[nil, nil, "hello", "world", nil].compact_by :left
+	#=> ["hello", "world", nil]
+	
+	[nil, nil, "hello", nil, "world"].compact_by :left
+	#=> ["hello", nil, "world"]
+	
+	[nil, [], "hello", nil, "world"].compact_by :left
+	#=> #=> ["hello", "world"]
+	
+	["hello", "world"].compact_by :left
+	#=> ["hello", "world"]
+```
+
+Code
+
+```ruby
+	def compact_by! side
+		case side
+		when :right, "right"
+			while self.last.blank?
+				self.pop
+			end
+
+		when :left, "left"
+			while self.first.blank?
+				self.shift
+			end
+
+		else
+			raise ArgumentError, "'side' argument must be in %w{right left}"
+		end
+
+		self
+	end
+```
+
 
 ## Contributing
 

data/array_extend.gemspec

@@ -5,7 +5,7 @@ Gem::Specification.new do |gem|
   gem.authors       = ["Thomas Petrachi"]
   gem.email         = ["thomas.petrachi@vodeclic.com"]
   gem.description   = %q{Extend ruby Array. No override.}
-  gem.summary       = %q{Adding methods [:after, :stealth_delete]}
+  gem.summary       = %q{Adding methods %w{after stealth_delete tautology? compact_by}}
   gem.homepage      = "https://github.com/petrachi/array_extend"
 
   gem.files         = `git ls-files`.split($\)

data/lib/array_extend.rb

@@ -11,11 +11,35 @@ class Array
     vals.each do |val|
       delete val
     end
-    return self
   end
   
+  # maps an '&&' operation through all elements of array
+  def tautology?
+    self.inject(true){ |res, elt| res && elt.present? }
+  end
+  
+  # allow to compact by left side, or right side. this only delete the "extreme positioned" nils values
+  def compact_by! side
+    case side
+    when :right, "right"
+      while self.last.blank?
+        self.pop
+      end
+      
+    when :left, "left"
+      while self.first.blank?
+        self.shift
+      end
+    
+    else
+      raise ArgumentError, "'side' argument must be in %w{right left}"
+    end
+    
+    self
+  end
+
   # duplicate method without self modification
-  [:stealth_delete].each do |method_name|
+  [:stealth_delete, :compact_by].each do |method_name|
     define_method method_name do |*args|
       array = self.dup
       eval "array.#{ method_name }! *args"

data/lib/array_extend/version.rb

@@ -1,3 +1,3 @@
 module ArrayExtend
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: array_extend
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-29 00:00:00.000000000 Z
+date: 2012-09-30 00:00:00.000000000 Z
 dependencies: []
 description: Extend ruby Array. No override.
 email:
@@ -49,5 +49,5 @@ rubyforge_project:
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: Adding methods [:after, :stealth_delete]
+summary: Adding methods %w{after stealth_delete tautology? compact_by}
 test_files: []