niceties 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5303d182f90f15c71f74382af7747c3f59db95b71869c76558607575f16096d8
-  data.tar.gz: 587bb532dadde01c08f8ec563c0032adaa596d9bc7ee35ebc049735917ba0919
+  metadata.gz: 0a9ad3ee3ee46696a6666807b885e63a91aa712b498fc1a40e5a15504c12802d
+  data.tar.gz: e53b14269f544e47be8cf5fe1824faf37320460e7549fb60eb9b88ed1ba1ddc1
 SHA512:
-  metadata.gz: 5f64b16ad027af13f3564e9f163c374f69ab68389fd1017b7e52254b0ae415541e504d7449c03ce860e113ed704a8f37aaba65aef1d8f83b56cfb6be73e2bd0e
-  data.tar.gz: 4fd2cd8131b9c76525abd11b7f986e1ec7f507efec8855a1c2215eda59a8e33cbaf584158c94aef2493da4d7cd457d3e1f8673c44c719f58b340e633a15a57e9
+  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,78 +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)
+### Numeric
 
-```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
+```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
 ```
 
-More methods will be coming soon and contributions are very much welcomed!
-
----
-
-## 🫂 Contributing
+### Time, Date, DateTime
 
-Niceties is open to anyone with an idea that makes Ruby or Rails feel better to use.
+```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
 
-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/{integer.rb → core_ext/numeric/percent_of.rb}

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
-# Niceties for the Integer class
-class Integer
+class Numeric
   def percent_of(other)
     (other / 100.0) * to_f
   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/{object.rb → core_ext/object/try_each.rb}

@@ -1,11 +1,9 @@
 # frozen_string_literal: true
 
-# Niceties for the Object class
-class Object
-  def not_a?(klass)
-    !is_a?(klass)
-  end
+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)

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.2.0"
+  VERSION = "0.4.0"
 end

data/lib/niceties.rb

@@ -1,13 +1,7 @@
 # frozen_string_literal: true
 
-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"
+require_relative "niceties/core_ext"
 
-# 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.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Carl Dawson
@@ -40,10 +40,24 @@ 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/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
@@ -60,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/array.rb

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

data/lib/niceties/float.rb

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