edtf-humanize 1.0.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 370eca8ed68c9afdd06117f0e584f82f2f48eac108a1113b77ce91355844bcba
-  data.tar.gz: 608b950683ce5117a1bcb9fe63380fc99ce705b53184f8e68c6e6a545527bbf7
+  metadata.gz: dcd453eb435bc411afc324c1fe00324311b91ad5feb2559cf44f6e7df30dc610
+  data.tar.gz: '019a07057a906c4d45fe710c7034bab92a63fb86241ffca22858049c51bb4085'
 SHA512:
-  metadata.gz: 4093df048a06504a30c04a8960ed6e253bb39a3d5d0015ac6f791287515ea9d2c800c0d04bf1e2834b5da2757243b47a1ab78589c5b259e7b9a7bd58ad4d2991
-  data.tar.gz: 6946c6594d3149788cbfc4ec50f770d450b3716817d7c8ad4c73c0ad58cd3a3b535436b1e373ccf998528d9ebdd4eb9faed24f42898da2d5de58b9ca9023bd7e
+  metadata.gz: 9a95e5aba3f7e614f88f66eeb33c7ea6046b0a977fc39b87c638de2cad6e7ffad4e751c68392da4533faaec3f5ba40ba44c6792267f07beed5c350a48479163c
+  data.tar.gz: 31f9e3b7d806b3a095444264e2f56302bfcbca868e88c5690d8ddbf5a119a773a5a4f18109534576ba3ec3b88d13129e9cc5835877ba980de03f7f6571333c85

data/config/locales/en.edtf.yml

@@ -0,0 +1,44 @@
+en:
+  edtf:
+    terms:
+      approximate_date_prefix_day: "circa "
+      approximate_date_prefix_month: "circa "
+      approximate_date_prefix_year: "circa "
+      approximate_date_suffix_day: ""
+      approximate_date_suffix_month: ""
+      approximate_date_suffix_year: ""
+      century_suffix: "s"
+      decade_prefix: ""
+      decade_suffix: "s"
+      interval_prefix_day: ""
+      interval_prefix_month: ""
+      interval_prefix_year: ""
+      interval_connector_approximate: " to "
+      interval_connector_day: " to "
+      interval_connector_open: " to "
+      interval_connector_month: " to "
+      interval_connector_year: " to "
+      interval_unspecified_suffix: "s"
+      open_start_interval_with_day: "until %{date}"
+      open_start_interval_with_month: "until %{date}"
+      open_start_interval_with_year: "until %{date}"
+      open_end_interval_with_day: "since %{date}"
+      open_end_interval_with_month: "since %{date}"
+      open_end_interval_with_year: "since %{date}"
+      set_dates_connector_exclusive: ", "
+      set_dates_connector_inclusive: ", "
+      set_earlier_prefix_exclusive: 'on or before '
+      set_earlier_prefix_inclusive: 'on and before '
+      set_last_date_connector_exclusive: " or "
+      set_last_date_connector_inclusive: " and "
+      set_later_prefix_exclusive: 'on or after '
+      set_later_prefix_inclusive: 'on and after '
+      set_two_dates_connector_exclusive: " or "
+      set_two_dates_connector_inclusive: " and "
+      uncertain_date_suffix: "?"
+      unknown: 'unknown'
+      unspecified_digit_substitute: "x"
+    formats:
+      day_precision_strftime_format: "%B %-d, %Y"
+      month_precision_strftime_format: "%B %Y"
+      year_precision_strftime_format: "%Y"

data/config/locales/fr.edtf.yml

@@ -0,0 +1,55 @@
+fr:
+  date:
+    day_names: [Dimanche, Lundi, Mardi, Mercredi, Jeudi, Vendredi, Samedi]
+    abbr_day_names: [Dim, Lun, Mar, Mer, Jeu, Ven, Sam]
+    # Don't forget the nil at the beginning; there's no such thing as a 0th month
+    month_names: [~, Janvier, Février, Mars, Avril, Mai, Juin, Juillet, Août, Septembre, Octobre, Novembre, Decembre]
+    abbr_month_names: [~, Jan, Fev, Mar, Avr, Mai, Jun, Jul, Aou, Sep, Oct, Nov, Dec]
+    seasons:
+      spring: "printemps"
+      summer: "été"
+      autumn: "automne"
+      winter: "hiver"
+  edtf:
+    terms:
+      approximate_date_prefix_day: ""
+      approximate_date_prefix_month: ""
+      approximate_date_prefix_year: ""
+      approximate_date_suffix_day: " environ"
+      approximate_date_suffix_month: " environ"
+      approximate_date_suffix_year: " environ"
+      decade_prefix: "Les années "
+      decade_suffix: ""
+      century_suffix: ""
+      interval_prefix_day: "Du "
+      interval_prefix_month: "De "
+      interval_prefix_year: "De "
+      interval_connector_approximate: " à "
+      interval_connector_open: " à "
+      interval_connector_day: " au "
+      interval_connector_month: " à "
+      interval_connector_year: " à "
+      interval_unspecified_suffix: "s"
+      open_start_interval_with_day: "Jusqu'au %{date}"
+      open_start_interval_with_month: "Jusqu'en %{date}"
+      open_start_interval_with_year: "Jusqu'en %{date}"
+      open_end_interval_with_day: "Depuis le %{date}"
+      open_end_interval_with_month: "Depuis %{date}"
+      open_end_interval_with_year: "Depuis %{date}"
+      set_dates_connector_exclusive: ", "
+      set_dates_connector_inclusive: ", "
+      set_earlier_prefix_exclusive: 'Le ou avant '
+      set_earlier_prefix_inclusive: 'Le et avant '
+      set_last_date_connector_exclusive: " ou "
+      set_last_date_connector_inclusive: " et "
+      set_later_prefix_exclusive: 'Le ou après '
+      set_later_prefix_inclusive: 'Le et après '
+      set_two_dates_connector_exclusive: " ou "
+      set_two_dates_connector_inclusive: " et "
+      uncertain_date_suffix: "?"
+      unknown: 'Inconnue'
+      unspecified_digit_substitute: "x"
+    formats:
+      day_precision_strftime_format: "%-d %B %Y"
+      month_precision_strftime_format: "%B %Y"
+      year_precision_strftime_format: "%Y"

data/lib/edtf-humanize.rb

@@ -1 +1,6 @@
+# frozen_string_literal: true
+
 require 'edtf/humanize'
+
+I18n.load_path +=
+  Dir.glob(File.dirname(__FILE__) + '/../config/locales/*.{rb,yml}')

data/lib/edtf/humanize.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
-
     require 'edtf'
 
-    require 'edtf/humanize/formats'
+    require 'edtf/humanize/language'
     require 'edtf/humanize/decade'
     require 'edtf/humanize/century'
     require 'edtf/humanize/season'
@@ -11,6 +12,17 @@ module Edtf
     require 'edtf/humanize/set'
     require 'edtf/humanize/unknown'
     require 'edtf/humanize/iso_date'
+    require 'edtf/humanize/language/default/formats'
+    require 'edtf/humanize/language/default/decade'
+    require 'edtf/humanize/language/default/century'
+    require 'edtf/humanize/language/default/season'
+    require 'edtf/humanize/language/default/interval'
+    require 'edtf/humanize/language/default/set'
+    require 'edtf/humanize/language/default/unknown'
+    require 'edtf/humanize/language/default/iso_date'
+    require 'edtf/humanize/language/default'
+    require 'edtf/humanize/language/english'
+    require 'edtf/humanize/language/french'
 
     EDTF::Decade.include Edtf::Humanize::Decade
     EDTF::Century.include Edtf::Humanize::Century
@@ -20,7 +32,6 @@ module Edtf
     EDTF::Unknown.include Edtf::Humanize::Unknown
     Date.include Edtf::Humanize::IsoDate
 
-
     def self.configuration
       @configuration ||= Configuration.new
     end
@@ -34,51 +45,17 @@ module Edtf
     end
 
     class Configuration
-
-      attr_accessor :day_precision_strftime_format,
-                    :month_precision_strftime_format,
-                    :year_precision_strftime_format,
-                    :approximate_date_prefix,
-                    :uncertain_date_suffix,
-                    :decade_suffix,
-                    :century_suffix,
-                    :unspecified_digit_substitute,
-                    :interval_connector,
-                    :interval_unspecified_suffix,
-                    :set_dates_connector,
-                    :set_last_date_connector,
-                    :set_two_dates_connector,
-                    :set_earlier_prefix,
-                    :set_later_prefix,
-                    :unknown
-
       def initialize
-        @day_precision_strftime_format = "%B %-d, %Y"
-        @month_precision_strftime_format = "%B %Y"
-        @year_precision_strftime_format = "%Y"
-
-        @approximate_date_prefix = "circa "
-
-        @uncertain_date_suffix = "?"
-
-        @decade_suffix = "s"
-        @century_suffix = "s"
-
-        @unspecified_digit_substitute = "x"
-
-        @interval_connector = " to "
-        @interval_unspecified_suffix = "s"
-
-        @set_dates_connector = ", "
-        @set_last_date_connector = " or "
-        @set_two_dates_connector = " or "
-        @set_earlier_prefix = "on or before "
-        @set_later_prefix = "on or after "
-
-        @unknown = "unknown"
+        @language_strategies = {
+          default: Edtf::Humanize::Language::Default,
+          en: Edtf::Humanize::Language::English,
+          fr: Edtf::Humanize::Language::French
+        }
       end
 
+      def language_strategy(language)
+        @language_strategies[language.to_sym] || @language_strategies[:default]
+      end
     end
-
   end
 end

data/lib/edtf/humanize/century.rb

@@ -1,13 +1,13 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
     module Century
-
-      include Edtf::Humanize::Formats
+      include Edtf::Humanize::Language
 
       def humanize
-        "#{self.begin.year}#{Edtf::Humanize.configuration.century_suffix}"
+        language_strategy::Century.humanizer(self)
       end
-
     end
   end
 end

data/lib/edtf/humanize/decade.rb

@@ -1,13 +1,13 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
     module Decade
-
-      include Edtf::Humanize::Formats
+      include Edtf::Humanize::Language
 
       def humanize
-        "#{self.begin.year}#{Edtf::Humanize.configuration.decade_suffix}"
+        language_strategy::Decade.humanizer(self)
       end
-
     end
   end
 end

data/lib/edtf/humanize/interval.rb

@@ -1,30 +1,13 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
     module Interval
-
-      include Edtf::Humanize::Formats
+      include Edtf::Humanize::Language
 
       def humanize
-        "#{apply_if_approximate(self.from)}"\
-        "#{simple_date_format(self.from)}"\
-        "#{Edtf::Humanize.configuration.interval_connector}"\
-        "#{apply_if_approximate(self.to)}"\
-        "#{simple_date_format(self.to)}"
-      end
-
-      private
-
-      # '198u/199u' => 1980s to 1990s
-      def apply_if_unspecified_year date
-        display = date_precision(date)
-        if date.respond_to? :unspecified?
-          if date.unspecified? :year
-            display << Edtf::Humanize.configuration.interval_unspecified_suffix
-          end
-        end
-        display
+        language_strategy::Interval.humanizer(self)
       end
-
     end
   end
 end

data/lib/edtf/humanize/iso_date.rb

@@ -1,13 +1,13 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
     module IsoDate
-
-      include Edtf::Humanize::Formats
+      include Edtf::Humanize::Language
 
       def humanize
-        "#{apply_if_approximate(self)}#{simple_date_format(self)}"
+        language_strategy::IsoDate.humanizer(self)
       end
-
     end
   end
 end

data/lib/edtf/humanize/language.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      extend self
+
+      def language_strategy
+        Edtf::Humanize.configuration.language_strategy(I18n.locale)
+      end
+    end
+  end
+end

data/lib/edtf/humanize/language/default.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      module Default
+        include Century
+        include Decade
+        include Interval
+        include IsoDate
+        include Season
+        include Set
+        include Unknown
+      end
+    end
+  end
+end

data/lib/edtf/humanize/language/default/century.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      module Default
+        module Century
+          include Edtf::Humanize::Language::Default::Formats
+
+          extend self
+
+          def humanizer(date)
+            "#{date.begin.year}" \
+            "#{I18n.t('edtf.terms.century_suffix', default: 's')}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/edtf/humanize/language/default/decade.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      module Default
+        module Decade
+          include Edtf::Humanize::Language::Default::Formats
+
+          extend self
+
+          def humanizer(date)
+            "#{I18n.t('edtf.terms.decade_prefix', default: '')}" \
+            "#{date.begin.year}" \
+            "#{I18n.t('edtf.terms.decade_suffix', default: 's')}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/edtf/humanize/language/default/formats.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      module Default
+        module Formats
+          extend self
+
+          private
+
+          def date_format(date)
+            "#{apply_if_unspecified_year(date)}#{apply_if_uncertain(date)}"
+          end
+
+          def date_precision(date)
+            if date.respond_to? :precision
+              case date.precision
+              when :day # 2010-10-25
+                day_precision_format(date)
+              when :month # 2010-10
+                month_precision_format(date)
+              when :year # 2010
+                year_precision_format(date)
+              end
+            else
+              date
+            end
+          end
+
+          # October 5, 1995
+          def day_precision_format(date)
+            I18n.localize(
+              date,
+              format: I18n.t('edtf.formats.day_precision_strftime_format',
+                             default: '%B %-d, %Y')
+            )
+          end
+
+          # October 1995
+          def month_precision_format(date)
+            I18n.localize(
+              date,
+              format: I18n.t('edtf.formats.month_precision_strftime_format',
+                             default: '%B %Y')
+            )
+          end
+
+          # 1995
+          def year_precision_format(date)
+            date.strftime(I18n.t('edtf.formats.year_precision_strftime_format',
+                                 default: '%Y'))
+          end
+
+          # '1990~' => circa 1990
+          def apply_prefix_if_approximate(date)
+            return unless date.respond_to?(:approximate?) && date.approximate?
+
+            case date.precision
+            when :year
+              I18n.t('edtf.terms.approximate_date_prefix_year',
+                     default: 'circa ')
+            when :month
+              I18n.t('edtf.terms.approximate_date_prefix_month',
+                     default: 'circa ')
+            when :day
+              I18n.t('edtf.terms.approximate_date_prefix_day',
+                     default: 'circa ')
+            end
+          end
+
+          # '1990~' => 1990 environ
+          def apply_suffix_if_approximate(date)
+            return '' unless date.respond_to?(:approximate?) &&
+                             date.approximate?
+
+            case date.precision
+            when :year
+              I18n.t('edtf.terms.approximate_date_suffix_year', default: '')
+            when :month
+              I18n.t('edtf.terms.approximate_date_suffix_month', default: '')
+            when :day
+              I18n.t('edtf.terms.approximate_date_suffix_day', default: '')
+            end
+          end
+
+          # '1990?' => 1990?
+          def apply_if_uncertain(date)
+            return '' unless date.respond_to?(:uncertain?) && date.uncertain?
+
+            I18n.t('edtf.terms.uncertain_date_suffix', default: '?')
+          end
+
+          # '198u' => 198x
+          def apply_if_unspecified_year(date)
+            display = date_precision(date)
+            if date.respond_to? :unspecified?
+              if date.unspecified? :year
+                year_substitute =
+                  date.year_precision.edtf.gsub(
+                    /u/,
+                    I18n.t('edtf.terms.unspecified_digit_substitute',
+                           default: 'x')
+                  )
+                display.gsub!(date.year.to_s, year_substitute)
+              end
+            elsif date
+            end
+            display
+          end
+        end
+      end
+    end
+  end
+end