mobility 0.8.13 → 1.0.0

data/lib/rails/generators/mobility/templates/create_string_translations.rb

@@ -1,5 +1,4 @@
 class CreateStringTranslations < <%= activerecord_migration_class %>
-
   def change
     create_table :mobility_string_translations do |t|
       t.string :locale, null: false

data/lib/rails/generators/mobility/templates/create_text_translations.rb

@@ -1,5 +1,4 @@
 class CreateTextTranslations < <%= activerecord_migration_class %>
-
   def change
     create_table :mobility_text_translations do |t|
       t.string :locale, null: false

data/lib/rails/generators/mobility/templates/initializer.rb

@@ -1,90 +1,116 @@
-Mobility.configure do |config|
-  # Sets the default backend to use in models. This can be overridden in models
-  # by passing +backend: ...+ to +translates+.
-  config.default_backend = :key_value
+Mobility.configure do
+  # PLUGINS
+  plugins do
+    # Backend
+    #
+    # Sets the default backend to use in models. This can be overridden in models
+    # by passing +backend: ...+ to +translates+.
+    #
+    # To default to a different backend globally, replace +:key_value+ by another
+    # backend name.
+    #
+    backend :key_value
 
-  # By default, Mobility uses the +translates+ class method in models to
-  # describe translated attributes, but you can configure this method to be
-  # whatever you like. This may be useful if using Mobility alongside another
-  # translation gem which uses the same method name.
-  config.accessor_method = :translates
+    # ActiveRecord
+    #
+    # Defines ActiveRecord as ORM, and enables ActiveRecord-specific plugins.
+    active_record
 
-  # To query on translated attributes, you need to append a scope to your
-  # model. The name of this scope is +i18n+ by default, but this can be changed
-  # to something else.
-  config.query_method    = :i18n
+    # Accessors
+    #
+    # Define reader and writer methods for translated attributes. Remove either
+    # to disable globally, or pass +reader: false+ or +writer: false+ to
+    # +translates+ in any translated model.
+    #
+    reader
+    writer
 
-  # Uncomment and remove (or add) items to (from) this list to completely
-  # disable/enable plugins globally (so they cannot be used and are never even
-  # loaded). Note that if you remove an item from the list, you will not be
-  # able to use the plugin at all, and any options for the plugin will be
-  # ignored by models. (In most cases, you probably don't want to change this.)
-  #
-  # config.plugins = %i[
-  #   query
-  #   cache
-  #   dirty
-  #   fallbacks
-  #   presence
-  #   default
-  #   attribute_methods
-  #   fallthrough_accessors
-  #   locale_accessors
-  # ]
+    # Backend Reader
+    #
+    # Defines reader to access the backend for any attribute, of the form
+    # +<attribute>_backend+.
+    #
+    backend_reader
+    #
+    # Or pass an interpolation string to define a different pattern:
+    # backend_reader "%s_translations"
 
-  # The translation cache is on by default, but you can turn it off by
-  # uncommenting this line. (This may be helpful in debugging.)
-  #
-  # config.default_options[:cache] = false
+    # Query
+    #
+    # Defines a scope on the model class which allows querying on
+    # translated attributes. The default scope is named +i18n+, pass a different
+    # name as default to change the global default, or to +translates+ in any
+    # model to change it for that model alone.
+    #
+    query
 
-  # Dirty tracking is disabled by default. Uncomment this line to enable it.
-  # If you enable this, you should also enable +locale_accessors+ by default
-  # (see below).
-  #
-  # config.default_options[:dirty] = true
+    # Cache
+    #
+    # Comment out to disable caching reads and writes.
+    #
+    cache
 
-  # No fallbacks are used by default. To define default fallbacks, uncomment
-  # and set the default fallback option value here. A "true" value will use
-  # whatever is defined by +I18n.fallbacks+ (if defined), or alternatively will
-  # fallback to your +I18n.default_locale+.
-  #
-  # config.default_options[:fallbacks] = true
+    # Dirty
+    #
+    # Uncomment this line to include and enable globally:
+    # dirty
+    #
+    # Or uncomment this line to include but disable by default, and only enable
+    # per model by passing +dirty: true+ to +translates+.
+    # dirty false
 
-  # The Presence plugin converts empty strings to nil when fetching and setting
-  # translations. By default it is on, uncomment this line to turn it off.
-  #
-  # config.default_options[:presence] = false
+    # Fallbacks
+    #
+    # Uncomment line below to enable fallbacks, using +I18n.fallbacks+.
+    # fallbacks
+    #
+    # Or uncomment this line to enable fallbacks with a global default.
+    # fallbacks { :pt => :en }
 
-  # Set a default value to use if the translation is nil. By default this is
-  # off, uncomment and set a default to use it across all models (you probably
-  # don't want to do that).
-  #
-  # config.default_options[:default] = ...
+    # Presence
+    #
+    # Converts blank strings to nil on reads and writes. Comment out to
+    # disable.
+    #
+    presence
 
-  # Uncomment to enable locale_accessors by default on models. A true value
-  # will use the locales defined either in
-  # Rails.application.config.i18n.available_locales or I18n.available_locales.
-  # If you want something else, pass an array of locales instead.
-  #
-  # config.default_options[:locale_accessors] = true
+    # Default
+    #
+    # Set a default translation per attributes. When enabled, passing +default:
+    # 'foo'+ sets a default translation string to show in case no translation is
+    # present. Can also be passed a proc.
+    #
+    # default 'foo'
 
-  # Uncomment to enable fallthrough accessors by default on models. This will
-  # allow you to call any method with a suffix like _en or _pt_br, and Mobility
-  # will catch the suffix and convert it into a locale in +method_missing+. If
-  # you don't need this kind of open-ended fallthrough behavior, it's better
-  # to use locale_accessors instead (which define methods) since method_missing
-  # is very slow. (You can use both fallthrough and locale accessor plugins
-  # together without conflict.)
-  #
-  # Note: The dirty plugin enables fallthrough_accessors by default.
-  #
-  # config.default_options[:fallthrough_accessors] = true
+    # Fallthrough Accessors
+    #
+    # Uses method_missing to define locale-specific accessor methods like
+    # +title_en+, +title_en=+, +title_fr+, +title_fr=+ for each translated
+    # attribute. If you know what set of locales you want to support, it's
+    # generally better to use Locale Accessors (or both together) since
+    # +method_missing+ is very slow.  (You can use both fallthrough and locale
+    # accessor plugins together without conflict.)
+    #
+    # fallthrough_accessors
 
-  # You can also include backend-specific default options. For example, if you
-  # want to default to using the text-type translation table with the KeyValue
-  # backend, you can set that as a default by uncommenting this line, or change
-  # it to :string to default to the string-type translation table instead. (For
-  # other backends, this option is ignored.)
-  #
-  # config.default_options[:type] = :text
+    # Locale Accessors
+    #
+    # Uses +def+ to define accessor methods for a set of locales. By default uses
+    # +I18n.available_locales+, but you can pass the set of locales with
+    # +translates+ and/or set a global default here.
+    #
+    # locale_accessors
+    #
+    # Or define specific defaults by uncommenting line below
+    # locale_accessors [:en, :ja]
+
+    # Attribute Methods
+    #
+    # Adds translated attributes to +attributes+ hash, and defines methods
+    # +translated_attributes+ and +untranslated_attributes+ which return hashes
+    # with translatd and untranslated attributes, respectively. Be aware that
+    # this plugin can create conflicts with other gems.
+    #
+    # attribute_methods
+  end
 end

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: mobility
 version: !ruby/object:Gem::Version
-  version: 0.8.13
+  version: 1.0.0
 platform: ruby
 authors:
 - Chris Salzberg
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain:
 - |
@@ -34,7 +34,7 @@ cert_chain:
   gSQml7TqcC6dZRsZRwYqzD9kUwdAJoCqno2CBUKs2l0yQAjFT36lRrVJznb7uWwa
   xpPFnsrtyaZW6Dty8TSG3qzmeGpmpIotA8x1VA==
   -----END CERTIFICATE-----
-date: 2020-05-27 00:00:00.000000000 Z
+date: 2020-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: request_store
@@ -156,23 +156,7 @@ files:
 - README.md
 - Rakefile
 - lib/mobility.rb
-- lib/mobility/active_model.rb
-- lib/mobility/active_model/backend_resetter.rb
-- lib/mobility/active_record.rb
-- lib/mobility/active_record/backend_resetter.rb
-- lib/mobility/active_record/model_translation.rb
-- lib/mobility/active_record/string_translation.rb
-- lib/mobility/active_record/text_translation.rb
-- lib/mobility/active_record/translation.rb
-- lib/mobility/active_record/uniqueness_validator.rb
-- lib/mobility/arel.rb
-- lib/mobility/arel/nodes.rb
-- lib/mobility/arel/nodes/pg_ops.rb
-- lib/mobility/arel/visitor.rb
-- lib/mobility/attributes.rb
 - lib/mobility/backend.rb
-- lib/mobility/backend/orm_delegator.rb
-- lib/mobility/backend_resetter.rb
 - lib/mobility/backends.rb
 - lib/mobility/backends/active_record.rb
 - lib/mobility/backends/active_record/column.rb
@@ -186,6 +170,7 @@ files:
 - lib/mobility/backends/active_record/table.rb
 - lib/mobility/backends/column.rb
 - lib/mobility/backends/container.rb
+- lib/mobility/backends/hash.rb
 - lib/mobility/backends/hash_valued.rb
 - lib/mobility/backends/hstore.rb
 - lib/mobility/backends/json.rb
@@ -204,20 +189,26 @@ files:
 - lib/mobility/backends/sequel/table.rb
 - lib/mobility/backends/serialized.rb
 - lib/mobility/backends/table.rb
-- lib/mobility/configuration.rb
-- lib/mobility/fallbacks.rb
-- lib/mobility/interface.rb
-- lib/mobility/loaded.rb
+- lib/mobility/pluggable.rb
+- lib/mobility/plugin.rb
 - lib/mobility/plugins.rb
 - lib/mobility/plugins/active_model.rb
+- lib/mobility/plugins/active_model/cache.rb
 - lib/mobility/plugins/active_model/dirty.rb
 - lib/mobility/plugins/active_record.rb
-- lib/mobility/plugins/active_record/attribute_methods.rb
+- lib/mobility/plugins/active_record/backend.rb
+- lib/mobility/plugins/active_record/cache.rb
 - lib/mobility/plugins/active_record/dirty.rb
 - lib/mobility/plugins/active_record/query.rb
+- lib/mobility/plugins/active_record/uniqueness_validation.rb
+- lib/mobility/plugins/arel.rb
+- lib/mobility/plugins/arel/nodes.rb
+- lib/mobility/plugins/arel/nodes/pg_ops.rb
 - lib/mobility/plugins/attribute_methods.rb
+- lib/mobility/plugins/attributes.rb
+- lib/mobility/plugins/backend.rb
+- lib/mobility/plugins/backend_reader.rb
 - lib/mobility/plugins/cache.rb
-- lib/mobility/plugins/cache/translation_cacher.rb
 - lib/mobility/plugins/default.rb
 - lib/mobility/plugins/dirty.rb
 - lib/mobility/plugins/fallbacks.rb
@@ -225,19 +216,14 @@ files:
 - lib/mobility/plugins/locale_accessors.rb
 - lib/mobility/plugins/presence.rb
 - lib/mobility/plugins/query.rb
+- lib/mobility/plugins/reader.rb
 - lib/mobility/plugins/sequel.rb
+- lib/mobility/plugins/sequel/backend.rb
+- lib/mobility/plugins/sequel/cache.rb
 - lib/mobility/plugins/sequel/dirty.rb
 - lib/mobility/plugins/sequel/query.rb
-- lib/mobility/sequel.rb
-- lib/mobility/sequel/backend_resetter.rb
-- lib/mobility/sequel/column_changes.rb
-- lib/mobility/sequel/hash_initializer.rb
-- lib/mobility/sequel/model_translation.rb
-- lib/mobility/sequel/sql.rb
-- lib/mobility/sequel/string_translation.rb
-- lib/mobility/sequel/text_translation.rb
-- lib/mobility/sequel/translation.rb
-- lib/mobility/translates.rb
+- lib/mobility/plugins/writer.rb
+- lib/mobility/translations.rb
 - lib/mobility/util.rb
 - lib/mobility/version.rb
 - lib/rails/generators/mobility/active_record_migration_compatibility.rb
@@ -257,8 +243,17 @@ files:
 homepage: https://github.com/shioyama/mobility
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  homepage_uri: https://github.com/shioyama/mobility
+  source_code_uri: https://github.com/shioyama/mobility
+  changelog_uri: https://github.com/shioyama/mobility/blob/master/CHANGELOG.md
+post_install_message: |2
+
+  Warning: Mobility v1.0 includes backwards-incompatible changes (mostly around configuration).
+
+  If you are upgrading from an earlier version, please see:
+  - https://github.com/shioyama/mobility/releases/tag/v1.0.0
+  - https://github.com/shioyama/mobility/wiki/Introduction-to-Mobility-v1.0
 rdoc_options: []
 require_paths:
 - lib
@@ -266,15 +261,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.7
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: Pluggable Ruby translation framework
 test_files: []

data/lib/mobility/active_model.rb

@@ -1,4 +0,0 @@
-module Mobility
-  module ActiveModel
-  end
-end

data/lib/mobility/active_model/backend_resetter.rb

@@ -1,26 +0,0 @@
-module Mobility
-  module ActiveModel
-=begin
-
-Backend resetter for ActiveModel models. Adds hook to reset backend when
-+changes_applied+ or +clear_changes_information+ methods are called on model.
-
-=end
-    class BackendResetter < Mobility::BackendResetter
-
-      # (see Mobility::BackendResetter#initialize)
-      def initialize(attribute_names, &block)
-        super
-
-        model_reset_method = @model_reset_method
-
-        %i[changes_applied clear_changes_information].each do |method|
-          define_method method do
-            super()
-            instance_eval(&model_reset_method)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mobility/active_record.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-require "mobility/arel"
-
-module Mobility
-=begin
-
-Module loading ActiveRecord-specific classes for Mobility models.
-
-=end
-  module ActiveRecord
-    require "mobility/active_record/uniqueness_validator"
-
-    def self.included(model_class)
-      model_class.class_eval do
-        unless const_defined?(:UniquenessValidator)
-          const_set(:UniquenessValidator,
-                    Class.new(::Mobility::ActiveRecord::UniquenessValidator))
-        end
-        delegate :translated_attribute_names, to: :class
-      end
-    end
-  end
-end

data/lib/mobility/active_record/backend_resetter.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-require "mobility/active_model/backend_resetter"
-
-module Mobility
-  module ActiveRecord
-=begin
-
-Backend resetter for ActiveRecord models. Adds hook on +reload+ event to
-{Mobility::ActiveModel::BackendResetter}.
-
-=end
-    class BackendResetter < Mobility::ActiveModel::BackendResetter
-
-      # (see Mobility::BackendResetter#initialize)
-      def initialize(attribute_names, &block)
-        super
-
-        model_reset_method = @model_reset_method
-
-        define_method :reload do |*args|
-          super(*args).tap { instance_eval(&model_reset_method) }
-        end
-      end
-    end
-  end
-end

data/lib/mobility/active_record/model_translation.rb

@@ -1,14 +0,0 @@
-module Mobility
-  module ActiveRecord
-=begin
-
-Subclassed dynamically to generate translation class in
-{Backends::ActiveRecord::Table} backend.
-
-=end
-    class ModelTranslation < ::ActiveRecord::Base
-      self.abstract_class = true
-      validates :locale, presence: true
-    end
-  end
-end