tater 3.0.2 → 3.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b543d8ed6a28b2f4059b2c1fc63593bc2f7ced7b2cc9d62e786c78263b97ec35
-  data.tar.gz: 0042276af4078a436e7f34e1f50500e5dd92649ae060b24921a98f5dfc859789
+  metadata.gz: 7176a93dd72c2135f8114c2baed2d4fdda8ffcb7c02312517810d94f9e275dce
+  data.tar.gz: 5dea4c80c2a894063790d2cd4ed2232e8566b3cae4a3ab9a73a2be3c45ffd4f5
 SHA512:
-  metadata.gz: cd927d5425f5a8b7356fafb72db449d57494042369eb9ba0018a2ba7d68893fe24c0d633d75a93ab8ff1d3e8f2367d148e87c5bc068ec1717afa27d1168cec8c
-  data.tar.gz: 4f0a917429aef2c443288f9c338a0471f86fb608585e29e5fdc8b3f04b8ecfe654ecdc7e09daed29e99b19ddb3bf1a4175057d6db77c64b495b25a232f2c6eb7
+  metadata.gz: b32716e497cc9a2e81eded3bc277450d143ffec829b4accf3b3396b2c1afb28b4c66bab044695cf13bd6b64ff830d4168b181435565864e977f59ce9fcf6df1e
+  data.tar.gz: bd697439d8db3cd1607762bd92adb13e066fb40e16c7db6469a8e2a226774480a4cd1ba19651d45673c6ce819e9f7913af82c0b779c37c5f803e0c72ce3d42ff

data/lib/tater/aliases.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+require 'tater'
+
+class Tater # :nodoc:
+  # Alias to Tater#localize
+  alias l localize
+
+  # Alias to Tater#translate
+  alias t translate
+end

data/lib/tater/hash.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+class Tater
+  # Refine Hash and add the #except method from Ruby 3.
+  module HashExcept
+    refine Hash do
+      # Taken from the excellent backports gem written by Marc-André Lafortune.
+      #   https://github.com/marcandre/backports/blob/master/lib/backports/3.0.0/hash/except.rb
+      def except(*keys)
+        if keys.size > 4 && size > 4 # index if O(m*n) is big
+          h = {}
+          keys.each { |key| h[key] = true }
+          keys = h
+        end
+
+        reject { |key, _value| keys.include?(key) }
+      end
+    end
+  end
+end

data/lib/tater/utils.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+class Tater
+  # Utility methods that require no state.
+  module Utils
+    HASH = {}.freeze
+    FORMAT_CURLY = '%{'
+    FORMAT_NAMED = '%<'
+
+    # Merge all the way down.
+    #
+    # @param to [Hash]
+    #   The target Hash to merge into.
+    # @param from [Hash]
+    #   The Hash to copy values from.
+    # @return [Hash]
+    def self.deep_merge(to, from)
+      to.merge(from) do |_key, left, right|
+        if left.is_a?(Hash) && right.is_a?(Hash)
+          Utils.deep_merge(left, right)
+        else
+          right
+        end
+      end
+    end
+
+    # Transform keys all the way down.
+    #
+    # @param hash [Hash]
+    #   The Hash to stringify keys for.
+    # @return [Hash]
+    def self.deep_stringify_keys(hash)
+      hash.transform_keys(&:to_s).transform_values do |value|
+        if value.is_a?(Hash)
+          Utils.deep_stringify_keys(value)
+        else
+          value
+        end
+      end
+    end
+
+    # Freeze all the way down.
+    #
+    # @param hash [Hash]
+    # @return [Hash]
+    def self.deep_freeze(hash)
+      hash.transform_keys(&:freeze).transform_values do |value|
+        if value.is_a?(Hash)
+          Utils.deep_freeze(value)
+        else
+          value.freeze
+        end
+      end.freeze
+    end
+
+    # Format values into a string if appropriate.
+    #
+    # @param string [String]
+    #   The target string to interpolate into.
+    # @param options [Hash]
+    #   The values to interpolate into the target string.
+    #
+    # @return [String]
+    def self.interpolate(string, options = HASH)
+      return string if options.empty?
+      return string unless interpolation_string?(string)
+
+      format(string, options)
+    end
+
+    # Determine whether a string includes any interpolation placeholders e.g.
+    # "%{" or "%<"
+    #
+    # @param string [String]
+    # @return [Boolean]
+    def self.interpolation_string?(string)
+      string.include?(FORMAT_CURLY) || string.include?(FORMAT_NAMED)
+    end
+
+    # Convert a Numeric to a string, particularly formatting BigDecimals to a
+    # Float-like string representation.
+    #
+    # @param numeric [Numeric]
+    #
+    # @return [String]
+    def self.string_from_numeric(numeric)
+      if numeric.is_a?(BigDecimal)
+        numeric.to_s('F')
+      else
+        numeric.to_s
+      end
+    end
+  end
+end

data/lib/tater.rb

@@ -3,8 +3,9 @@ require 'bigdecimal'
 require 'date'
 require 'time'
 require 'yaml'
-require_relative 'tater/utils'
-require_relative 'tater/hash' unless Hash.method_defined?(:except)
+
+require 'tater/utils'
+require 'tater/hash' unless Hash.method_defined?(:except)
 
 # Tater is a internationalization (i18n) and localization (l10n) library
 # designed for speed and simplicity.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tater
 version: !ruby/object:Gem::Version
-  version: 3.0.2
+  version: 3.0.3
 platform: ruby
 authors:
 - Evan Lecklider
@@ -132,6 +132,9 @@ files:
 - LICENSE.txt
 - README.org
 - lib/tater.rb
+- lib/tater/aliases.rb
+- lib/tater/hash.rb
+- lib/tater/utils.rb
 - test/fixtures/another.yml
 - test/fixtures/fixtures.yml
 - test/fixtures/messages/more.yml