jekyll-timeago 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd02d79b4df7829ed8f3f0709c05ba9a30269c270d822f1b0688b11d04570cdc
-  data.tar.gz: 02e9e2d294c95e585ebb550fe97ac837aa6bee19937a1b9812d15662bdc654f0
+  metadata.gz: 2f8ae690f6686791715f0397fd0c38f6284c5857e78d9cc7669d437d402ce838
+  data.tar.gz: '083e7d05d403c01c22dac5f5f2bc5b832279dd5a7fb65a049e497939078ed0e9'
 SHA512:
-  metadata.gz: cfb1421c691b8979502e5678718e8ca5d25a16a172827cb6efc8ff1483fa3b32c3fb28953c86b1aaff8e306c7292b626241c495a9e25a1852818a275bd5d2b4a
-  data.tar.gz: cf53259ddca10910d3da16643cdd766294b71e737827ac8558856c7c32851474fbf5c2a0d8884446fdf4720d1e0fc0357abd34bbd319eb551ebf502824c041a9
+  metadata.gz: c1184731bf638031b1ab559e9fc26c0e98a641d33a4e71b5ae7fb88c5a6c6982975de6f6d0c311daf88f76de4c1fdb6931acc54241cb8b860b4bb4b8621e45ed
+  data.tar.gz: 3c03eebcd1100a75059fc96f11987204c7fe08acf6879da4ea35d4a451f9902952b3932915e3a79d8ee532b2bd21dd1a6f7fa64db984d91af2ca57fa8261b649

data/README.md

@@ -8,14 +8,14 @@
 
 Main features:
 
-- Compute distance of dates, in words, ie: `1 week and 2 days ago`, `5 months ago`, `in 1 year`
-- Future times
-- Alternative formats: short (`2y and 1mo ago`) and array (`['2 years', '1 month']`)
+- Compute distance of dates, in words: `1 week and 2 days ago`, `5 months ago`
+- Future times: `in 1 year`
+- Alternative formats: short (`2y and 1mo ago`), array (`['2 years', '1 month']`), and hash (`{years: 2, months: 1}`)
 - Out of the box support for `Jekyll` projects, available as a Liquid Filter and as a Liquid Tag
-- Localization
+- Localization: `hace 3 semanas`, `3週間前`, `il y a environ 3 semaines`
 - Level of detail customization
-- Command line utility
-- Approximate distance, with customizable threshold, ie: `366 days` becomes `1 year ago` instead of `1 year and 1 day ago`
+- CLI
+- Approximate distance, with customizable threshold: `366 days` becomes `1 year ago` instead of `1 year and 1 day ago`
 
 In fact, `jekyll-timeago` started as an extension for the [Liquid](https://github.com/Shopify/liquid) template engine, to be used in Jekyll backed sites. But actually, you can use it easily on any Ruby project and even as a tool from the [terminal](#cli)!
 
@@ -74,7 +74,7 @@ Examples:
 => "in 2 years and 8 months"
 ```
 
-**NOTE** If you have the gem installed in your system globally, and you're not using Bundler (probably because you're are writing a basic script), don't forget to require the library first:
+**NOTE** If you have the gem installed in your system globally, and you're not using Bundler (probably because you're are writing a small script), don't forget to require the library first:
 
 ```ruby
 require 'jekyll-timeago'
@@ -138,6 +138,19 @@ Use `:array` style for structured data:
 => ["1 year"]
 >> timeago(Date.today.prev_day(160), style: :array)
 => ["5 months", "1 week"]
+>> timeago(Date.today.prev_day(160), style: :array, locale: :es)
+=> ["5 meses", "1 semana"]
+```
+
+Use `:hash` style for structured hash data:
+
+```ruby
+>> timeago(Date.today.prev_day(365), style: :hash)
+=> {:years=>1}
+>> timeago(Date.today.prev_day(160), style: :hash)
+=> {:months=>5, :weeks=>1}
+>> timeago(Date.today.prev_day(160), style: :hash, locale: :es)
+=> {:meses=>5, :semanas=>1}
 ```
 
 #### `only`
@@ -157,6 +170,8 @@ Use the `only` option to accumulate all time into a single unit. Supported value
 => "52w ago"
 >> timeago(Date.today.prev_day(365), only: :months, locale: :es)
 => "hace 12 meses"
+>> timeago(Date.today.prev_day(365), only: :months, style: :hash)
+=> {:months=>12}
 ```
 
 ## Localization
@@ -188,6 +203,8 @@ il y a environ 2 années et 6 mois
 2y ago
 > timeago 2016-1-1 2018-1-1 -l es -s short
 hace 2a y 1d
+> timeago 2016-1-1 2018-1-1 --style hash
+{:years=>2, :days=>1}
 > timeago 2016-1-1 2018-1-1 --only weeks
 104 weeks ago
 > timeago 2016-1-1 2018-1-1 --only months -s short

data/bin/timeago

@@ -36,7 +36,7 @@ parser = OptionParser.new do |opts|
     options[:locale] = locale
   end
 
-  opts.on("-s", "--style STYLE", "Uses the provided style (short, array)") do |style|
+  opts.on("-s", "--style STYLE", "Uses the provided style (short, array, hash)") do |style|
     options[:style] = style
   end
 

data/lib/jekyll-timeago/core.rb

@@ -15,7 +15,7 @@ module Jekyll
       DEFAULT_THRESHOLD = 0
 
       # Available styles
-      STYLES = %w(default short array)
+      STYLES = %w(short array hash)
 
       # Available "only" options
       ONLY_OPTIONS = %w(years months weeks days)
@@ -58,7 +58,6 @@ module Jekyll
       end
 
       def validate_only(only)
-        return nil if only.nil?
         only = only.to_s
         ONLY_OPTIONS.include?(only) ? only : nil
       end
@@ -66,14 +65,24 @@ module Jekyll
       def time_ago_to_now
         days_passed = (@to - @from).to_i
 
-        return t(:today)     if days_passed == 0
-        return t(:yesterday) if days_passed == 1
-        return t(:tomorrow)  if days_passed == -1
+        if @style == "hash"
+          return { localized_unit_name(:days) => 0 }  if days_passed == 0
+          return { localized_unit_name(:days) => 1 }  if days_passed == 1
+          return { localized_unit_name(:days) => -1 } if days_passed == -1
+        elsif @style == "array"
+          return [t(:today)]     if days_passed == 0
+          return [t(:yesterday)] if days_passed == 1
+          return [t(:tomorrow)]  if days_passed == -1
+        else
+          return t(:today)     if days_passed == 0
+          return t(:yesterday) if days_passed == 1
+          return t(:tomorrow)  if days_passed == -1
+        end
 
         past_or_future = @from < @to ? :past : :future
         slots = build_time_ago_slots(days_passed.abs)
 
-        if @style == "array"
+        if @style == "array" || @style == "hash"
           slots
         else
           t(past_or_future, date_range: to_sentence(slots))
@@ -93,7 +102,15 @@ module Jekyll
         end
       end
 
-      # Builds time ranges with natural unit conversions: ['1 month', '5 days']
+      # Get localized unit name for hash keys (always plural form)
+      def localized_unit_name(unit)
+        # Extract the unit name from the plural form translation
+        translated = t(unit, count: 2)
+        # Remove any count prefix (e.g. "2 años" -> "años")
+        translated.gsub(/^\d+\s+/, '').to_sym
+      end
+
+      # Builds time ranges with natural unit conversions: ['1 month', '5 days'] or {:months => 1, :days => 5}
       def build_time_ago_slots(days_passed)
         # If "only" option is specified, calculate total time in that unit
         return build_only_slots(days_passed) if @only
@@ -104,15 +121,26 @@ module Jekyll
         # Select components based on depth and threshold  
         selected = select_components(components, days_passed)
         
-        # Convert to translated strings
-        selected.map { |unit, count| translate_unit(unit, count) }
+        # Format output based on current style
+        if @style == "hash"
+          result = {}
+          selected.each { |unit, count| result[localized_unit_name(unit)] = count }
+          result
+        else
+          selected.map { |unit, count| translate_unit(unit, count) }
+        end
       end
 
       # Build time slots when "only" option is specified
       def build_only_slots(days_passed)
         unit = @only.to_sym
         count = calculate_total_in_unit(days_passed, unit)
-        [translate_unit(unit, count)]
+        
+        if @style == "hash"
+          { localized_unit_name(unit) => count }
+        else
+          [translate_unit(unit, count)]
+        end
       end
 
       # Calculate total time in specified unit

data/lib/jekyll-timeago/version.rb

@@ -1,5 +1,5 @@
 module Jekyll
   module Timeago
-    VERSION = "1.0.0"
+    VERSION = "1.1.0"
   end
 end

data/lib/locales/{ja.yaml → ja.yml}

@@ -12,7 +12,7 @@ ja:
   years_short: '%{count}年'
   months:
     one: '1ヶ月'
-    other: '%{count}个月'
+    other: '%{count}ヵ月'
   months_short: '%{count}月'
   weeks:
     one: '1週間'

data/spec/jekyll-timeago_spec.rb

@@ -97,6 +97,8 @@ describe Jekyll::Timeago do
     it 'allows localization' do
       expect(timeago(sample_date.prev_day(100), sample_date, locale: :fr)).to eq('il y a environ 3 mois et 1 semaine')
       expect(timeago(sample_date.prev_day(100), sample_date, locale: :ru)).to eq('3 месяца и неделю назад')
+      expect(timeago(sample_date.prev_day(100), sample_date, locale: :it)).to eq('3 mesi e 1 settimana fa')
+      expect(timeago(sample_date.prev_day(100), sample_date, locale: :pt)).to eq('3 meses e 1 semana atrás')
     end
 
     it 'allows short style formatting' do
@@ -116,6 +118,8 @@ describe Jekyll::Timeago do
       expect(timeago(sample_date.prev_day(365), sample_date, locale: :ru, style: :short)).to eq('1г назад')
       expect(timeago(sample_date.prev_day(365), sample_date, locale: :es, style: :short)).to eq('hace 1a')
       expect(timeago(sample_date.prev_day(30), sample_date, locale: :de, style: :short)).to eq('vor 1mo')
+      expect(timeago(sample_date.prev_day(120), sample_date, locale: :ca, style: :short)).to eq('fa 4m')
+      expect(timeago(sample_date.prev_day(120), sample_date, locale: :ja, style: :short)).to eq('4月前')
     end
 
     it 'allows complex combinations with short style' do
@@ -125,12 +129,26 @@ describe Jekyll::Timeago do
     end
 
     it 'allows array style formatting' do
+      expect(timeago(sample_date, sample_date, style: :array)).to eq(['today'])
       expect(timeago(sample_date.prev_day(365), sample_date, style: :array)).to eq(['1 year'])
       expect(timeago(sample_date.prev_day(365), sample_date, "style" => "array")).to eq(['1 year'])
       expect(timeago(sample_date.prev_day(160), sample_date, style: :array)).to eq(['5 months', '1 week'])
       expect(timeago(sample_date.prev_day(160), sample_date, style: :array, locale: :es)).to eq(['5 meses', '1 semana'])
     end
 
+    it 'allows hash style formatting' do
+      expect(timeago(sample_date, sample_date, style: :hash)).to eq({days: 0})
+      expect(timeago(sample_date, sample_date, style: :hash, locale: :es)).to eq({días: 0})
+      expect(timeago(sample_date.prev_day(365), sample_date, style: :hash)).to eq({years: 1})
+      expect(timeago(sample_date.prev_day(365), sample_date, "style" => "hash")).to eq({years: 1})
+      expect(timeago(sample_date.prev_day(160), sample_date, style: :hash)).to eq({months: 5, weeks: 1})
+      expect(timeago(sample_date.prev_day(500), sample_date, style: :hash)).to eq({years: 1, months: 4})
+      expect(timeago(sample_date.prev_day(10), sample_date, style: :hash)).to eq({weeks: 1, days: 3})
+      expect(timeago(sample_date.prev_day(160), sample_date, style: :hash, locale: :es)).to eq({meses: 5, semanas: 1})
+      expect(timeago(sample_date.prev_day(500), sample_date, style: :hash, locale: :fr)).to eq({années: 1, mois: 4})
+      expect(timeago(sample_date.prev_day(500), sample_date, style: :hash, depth: 4)).to eq({years: 1, months: 4, weeks: 2, days: 1})
+    end
+
     it 'allows "only" option to accumulate time into single unit' do
       # Test "only: :days"
       expect(timeago(sample_date.prev_day(7), sample_date, only: :days)).to eq('7 days ago')
@@ -162,6 +180,13 @@ describe Jekyll::Timeago do
       # Test with array style
       expect(timeago(sample_date.prev_day(365), sample_date, only: :weeks, style: :array)).to eq(['52 weeks'])
       expect(timeago(sample_date.prev_day(30), sample_date, only: :months, style: :array)).to eq(['1 month'])
+      
+      # Test with hash style
+      expect(timeago(sample_date.prev_day(365), sample_date, only: :weeks, style: :hash)).to eq({weeks: 52})
+      expect(timeago(sample_date.prev_day(30), sample_date, only: :months, style: :hash)).to eq({months: 1})
+      expect(timeago(sample_date.prev_day(365), sample_date, only: :days, style: :hash)).to eq({days: 365})
+      expect(timeago(sample_date.prev_day(365), sample_date, only: :years, style: :hash)).to eq({years: 1})
+      expect(timeago(sample_date.prev_day(365), sample_date, only: :weeks, style: :hash, locale: :es)).to eq({semanas: 52})
     end
 
     it 'allows "only" option with different locales' do
@@ -203,12 +228,19 @@ describe Jekyll::Timeago do
       expect(`bin/timeago 2016-1-1 2018-1-1 --locale ru --style short`).to match("2г и 1д назад")
     end
 
+    it 'with hash style' do
+      expect(`bin/timeago 2016-1-1 2018-1-1 --style hash`).to match("{:years=>2, :days=>1}")
+      expect(`bin/timeago 2016-1-1 2018-1-1 -s hash`).to match("{:years=>2, :days=>1}")
+      expect(`bin/timeago 2016-1-1 2016-2-1 --style hash`).to match("{:months=>1, :days=>1}")
+    end
+
     it 'with only option' do
       expect(`bin/timeago 2016-1-1 2018-1-1 --only weeks`).to match("104 weeks ago")
       expect(`bin/timeago 2016-1-1 2018-1-1 -o months`).to match("24 months ago")
       expect(`bin/timeago 2016-1-1 2016-2-1 --only days`).to match("31 days ago")
       expect(`bin/timeago 2016-1-1 2018-1-1 -l fr --only months`).to match("il y a environ 24 mois")
       expect(`bin/timeago 2016-1-1 2018-1-1 --only weeks -s short`).to match("104w ago")
+      expect(`bin/timeago 2016-1-1 2018-1-1 --only weeks --style hash`).to match("{:weeks=>104}")
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-timeago
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - markets
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-11 00:00:00.000000000 Z
+date: 2025-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mini_i18n
@@ -110,7 +110,7 @@ files:
 - lib/locales/es.yml
 - lib/locales/fr.yml
 - lib/locales/it.yml
-- lib/locales/ja.yaml
+- lib/locales/ja.yml
 - lib/locales/pt.yml
 - lib/locales/ru.yml
 - lib/locales/tr.yml