formtastic_tristate_radio 0.2.1 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86bedb2f66a40f6a3ed5279b74fe1ecdc3ad78cf0c288183580986c162ace2ec
-  data.tar.gz: 7616b0e734f3760402146faabc3826b65e19662b18656aa21b182302d8268cdd
+  metadata.gz: b26a9dab6e7233cd6a694dc88f59d08f6d47263c900abfc07416679a87f7c974
+  data.tar.gz: 0a399b71d713ce0f4488f1f7461694d824d43c8f0f42db848daf4c0ad2caa0db
 SHA512:
-  metadata.gz: f43eb8544a29be624ac73048e86e4369653e4311347a5f07b49cfbe1cc70c6adf66827e5f9cf2a6530ff84a0e1fc6b2d5154f9d08a11849b07e4781fa28ad2ef
-  data.tar.gz: 6e60adba7f1d57f623f60a7cd4a448e5c443f0eb27721da49fc1767c509d16e19842a8b220ec301dfdbb188a051e2d1c1e4d8420efbbcf810f65a4dd07229704
+  metadata.gz: '0339d723213d63e7355ca4c50f120f6b08b22d406ba042ad47a89414708d4e07a1748dfa6d530190d2ca45ffd5dff0402779d53a225d9af80449c86b90d85a88'
+  data.tar.gz: b36093c5c3207e2375adb7c80769f890ac3b433c178128add4fa0d24ebd68aff11c5421b783213ff4d3e25d0f3603bf3b49ab8f794475f958e6aa909c879a088

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.2.5] - 2021-11-10
+
+- Corrects an error introduced in 0.2.4
+- Moves error-related code into a new module
+- Type-checks the `unset_value` passed into configuration
+
+## [0.2.4] - 2021-11-09
+
+- Add translations into most popular languages (although the problem with loading them seems to persist)
+
+## [0.2.2] - 2021-11-05
+
+- Make the gem configurable
+- Pull the key used for “unset” choice value into configuration
+
 ## [0.2.1] - 2021-11-04
 
 - Updates docs URL in gemspec

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec # Specify your gem's dependencies in .gemspec

data/Gemfile.lock

@@ -0,0 +1,162 @@
+PATH
+  remote: .
+  specs:
+    formtastic_tristate_radio (0.2.3)
+      formtastic (>= 3, < 5)
+      rails (>= 4, < 7)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actioncable (6.1.4.1)
+      actionpack (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+    actionmailbox (6.1.4.1)
+      actionpack (= 6.1.4.1)
+      activejob (= 6.1.4.1)
+      activerecord (= 6.1.4.1)
+      activestorage (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      mail (>= 2.7.1)
+    actionmailer (6.1.4.1)
+      actionpack (= 6.1.4.1)
+      actionview (= 6.1.4.1)
+      activejob (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 2.0)
+    actionpack (6.1.4.1)
+      actionview (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      rack (~> 2.0, >= 2.0.9)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.2.0)
+    actiontext (6.1.4.1)
+      actionpack (= 6.1.4.1)
+      activerecord (= 6.1.4.1)
+      activestorage (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      nokogiri (>= 1.8.5)
+    actionview (6.1.4.1)
+      activesupport (= 6.1.4.1)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.1, >= 1.2.0)
+    activejob (6.1.4.1)
+      activesupport (= 6.1.4.1)
+      globalid (>= 0.3.6)
+    activemodel (6.1.4.1)
+      activesupport (= 6.1.4.1)
+    activerecord (6.1.4.1)
+      activemodel (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+    activestorage (6.1.4.1)
+      actionpack (= 6.1.4.1)
+      activejob (= 6.1.4.1)
+      activerecord (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      marcel (~> 1.0.0)
+      mini_mime (>= 1.1.0)
+    activesupport (6.1.4.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    builder (3.2.4)
+    concurrent-ruby (1.1.9)
+    crass (1.0.6)
+    diff-lcs (1.4.4)
+    erubi (1.10.0)
+    formtastic (4.0.0)
+      actionpack (>= 5.2.0)
+    globalid (0.5.2)
+      activesupport (>= 5.0)
+    i18n (1.8.11)
+      concurrent-ruby (~> 1.0)
+    loofah (2.12.0)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    mail (2.7.1)
+      mini_mime (>= 0.1.1)
+    marcel (1.0.2)
+    method_source (1.0.0)
+    mini_mime (1.1.2)
+    minitest (5.14.4)
+    nio4r (2.5.8)
+    nokogiri (1.12.5-x86_64-darwin)
+      racc (~> 1.4)
+    racc (1.6.0)
+    rack (2.2.3)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails (6.1.4.1)
+      actioncable (= 6.1.4.1)
+      actionmailbox (= 6.1.4.1)
+      actionmailer (= 6.1.4.1)
+      actionpack (= 6.1.4.1)
+      actiontext (= 6.1.4.1)
+      actionview (= 6.1.4.1)
+      activejob (= 6.1.4.1)
+      activemodel (= 6.1.4.1)
+      activerecord (= 6.1.4.1)
+      activestorage (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      bundler (>= 1.15.0)
+      railties (= 6.1.4.1)
+      sprockets-rails (>= 2.0.0)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.4.2)
+      loofah (~> 2.3)
+    railties (6.1.4.1)
+      actionpack (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      method_source
+      rake (>= 0.13)
+      thor (~> 1.0)
+    rake (13.0.6)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.3)
+    sprockets (4.0.2)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.2.2)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    thor (1.1.0)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    websocket-driver (0.7.5)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.5)
+    yard (0.9.26)
+    zeitwerk (2.5.1)
+
+PLATFORMS
+  x86_64-darwin-17
+
+DEPENDENCIES
+  formtastic_tristate_radio!
+  rspec (~> 3)
+  yard (>= 0.9.20, < 1)
+
+BUNDLED WITH
+   2.2.27

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2021 Sergey Pedan
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -27,8 +27,7 @@ Some may consider this practice questionable — I don’t think so. In real
 For a Boolean column with 3 possible states:
 
 ```ruby
-f.input :am_i_awake,      as: :tristate_radio
-f.input :is_this_a_dream, as: :tristate_radio, null: "Reality is a persistent hallucination"
+f.input :am_i_awake, as: :tristate_radio
 ```
 
 You get (HTML is simplified, actually there are more classes etc.):
@@ -40,13 +39,6 @@ You get (HTML is simplified, actually there are more classes etc.):
   <input name="am_i_awake" type="radio" value="false"> <label>No</label>
   <input name="am_i_awake" type="radio" value="null">  <label>Unset</label>
 </fieldset>
-
-<fieldset>
-  <legend>Is this a dream?</legend>
-  <input name="is_this_a_dream" type="radio" value="true">  <label>Yes</label>
-  <input name="is_this_a_dream" type="radio" value="false"> <label>No</label>
-  <input name="is_this_a_dream" type="radio" value="null">  <label>Reality is a persistent hallucination</label>
-</fieldset>
 ```
 
 
@@ -94,12 +86,29 @@ Notice that the key ActiveAdmin uses is “unset”, not “null”.
 
 ## Configuration
 
-Nothing is configurable yet. I think of making configurable which values are regognized as `nil`.
+It’s difficult to come up with a reasonable use case for that, but you can configure what will be used as inputs value:
+
+```ruby
+# config/initializers/formtastic.rb
+FormtasticTristateRadio.configure do |config|
+  config.unset_key = "__unset" # default is :null
+end
+```
+
+which will result in:
+
+```html
+<input type="radio" name="am_i_awake" value="true">
+<input type="radio" name="am_i_awake" value="false">
+<input type="radio" name="am_i_awake" value="__unset">
+```
+
+Mind that for your custom value to work, you also need to configure `ActiveModel` to recognize that value as `nil`. Currently that is done [like so](https://github.com/sergeypedan/formtastic-tristate-radio/blob/master/config/initializers/activemodel_type_boolean.rb#L9).
 
 
 ## Documentation
 
-Low-level methods are properly documented in RubyDoc [here](https://www.rubydoc.info/gems/formtastic_tristate_radio/).
+Low-level methods are properly documented in RubyDoc [here](https://www.rubydoc.info/gems/formtastic_tristate_radio/TristateRadioInput).
 
 
 ## Dependencies
@@ -121,7 +130,7 @@ In Ruby any String is cast to `true`:
 
 Web form params are passed as plain text and are interpreted as String by Rack.
 
-So how Boolean values are transfered as strings if a `"no"` or `"0"` and even `""` is truthy in Ruby?
+So how are Boolean values transfered as strings if a `"no"` or `"0"` and even `""` is truthy in Ruby?
 
 Frameworks just have a list of string values to be recognized and mapped to Boolean values:
 
@@ -178,10 +187,11 @@ ActiveModel::Type::Boolean.new.cast(:nil)   #=> nil
 
 ## Roadmap
 
+- [ ] Remove `require_relative "../app/models/active_record/base"` from main file
+- [x] Make the gem configurable
+- [x] Pull the key used for “unset” choice value into configuration
+- [x] Add translations into most popular languages
 - [ ] Load translations from gem
-- [ ] Add translations into most popular languages
-- [ ] Make the gem configurable
-- [ ] Pull the key used for “unset” choice value into configuration
 - [ ] Rgister `:tristate_radio` for Boolean columns with `null`
 - [ ] Decouple `ActiveModel::Type::Boolean` thing from Formtastic things, maybe into a separate gem
 - [ ] Decouple from Rails

data/app/inputs/tristate_radio_input.rb

@@ -1,48 +1,16 @@
 # frozen_string_literal: true
 
-require "formtastic"
-
 # It may also be appropriate to put this file in `app/inputs`
 class TristateRadioInput < Formtastic::Inputs::RadioInput
 
-  # No equals `:null`.
+  # Now equals `:null`.
+  # Should equal one of `ActiveModel::Type::Boolean::NULL_VALUES`
   #
   # Mind ActiveAdmin [status resolving logic](https://github.com/activeadmin/activeadmin/blob/master/lib/active_admin/views/components/status_tag.rb#L51):
   # in status tag builder the value is lowercased before casting into Boolean, and the keyword for nil is `"unset"`.
   # So if we have lowercase `"unset"`, translations from `ru.formtastic.unset` will be overriden by `ru.active_admin.status_tag.unset`.
   #
-  UNSET_KEY = ActiveModel::Type::Boolean::NULL_VALUES.reject(&:blank?).first
-
-  I18N_EXAMPLE_ACTIVEADMIN = <<~YAML.chomp
-    ru:
-      active_admin:
-        status_tag:
-          :yes: Да
-          :no: Нет
-          :#{UNSET_KEY}: Неизвестно
-  YAML
-
-  I18N_EXAMPLE_FORMTASTIC = <<~YAML.chomp
-    ru:
-      formtastic:
-        :yes: Да
-        :no: Нет
-        :#{UNSET_KEY}: Неизвестно
-  YAML
-
-
-  # @note In you have ActiveAdmin installed, it will give you YAML example for ActiveAdmin as well, otherwise only for Formtastic
-  #
-  # @return [String] error message with YAML examples for the “unset” label translation lookup error
-  #
-  def self.missing_i18n_error_msg
-    msg = []
-    msg << "Add translations for the “unset” radio label"
-    msg << ["For radiobutton labels in forms:", I18N_EXAMPLE_FORMTASTIC].join("\n")
-    msg << "Note: “yes”, “no” and some other reserved words are converted into Boolean values in YAML, so you need to quote or symbolize them."
-    msg << ["For ActiveAdmin status tags in index & view tables:", I18N_EXAMPLE_ACTIVEADMIN].join("\n") if !!defined?(ActiveAdmin)
-    msg.join("\n\n")
-  end
+  UNSET_KEY = FormtasticTristateRadio.config.unset_key
 
 
   # @see https://github.com/formtastic/formtastic/blob/35dc806964403cb2bb0a6074b951ceef906c8581/lib/formtastic/inputs/base/choices.rb#L59 Original Formtastic method
@@ -84,12 +52,10 @@ class TristateRadioInput < Formtastic::Inputs::RadioInput
   #
   # @return [String] Label of the radio that stands for the unknown choice
   #
-  # @raise [StandardError] if the translation could not be found
-  # @see missing_i18n_error_msg
+  # @raise [FormtasticTristateRadio::I18n::Error] if the translation could not be found
   #
   def label_text_for_unset
-    options.fetch(:null, Formtastic::I18n.t(UNSET_KEY)).presence or \
-      fail FormtasticTristateRadio::MissingTranslationError.new(self.class.missing_i18n_error_msg)
+    options.fetch(:null, Formtastic::I18n.t(UNSET_KEY)).presence or fail FormtasticTristateRadio::I18n::Error.new(I18n.locale, UNSET_KEY)
   end
 
 

data/config/locales/active_admin.yml

@@ -0,0 +1,60 @@
+---
+ca:
+  active_admin:
+    status_tag:
+      :null: No establert
+---
+de:
+  active_admin:
+    status_tag:
+      :null: Nicht eingestellt
+---
+fr:
+  active_admin:
+    status_tag:
+      :null: Pas défini
+---
+it:
+  active_admin:
+    status_tag:
+      :null: Sconosciuto
+---
+ja:
+  active_admin:
+    status_tag:
+      :null: 不明
+---
+en:
+  active_admin:
+    status_tag:
+      :null: Unset
+---
+es:
+  active_admin:
+    status_tag:
+      :null: No establecido
+---
+pl:
+  active_admin:
+    status_tag:
+      :null: Nie ustawiony
+---
+pt-BR:
+  active_admin:
+    status_tag:
+      :null: Não configurado
+---
+pt:
+  active_admin:
+    status_tag:
+      :null: Não configurado
+---
+ru:
+  active_admin:
+    status_tag:
+      :null: Неизвестно
+---
+tr:
+  active_admin:
+    status_tag:
+      :null: Ayarlanmadı

data/config/locales/formtastic.yml

@@ -0,0 +1,48 @@
+---
+ca:
+  formtastic:
+    :null: No establert
+---
+de:
+  formtastic:
+    :null: Nicht eingestellt
+---
+fr:
+  formtastic:
+    :null: Pas défini
+---
+it:
+  formtastic:
+    :null: Sconosciuto
+---
+ja:
+  formtastic:
+    :null: 不明
+---
+en:
+  formtastic:
+    :null: Unset
+---
+es:
+  formtastic:
+    :null: No establecido
+---
+pl:
+  formtastic:
+    :null: Nie ustawiony
+---
+pt-BR:
+  formtastic:
+    :null: Não configurado
+---
+pt:
+  formtastic:
+    :null: Não configurado
+---
+ru:
+  formtastic:
+    :null: Неизвестно
+---
+tr:
+  formtastic:
+    :null: Ayarlanmadı

data/formtastic_tristate_radio.gemspec

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# https://guides.rubygems.org/name-your-gem/
+# https://bundler.io/guides/creating_gem.html
+# https://guides.rubyonrails.org/engines.html
+# https://guides.rubyonrails.org/plugins.html
+
+require_relative "lib/formtastic_tristate_radio/version"
+
+Gem::Specification.new do |spec|
+  spec.name             = "formtastic_tristate_radio"
+  spec.version          =  FormtasticTristateRadio::VERSION
+  spec.authors          = ["Sergey Pedan"]
+  spec.email            = ["sergey.pedan@gmail.com"]
+  spec.license          =  "MIT"
+
+  spec.summary          =  "Have 3-state radiobuttons instead of a 2-state checkbox for your Boolean columns which can store NULL"
+  spec.description      = <<~HEREDOC
+                            #{spec.summary}. This gem:
+                            1. Provides a custom Formtastic input type `:tristate_radio` which renders 3 radios (“Yes”, “No”, “Unset”) instead of a checkbox (only where you put it).
+                            2. Teaches Rails recognize `"null"` and `"nil"` param values as `nil`
+                            3. Encourages you to add translations for ActiveAdmin “status tag” so that `nil` be correctly translated as “Unset” instead of “False”.
+                            Does not change controls, you need to turn it on via `as: :tristate_radio` option.
+                          HEREDOC
+
+  spec.homepage         =  "https://github.com/sergeypedan/formtastic-tristate-radio"
+  spec.extra_rdoc_files = ["README.md", "CHANGELOG.md"]
+  spec.rdoc_options     = ["--charset=UTF-8"]
+  spec.metadata         = { "changelog_uri"     => "#{spec.homepage}/blob/master/CHANGELOG.md",
+                            "documentation_uri" => "https://www.rubydoc.info/gems/#{spec.name}",
+                            "homepage_uri"      => spec.homepage,
+                            "source_code_uri"   => spec.homepage }
+
+  spec.require_paths    = ["app/inputs", "app/models/active_record", "config/initializers", "config/locales", "lib"]
+  spec.bindir           = "exe"
+  spec.executables      = []
+  spec.files            = Dir.chdir(File.expand_path(__dir__)) do
+                            `git ls-files`.split("\n")
+                              .reject { |f| %w[bin spec test].any? { |dir| f.start_with? dir } }
+                              .reject { |f| f.start_with? "." }
+                          end
+
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.4.0")
+
+  spec.add_dependency "formtastic", ">= 3", "< 5"
+  spec.add_dependency "rails",      ">= 4", "< 7"
+
+  spec.add_development_dependency "rspec", "~> 3"
+  spec.add_development_dependency "yard",  ">= 0.9.20", "< 1"
+end

data/lib/formtastic_tristate_radio/configuration.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module FormtasticTristateRadio
+
+  class << self
+    attr_writer :config
+  end
+
+  def self.config
+    @config ||= Configuration.new
+  end
+
+  def self.configure
+    yield(config)
+  end
+
+  # Configuration block pattern
+  #
+  # @see https://thoughtbot.com/blog/mygem-configure-block
+  # @see https://brandonhilkert.com/blog/ruby-gem-configuration-patterns/
+  #
+  class Configuration
+
+    def initialize
+      @unset_key = :null
+    end
+
+    # @!attribute [r] unset_key
+    #   @return [Symbol, String] the value of <var>@unset_key</var>
+    #
+    attr_reader :unset_key
+
+    # @return [Symbol, String, Integer] value that was passed into the method
+    #
+    # @raise [TypeError] because no other types seem to make sence here
+    #
+    def unset_key=(value)
+      fail TypeError, "`unset_key` must be a Symbol, String or Integer" unless [Symbol, String, Integer].include? value.class
+      @unset_key = value
+    end
+  end
+
+end

data/lib/formtastic_tristate_radio/engine.rb

@@ -3,7 +3,7 @@
 module FormtasticTristateRadio
 
   # This is standard Rails way to autoload gem’s contents dynamically as an “engine”
-  # https://guides.rubyonrails.org/engines.html
+  # @see https://guides.rubyonrails.org/engines.html Rails guide on engines
   #
   class Engine < ::Rails::Engine
   end

data/lib/formtastic_tristate_radio/i18n/error.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module FormtasticTristateRadio
+  module I18n
+
+    EXAMPLE_ACTIVEADMIN = <<~YAML.chomp
+      ru:
+        active_admin:
+          status_tag:
+            :yes: Да
+            :no: Нет
+            :#{FormtasticTristateRadio.config.unset_key}: Неизвестно
+    YAML
+
+    EXAMPLE_FORMTASTIC = <<~YAML.chomp
+      ru:
+        formtastic:
+          :yes: Да
+          :no: Нет
+          :#{FormtasticTristateRadio.config.unset_key}: Неизвестно
+    YAML
+
+    class Error < ::I18n::MissingTranslationData
+      module Base
+
+        # @note In you have ActiveAdmin installed, it will give you YAML example for ActiveAdmin as well, otherwise only for Formtastic
+        #
+        # @return [String] error message with YAML examples for the “unset” label translation lookup error
+        #
+        # @see https://github.com/ruby-i18n/i18n/blob/master/lib/i18n/exceptions.rb#L63 Original I18n method
+        #
+        def message
+          msg = []
+          msg << "Add translations for the “unset” radio label"
+          msg << ["For radiobutton labels in forms:", EXAMPLE_FORMTASTIC].join("\n")
+          msg << "Note: “yes”, “no” and some other reserved words are converted into Boolean values in YAML, so you need to quote or symbolize them."
+          msg << ["For ActiveAdmin status tags in index & view tables:", EXAMPLE_ACTIVEADMIN].join("\n") if !!defined?(ActiveAdmin)
+          [super, msg.join("\n\n")].join("\n\n")
+        end
+      end
+
+      include Base
+    end
+
+  end
+end

data/lib/formtastic_tristate_radio/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FormtasticTristateRadio
-  VERSION = '0.2.1'
+  VERSION = "0.2.5"
 end

data/lib/formtastic_tristate_radio.rb

@@ -1,9 +1,7 @@
 require_relative "formtastic_tristate_radio/version"
+require_relative "formtastic_tristate_radio/configuration"
+require_relative "formtastic_tristate_radio/i18n/error"
 require_relative "formtastic_tristate_radio/engine"
 require_relative "../app/models/active_record/base"
 
-module FormtasticTristateRadio
-
-  class MissingTranslationError < StandardError; end
-
-end
+module FormtasticTristateRadio; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: formtastic_tristate_radio
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.5
 platform: ruby
 authors:
 - Sergey Pedan
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-04 00:00:00.000000000 Z
+date: 2021-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: formtastic
@@ -50,13 +50,27 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '7'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.9.20
     - - "<"
       - !ruby/object:Gem::Version
         version: '1'
@@ -66,13 +80,16 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.9.20
     - - "<"
       - !ruby/object:Gem::Version
         version: '1'
-description: 'Have 3-state radiobuttons instead of a 2-state checkbox for your Boolean
-  columns which can store NULL. Does not change controls, you need to turn it on via
-  `as: :tristate_radio` option.'
+description: |
+  Have 3-state radiobuttons instead of a 2-state checkbox for your Boolean columns which can store NULL. This gem:
+  1. Provides a custom Formtastic input type `:tristate_radio` which renders 3 radios (“Yes”, “No”, “Unset”) instead of a checkbox (only where you put it).
+  2. Teaches Rails recognize `"null"` and `"nil"` param values as `nil`
+  3. Encourages you to add translations for ActiveAdmin “status tag” so that `nil` be correctly translated as “Unset” instead of “False”.
+  Does not change controls, you need to turn it on via `as: :tristate_radio` option.
 email:
 - sergey.pedan@gmail.com
 executables: []
@@ -82,20 +99,24 @@ extra_rdoc_files:
 - CHANGELOG.md
 files:
 - CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
 - README.md
 - Rakefile
 - app/inputs/tristate_radio_input.rb
 - app/models/active_record/base.rb
 - config/initializers/activemodel_type_boolean.rb
-- config/locales/active_admin.en.yml
-- config/locales/active_admin.ru.yml
-- config/locales/formtastic.en.yml
-- config/locales/formtastic.ru.yml
+- config/locales/active_admin.yml
+- config/locales/formtastic.yml
 - config/routes.rb
+- formtastic_tristate_radio-0.2.4.gem
+- formtastic_tristate_radio.gemspec
 - lib/formtastic_tristate_radio.rb
+- lib/formtastic_tristate_radio/configuration.rb
 - lib/formtastic_tristate_radio/engine.rb
+- lib/formtastic_tristate_radio/i18n/error.rb
 - lib/formtastic_tristate_radio/version.rb
-- lib/tasks/formtastic_tristate_radio_tasks.rake
 homepage: https://github.com/sergeypedan/formtastic-tristate-radio
 licenses:
 - MIT
@@ -108,11 +129,11 @@ post_install_message:
 rdoc_options:
 - "--charset=UTF-8"
 require_paths:
-- lib
 - app/inputs
 - app/models/active_record
 - config/initializers
 - config/locales
+- lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/config/locales/active_admin.en.yml

@@ -1,5 +0,0 @@
----
-en:
-  active_admin:
-    status_tag:
-      unset: Unset

data/config/locales/active_admin.ru.yml

@@ -1,7 +0,0 @@
----
-ru:
-  active_admin:
-    status_tag:
-      :no: Нет
-      :yes: Да
-      unset: Неизвестно

data/config/locales/formtastic.en.yml

@@ -1,4 +0,0 @@
----
-en:
-  formtastic:
-    :null: Unset

data/config/locales/formtastic.ru.yml

@@ -1,6 +0,0 @@
----
-ru:
-  formtastic:
-    :no: Нет
-    :null: Неизвестно
-    :yes: Да

data/lib/tasks/formtastic_tristate_radio_tasks.rake

@@ -1,4 +0,0 @@
-# desc "Explaining what the task does"
-# task :formtastic_tristate_radio do
-#   # Task goes here
-# end