edtf-humanize 1.0.0 → 2.1.0

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      module Default
+        module Unknown
+          extend self
+
+          def humanizer(_date)
+            I18n.t('edtf.terms.unknown', default: 'unknown')
+          end
+        end
+      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/english.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      module English
+        include Default
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      module French
+        include Default
+
+        module Century
+          extend self
+
+          def humanizer(date)
+            require 'roman'
+            "#{(date.year.abs / 100 + 1).to_roman}" \
+            "#{century_number_suffix(date)}" \
+            "#{century_sign_suffix(date)}"
+          end
+
+          private
+
+          def century_number_suffix(date)
+            return 'er siècle' if (date.year.abs / 100).zero?
+
+            'e siècle'
+          end
+
+          def century_sign_suffix(date)
+            return ' avant J.C.' if date.year.negative?
+
+            ''
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Edtf
+  module Humanize
+    module Language
+      module Italian
+        include Default
+
+        module Century
+          extend self
+
+          def humanizer(date)
+            require 'roman'
+            "#{(date.year.abs / 100 + 1).to_roman}" \
+            "#{century_number_suffix}" \
+            "#{century_sign_suffix(date)}"
+          end
+
+          private
+
+          def century_number_suffix
+            ' secolo'
+          end
+
+          def century_sign_suffix(date)
+            return ' a. C.' if date.year.negative?
+
+            ''
+          end
+        end
+      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/season.rb

@@ -1,25 +1,13 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
     module Season
-
-      include Edtf::Humanize::Formats
+      include Edtf::Humanize::Language
 
       def humanize
-        "#{apply_if_approximate(self)}"\
-        "#{translate_season(self.season)} #{self.year}"\
-        "#{apply_if_uncertain(self)}"
-      end
-
-      private
-
-      def translate_season(season)
-        begin
-          I18n.translate!("date.seasons.#{self.season}")
-        rescue I18n::MissingTranslationData
-          self.season
-        end
+        language_strategy::Season.humanizer(self)
       end
-
     end
   end
 end

data/lib/edtf/humanize/set.rb

@@ -1,42 +1,13 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
     module Set
-
-      include Edtf::Humanize::Formats
+      include Edtf::Humanize::Language
 
       def humanize
-        format_set_entries(self).to_sentence(
-          words_connector:     Edtf::Humanize.configuration.set_dates_connector,
-          last_word_connector: Edtf::Humanize.configuration.set_last_date_connector,
-          two_words_connector: Edtf::Humanize.configuration.set_two_dates_connector
-        )
-      end
-
-      private
-
-      def format_set_entries(dates)
-        dates.entries.map.with_index { |date, index|
-          "#{apply_if_earlier(dates, index)}"\
-          "#{apply_if_later(dates, index)}"\
-          "#{apply_if_approximate(date)}"\
-          "#{simple_date_format(date)}"
-        }
+        language_strategy::Set.humanizer(self)
       end
-
-      # '[..1760-12-03]' => on or before December 3, 1760
-      def apply_if_earlier(dates, index)
-        if dates.earlier? && index == 0
-          Edtf::Humanize.configuration.set_earlier_prefix
-        end
-      end
-
-      # '[1760-12..]' => on or after December 1760
-      def apply_if_later(dates, index)
-        if dates.later? && (index + 1) == dates.size
-          Edtf::Humanize.configuration.set_later_prefix
-        end
-      end
-
     end
   end
 end

data/lib/edtf/humanize/unknown.rb

@@ -1,11 +1,13 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
     module Unknown
+      include Edtf::Humanize::Language
 
       def humanize
-        Edtf::Humanize.configuration.unknown
+        language_strategy::Unknown.humanizer(self)
       end
-
     end
   end
-end
+end

data/lib/edtf/humanize/version.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 module Edtf
   module Humanize
-    VERSION = "1.0.0"
+    VERSION = '2.1.0'
   end
 end

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,18 @@ 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'
+    require 'edtf/humanize/language/italian'
 
     EDTF::Decade.include Edtf::Humanize::Decade
     EDTF::Century.include Edtf::Humanize::Century
@@ -20,7 +33,6 @@ module Edtf
     EDTF::Unknown.include Edtf::Humanize::Unknown
     Date.include Edtf::Humanize::IsoDate
 
-
     def self.configuration
       @configuration ||= Configuration.new
     end
@@ -34,51 +46,18 @@ 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,
+          it: Edtf::Humanize::Language::Italian
+        }
       end
 
+      def language_strategy(language)
+        @language_strategies[language.to_sym] || @language_strategies[:default]
+      end
     end
-
   end
 end

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/spec/edtf_humanize_en_spec.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require 'edtf-humanize'
+
+RSpec.describe Edtf::Humanize do
+  before do
+    I18n.locale = :en
+  end
+
+  it { is_expected.to be_a(Module) }
+
+  context 'with a decade' do
+    it 'returns a humanized decade string' do
+      expect(Date.edtf('199x').humanize).to eq('1990s')
+    end
+  end
+
+  context 'with a century' do
+    it 'returns a humanized century string' do
+      expect(Date.edtf('19xx').humanize).to eq('1900s')
+    end
+  end
+
+  context 'with an interval' do
+    it 'returns a humanized interval string' do
+      expect(Date.edtf('1970/1980').humanize).to eq('1970 to 1980')
+    end
+  end
+
+  context 'with an open interval' do
+    it 'returns a humanized interval string' do
+      expect(Date.edtf('1970/open').humanize).to eq('since 1970')
+    end
+  end
+
+  context 'with an approximate interval'
+  it 'returns a humanized approximate interval string' do
+    expect(Date.edtf('1970~/1980~').humanize).to(
+      eq('circa 1970 to circa 1980')
+    )
+  end
+
+  context 'with an iso date' do
+    it 'returns a humanized ISO date string' do
+      expect(Date.edtf('1975-07-01').humanize).to eq('July 1, 1975')
+    end
+  end
+
+  context 'with an uncertain iso date' do
+    it 'returns a humanized uncertain ISO date string' do
+      expect(Date.edtf('1975?').humanize).to eq('1975?')
+    end
+  end
+
+  context 'with an unspecified year iso date' do
+    it 'returns a humanized unspecified year ISO date string' do
+      expect(Date.edtf('197u').humanize).to eq('197X')
+    end
+  end
+
+  context 'with a season' do
+    it 'returns a humanized season string' do
+      expect(Date.edtf('1975-22').humanize).to eq('summer 1975')
+    end
+  end
+
+  context 'with a set' do
+    it 'returns a humanized exclusive set string' do
+      expect(Date.edtf('[1980, 1981, 1983]').humanize).to(
+        eq('1980, 1981 or 1983')
+      )
+    end
+
+    it 'returns a humanized inclusive set string' do
+      expect(Date.edtf('{1980, 1981, 1983}').humanize).to(
+        eq('1980, 1981 and 1983')
+      )
+    end
+
+    it 'returns a humanized open (before) exclusive set string' do
+      expect(Date.edtf('[..1980]').humanize).to eq('on or before 1980')
+    end
+
+    it 'returns a humanized open (after) exclusive set string' do
+      expect(Date.edtf('[1980..]').humanize).to eq('on or after 1980')
+    end
+
+    it 'returns a humanized open (before) inclusive set string' do
+      expect(Date.edtf('{..1980}').humanize).to eq('on and before 1980')
+    end
+
+    it 'returns a humanized open (after) inclusive set string' do
+      expect(Date.edtf('{1980..}').humanize).to eq('on and after 1980')
+    end
+  end
+
+  context 'with an unknown value' do
+    it 'returns a humanized unknown string' do
+      expect(Date.edtf('uuuu').humanize).to eq('unknown')
+    end
+  end
+end

data/spec/edtf_humanize_fr_spec.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require 'edtf-humanize'
+
+RSpec.describe Edtf::Humanize do
+  before do
+    I18n.locale = :fr
+  end
+
+  it { is_expected.to be_a(Module) }
+
+  context 'with a decade' do
+    it 'returns a humanized decade string' do
+      expect(Date.edtf('199x').humanize).to eq('Les années 1990')
+    end
+  end
+
+  context 'with a century' do
+    it 'returns a humanized century string' do
+      expect(Date.edtf('19xx').humanize).to eq('XXe siècle')
+    end
+  end
+
+  context 'with an interval' do
+    it 'returns a humanized interval string' do
+      expect(Date.edtf('1970/1980').humanize).to eq('De 1970 à 1980')
+    end
+  end
+
+  context 'with an open interval' do
+    it 'returns a humanized interval string' do
+      expect(Date.edtf('1970/open').humanize).to eq('Depuis 1970')
+    end
+  end
+
+  context 'with an approximate interval'
+  it 'returns a humanized approximate interval string' do
+    expect(Date.edtf('1970~/1980~').humanize).to(
+      eq('De 1970 environ à 1980 environ')
+    )
+  end
+
+  context 'with an iso date' do
+    it 'returns a humanized ISO date string' do
+      expect(Date.edtf('1975-07-01').humanize).to eq('1 Juillet 1975')
+    end
+  end
+
+  context 'with an uncertain iso date' do
+    it 'returns a humanized uncertain ISO date string' do
+      expect(Date.edtf('1975?').humanize).to eq('1975?')
+    end
+  end
+
+  context 'with an unspecified year iso date' do
+    it 'returns a humanized unspecified year ISO date string' do
+      expect(Date.edtf('197u').humanize).to eq('197X')
+    end
+  end
+
+  context 'with a season' do
+    it 'returns a humanized season string' do
+      expect(Date.edtf('1975-22').humanize).to eq('été 1975')
+    end
+  end
+
+  context 'with a set' do
+    it 'returns a humanized exclusive set string' do
+      expect(Date.edtf('[1980, 1981, 1983]').humanize).to(
+        eq('1980, 1981 ou 1983')
+      )
+    end
+
+    it 'returns a humanized inclusive set string' do
+      expect(Date.edtf('{1980, 1981, 1983}').humanize).to(
+        eq('1980, 1981 et 1983')
+      )
+    end
+
+    it 'returns a humanized open (before) exclusive set string' do
+      expect(Date.edtf('[..1980]').humanize).to(
+        eq('Le ou avant 1980')
+      )
+    end
+
+    it 'returns a humanized open (after) exclusive set string' do
+      expect(Date.edtf('[1980..]').humanize).to(
+        eq('Le ou après 1980')
+      )
+    end
+
+    it 'returns a humanized open (before) inclusive set string' do
+      expect(Date.edtf('{..1980}').humanize).to(
+        eq('Le et avant 1980')
+      )
+    end
+
+    it 'returns a humanized open (after) inclusive set string' do
+      expect(Date.edtf('{1980..}').humanize).to(
+        eq('Le et après 1980')
+      )
+    end
+  end
+
+  context 'with an unknown value' do
+    it 'returns a humanized unknown string' do
+      expect(Date.edtf('uuuu').humanize).to eq('Inconnue')
+    end
+  end
+end

data/spec/edtf_humanize_it_spec.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require 'edtf-humanize'
+
+RSpec.describe Edtf::Humanize do
+  before do
+    I18n.locale = :it
+  end
+
+  it { is_expected.to be_a(Module) }
+
+  context 'with a decade' do
+    it 'returns a humanized decade string' do
+      expect(Date.edtf('199x').humanize).to eq('anni 1990')
+    end
+  end
+
+  context 'with a century' do
+    it 'returns a humanized century string' do
+      expect(Date.edtf('19xx').humanize).to eq('XX secolo')
+    end
+  end
+
+  context 'with an interval' do
+    it 'returns a humanized interval string' do
+      expect(Date.edtf('1970/1980').humanize).to eq('1970 - 1980')
+    end
+  end
+
+  context 'with an open interval' do
+    it 'returns a humanized interval string' do
+      expect(Date.edtf('1970/open').humanize).to eq('1970 - ')
+    end
+  end
+
+  context 'with an approximate interval'
+  it 'returns a humanized approximate interval string' do
+    expect(Date.edtf('1970~/1980~').humanize).to(
+      eq('circa 1970 - circa 1980')
+    )
+  end
+
+  context 'with an iso date' do
+    it 'returns a humanized ISO date string' do
+      expect(Date.edtf('1975-07-01').humanize).to eq('1 luglio 1975')
+    end
+  end
+
+  context 'with an uncertain iso date' do
+    it 'returns a humanized uncertain ISO date string' do
+      expect(Date.edtf('1975?').humanize).to eq('1975 ?')
+    end
+  end
+
+  context 'with an unspecified year iso date' do
+    it 'returns a humanized unspecified year ISO date string' do
+      expect(Date.edtf('197u').humanize).to eq('197X')
+    end
+  end
+
+  context 'with a season' do
+    it 'returns a humanized season string' do
+      expect(Date.edtf('1975-22').humanize).to eq('estate 1975')
+    end
+  end
+
+  context 'with a set' do
+    it 'returns a humanized exclusive set string' do
+      expect(Date.edtf('[1980, 1981, 1983]').humanize).to(
+        eq('1980, 1981 o 1983')
+      )
+    end
+
+    it 'returns a humanized inclusive set string' do
+      expect(Date.edtf('{1980, 1981, 1983}').humanize).to(
+        eq('1980, 1981 e 1983')
+      )
+    end
+
+    it 'returns a humanized open (before) exclusive set string' do
+      expect(Date.edtf('[..1980]').humanize).to(
+        eq('prima di 1980')
+      )
+    end
+
+    it 'returns a humanized open (after) exclusive set string' do
+      expect(Date.edtf('[1980..]').humanize).to(
+        eq('dopo 1980')
+      )
+    end
+
+    it 'returns a humanized open (before) inclusive set string' do
+      expect(Date.edtf('{..1980}').humanize).to(
+        eq('prima di 1980')
+      )
+    end
+
+    it 'returns a humanized open (after) inclusive set string' do
+      expect(Date.edtf('{1980..}').humanize).to(
+        eq('dopo 1980')
+      )
+    end
+  end
+
+  context 'with an unknown value' do
+    it 'returns a humanized unknown string' do
+      expect(Date.edtf('uuuu').humanize).to eq('data sconosciuta')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # This file was generated by the `rspec --init` command. Conventionally, all
 # specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
 # The generated `.rspec` file contains `--require spec_helper` which will cause