tater 2.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6106cd4e2b4936a681033a8d27c663cde05b412c014d155d79363b36370a07b7
-  data.tar.gz: cc2ad7ed82fce6f3718a3f56d5475d750b006708c16882b82197c2f54c9dec32
+  metadata.gz: eb7166fcdf9b548f8837e4411bfe5d83712f202e1de27c299fa0e5694b50bc2b
+  data.tar.gz: ab3f53e56fa8538f39ce59ba9f2e42496e5bea116a880fc26e23ad2091e5e93c
 SHA512:
-  metadata.gz: 4cbf5271ab90d0b5d941dc3a338363c61f0a82916df5da691f2be08cf31ca8b77afa3099f9eb83e8b28c08b13d36e46eb3bb2d63129d44f5e4d3e267dea9da43
-  data.tar.gz: f5c6d9b1d95f94bb9780d351d5d6ecfb30e9d66706559854cfa77dfa303cee9ab9b67fb325ea78a7b9a0092a6a439d0163221e8e06ae650da163391fb88c361e
+  metadata.gz: ceb821ff34a086711feb0df9e21a7aa4c7891a3e84fc52a9cf62d5972462c6ab0a5f81eef2ab820ef95df7211dda82e2a56299a1ced017e468c50358b6e537db
+  data.tar.gz: 2ad3f4c078bb63e39b5650254f92cb3859c39c73f4eaf2dfae18320e60712bf2c632e42c38770c39a456ee62f13fbf6262e1fef527846c17c53d7ebd859fa6de

data/{README.md → README.org}

@@ -1,42 +1,39 @@
-# Tater 
+* Tater
 
-[![Gem Version](https://badge.fury.io/rb/tater.svg)](https://badge.fury.io/rb/tater)
-[![Build Status](https://travis-ci.com/evanleck/tater.svg?branch=main)](https://travis-ci.com/evanleck/tater)
+[[https://badge.fury.io/rb/tater][https://badge.fury.io/rb/tater.svg]]
 
 Tater is an internationalization (i18n) and localization (l10n) library designed
 for simplicity. It doesn't do everything that other libraries do, but that's by
 design.
 
-Under the hood, Tater uses a Hash to store the messages, the `dig` method for
-lookups, `strftime` for date and time localizations, and `format` for
+Under the hood, Tater uses a Hash to store the messages, the =dig= method for
+lookups, =strftime= for date and time localizations, and =format= for
 interpolation. That's probably 90% of what Tater does.
 
-
-## Installation
+** Installation
 
 Tater requires Ruby 2.5 or higher. To install Tater, add this line to your
 application's Gemfile (or gems.rb):
 
-```ruby
+#+begin_src ruby
 gem 'tater'
-```
+#+end_src
 
 And then execute:
 
-```sh
+#+begin_src sh
 bundle
-```
+#+end_src
 
 Or install it yourself by running:
 
-```sh
+#+begin_src sh
 gem install tater
-```
-
+#+end_src
 
-## Usage
+** Usage
 
-```ruby
+#+begin_src ruby
 require 'tater'
 
 messages = {
@@ -59,59 +56,56 @@ i18n.translate('some.key') # => 'This here string!'
 
 # Interpolation:
 i18n.translate('interpolated', you: 'world') # => 'Hello world!'
-```
+#+end_src
 
-
-## Array localization
+** Array localization
 
 Given an array, Tater will do it's best to join the elements of the array into a
 sentence based on how many elements there are.
 
-```yaml
+#+begin_example
 en:
   array:
     last_word_connector: ", and "
     two_words_connector: " and "
     words_connector: ", "
-```
+#+end_example
 
-```ruby
+#+begin_src ruby
 i18n.localize(%w[tacos enchiladas burritos]) # => "tacos, enchiladas, and burritos"
-```
-
+#+end_src
 
-## Numeric localization
+** Numeric localization
 
-Numeric localization (`Numeric`, `Integer`, `Float`, and `BigDecimal`) require
+Numeric localization (=Numeric=, =Integer=, =Float=, and =BigDecimal=) require
 filling in a separator and delimiter. For example:
 
-```yaml
+#+begin_example
 en:
   numeric:
     delimiter: ','
     separator: '.'
-```
+#+end_example
 
 With that, you can do things like this:
 
-```ruby
+#+begin_src ruby
 i18n.localize(1000.2) # => "1,000.20"
-```
+#+end_src
 
 The separator and delimiter can also be passed in per-call:
 
-```ruby
+#+begin_src ruby
 i18n.localize(1000.2, delimiter: '_', separator: '+') # => "1_000+20"
-```
+#+end_src
 
+** Date and time localization
 
-## Date and time localization
-
-Date and time localization (`Date`, `Time`, and `DateTime`) require filling in
+Date and time localization (=Date=, =Time=, and =DateTime=) require filling in
 all of the needed names and abbreviations for days and months. Here's the
 example for French, which is used in the tests.
 
-```yaml
+#+begin_example
 fr:
   time:
     am: 'am'
@@ -174,28 +168,27 @@ fr:
       - oct.
       - nov.
       - déc.
-```
+#+end_example
 
-The statically defined keys for dates are `days`, `abbreviated_days`, `months`,
-and `abbreviated_months`. Only `am` and `pm` are needed for times and only if
-you plan on using the `%p` or `%P` format strings.
+The statically defined keys for dates are =days=, =abbreviated_days=, =months=,
+and =abbreviated_months=. Only =am= and =pm= are needed for times and only if
+you plan on using the =%p= or =%P= format strings.
 
 With all of that, you can do something like:
 
-```ruby
+#+begin_src ruby
 i18n.localize(Date.new(1970, 1, 1), format: '%A') # => 'jeudi'
 
 # Or, using a key defined in "formats":
 i18n.localize(Date.new(1970, 1, 1), format: 'day') # => 'jeudi'
-```
-
+#+end_src
 
-## Cascading lookups
+** Cascading lookups
 
-Lookups can be cascaded, i.e. pieces of the scope of the can be lopped off
+Lookups can be cascaded, i.e. pieces of the scope of the can be lopped off
 incrementally.
 
-```ruby
+#+begin_src ruby
 messages = {
   'en' => {
     'login' => {
@@ -214,42 +207,40 @@ i18n.translate('login.special.title') # => 'Special Login'
 i18n.translate('login.special.description') # => 'Tater lookup failed'
 
 i18n.translate('login.special.description', cascade: true) # => 'Normal description.'
-```
+#+end_src
 
 With cascade, the final key stays the same, but pieces of the scope get lopped
 off. In this case, lookups will be tried in this order:
 
-1. `'login.special.description'`
-2. `'login.description'`
+1. ='login.special.description'=
+2. ='login.description'=
 
 This can be useful when you want to override some messages but don't want to
 have to copy all of the other, non-overwritten messages.
 
 Cascading can also be enabled by default when initializing an instance of Tater.
 
-```ruby
+#+begin_src ruby
 Tater.new(cascade: true)
-```
+#+end_src
 
 Cascading is off by default.
 
-
-## Defaults
+** Defaults
 
 If you'd like to default to another value in case of a missed lookup, you can
-provide the `:default` option to `#translate`.
+provide the =:default= option to =#translate=.
 
-```ruby
+#+begin_src ruby
 Tater.new.translate('nope', default: 'Yep!') # => 'Yep!'
-```
+#+end_src
 
-
-## Procs and messages in Ruby
+** Procs and messages in Ruby
 
 Ruby files can be used to store messages in addition to YAML, so long as the
-Ruby file returns a `Hash` when evalled.
+Ruby file returns a =Hash= when evalled.
 
-```ruby
+#+begin_src ruby
 {
   'en' => {
     ruby: proc do |key, options = {}|
@@ -257,16 +248,15 @@ Ruby file returns a `Hash` when evalled.
     end
   }
 }
-```
-
+#+end_src
 
-## Multiple locales
+** Multiple locales
 
 If you would like to check multiple locales and pull the first matching one out,
-you can pass the `:locales` option to initialization or the `translate` method
+you can pass the =:locales= option to initialization or the =translate= method
 with an array of top-level locale keys.
 
-```ruby
+#+begin_src ruby
 messages = {
   'en' => {
     'title' => 'Login',
@@ -285,31 +275,23 @@ i18n.translate('description', locales: %w[fr en]) # => 'English description.'
 i18n = Tater.new(messages: messages, locales: %w[fr en])
 i18n.translate('title') # => 'la connexion'
 i18n.translate('description') # => 'English description.'
-```
+#+end_src
 
 Locales will be tried in order and whichever one matches first will be returned.
 
+** Limitations
 
-## Limitations
-
-- It is not "pluggable", it does what it does and that's it.
+- It is not pluggable, it does what it does and that's it.
 - It doesn't handle pluralization yet, though it may in the future.
-- It doesn't cache anything, that's up to you.
-
-
-## Why?
-
-Because [Ruby I18n][rubyi18n] is amazing and I wanted to try to create a minimum
-viable implementation of the bits of I18n that I use 90% of the time. Tater is a
-single file that handles the basics of lookup and interpolation.
 
+** Why?
 
-## Trivia
+Because [[https://github.com/ruby-i18n/i18n][Ruby I18n]] is amazing and I wanted to try to create a minimum viable
+implementation of the bits of I18n that I use 90% of the time. Tater is a single
+file that handles the basics of lookup and interpolation.
 
-I was orininally going to call this library "Translator" but with a
-[numeronym][numeronym] like I18n: "t8r". I looked at it for a while but I read
-it as "tater" instead of "tee-eight-arr" so I figured I'd just name it Tater.
-Tater the translator.
+** Trivia
 
-[numeronym]: https://en.wikipedia.org/wiki/Numeronym
-[rubyi18n]: https://github.com/ruby-i18n/i18n
+I was orininally going to call this library "Translator" but with a [[https://en.wikipedia.org/wiki/Numeronym][numeronym]]
+like I18n: "t8r".  I looked at it for a while but I read it as "tater" instead
+of "tee-eight-arr" so I figured I'd just name it Tater. Tater the translator.

data/lib/tater.rb

@@ -6,6 +6,7 @@ require 'yaml'
 # designed for speed and simplicity.
 class Tater
   class MissingLocalizationFormat < ArgumentError; end
+
   class UnLocalizableObject < ArgumentError; end
 
   module Utils # :nodoc:
@@ -214,16 +215,20 @@ class Tater
       raise(MissingLocalizationFormat, "Numeric localization delimiter ('numeric.delimiter') missing or not passed as option :delimiter") unless delimiter
       raise(MissingLocalizationFormat, "Numeric localization separator ('numeric.separator') missing or not passed as option :separator") unless separator
 
-      # Heavily cribbed from Rails.
-      integer, fraction = Utils.string_from_numeric(object).split('.')
-      integer.gsub!(DELIMITING_REGEX) do |number|
-        "#{ number }#{ delimiter }"
+      # Break the number up into integer and fraction parts.
+      integer = Utils.string_from_numeric(object)
+      integer, fraction = integer.split('.') unless object.is_a?(Integer)
+
+      if integer.length > 3
+        integer.gsub!(DELIMITING_REGEX) do |number|
+          "#{ number }#{ delimiter }"
+        end
       end
 
-      if precision.zero?
+      if precision.zero? || fraction.nil?
         integer
       else
-        [integer, fraction&.ljust(precision, '0')&.slice(0, precision)].compact.join(separator)
+        "#{ integer }#{ separator }#{ fraction.ljust(precision, '0').slice(0, precision) }"
       end
     when Date, Time, DateTime
       format = lookup("#{ object.class.to_s.downcase }.formats.#{ options[:format] || DEFAULT }", locale: options[:locale]) || options[:format] || DEFAULT

data/test/tater_test.rb

@@ -118,7 +118,7 @@ describe Tater do
     end
 
     it 'updates the available list when new messages are loaded' do
-      i18n.load(messages: { 'added' => { 'hey' => 'yeah' }})
+      i18n.load(messages: { 'added' => { 'hey' => 'yeah' } })
 
       assert_equal %w[en delimiter_only separator_only fr added].sort, i18n.available.sort
     end
@@ -265,10 +265,28 @@ describe Tater do
       assert_equal '1NAH12', i18n.localize(BigDecimal('1.12'))
     end
 
-    it 'accomodates precision' do
-      assert_equal '10NAH00', i18n.localize(BigDecimal('10'))
-      assert_equal '10', i18n.localize(BigDecimal('10'), precision: 0)
-      assert_equal '10NAH00', i18n.localize(BigDecimal('10.00234'))
+    describe 'precision option' do
+      it 'defaults to 2' do
+        assert_equal '10NAH00', i18n.localize(BigDecimal('10'))
+        assert_equal '10NAH00', i18n.localize(10.0)
+      end
+
+      it 'defaults to zero for integers' do
+        assert_equal '10', i18n.localize(10)
+      end
+
+      it 'removes fractional pieces when the precision is 0' do
+        assert_equal '10', i18n.localize(BigDecimal('10.123456'), precision: 0)
+        assert_equal '10', i18n.localize(10.123456, precision: 0)
+
+        assert_equal '10', i18n.localize(BigDecimal('10.12'), precision: 0)
+        assert_equal '10', i18n.localize(10.12, precision: 0)
+      end
+
+      it 'truncates long values to the desired precision' do
+        assert_equal '10NAH00', i18n.localize(BigDecimal('10.00234'))
+        assert_equal '10NAH00', i18n.localize(10.00234)
+      end
     end
 
     it 'allows overriding the delimiter and separator' do

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: tater
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Evan Lecklider
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-15 00:00:00.000000000 Z
+date: 2021-06-21 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Minimal internationalization and localization library.
 email:
 - evan@lecklider.com
@@ -74,7 +116,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE.txt
-- README.md
+- README.org
 - lib/tater.rb
 - test/fixtures/another.yml
 - test/fixtures/fixtures.yml