rubyhelper 0.2.4 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c821c362cc1520ecfca8057736a2822960fc33f8
-  data.tar.gz: 1dae1f8ac6991d29c0cacdff681d7f991f140255
+  metadata.gz: c44208355c233532a223344b7f61ad48060b0e1e
+  data.tar.gz: f6080e470235dd504cc5c77f745d23694bdc5200
 SHA512:
-  metadata.gz: 299aca8153165eb7a6d15ae623360484ccfa622d31153e993b55115d8eadfcf5c0e52848eadc51472a31e91bda9543dec987b64a390348f143b202c37a78654e
-  data.tar.gz: f102e264cd1602530f42fb698299a8e83f01bc945fbf764b326663284957bab21b1ca0c161e0f5cf705e15f1c55077c87ca2982d381daeb47338d6f9dc8b2500
+  metadata.gz: 1a1bf0cba4dcbb66382590317ecbb0bc159dc8b48fb67a16ebeea18d9b63d25b2ff2451dc11f04faf0bdc1b07ba40ae851527608129907194e61206d30457a3e
+  data.tar.gz: 0fda05d5b7c5b9cc6fbeb6d15a218795e47d58c62e984e9d2839be43b8ab777f7ccfda6e1950c7e8f110b8877b097fe801b9532b8db0ce4418a56398b2ecb67c

data/lib/rubyhelper/arrayhelper.rb

@@ -2,24 +2,6 @@
 
 module ArrayHelper
 
-  # A simple function like to_s(), but return a clean String
-  # for exemple :
-  #    [1,2,3].to_clean_s(" ; ")
-  # => "1 ; 2 ; 3"
-  # ==Parameters:
-  #   sep:
-  #   A String to separe each element (or an Array, see to_clean_s_with_array)
-  def to_clean_s(sep=' ')
-    return to_clean_s_with_array(sep) if sep.is_a?Array
-    to_clean_s_with_string(sep.to_s)
-  end
-  
-  def to_clean_s_with_string sep
-    str = String.new
-    self.each{|e| str = str + e.to_s + sep.to_s}
-    return str[0..(-sep.size - 1)]
-  end
-  
   # You can use an array as separator : [",", " "] will successively ',' and ' '
   def to_clean_s_with_array sep
     str = String.new
@@ -31,27 +13,38 @@ module ArrayHelper
     return str[0..(-sep.size - 1)]
   end
 
+  # Do the sum of an array of integer.
+  # if there is not integer, it will do a to_s.to_i of the element to try
+  # find an integer in the element. else, replace by a simple 0
   def sum
     return (self.size > 0) ? (self.map{|e| e.to_s.to_i}.reduce(:+)) : (0)
   end
 
+  # lke sum by with a to_f instead of to_i
   def sumf
     return (self.size > 0) ? (self.map{|e| e.to_s.to_f}.reduce(:+)) : (0.0)
   end
 
+  # Use the sum and divide by the size of the array. 0 if no element.
   def average
     return (self.size > 0) ? (self.sum / self.size) : (0)
   end
 
+  # Same than average but use to_f instead of to_i
   def averagef
     return (self.size > 0) ? (self.sumf / self.size.to_f) : (0.0)
   end
 
-  #TODO benchmark with sort{|e| -e}
+  # get the n higher values of the array
   def maxs(n=1)
     return Array(self.sort[(-n)..(-1)])
   end
 
+  # get the n lower values of the array
+  def mins(n=1)
+    return Array(self.sort[0..(n-1)])
+  end
+
 end
 
 class Array

data/lib/rubyhelper/integerhelper.rb

@@ -3,6 +3,7 @@
 
 module IntegerHelper
 
+  # get - or + function of the sign of the integer
   def sign
     return (self < 0) ? ("-") : ("+")
   end

data/lib/rubyhelper/stringhelper.rb

@@ -5,35 +5,56 @@ require 'digest'
 
 module StringHelper
 
-  def to_plain(case_mod = nil)
-    string = self.tr(
-      "ÀÁÂÃÄÅàáâãäåĀāĂ㥹ÇçĆćĈĉĊċČčÐðĎďĐđÈÉÊËèéêëĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħÌÍÎÏìíîïĨĩĪīĬĭĮįİıĴĵĶķĸĹĺĻļĽľĿŀŁłÑñŃńŅņŇňʼnŊŋÒÓÔÕÖØòóôõöøŌōŎŏŐőŔŕŖŗŘřŚśŜŝŞşŠšſŢţŤťŦŧÙÚÛÜùúûüŨũŪūŬŭŮůŰűŲųŴŵÝýÿŶŷŸŹźŻżŽž",
-      "AAAAAAaaaaaaAaAaAaCcCcCcCcCcDdDdDdEEEEeeeeEeEeEeEeEeGgGgGgGgHhHhIIIIiiiiIiIiIiIiIiJjKkkLlLlLlLlLlNnNnNnNnnNnOOOOOOooooooOoOoOoRrRrRrSsSsSsSssTtTtTtUUUUuuuuUuUuUuUuUuUuWwYyyYyYZzZzZz")
+  # == Params
+  #     case_mod: nil (not changement), :upcase, :capitalize or :downcase
+  #     replace: if a char is not utf8 valid, character will replace it
+  # Remove accents from the string. Change the case as first argument
+  def to_plain(case_mod = nil, replace= " ")
+    s = self.encode("UTF-8", :invalid=>:replace, :replace=>replace).tr("ÀÁÂÃÄÅàáâãäåĀāĂ㥹ÇçĆćĈĉĊċČčÐðĎďĐđÈÉÊËèéêëĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħÌÍÎÏìíîïĨĩĪīĬĭĮįİıĴĵĶķĸĹĺĻļĽľĿŀŁłÑñŃńŅņŇňʼnŊŋÒÓÔÕÖØòóôõöøŌōŎŏŐőŔŕŖŗŘřŚśŜŝŞşŠšſŢţŤťŦŧÙÚÛÜùúûüŨũŪūŬŭŮůŰűŲųŴŵÝýÿŶŷŸŹźŻżŽž",
+                                                                       "AAAAAAaaaaaaAaAaAaCcCcCcCcCcDdDdDdEEEEeeeeEeEeEeEeEeGgGgGgGgHhHhIIIIiiiiIiIiIiIiIiJjKkkLlLlLlLlLlNnNnNnNnnNnOOOOOOooooooOoOoOoRrRrRrSsSsSsSssTtTtTtUUUUuuuuUuUuUuUuUuUuWwYyyYyYZzZzZz")
+    return s.to_case(case_mod)
+  end
+
+  #to_plain alias
+  def p
+    return self.to_plain
+  end
+
+  # == Params
+  #     case_mod: nil (not changement), :upcase, :capitalize or :downcase
+  # permit to do upcase/downcase/capitalize easier with a simple param
+  def to_case(case_mod = :downcase)
     case case_mod
     when :upcase
-      return string.upcase
+      return self.upcase
     when :downcase
-      return string.downcase
+      return self.downcase
+    when :capitalize
+      return self.capitalize
     else
-      return string
+      return self
     end
   end
 
-  def to_case(case_mod = :downcase)
-    if case_mod == :upcase
-      return self.to_plain.upcase
-    else
-      return self.to_plain.downcase
+  # == Params
+  #     replace: a caracter to replace non-ascii chars
+  #     case_mod: nil (not changement), :upcase, :capitalize or :downcase
+  # return a simple ascii string. Invalid characters will be replaced by "replace" (argument)
+  def to_ascii(replace="", case_mod = nil)
+    s = String.new
+    self.to_plain.each_char do |c|
+      s += ((c.ord > 255) ? (replace.to_s) : (c))
     end
+    return s.to_case(case_mod)
   end
 
-  def to_ascii(case_mod = :upcase)
-    return to_case(case_mod)
-  end
-
+  # improvement of to_f to count "," caracter as "."
   def to_f
+    s = self.dup
     self.gsub!(',', '.')
-    super
+    f = super
+    self.replace(s)
+    return f
   end
 
   #To_i with delimiter
@@ -55,7 +76,10 @@ module StringHelper
     Digest::SHA2.hexdigest(self)
   end
 
-  #STATIC
+  # ==Param
+  #     n: number of char
+  #     char: char to replace if the initial str is too short
+  # Get a str with a static length
   def static(n, char=' ')
     if self.size < n
       return self + char * (n - self.size).to_i
@@ -64,12 +88,15 @@ module StringHelper
     end
   end
 
-  #Returns true or false
+  #Returns true or false if the string if "true" or "false"
   def to_t
-    if self == "true"
+    case self
+    when "true"
       return true
-    else
+    when "false"
       return false
+    else
+      return nil
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubyhelper
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.4.0
 platform: ruby
 authors:
 - poulet_a
@@ -50,6 +50,6 @@ rubyforge_project:
 rubygems_version: 2.4.1
 signing_key: 
 specification_version: 4
-summary: to_int / float
+summary: add to_plain
 test_files: []
 has_rdoc: