tempora 0.2.4 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6327210c05cd6e57387ce5f535f57124ab17f28d6420662f7c71226ea0de0bcc
-  data.tar.gz: 1199cc7e1fce28020eac60017ab4e16fffd808558c25d7fd155b210ec554929e
+  metadata.gz: 2a46ecbe3533d7f668ce4a69e5b6770f7ddd652d360b16fd2a8eca24a762807f
+  data.tar.gz: 20841d06370d1df8da36f26bce276114c3917fe2c0b9f8ff46bed644aada8061
 SHA512:
-  metadata.gz: 047b83913509e3d7394b6f646a1e8eb75bbb4fd75b7d1abb85fa5d8c7a6a0b26194fd69b7000d11717357005b693858a1691227c4bab25dcb39fa2c799690075
-  data.tar.gz: 73ad5d61432aad6aa039ba4f37d7698b0636618fdd1693266ce0af42d141b59c8ab4f25e3dbef33edb34f8f0534b866537e91371d4d1a7d7d80d8631b671c7dc
+  metadata.gz: 37bc14b3d16dab1f93f3f1319fb012ef5fafed211f09ed30ef446fda5f36187611b322e6b7bec11e73dfa9ba0ef34c339b897a4eabe09cee4e4e9de4f53171a9
+  data.tar.gz: 4f143cccd749e6157cc7cf954b5f9a7ca45246c4822ef7bfcf7cd8f239022eee7cb0346ac81865c539c574c67cff548d3a7de2c7c8a0202786a57b7c5a94c92d

data/config/locales/de.yml

@@ -0,0 +1,71 @@
+---
+de:
+  defaults: &defaults
+    month_names:
+      [~, Januar, Februar, März, April, Mai, Juni, Juli, August, September, Oktober, November, Dezember]
+    abbr_month_names:
+      [~, Jan, Feb, Mär, Apr, Mai, Jun, Jul, Aug, Sep, Okt, Nov, Dez]
+    day_names:
+      [Sonntag, Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag]
+    abbr_day_names:
+      [So, Mo, Di, Mi, Do, Fr, Sa]
+    formats:
+      default: "%d.%m.%Y"
+      long: "%e. %B %Y"
+      short: "%e. %b"
+    order:
+    - :day
+    - :month
+    - :year
+
+  date:
+    <<: *defaults
+  time:
+    <<: *defaults
+
+  timeperiod:
+    year: "Jahr"
+    quarter: "Quartal"
+    month: "Monat"
+    week: "Woche"
+    
+    same_day:
+      default: # 01.10.2015 10:30 - 12:45
+        from: "%d.%m.%Y, %H:%M"  
+        till: "%H:%M"            
+      long:   #  1. Oktober 2015, 10:30 - 12:45 Uhr 
+        from: "%-e. %B %Y, %H:%M"
+        till: "%H:%M Uhr"
+      short:  # 1. Okt 2015, 10:30 - 12:45
+        from: "%-e. %b %y, %H:%M"
+        till: "%H:%M"
+    same_month:
+      default: # 01. - 03.10.2015
+        from: "%d."
+        till: "%d.%m.%Y"
+      long:   # 1. - 3. Oktober 2015
+        from: "%-e."
+        till: "%-e. %B %Y"
+      short:  # 1. - 3. Okt 15
+        from: "%-e."
+        till: "%-e. %b %y"
+    same_year:
+      default: # 01.07 - 3.10.2015
+        from: "%d.%m."
+        till: "%d.%m.%Y"
+      long:   # 1. Juli - 3. Oktober 2015
+        from: "%-e. %B"
+        till: "%-e. %B %Y"
+      short:  # 1. Jul - 3. Okt 15
+        from: "%-e. %b"
+        till: "%-e. %b %y"
+    different_year:
+      default: # 01.07.2015 - 03.10.2016
+        from: "%d.%m.%Y"
+        till: "%d.%m.%Y"
+      long:  # 1. Juli 2015 - 3. Oktober 2016
+        from: "%-e. %B %Y"
+        till: "%-e. %B %Y"
+      short: # 1. Jul 15 - 3. Okt 16
+        from: "%-e. %b %y"
+        till: "%-e. %b %y"

data/config/locales/en.yml

@@ -0,0 +1,74 @@
+---
+en:
+  defaults: &defaults
+    month_names:
+      [~, January, February, March, April, May, June, July, August, September, October, November, December]
+    abbr_month_names:
+      [~, Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec]
+    day_names:
+      [Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday]
+    abbr_day_names:
+      [Su, Mo, Tu, We, Th, Fr, Sa]
+    formats:
+      default: "%Y-%m-%d"
+      long: "%B %d, %Y"
+      short: "%b %d"
+    order:
+    - :day
+    - :month
+    - :year
+
+  date:
+    <<: *defaults
+  time:
+    <<: *defaults
+    
+  timeperiod:
+    year: "Year"
+    quarter: "Quarter"
+    month: "Month"
+    week: "Week"
+
+    same_day:
+      default: # 2015-10-03, 10:30 - 12:45
+        from: "%Y-%m-%d, %H:%M"
+        till: "%H:%M"
+      long:   # October 03, 2015, 10:30 - 12:45
+        from: "%B %d, %Y, %H:%M"
+        till: "%H:%M"
+      short:  # Oct 03, 10:30 - 12:45
+        from: "%b %d, %H:%M"
+        till: "%H:%M"
+      time: 
+        from: "%H:%M"
+        till: "%H:%M"
+    same_month:
+      default: # 2015-10-03 - 09
+        from: "%Y-%m-%d"
+        till: "%d"
+      long:   # October 03 - 09, 2015 
+        from: "%B %d"
+        till: "%d, %Y"
+      short:  # Oct 03 - 09
+        from: "%b %d"
+        till: "%d"
+    same_year:
+      default: # 2015-10-03 - 11-30
+        from: "%Y-%m-%d"
+        till: "%m-%d"
+      long:   # October 10 - November 20, 2015
+        from: "%B %d"
+        till: "%B %d, %Y"
+      short:  # Oct 10 - Nov 20, 15
+        from: "%b %d"
+        till: "%b %d, %y"
+    different_year:
+      default: # 2015-10-10 - 2016-11-20
+        from: "%Y-%m-%d"
+        till: "%Y-%m-%d"
+      long:   # October 10, 2015 - November 20, 2016
+        from: "%B %d, %Y"
+        till: "%B %d, %Y"
+      short:   # Oct 10, 15 - Nov 20, 16
+        from: "%b %d, %y"
+        till: "%b %d, %y"

data/lib/month.rb

@@ -26,11 +26,11 @@ module Tempora
     end
 
     def month_name
-      Date::MONTHNAMES[number]
+      I18n.t('date.month_names')[number]
     end
   
     def month_abbr
-      Date::ABBR_MONTHNAMES[number]
+      I18n.t('date.abbr_month_names')[number]
     end
   
     def next

data/lib/quarter.rb

@@ -25,7 +25,7 @@ module Tempora
     end
 
     def to_s
-      "Q#{number} #{year}"
+      "#{I18n.t('timeperiod.quarter')} #{number}, #{year}"
     end
   
     def next

data/lib/tempora/formatter.rb

@@ -0,0 +1,64 @@
+module Tempora
+  class TimePeriodFormatter
+    I18nScopeKeys = %i(same_day same_month same_year different_year).freeze
+    I18nScopeKeysIdentifiers = { begin: :from, end: :till}
+    
+    # format: [:default, :short, :long] -> see I18n.localize
+    def initialize(timeperiod, format: :long) 
+      @timeperiod = timeperiod
+      @format = format
+    end
+    
+    def render
+      from = I18n.l @timeperiod.begin, format: format_for(:from)
+      till = I18n.l @timeperiod.end,   format: format_for(:till)
+      [from, till].reject(&:empty?).join ' – '
+    end
+    
+    private
+    
+    def format_for(key)
+      I18n.t key, scope: [:timeperiod, scope_key, @format]
+    end
+
+    def scope_key
+      I18nScopeKeyFinder.call(@timeperiod)
+    end
+
+    class I18nScopeKeyFinder
+      def initialize(timeperiod)
+        @timeperiod = timeperiod
+      end
+      
+      def call
+        I18nScopeKeys.find { |scope_key| send(:"#{scope_key}?") }
+      end
+      
+      def self.call(timeperiod)
+        new(timeperiod).call
+      end
+      
+      private
+    
+      def different_year?
+        !same_year?
+      end
+  
+      def same_year?
+        same? :year
+      end
+  
+      def same_month?
+        same? :year, :month
+      end
+  
+      def same_day?
+        same? :year, :month, :day
+      end
+    
+      def same?(*methods)
+        methods.all? { |m| @timeperiod.begin.send(m) == @timeperiod.end.send(m) }
+      end
+    end
+  end
+end

data/lib/tempora/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tempora
-  VERSION = "0.2.4"
+  VERSION = "0.2.5"
 end

data/lib/tempora.rb

@@ -1,15 +1,22 @@
 # frozen_string_literal: true
 
+require "i18n"
 require_relative "tempora/version"
 require_relative "timeperiod"
 require_relative "year"
 require_relative "month"
 require_relative "week"
 require_relative "quarter"
-
+require_relative "tempora/formatter"
 
 module Tempora
   class Error < StandardError; end
+  
+  def self.load_i18n
+    I18n.load_path += Dir[File.expand_path("../../config/locales/*.yml", __FILE__)]
+  end
 end
 
-Object.send(:include, Tempora)
+Tempora.load_i18n if defined?(I18n)
+
+Object.include Tempora

data/lib/week.rb

@@ -20,7 +20,7 @@ module Tempora
     end
   
     def to_s
-      "Week #{number}, #{year}"
+      "#{I18n.t('timeperiod.week')} #{number}, #{year}"
     end
   
     def next

metadata

@@ -1,14 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: tempora
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.5
 platform: ruby
 authors:
 - Max Power
 bindir: exe
 cert_chain: []
-date: 2025-03-02 00:00:00.000000000 Z
-dependencies: []
+date: 2025-03-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Tempora is a lightweight Ruby library for handling months, weeks, quarters,
   and years with intuitive date-based calculations and range support.
 email:
@@ -20,9 +34,12 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- config/locales/de.yml
+- config/locales/en.yml
 - lib/month.rb
 - lib/quarter.rb
 - lib/tempora.rb
+- lib/tempora/formatter.rb
 - lib/tempora/has_days.rb
 - lib/tempora/has_months.rb
 - lib/tempora/has_time.rb
@@ -55,7 +72,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.5
+rubygems_version: 3.6.6
 specification_version: 4
 summary: Tempora is a lightweight Ruby library for handling months, weeks, quarters,
   and years.