russian 0.6.0 → 1.0.0

data/lib/russian/action_view_ext/helpers/date_helper.rb

@@ -1,118 +1,153 @@
-# -*- encoding: utf-8 -*- 
+# frozen_string_literal: true
 
-# Заменяет хелпер Rails <tt>select_month</tt> и метод <tt>translated_month_names</tt> 
-# для поддержки функционала "отдельностоящих имен месяцев".
-#
-# Теперь можно использовать и полные, и сокращенные название месяцев в двух вариантах -- контекстном
-# (по умолчанию) и отдельностоящем (если в текущем языке есть соответствующие переводы).
-# Теперь хелперы поддерживают ключ <tt>:use_standalone_month_names</tt>, хелпер <tt>select_month</tt> 
-# устанавливает его по умолчанию.
-# Отдельностоящие имена месяцев также используютс когда указан ключ <tt>:discard_day</tt>.
-#
-#
-# Replaces Rails <tt>select_month</tt> helper and <tt>translated_month_names</tt> private method to provide
-# "standalone month names" feature. 
-#
-# It is now possible to use both abbreviated and full month names in two variants (if current locale provides them).
-# All date helpers support <tt>:use_standalone_month_names</tt> key now, <tt>select_month</tt> helper sets 
-# it to true by default.
-# Standalone month names are also used when <tt>:discard_day</tt> key is provided.
-if defined?(ActionView::Helpers::DateTimeSelector)
-  module ActionView
+module Russian
+  # Rails date helper integration with support for standalone month names.
+  #
+  # The patch teaches Rails date helpers to distinguish between common
+  # ("01 декабря") and standalone ("Декабрь") month names when the active
+  # locale provides both forms.
+  #
+  # For Russian, `select_month` always uses standalone month names. Other month
+  # rendering helpers switch to standalone names when `:discard_day` or
+  # `:use_standalone_month_names` is set. If split translations are unavailable,
+  # the implementation falls back to the standard Rails month-name keys.
+  #
+  #
+  # Интеграция с Rails date helper'ами для поддержки отдельностоящих
+  # названий месяцев.
+  #
+  # Патч учит Rails date helper'ы различать контекстные ("01 декабря") и
+  # отдельностоящие ("Декабрь") формы названий месяцев, если активная локаль
+  # предоставляет обе формы.
+  #
+  # Для русского языка `select_month` всегда использует отдельностоящие
+  # названия месяцев. Остальные helper'ы, рендерящие месяцы, переключаются на
+  # отдельностоящие формы, если указан `:discard_day` или
+  # `:use_standalone_month_names`. Если раздельных переводов нет, реализация
+  # откатывается к стандартным ключам Rails для названий месяцев.
+  module ActionViewExt
+    # Helper patches injected into Action View.
+    #
+    #
+    # Патчи хелперов, внедряемые в Action View.
     module Helpers
-      module DateHelper
-        # Returns a select tag with options for each of the months January through December with the current month
-        # selected. The month names are presented as keys (what's shown to the user) and the month numbers (1-12) are
-        # used as values (what's submitted to the server). It's also possible to use month numbers for the presentation
-        # instead of names -- set the <tt>:use_month_numbers</tt> key in +options+ to true for this to happen. If you
-        # want both numbers and names, set the <tt>:add_month_numbers</tt> key in +options+ to true. If you would prefer
-        # to show month names as abbreviations, set the <tt>:use_short_month</tt> key in +options+ to true. If you want
-        # to use your own month names, set the <tt>:use_month_names</tt> key in +options+ to an array of 12 month names. 
-        # You can also choose if you want to use i18n standalone month names or default month names -- you can
-        # force standalone month names usage by using <tt>:use_standalone_month_names</tt> key.
-        # Override the field name using the <tt>:field_name</tt> option, 'month' by default.
-        #
-        #
-        # Также поддерживается ключ <tt>:use_standalone_month_names</tt> для явного указания о необходимости
-        # использования отдельностоящих имен месяцев, если текущий язык их поддерживает.
+      # @private
+      MONTH_NAME_KEYS = {
+        short: {
+          common: :"date.common_abbr_month_names",
+          standalone: :"date.standalone_abbr_month_names",
+          fallback: :"date.abbr_month_names"
+        },
+        long: {
+          common: :"date.common_month_names",
+          standalone: :"date.standalone_month_names",
+          fallback: :"date.month_names"
+        }
+      }.freeze
+
+      # Patch for `ActionView::Helpers::DateHelper`.
+      #
+      #
+      # Патч для `ActionView::Helpers::DateHelper`.
+      module DateHelperPatch
+        # Builds a `<select>` with month options and forces standalone month
+        # names for Russian.
         #
+        # The method keeps standard Rails month helper behavior and options,
+        # but injects `use_standalone_month_names: true` before delegating to
+        # Rails. This makes Russian month names render as standalone forms such
+        # as `Декабрь` instead of contextual forms such as `декабря`.
         #
-        # ==== Examples
-        #   # Generates a select field for months that defaults to the current month that
-        #   # will use keys like "January", "March".
-        #   select_month(Date.today)
         #
-        #   # Generates a select field for months that defaults to the current month that
-        #   # is named "start" rather than "month"
-        #   select_month(Date.today, :field_name => 'start')
+        # Формирует `<select>` со списком месяцев и принудительно использует
+        # отдельностоящие названия месяцев для русского языка.
         #
-        #   # Generates a select field for months that defaults to the current month that
-        #   # will use keys like "1", "3".
-        #   select_month(Date.today, :use_month_numbers => true)
+        # Метод сохраняет стандартное поведение и опции Rails month helper'а,
+        # но перед делегированием в Rails добавляет
+        # `use_standalone_month_names: true`. Благодаря этому для русского
+        # языка рендерятся отдельностоящие формы вроде `Декабрь`, а не
+        # контекстные формы вроде `декабря`.
         #
-        #   # Generates a select field for months that defaults to the current month that
-        #   # will use keys like "1 - January", "3 - March".
-        #   select_month(Date.today, :add_month_numbers => true)
+        # @param date [Date, Time, DateTime, Integer, nil] Selected month value.
+        #   Выбранное значение месяца.
+        # @param options [Hash] Rails helper options.
+        #   Опции Rails-хелпера.
+        # @option options [Boolean] :use_month_numbers Show month numbers instead of names.
+        #   Показывать номера месяцев вместо названий.
+        # @option options [Boolean] :add_month_numbers Prefix month names with numbers.
+        #   Добавлять номер месяца перед названием.
+        # @option options [Boolean] :use_short_month Use abbreviated month names.
+        #   Использовать сокращенные названия месяцев.
+        # @option options [Array<String>] :use_month_names Custom month names array.
+        #   Пользовательский массив названий месяцев.
+        # @option options [String, Symbol] :field_name Override the field name, `"month"` by default.
+        #   Переопределить имя поля; по умолчанию используется `"month"`.
+        # @option options [Boolean] :use_standalone_month_names Request standalone month names explicitly.
+        #   Явно запросить отдельностоящие названия месяцев.
+        # @param html_options [Hash] HTML options.
+        #   HTML-опции.
+        # @return [String] HTML for the select tag.
+        #   HTML для select-тега.
         #
-        #   # Generates a select field for months that defaults to the current month that
-        #   # will use keys like "Jan", "Mar".
-        #   select_month(Date.today, :use_short_month => true)
+        # @example Default Russian output
+        #   select_month(Date.new(2024, 12, 1))
+        #   # => uses standalone month names for :ru
         #
-        #   # Generates a select field for months that defaults to the current month that
-        #   # will use keys like "Januar", "Marts."
-        #   select_month(Date.today, :use_month_names => %w(Januar Februar Marts ...))
+        # @example Custom field name
+        #   select_month(Date.new(2024, 12, 1), field_name: "start")
+        #   # => overrides the generated field name
         #
+        # @example Abbreviated standalone month names
+        #   select_month(Date.new(2024, 12, 1), use_short_month: true)
+        #   # => uses abbreviated standalone month names
         def select_month(date, options = {}, html_options = {})
-          DateTimeSelector.new(date, options.merge(:use_standalone_month_names => true), html_options).select_month
+          super(date, options.merge(use_standalone_month_names: true), html_options)
         end
       end
-      
-      class DateTimeSelector #:nodoc:
+
+      # @private
+      module DateTimeSelectorPatch
         private
-          # Returns translated month names
-          #  => [nil, "January", "February", "March",
-          #           "April", "May", "June", "July",
-          #           "August", "September", "October",
-          #           "November", "December"]
-          #
-          # If :use_short_month option is set
-          #  => [nil, "Jan", "Feb", "Mar", "Apr", "May", "Jun",
-          #           "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
-          #
-          # Also looks up if <tt>:discard_day</tt> or <tt>:use_standalone_month_names</tt> option is set
-          # and uses i18n standalone month names if so.
-          #
-          #
-          # Также в зависимости от использования ключей <tt>:discard_day</tt> или <tt>:use_standalone_month_names</tt>
-          # убеждается, есть ли соотвествующие переводы в текущем языке и использует "отдельностоящие" названия
-          # месяцев по необходимости
-          def translated_month_names
-            if @options[:use_short_month]
-              if I18n.backend.send(:lookup, I18n.locale, :'date.common_abbr_month_names')
-                if (@options[:discard_day] || @options[:use_standalone_month_names])
-                  key = :'date.standalone_abbr_month_names'
-                else
-                  key = :'date.common_abbr_month_names'
-                end
-              else
-                key = :'date.abbr_month_names'
-              end
-            else
-              if I18n.backend.send(:lookup, I18n.locale, :'date.common_month_names')
-                if (@options[:discard_day] || @options[:use_standalone_month_names])
-                  key = :'date.standalone_month_names'
-                else
-                  key = :'date.common_month_names'
-                end
-              else
-                key = :'date.month_names'
-              end
-            end
-            
-            I18n.translate(key, :locale => @options[:locale])
-          end
-          
+
+        # Returns translated month names for the current selector options.
+        #
+        # The method chooses between common and standalone month-name
+        # translations depending on `:discard_day`,
+        # `:use_standalone_month_names`, and `:use_short_month`. If split
+        # common/standalone translations are not defined for the current
+        # locale, it falls back to the standard Rails month-name keys.
+        #
+        #
+        # Возвращает переведенные названия месяцев для текущих
+        # опций selector'а.
+        #
+        # Метод выбирает между контекстными и отдельностоящими переводами
+        # названий месяцев в зависимости от `:discard_day`,
+        # `:use_standalone_month_names` и `:use_short_month`. Если для текущей
+        # локали не определены раздельные контекстные и отдельностоящие
+        # переводы, метод откатывается к стандартным ключам Rails.
+        #
+        # @return [Array<String, nil>] Month names array with `nil` at index `0`.
+        #   Массив названий месяцев с `nil` на позиции `0`.
+        def translated_month_names
+          I18n.translate(translated_month_names_key, locale: month_names_locale)
+        end
+
+        def translated_month_names_key
+          month_name_keys = MONTH_NAME_KEYS.fetch(@options[:use_short_month] ? :short : :long)
+          return month_name_keys[:fallback] unless I18n.exists?(month_name_keys[:common], month_names_locale)
+
+          standalone_month_names? ? month_name_keys[:standalone] : month_name_keys[:common]
+        end
+
+        def standalone_month_names?
+          @options[:discard_day] || @options[:use_standalone_month_names]
+        end
+
+        def month_names_locale
+          @options[:locale] || I18n.locale
+        end
       end
     end
   end
-end # if defined?
+end

data/lib/russian/active_model_ext/custom_error_message.rb

@@ -1,70 +1,51 @@
-# -*- encoding: utf-8 -*- 
+# frozen_string_literal: true
 
-if defined?(ActiveModel::Errors)
-  module ActiveModel
-    class Errors
-      # Redefine the ActiveModel::Errors.full_messages method:
-      #  Returns all the full error messages in an array. 'Base' messages are handled as usual.
-      #  Non-base messages are prefixed with the attribute name as usual UNLESS they begin with '^'
-      #  in which case the attribute name is omitted.
-      #  E.g. validates_acceptance_of :accepted_terms, :message => '^Please accept the terms of service'
+module Russian
+  # Extensions for ActiveModel integration.
+  #
+  #
+  # Расширения для интеграции с ActiveModel.
+  module ActiveModelExt
+    # Patch for `ActiveModel::Error.full_message`.
+    # Validation messages prefixed with `^` suppress the humanized
+    # attribute name in the resulting full message.
+    #
+    #
+    # Патч для `ActiveModel::Error.full_message`.
+    # Сообщения валидации с префиксом `^` подавляют humanized-имя
+    # атрибута в итоговом полном сообщении.
+    module ErrorPatch
+      # Builds a full validation message and optionally suppresses the
+      # attribute name when the message starts with `^`.
       #
-      # Переопределяет метод ActiveModel::Errors.full_messages. Сообщения об ошибках для атрибутов
-      # теперь не имеют префикса с названием атрибута если в сообщении об ошибке первым символом указан "^".
       #
-      # Так, например,
-      # 
-      #   validates_acceptance_of :accepted_terms, :message => 'нужно принять соглашение'
-      # 
-      # даст сообщение
-      # 
-      #   Accepted terms нужно принять соглашение
-      # 
-      # однако,
-      # 
-      #   validates_acceptance_of :accepted_terms, :message => '^Нужно принять соглашение'
-      # 
-      # даст сообщение
-      # 
-      #   Нужно принять соглашение
+      # Строит полное сообщение валидации и при необходимости подавляет имя
+      # атрибута, если сообщение начинается с `^`.
       #
+      # @param attribute [String, Symbol] Attribute name.
+      #   Имя атрибута.
+      # @param message [#to_s] Validation message.
+      #   Сообщение валидации.
+      # @param base [Object] Model instance.
+      #   Экземпляр модели.
+      # @return [String] Full validation message.
+      #   Полное сообщение валидации.
       #
-      # Returns all the full error messages in an array.
-      #
-      #   class Company
-      #     validates_presence_of :name, :address, :email
-      #     validates_length_of :name, :in => 5..30
-      #   end
-      #
-      #   company = Company.create(:address => '123 First St.')
-      #   company.errors.full_messages # =>
-      #     ["Name is too short (minimum is 5 characters)", "Name can't be blank", "Address can't be blank"]
-      def full_messages
-        full_messages = []
+      # @example
+      #   ActiveModel::Error.full_message(:agreement, "^Нужно согласиться с соглашением", record)
+      #   # => "Нужно согласиться с соглашением"
+      def full_message(attribute, message, base)
+        return super unless suppress_attribute_name?(attribute, message)
 
-        each do |attribute, messages|
-          messages = Array.wrap(messages)
-          next if messages.empty?
-
-          if attribute == :base
-            messages.each {|m| full_messages << m }
-          else
-            attr_name = attribute.to_s.gsub('.', '_').humanize
-            attr_name = @base.class.human_attribute_name(attribute, :default => attr_name)
-            options = { :attribute => attr_name, :default => "%{attribute} %{message}" }
+        message.to_s.delete_prefix("^")
+      end
 
-            messages.each do |m|
-              if m =~ /^\^/
-                full_messages << m[1..-1]
-              else
-                full_messages << I18n.t(:"errors.format", options.merge(:message => m))
-              end
-            end
-          end
-        end
+      private
 
-        full_messages
+      # @private
+      def suppress_attribute_name?(attribute, message)
+        attribute.to_s != "base" && message.to_s.start_with?("^")
       end
     end
   end
-end # if defined?
+end