whenwords 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b632b8d1b88e484cd487236d6f074de258636bbc8485fe633c57f4d0da3a20a
-  data.tar.gz: 2c3dd46ebccb057efd996a6c13c287f8a216509ae9037e46d19c37b0ee57026d
+  metadata.gz: 3bd67c93384599212636f8539189dec434b1c0e3c0fb78ecf9b31039df9560f4
+  data.tar.gz: 577b977de38168eb4863dad6384ed0ffdcfe03a3cc0becee46ac9c61092161c7
 SHA512:
-  metadata.gz: f4c62f91e2837875c537c3b2f3fc51fb7f9a7c2855da99e4cd41fd61f4ca6392166da376ddd0b3294a18a39b856fa7cfb6a7ec95f6eb3d520422ce5b7f91cac6
-  data.tar.gz: ff07da6df5d2cc3d719019cf309916ac29627c3f974058bf12ea9bdb29de8be6ae4a945ea35111dfa4694b06bcdc7661e8a2006209e958e243fd05b673a8be36
+  metadata.gz: 150a6aea8bd49cbb182e405ad8d6a2e2bdab29087b4a207d2865ddc9e9447b5babfe45342cc61dcf1390089b7232f8077e4678e460aadefa657b44f16808dde1
+  data.tar.gz: fd1481665e27708fc22e4f86c781d7cc2b22193e40fe5c5680871182e214cddbe133645c68a5cdde34d97a79f7b31ea95d68bcb7c1a8f49527d6f8772a685bb4

data/README.md

@@ -275,7 +275,11 @@ To install this gem onto your local machine, run `bundle exec rake install`.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/dbreunig/whenwords.
+Bug reports and pull requests are welcome on GitHub at https://github.com/ZPVIP/whenwords.
+
+## Credits
+
+This Ruby gem is an implementation of the [whenwords specification](https://github.com/dbreunig/whenwords) by Drew Breunig — "An Open Source Library Without Code".
 
 ## License
 

data/lib/whenwords/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Whenwords
-  VERSION = "0.1.0"
+  VERSION = '0.1.1'
 end

data/lib/whenwords.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require "time"
-require_relative "whenwords/version"
+require 'time'
+require_relative 'whenwords/version'
 
 module Whenwords
   class Error < StandardError; end
@@ -9,10 +9,10 @@ module Whenwords
 
   SECONDS_PER_MINUTE = 60
   SECONDS_PER_HOUR = 3600
-  SECONDS_PER_DAY = 86400
-  SECONDS_PER_WEEK = 604800
-  SECONDS_PER_MONTH = 2592000  # 30 days
-  SECONDS_PER_YEAR = 31536000  # 365 days
+  SECONDS_PER_DAY = 86_400
+  SECONDS_PER_WEEK = 604_800
+  SECONDS_PER_MONTH = 2_592_000  # 30 days
+  SECONDS_PER_YEAR = 31_536_000  # 365 days
 
   WEEKDAY_NAMES = %w[Sunday Monday Tuesday Wednesday Thursday Friday Saturday].freeze
   MONTH_NAMES = %w[January February March April May June July August September October November December].freeze
@@ -45,12 +45,12 @@ module Whenwords
       ref = reference.nil? ? ts : normalize_timestamp(reference)
 
       diff = ref - ts
-      future = diff < 0
+      future = diff.negative?
       diff = diff.abs
 
       text = calculate_timeago_text(diff)
 
-      if text == "just now"
+      if text == 'just now'
         text
       elsif future
         "in #{text.sub(/ ago$/, '')}"
@@ -65,13 +65,13 @@ module Whenwords
     # @param max_units [Integer] Maximum number of units to display
     # @return [String] Human-readable duration
     def duration(seconds, compact: false, max_units: 2)
-      raise Error, "Duration cannot be negative" if seconds.negative?
-      raise Error, "Duration cannot be NaN" if seconds.respond_to?(:nan?) && seconds.nan?
-      raise Error, "Duration cannot be infinite" if seconds.respond_to?(:infinite?) && seconds.infinite?
+      raise Error, 'Duration cannot be negative' if seconds.negative?
+      raise Error, 'Duration cannot be NaN' if seconds.respond_to?(:nan?) && seconds.nan?
+      raise Error, 'Duration cannot be infinite' if seconds.respond_to?(:infinite?) && seconds.infinite?
 
       seconds = seconds.to_f
 
-      return compact ? "0s" : "0 seconds" if seconds.zero?
+      return compact ? '0s' : '0 seconds' if seconds.zero?
 
       units = calculate_duration_units(seconds)
       non_zero_units = units.select { |_, v| v.positive? }
@@ -90,20 +90,18 @@ module Whenwords
     # @param string [String] The duration string to parse
     # @return [Numeric] Duration in seconds
     def parse_duration(string)
-      raise ParseError, "Duration string cannot be empty" if string.nil? || string.strip.empty?
+      raise ParseError, 'Duration string cannot be empty' if string.nil? || string.strip.empty?
 
       input = string.strip.downcase
 
       # Check for negative values
-      raise ParseError, "Negative durations are not allowed" if input.include?("-")
+      raise ParseError, 'Negative durations are not allowed' if input.include?('-')
 
       # Try colon notation first
-      if input.match?(/^\d+:\d{1,2}(:\d{1,2})?$/)
-        return parse_colon_notation(input)
-      end
+      return parse_colon_notation(input) if input.match?(/^\d+:\d{1,2}(:\d{1,2})?$/)
 
       total = parse_duration_parts(input)
-      raise ParseError, "No parseable duration units found" if total.zero? && !input.match?(/\b0\s*[a-z]/)
+      raise ParseError, 'No parseable duration units found' if total.zero? && !input.match?(/\b0\s*[a-z]/)
 
       total
     end
@@ -123,11 +121,11 @@ module Whenwords
 
       case diff_days
       when 0
-        "Today"
+        'Today'
       when -1
-        "Yesterday"
+        'Yesterday'
       when 1
-        "Tomorrow"
+        'Tomorrow'
       when -6..-2
         "Last #{WEEKDAY_NAMES[ts_date.wday]}"
       when 2..6
@@ -159,27 +157,27 @@ module Whenwords
     def calculate_timeago_text(diff)
       case diff
       when 0...45
-        "just now"
+        'just now'
       when 45...90
-        "1 minute ago"
+        '1 minute ago'
       when 90...(45 * 60)
         "#{(diff / 60.0).round} minutes ago"
       when (45 * 60)...(90 * 60)
-        "1 hour ago"
+        '1 hour ago'
       when (90 * 60)...(22 * 3600)
         "#{(diff / 3600.0).round} hours ago"
       when (22 * 3600)...(36 * 3600)
-        "1 day ago"
-      when (36 * 3600)...(26 * 86400)
-        "#{(diff / 86400.0).round} days ago"
-      when (26 * 86400)...(46 * 86400)
-        "1 month ago"
-      when (46 * 86400)...(320 * 86400)
-        "#{(diff / (30.44 * 86400)).round} months ago"
-      when (320 * 86400)...(548 * 86400)
-        "1 year ago"
+        '1 day ago'
+      when (36 * 3600)...(26 * 86_400)
+        "#{(diff / 86_400.0).round} days ago"
+      when (26 * 86_400)...(46 * 86_400)
+        '1 month ago'
+      when (46 * 86_400)...(320 * 86_400)
+        "#{(diff / (30.44 * 86_400)).round} months ago"
+      when (320 * 86_400)...(548 * 86_400)
+        '1 year ago'
       else
-        "#{(diff / (365.0 * 86400)).round} years ago"
+        "#{(diff / (365.0 * 86_400)).round} years ago"
       end
     end
 
@@ -213,34 +211,34 @@ module Whenwords
 
     def format_compact_duration(units)
       abbreviations = {
-        years: "y",
-        months: "mo",
-        days: "d",
-        hours: "h",
-        minutes: "m",
-        seconds: "s"
+        years: 'y',
+        months: 'mo',
+        days: 'd',
+        hours: 'h',
+        minutes: 'm',
+        seconds: 's'
       }
 
-      units.map { |unit, value| "#{value}#{abbreviations[unit]}" }.join(" ")
+      units.map { |unit, value| "#{value}#{abbreviations[unit]}" }.join(' ')
     end
 
     def format_verbose_duration(units)
       units.map do |unit, value|
         unit_name = unit.to_s
-        unit_name = unit_name.chomp("s") if value == 1
+        unit_name = unit_name.chomp('s') if value == 1
         "#{value} #{unit_name}"
-      end.join(", ")
+      end.join(', ')
     end
 
     def parse_colon_notation(input)
-      parts = input.split(":").map(&:to_i)
+      parts = input.split(':').map(&:to_i)
 
       if parts.length == 2
         # h:mm
-        parts[0] * SECONDS_PER_HOUR + parts[1] * SECONDS_PER_MINUTE
+        (parts[0] * SECONDS_PER_HOUR) + (parts[1] * SECONDS_PER_MINUTE)
       else
         # h:mm:ss
-        parts[0] * SECONDS_PER_HOUR + parts[1] * SECONDS_PER_MINUTE + parts[2]
+        (parts[0] * SECONDS_PER_HOUR) + (parts[1] * SECONDS_PER_MINUTE) + parts[2]
       end
     end
 
@@ -263,7 +261,7 @@ module Whenwords
         end
       end
 
-      raise ParseError, "No parseable duration units found" unless found_any
+      raise ParseError, 'No parseable duration units found' unless found_any
 
       total.round
     end
@@ -277,14 +275,18 @@ module Whenwords
     end
 
     def format_date_range(start_date, end_date)
+      start_month = MONTH_NAMES[start_date.month - 1]
+      end_month = MONTH_NAMES[end_date.month - 1]
+
       if start_date == end_date
-        "#{MONTH_NAMES[start_date.month - 1]} #{start_date.day}, #{start_date.year}"
+        "#{start_month} #{start_date.day}, #{start_date.year}"
       elsif start_date.year == end_date.year && start_date.month == end_date.month
-        "#{MONTH_NAMES[start_date.month - 1]} #{start_date.day}–#{end_date.day}, #{start_date.year}"
+        "#{start_month} #{start_date.day}–#{end_date.day}, #{start_date.year}"
       elsif start_date.year == end_date.year
-        "#{MONTH_NAMES[start_date.month - 1]} #{start_date.day} – #{MONTH_NAMES[end_date.month - 1]} #{end_date.day}, #{end_date.year}"
+        "#{start_month} #{start_date.day} – #{end_month} #{end_date.day}, #{end_date.year}"
       else
-        "#{MONTH_NAMES[start_date.month - 1]} #{start_date.day}, #{start_date.year} – #{MONTH_NAMES[end_date.month - 1]} #{end_date.day}, #{end_date.year}"
+        "#{start_month} #{start_date.day}, #{start_date.year} – " \
+          "#{end_month} #{end_date.day}, #{end_date.year}"
       end
     end
   end

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: whenwords
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
-- Drew Breunig
+- Peng Zhang
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -13,7 +13,7 @@ description: Convert timestamps to readable strings like '3 hours ago' and parse
   strings like '2h 30m' into seconds. Includes timeago, duration formatting, duration
   parsing, contextual dates, and date range formatting.
 email:
-- drew@breunig.com
+- peng@zpvip.com
 executables:
 - whenwords
 extensions: []
@@ -24,14 +24,14 @@ files:
 - exe/whenwords
 - lib/whenwords.rb
 - lib/whenwords/version.rb
-homepage: https://github.com/dbreunig/whenwords
+homepage: https://github.com/ZPVIP/whenwords
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/dbreunig/whenwords
-  source_code_uri: https://github.com/dbreunig/whenwords
-  changelog_uri: https://github.com/dbreunig/whenwords/blob/main/CHANGELOG.md
-  documentation_uri: https://github.com/dbreunig/whenwords#readme
+  homepage_uri: https://github.com/ZPVIP/whenwords
+  source_code_uri: https://github.com/ZPVIP/whenwords.git
+  changelog_uri: https://github.com/ZPVIP/whenwords/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/ZPVIP/whenwords#readme
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: