niceties 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a344de89699dbdc123ebe5cd16c0457e0b35b7ef3717db07348415b752b6b75
-  data.tar.gz: 3a4f87520eb6808cc9998720aa283f84a6841f9f5505f1d4d6faf02773314441
+  metadata.gz: 5303d182f90f15c71f74382af7747c3f59db95b71869c76558607575f16096d8
+  data.tar.gz: 587bb532dadde01c08f8ec563c0032adaa596d9bc7ee35ebc049735917ba0919
 SHA512:
-  metadata.gz: d05d3be08f1576176537516acedead938c049985e81a5e6ac143d90b3b1af477e2a95110da8209355630ecef5a9dd360f2c34e4bd12c0d2de5c3a28b7a4e53dd
-  data.tar.gz: e21eb52f1c78b876fb340f3b276eb210c1c96dacea0491f23d700e13e20e777e0fd98f4a5652c5f84f9433c5cf2711533283f6588a5b4ac44ca89b53e4ca0272
+  metadata.gz: 5f64b16ad027af13f3564e9f163c374f69ab68389fd1017b7e52254b0ae415541e504d7449c03ce860e113ed704a8f37aaba65aef1d8f83b56cfb6be73e2bd0e
+  data.tar.gz: 4fd2cd8131b9c76525abd11b7f986e1ec7f507efec8855a1c2215eda59a8e33cbaf584158c94aef2493da4d7cd457d3e1f8673c44c719f58b340e633a15a57e9

data/.gitignore

@@ -6,3 +6,5 @@
 /pkg/
 /spec/reports/
 /tmp/
+*.gem
+Gemfile.lock

data/README.md

@@ -21,6 +21,44 @@ You should be able to drop Niceties into your app and feel like it’s always be
 
 ---
 
+## What's on the Menu
+
+Niceties provides the following methods so far:
+
+### Object
+
+```rb
+# Object.try_each
+@user.try_each(:full_name, :nickname, :username) # instead of @user&.full_name || @user&.nickname || @user&.username
+
+# Object.coalesce
+@user.coalesce(:full_name, :nickname, "Valued Customer") # instead of @user&.full_name || @user&.nickname || "Valued Customer"
+
+# Object.not_a?
+@user.not_a? Widget # instead of !@user.is_a? Widget
+```
+
+### Array
+
+```rb
+# Array.tidy
+["", nil, 4].tidy => [4] # instead of ["", nil, 4].select { it.present? } 
+```
+
+### Numerics (Integer and Float)
+
+```rb
+# Integer.percent_of
+25.percent_of(200) => 50 # instead of (200 / 100.0) * 25
+
+# Float.percent_of
+16.6.percent_of(1000) => 166 # instead of (1000 / 100.0) * 16.6
+```
+
+More methods will be coming soon and contributions are very much welcomed!
+
+---
+
 ## 🫂 Contributing
 
 Niceties is open to anyone with an idea that makes Ruby or Rails feel better to use.

data/lib/niceties/array.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# Niceties for the Array class
+class Array
+  def tidy
+    select { it.present? }
+  end
+end

data/lib/niceties/float.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal:  true
+
+# Niceties for the Float class
+class Float
+  def percent_of(other)
+    (other / 100.0) * self
+  end
+end

data/lib/niceties/integer.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# Niceties for the Integer class
+class Integer
+  def percent_of(other)
+    (other / 100.0) * to_f
+  end
+end

data/lib/niceties/object.rb

@@ -1,9 +1,12 @@
+# frozen_string_literal: true
+
+# Niceties for the Object class
 class Object
   def not_a?(klass)
     !is_a?(klass)
   end
 
-  def try_all(*methods)
+  def try_each(*methods)
     methods.each do |method|
       result = try(method)
       return result unless result.nil?

data/lib/niceties/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Niceties
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/niceties.rb

@@ -4,6 +4,10 @@ require "active_support/core_ext/object/try"
 require "active_support/core_ext/object/blank"
 require_relative "niceties/version"
 require_relative "niceties/object"
+require_relative "niceties/array"
+require_relative "niceties/integer"
+require_relative "niceties/float"
 
+# See individual class files for implementations
 module Niceties
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: niceties
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Carl Dawson
@@ -23,8 +23,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
-description: Niceties is a carefully curated set of ergonomic Ruby and Rails extensions—small,
-  expressive methods that make code feel more natural and joyful to write.
+description: Niceties is a curated set of small, ergonomic and expressive methods
+  for Ruby and Rails.
 email:
 - email@carldaws.com
 executables: []
@@ -40,6 +40,9 @@ files:
 - bin/console
 - bin/setup
 - lib/niceties.rb
+- lib/niceties/array.rb
+- lib/niceties/float.rb
+- lib/niceties/integer.rb
 - lib/niceties/object.rb
 - lib/niceties/version.rb
 - sig/niceties.rbs