creative_rails_utilities 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 659c881b3a274cfde2d12897738873d28251e418
-  data.tar.gz: 3f02b2a1c7371c4f63cf0dcef947c2dbbe12d336
+  metadata.gz: df58ca7b40c5342a60e7870b8dc7eb7981a5658e
+  data.tar.gz: ac593955b0f0414407b126202593840fd96b12a1
 SHA512:
-  metadata.gz: b33798102b44262376951f6380247d0b2bf54abfce0f071f06bf5ae5d85eb4c63e6dd1ed93a01da8179bc2179ea05d9a3bd96ed45699e263731291b4eda66682
-  data.tar.gz: 7eae1eab13c24e4bf4e4ef06d62b55754ec7bd1fe59f712f1c6a49577093d77d10bcc5a559d2bbefd878d9158d3b20d0337d405b55860e42a21bf0079e14ff02
+  metadata.gz: 96eb6862958090754f5c7d6dc40a0a32ff52db575dbfc594ee2006d0c4939c512a9ce114c80784907a8ff2fe54d79661fbd822b67a6803e71327c3224dcd848d
+  data.tar.gz: 472ec2660a18dda63c7eb0fee2694fa287cc5cd1067cf525add8d2d5ebf23dd1d60826bc29a195b34583fe6c7141f2d12d0616ced5c495746c5d65361976ece8

data/CHANGELOG.md

@@ -8,7 +8,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 -
 ```
 
-## [0.3.5] - 2016-04-22
+## [0.4.1] - 2016-05-02
+### Added
+- Numeric#safe_per
+
+## [0.4.0] - 2016-04-22
 ### Added
 - Hash#dig via 'ruby_dig' dep
 

data/README.md

@@ -12,67 +12,6 @@ Intended for `Rails >= 4.0.0`, but will probably work for older projects with ro
 
 Feel free to read the source under `/lib/creative_rails_utilities/` and peruse the method "it" lines under `/spec`
 
-#### View Helpers
-Rails-only (via railtie) view helpers have been added, they are automagically loaded and usable upon gem inclusion.
-
-##### relative_time_parse(earlier_time, later_time=optional)
-turns a timestamp into "time ago" format.  
-Examples:
-
-```ruby
-# If used with only one argument, will default the second argument to Time.now
-# at "2015-01-15 12:00".to_datetime
-
-relative_time_parse("2015-01-15 12:00".to_datetime)
-#=> {key: "now", count: nil}
-relative_time_parse("2015-01-15 11:59:59".to_datetime)
-#=> {key: "second", count: nil}
-relative_time_parse("2015-01-15 11:59:58".to_datetime)
-#=> {key: "seconds", count: "1"}
-relative_time_parse("2015-01-15 11:59:00".to_datetime)
-#=> {key: "minute", count: nil}
-relative_time_parse("2015-01-15 11:58:00".to_datetime)
-#=> {key: "minutes", count: "2"}
-relative_time_parse("2015-01-15 11:00".to_datetime)
-#=> {key: "hour", count: nil}
-relative_time_parse("2015-01-15 09:00".to_datetime)
-#=> {key: "hours", count: "3"}
-relative_time_parse("2015-01-14 11:00".to_datetime)
-#=> {key: "day", count: nil}
-relative_time_parse("2015-01-10 09:00".to_datetime)
-#=> {key: "days", count: 5}
-
-# if used with both arguments, expects the second to be later than the first and will calculate relative time between them
-relative_time_parse("2015-01-01 12:00".to_datetime, "2015-01-01 12:02".to_datetime)
-#=> {key: "minutes", count: "2"}
-```
-
-The keys are intended to be used together with `I18n.t`  
-Sample yaml for English
-
-```yml
-en:
-  time:
-    now: "just now"
-    second: "a second ago"
-    seconds: "%{count} seconds ago"
-    minute: "a minute ago"
-    minutes: "%{count} minutes ago"
-    hour: "an hour ago"
-    hours: "%{count} hours ago"
-    day: "a day ago"
-    days: "%{count} days ago"
-```
-
-Then you can write a simple helper that specifies localization key location and returns the correct value based on the hash returned by `relative_time_parse`
-```ruby
-def relative_short_time(t1, t2=nil)
-  hash = relative_time_parse(t1, t2)
-  count_hash = hash.count.present? ? hash.except(:key): {}
-  return I18n.t("time.#{hash[:key]}", count_hash)
-end
-```
-
 ##### Date
 
 ```ruby
@@ -150,6 +89,15 @@ some_hash.fast_sort_keys #=> some_sorted_hash
 0.safe_percent(0) #=> 0
 ```
 
+```ruby
+# get a portion even when deleting with zero
+# whole.safe_per(part)
+100.safe_per(50) #=> 2.0
+3.12.safe_per(2.6) #=> 1.2
+1.safe_per(3) #=> 0.3333333333333333
+0.safe_per(0) #=> 0
+```
+
 ```ruby
 # transform a Numeric that denotes seconds into a hash of how many :days, :hours, :minutes ad :seconds that is
 61.5.to_time_hash #=> {days: 0, hours: 0, minutes: 1, seconds: 1.5}
@@ -191,6 +139,67 @@ string #=> "1..." instead of "  1..."
 "y".to_bool #=> true
 ```
 
+#### View Helpers
+Rails-only (via railtie) view helpers have been added, they are automagically loaded and usable upon gem inclusion.
+
+##### relative_time_parse(earlier_time, later_time=optional)
+turns a timestamp into "time ago" format.  
+Examples:
+
+```ruby
+# If used with only one argument, will default the second argument to Time.now
+# at "2015-01-15 12:00".to_datetime
+
+relative_time_parse("2015-01-15 12:00".to_datetime)
+#=> {key: "now", count: nil}
+relative_time_parse("2015-01-15 11:59:59".to_datetime)
+#=> {key: "second", count: nil}
+relative_time_parse("2015-01-15 11:59:58".to_datetime)
+#=> {key: "seconds", count: "1"}
+relative_time_parse("2015-01-15 11:59:00".to_datetime)
+#=> {key: "minute", count: nil}
+relative_time_parse("2015-01-15 11:58:00".to_datetime)
+#=> {key: "minutes", count: "2"}
+relative_time_parse("2015-01-15 11:00".to_datetime)
+#=> {key: "hour", count: nil}
+relative_time_parse("2015-01-15 09:00".to_datetime)
+#=> {key: "hours", count: "3"}
+relative_time_parse("2015-01-14 11:00".to_datetime)
+#=> {key: "day", count: nil}
+relative_time_parse("2015-01-10 09:00".to_datetime)
+#=> {key: "days", count: 5}
+
+# if used with both arguments, expects the second to be later than the first and will calculate relative time between them
+relative_time_parse("2015-01-01 12:00".to_datetime, "2015-01-01 12:02".to_datetime)
+#=> {key: "minutes", count: "2"}
+```
+
+The keys are intended to be used together with `I18n.t`  
+Sample yaml for English
+
+```yml
+en:
+  time:
+    now: "just now"
+    second: "a second ago"
+    seconds: "%{count} seconds ago"
+    minute: "a minute ago"
+    minutes: "%{count} minutes ago"
+    hour: "an hour ago"
+    hours: "%{count} hours ago"
+    day: "a day ago"
+    days: "%{count} days ago"
+```
+
+Then you can write a simple helper that specifies localization key location and returns the correct value based on the hash returned by `relative_time_parse`
+```ruby
+def relative_short_time(t1, t2=nil)
+  hash = relative_time_parse(t1, t2)
+  count_hash = hash.count.present? ? hash.except(:key): {}
+  return I18n.t("time.#{hash[:key]}", count_hash)
+end
+```
+
 ## Development
 Use ruby >=2.1
 

data/lib/creative_rails_utilities/numeric.rb

@@ -43,6 +43,12 @@ class Numeric
     end
   end
 
+  def safe_per(parts)
+    return 0 if self == 0 || parts == 0
+
+    return self.to_f/parts.to_f
+  end
+
   def to_time_hash
     mm, ss = self.divmod(60)
     hh, mm = mm.divmod(60)

data/lib/creative_rails_utilities/version.rb

@@ -1,3 +1,3 @@
 module CreativeRailsUtilities
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: creative_rails_utilities
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Creative
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-04-27 00:00:00.000000000 Z
+date: 2016-05-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport