niceties 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a864755de9a566ad580394e72820ea1f9d824b5f5a54997494198ad984b50c7b
-  data.tar.gz: 1dad3eb338a74c7ea1eef8b486a5dac9d188ca0483fde5c2cac12abeb06d7c0e
+  metadata.gz: 0a9ad3ee3ee46696a6666807b885e63a91aa712b498fc1a40e5a15504c12802d
+  data.tar.gz: e53b14269f544e47be8cf5fe1824faf37320460e7549fb60eb9b88ed1ba1ddc1
 SHA512:
-  metadata.gz: 7adf9811df2dc492c67768bb5b20076f6651c543231ce94794174b765d88d32e259af2867397ebcf4dcd9c7cada88d892522325045dc38dc7b6bfa2658988052
-  data.tar.gz: ea59ade372a556e0455b5847f0c905816f908ea0cc206d0034e1c6159cf2cc912ae48f97ddf1a01e11c2c4b4eadeeda68c491ad40ac174f82af83d3bd9e6ca68
+  metadata.gz: 4c0ef7842dba7bd9a6ef8b594707a2fb5d698b892848ea86c7fd6f1e9d611af40d2e414d9736e4bb579af8689efc8804d69f1c129a8c13ac323bdd18a38a3cc9
+  data.tar.gz: 67f149fa184f53744fdc857edcc3652b33c0fa00c76040c050cb6ac24561a5624c05da14163ce277325eb72a8eafdef64707ae06532840c8dcf60f8eecc61368

data/Gemfile

@@ -9,5 +9,6 @@ gem "irb"
 gem "rake", "~> 13.0"
 
 gem "minitest", "~> 5.16"
+gem "ostruct"
 
 gem "rubocop", "~> 1.21"

data/README.md

@@ -1,87 +1,57 @@
 # Niceties
 
-Niceties is a curated collection of small, thoughtful additions to Rails.
-Nothing fancy, nothing heavy — just expressive, elegant helpers that make
-everyday code smoother and more joyful.
+Small, expressive helpers for Ruby and Rails. The kind of thing you'd monkey-patch in your own app — given a permanent home.
 
-It’s the kind of thing you might monkey-patch in your own app and forget about. Niceties gives those private little helpers a permanent, public home.
+## Installation
 
----
-
-## ✨ Philosophy
-
-Niceties is built on a few quiet principles:
-
-- **Ergonomics matter.** Tiny syntax improvements compound across projects and years.
-- **Less is more.** This isn’t a kitchen sink. Every addition is judged by feel.
-- **No surprises.** If you have to explain what it’s doing, it probably doesn’t belong here.
-- **Ruby’s voice, not ours.** Every method should *read* like Ruby. Nothing flashy, nothing clever for its own sake.
-
-You should be able to drop Niceties into your app and feel like it’s always been there.
-
----
-
-## What's on the Menu
+```ruby
+gem 'niceties'
+```
 
-Niceties provides the following methods so far:
+## Methods
 
 ### Object
 
-```rb
-# Object.try_each
-@user.try_each(:full_name, :nickname, :username) # instead of @user&.full_name || @user&.nickname || @user&.username
+```ruby
+@user.try_each(:full_name, :nickname, :username)
+# => returns first non-nil result
 
-# Object.coalesce
-@user.coalesce(:full_name, :nickname, "Valued Customer") # instead of @user&.full_name || @user&.nickname || "Valued Customer"
+@user.coalesce(:full_name, :nickname, "Guest")
+# => returns first present result, or fallback
 
-# Object.not_a?
-@user.not_a? Widget # instead of !@user.is_a? Widget
+@user.not_a?(Widget)
+# => true if not a Widget
 ```
 
 ### Array
 
-```rb
-# Array.tidy
-["", nil, 4].tidy => [4] # instead of ["", nil, 4].select { it.present? } 
+```ruby
+["", nil, 4].tidy
+# => [4]
 ```
 
-### 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
+### Numeric
 
-# Numeric.plus_or_minus
-5.plus_or_minus(2) => 3..7 # instead of (5-2)..(5+2)
+```ruby
+25.percent_of(200)          # => 50
+5.plus_or_minus(2)          # => 3..7
+5.plus_upto(2)              # => 5..7
+5.minus_upto(2)             # => 3..5
 ```
 
-### Time
+### Time, Date, DateTime
 
-```rb
-User.where(created_at: Time.current.minus_upto(1.hour))
-```
-
-More methods will be coming soon and contributions are very much welcomed!
-
----
-
-## 🫂 Contributing
+```ruby
+Time.current.plus_or_minus(1.hour)   # => Range
+Time.current.plus_upto(1.hour)       # => now..future
+Time.current.minus_upto(1.hour)      # => past..now
 
-Niceties is open to anyone with an idea that makes Ruby or Rails feel better to use.
-
-If you’ve ever written a helper method and thought:
-
-> _"This is too small for a gem, but I wish it lived somewhere..."_
-
-That’s exactly what Niceties is for.
+(Time.current + 1.day).future?       # => true
+(Time.current - 1.day).past?         # => true
+```
 
-**Guiding questions for contributors:**
+## Contributing
 
-- Does this make everyday code more readable or expressive?
-- Does it align with Ruby’s style and philosophy?
-- Would I be delighted if this existed in the language?
+If you've written a helper and thought "this is too small for a gem" — that's what Niceties is for.
 
-If yes — open a PR or start a discussion.
+PRs welcome if the method is readable, unsurprising, and feels like Ruby.

data/lib/niceties/core_ext/array/tidy.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/object/blank"
+
+class Array
+  def tidy
+    select(&:present?)
+  end
+end

data/lib/niceties/core_ext/array.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "array/tidy"

data/lib/niceties/core_ext/date/plus_or_minus.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "date"
+require_relative "../numeric/plus_or_minus"
+
+class Date
+  include Numeric::PlusOrMinus
+end

data/lib/niceties/core_ext/date/tenses.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "date"
+require_relative "../time/tenses"
+
+class Date
+  include Time::Tenses
+end

data/lib/niceties/core_ext/date.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "date/plus_or_minus"
+require_relative "date/tenses"

data/lib/niceties/core_ext/date_time/plus_or_minus.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "date"
+require_relative "../numeric/plus_or_minus"
+
+class DateTime
+  include Numeric::PlusOrMinus
+end

data/lib/niceties/core_ext/date_time/tenses.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "date"
+require_relative "../time/tenses"
+
+class DateTime
+  include Time::Tenses
+end

data/lib/niceties/core_ext/date_time.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "date_time/plus_or_minus"
+require_relative "date_time/tenses"

data/lib/niceties/core_ext/numeric/percent_of.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class Numeric
+  def percent_of(other)
+    (other / 100.0) * to_f
+  end
+end

data/lib/niceties/core_ext/numeric/plus_or_minus.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Numeric::PlusOrMinus
+  def plus_or_minus(amount)
+    (self - amount)..(self + amount)
+  end
+
+  def plus_upto(amount)
+    self..(self + amount)
+  end
+
+  def minus_upto(amount)
+    (self - amount)..self
+  end
+end
+
+class Numeric
+  include Numeric::PlusOrMinus
+end

data/lib/niceties/core_ext/numeric.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "numeric/percent_of"
+require_relative "numeric/plus_or_minus"

data/lib/niceties/core_ext/object/not_a.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class Object
+  def not_a?(klass)
+    !is_a?(klass)
+  end
+end

data/lib/niceties/core_ext/object/try_each.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/object/try"
+require "active_support/core_ext/object/blank"
+
+class Object
+  def try_each(*methods)
+    methods.each do |method|
+      result = try(method)
+      return result unless result.nil?
+    end
+
+    nil
+  end
+
+  def coalesce(*messages)
+    *methods, fallback = messages
+
+    methods.each do |method|
+      result = try(method)
+      return result if result.present?
+    end
+
+    fallback.is_a?(Symbol) ? try(fallback) : fallback
+  end
+end

data/lib/niceties/core_ext/object.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "object/not_a"
+require_relative "object/try_each"

data/lib/niceties/core_ext/time/plus_or_minus.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "../numeric/plus_or_minus"
+
+class Time
+  include Numeric::PlusOrMinus
+end

data/lib/niceties/core_ext/time/tenses.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/time/calculations"
+
+module Time::Tenses
+  def future?
+    self > Time.current
+  end
+
+  def past?
+    self < Time.current
+  end
+end
+
+class Time
+  include Time::Tenses
+end

data/lib/niceties/core_ext/time.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "time/plus_or_minus"
+require_relative "time/tenses"

data/lib/niceties/core_ext.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "core_ext/object"
+require_relative "core_ext/array"
+require_relative "core_ext/numeric"
+require_relative "core_ext/time"
+require_relative "core_ext/date"
+require_relative "core_ext/date_time"

data/lib/niceties/version.rb

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

data/lib/niceties.rb

@@ -1,41 +1,7 @@
 # frozen_string_literal: true
 
-require "date"
-require "active_support/core_ext/object/try"
-require "active_support/core_ext/object/blank"
 require_relative "niceties/version"
-require_relative "niceties/plus_or_minus"
-require_relative "niceties/not_a"
-require_relative "niceties/try_each"
-require_relative "niceties/percent_of"
-require_relative "niceties/tidy"
+require_relative "niceties/core_ext"
 
-# See included modules for implementations
 module Niceties
 end
-
-class Object
-  include Niceties::NotA
-  include Niceties::TryEach
-end
-
-class Array
-  include Niceties::Tidy
-end
-
-class Numeric
-  include Niceties::PlusOrMinus
-  include Niceties::PercentOf
-end
-
-class Time
-  include Niceties::PlusOrMinus
-end
-
-class Date
-  include Niceties::PlusOrMinus
-end
-
-class DateTime
-  include Niceties::PlusOrMinus
-end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: niceties
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Carl Dawson
@@ -40,11 +40,24 @@ files:
 - bin/console
 - bin/setup
 - lib/niceties.rb
-- lib/niceties/not_a.rb
-- lib/niceties/percent_of.rb
-- lib/niceties/plus_or_minus.rb
-- lib/niceties/tidy.rb
-- lib/niceties/try_each.rb
+- lib/niceties/core_ext.rb
+- lib/niceties/core_ext/array.rb
+- lib/niceties/core_ext/array/tidy.rb
+- lib/niceties/core_ext/date.rb
+- lib/niceties/core_ext/date/plus_or_minus.rb
+- lib/niceties/core_ext/date/tenses.rb
+- lib/niceties/core_ext/date_time.rb
+- lib/niceties/core_ext/date_time/plus_or_minus.rb
+- lib/niceties/core_ext/date_time/tenses.rb
+- lib/niceties/core_ext/numeric.rb
+- lib/niceties/core_ext/numeric/percent_of.rb
+- lib/niceties/core_ext/numeric/plus_or_minus.rb
+- lib/niceties/core_ext/object.rb
+- lib/niceties/core_ext/object/not_a.rb
+- lib/niceties/core_ext/object/try_each.rb
+- lib/niceties/core_ext/time.rb
+- lib/niceties/core_ext/time/plus_or_minus.rb
+- lib/niceties/core_ext/time/tenses.rb
 - lib/niceties/version.rb
 - sig/niceties.rbs
 homepage: https://github.com/carldaws/niceties
@@ -61,14 +74,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.3
 specification_version: 4
 summary: A collection of thoughtful Ruby and Rails helpers.
 test_files: []

data/lib/niceties/not_a.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-module Niceties
-  # Niceties for determining object classes
-  module NotA
-    def not_a?(klass)
-      !is_a?(klass)
-    end
-  end
-end

data/lib/niceties/percent_of.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-module Niceties
-  # Niceties for calculating percentages
-  module PercentOf
-    def percent_of(other)
-      (other / 100.0) * to_f
-    end
-  end
-end

data/lib/niceties/plus_or_minus.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-module Niceties
-  # Niceties for creating ranges
-  module PlusOrMinus
-    def plus_or_minus(amount)
-      (self - amount)..(self + amount)
-    end
-
-    def plus_upto(amount)
-      self..(self + amount)
-    end
-
-    def minus_upto(amount)
-      (self - amount)..self
-    end
-  end
-end

data/lib/niceties/tidy.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-module Niceties
-  # Niceties for removing blanks from Arrays
-  module Tidy
-    def tidy
-      select { it.present? }
-    end
-  end
-end

data/lib/niceties/try_each.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module Niceties
-  # Niceties for trying multiple methods
-  module TryEach
-    def try_each(*methods)
-      methods.each do |method|
-        result = try(method)
-        return result unless result.nil?
-      end
-
-      nil
-    end
-
-    def coalesce(*messages)
-      *methods, fallback = messages
-
-      methods.each do |method|
-        result = try(method)
-        return result if result.present?
-      end
-
-      fallback.is_a?(Symbol) ? try(fallback) : fallback
-    end
-  end
-end