Merge pull request #2 from aktsk/translations

AZQ1994 · web-flow · commit 714454754231 · 2025-12-22T19:08:21.000+09:00
Translate comments / outputs / warnings into English.
diff --git a/lib/simple_master.rb b/lib/simple_master.rb
@@ -33,7 +33,7 @@ def self.targets
   end
 
   def self.database_available?
-    # DBが存在しない場合、エラーになる
+    # Raises an error if the DB is missing
     ::ActiveRecord::Base.connection.verify!
 
     true
diff --git a/lib/simple_master/active_record/extension.rb b/lib/simple_master/active_record/extension.rb
@@ -75,7 +75,7 @@ def #{foreign_key}=(value)
               before_save do
                 if master_dirty[:#{name}]
                   master = master_dirty.delete(:#{name})
-                  # associationの代入後に別の値が代入された場合はassociationはsaveしない
+                  # Skip saving the association if the key was changed after assignment
                   if @_association_#{name}_source != #{foreign_key}
                     next
                   end
diff --git a/lib/simple_master/loader/query_loader.rb b/lib/simple_master/loader/query_loader.rb
@@ -24,11 +24,11 @@ def build_records(klass, raw)
         columns.each do |column_name|
           unless klass.method_defined?(:"#{column_name}=")
             if ENV["RAILS_ENV"] == "development"
-              # ローカル等環境の場合、何も起きないメソッドを用意し、エラーが起きないようにする
+              # In local/dev, define a no-op setter so loading does not raise
               klass.define_method(:"#{column_name}=", &:itself)
-              warn "#{klass}.#{column_name}カラムが定義されていません！"
+              warn "#{klass}.#{column_name} column is not defined!"
             else
-              fail "#{klass}.#{column_name}カラムが定義されていません！"
+              fail "#{klass}.#{column_name} column is not defined!"
             end
           end
         end
@@ -41,7 +41,7 @@ def build_records(klass, raw)
                 if child_klass == klass || child_klass.sti_base_class == klass
                   child_klass.new
                 else
-                  warn "[#{klass}] typeカラムに不正な値が入っています #{row}"
+                  warn "[#{klass}] Invalid value in the type column: #{row}"
                   next
                 end
               else
diff --git a/lib/simple_master/master.rb b/lib/simple_master/master.rb
@@ -30,7 +30,7 @@ def table_exists?
         table_available?
       end
 
-      # 自動作成のメソッドを module に入れることで、overrideできるようにしています。
+      # Auto-generated methods live in a module so they can be overridden.
       def simple_master_module
         @simple_master_module ||= Module.new
       end
@@ -78,7 +78,7 @@ def column_names
         all_columns.map(&:name)
       end
 
-      # ARの仕様と違い、カラムの存在を確認できるようにしただけ。
+      # Unlike ActiveRecord, we ensure column existence can be checked.
       #: () -> Hash[String, SimpleMaster::Master::Column]
       def columns_hash
         all_columns.index_by(&:name).with_indifferent_access
@@ -305,7 +305,7 @@ def build_default_object
         default_object = allocate
 
         all_columns.each do |column|
-          # 高速化のため、定義されていない場合でも nil を代入する
+          # Assign nil even when undefined to keep this fast
           default_object.send :"#{column.name}=", column.options[:default].freeze
           default_object.send :"_globalized_#{column.name}=", nil if column.options[:globalize]
         end
diff --git a/lib/simple_master/master/association/belongs_to_association.rb b/lib/simple_master/master/association/belongs_to_association.rb
@@ -53,7 +53,7 @@ def #{name}=(value)
             end
 
             def _#{name}_target_save?
-              # associationの代入後に別の値が代入された場合はassociationはsaveしない
+              # Skip saving the association if the key changed after assignment
               return false if @_association_#{name}_source != #{foreign_key}
 
               target = belongs_to_store[:#{name}]
diff --git a/lib/simple_master/master/association/belongs_to_polymorphic_association.rb b/lib/simple_master/master/association/belongs_to_polymorphic_association.rb
@@ -27,7 +27,7 @@ def target_class
 
         def init(master_class)
           unless master_class.method_defined?(foreign_type_class)
-            fail "[#{master_class}] polymorphic typeカラム <#{name}> に `polymorphic_type: true` の option を指定してください。"
+            fail "[#{master_class}] Please specify `polymorphic_type: true` on polymorphic type column <#{name}>."
           end
 
           master_class.simple_master_module.class_eval <<-RUBY, __FILE__, __LINE__ + 1
@@ -62,7 +62,7 @@ def #{name}=(value)
             end
 
             def _#{name}_target_save?
-              # associationの代入後に別の値が代入された場合はassociationはsaveしない
+              # Skip saving the association if the key changed after assignment
               return false if @_association_#{name}_source != #{foreign_key}
               return false if @_association_#{name}_class_source != #{foreign_type_class}
 
diff --git a/lib/simple_master/master/association/has_one_association.rb b/lib/simple_master/master/association/has_one_association.rb
@@ -24,7 +24,7 @@ def #{name}
               end
             else
               def #{name}
-                # nilの場合キャッシュヒットしないので、Arrayでキャッシュに入れる
+                # Store in an Array so nil values still hit the cache
                 values = (has_many_store[:#{name}] ||= [#{target_class}.simple_master_connection.find_by_#{foreign_key}(#{primary_key})])
                 values.first
               end
@@ -40,7 +40,7 @@ def #{name}
               end
             else
               def #{name}
-                # nilの場合キャッシュヒットしないので、Arrayでキャッシュに入れる
+                # Store in an Array so nil values still hit the cache
                 values = (has_many_store[:#{name}] ||= [#{target_class}.simple_master_connection.find_by_#{foreign_key}(#{primary_key})])
                 values.first
               end
diff --git a/lib/simple_master/master/column.rb b/lib/simple_master/master/column.rb
@@ -57,7 +57,7 @@ def #{name}_value_for_sql
             value
           end
 
-          # CSVの差分確認時など、生データ(DBの値 or CSVの値)をツールで見る時用
+          # For inspecting raw DB/CSV values when checking CSV diffs
           def #{name}_value_for_csv
             #{code_for_sql_value}
           end
diff --git a/lib/simple_master/master/column/boolean_column.rb b/lib/simple_master/master/column/boolean_column.rb
@@ -34,7 +34,7 @@ def code_for_conversion
 
         def code_for_sql_value
           <<-RUBY
-            # true, falseに対応しない場合があるので、0, 1に変換する
+            # Convert to 0/1 for systems that do not support true/false
             case #{name}
             when true
               1
diff --git a/lib/simple_master/master/column/enum_column.rb b/lib/simple_master/master/column/enum_column.rb
@@ -63,7 +63,7 @@ def #{name}_before_type_cast
           RUBY
 
           enum.each_key do |enum_name|
-            # 数字で開始する文字列の場合は作らない
+            # Skip generating helpers for names that start with a digit
             unless enum_name.match?(/\A\d/)
               master_class.simple_master_module.class_eval <<-RUBY, __FILE__, __LINE__ + 1
                 def #{prefix}#{enum_name}#{suffix}?
diff --git a/lib/simple_master/master/column/id_column.rb b/lib/simple_master/master/column/id_column.rb
@@ -16,7 +16,7 @@ def code_for_dirty_check
           <<-RUBY
             unless @#{name} == value
               dirty!
-              # IDの場合、@id_hashの修正が必要
+              # IDs require updating @id_hash when changed
               self.class.id_hash.delete(@#{name}) if @#{name}
             end
           RUBY
diff --git a/lib/simple_master/master/column/json_column.rb b/lib/simple_master/master/column/json_column.rb
@@ -17,7 +17,7 @@ def code_for_conversion
 
         def code_for_sql_value
           <<-RUBY
-            # to_json は不要な escape をしちゃうので、JSON.generateを利用
+            # Use JSON.generate because to_json adds unnecessary escaping
             #{name}&.then { JSON.generate(_1) }
           RUBY
         end
diff --git a/lib/simple_master/master/dsl.rb b/lib/simple_master/master/dsl.rb
@@ -2,7 +2,7 @@
 
 module SimpleMaster
   class Master
-    # クラス定義をするときに書くものはここのモジュールに集約される
+    # Items declared at class-definition time are grouped inside this module
     module Dsl
       TYPES_BY_OPTIONS = {
         polymorphic_type: Column::PolymorphicTypeColumn,
@@ -107,21 +107,21 @@ def globalize(column_name)
         }.tap { dsl_initializers << _1 }
       end
 
-      # * ロード時に生成され、datasetに保存されるキャッシュ。
+      # * Cache generated at load time and stored in the dataset.
       #
       #     cache_class_method method_name_symbol
       #
-      # * defの戻り値を利用すると、下記のようにも宣言可能
+      # * Can also be declared using the return value of a def:
       #
       #     cache_class_method def self.method_name
       #       ...
       #     end
       #
-      # * ブロックを渡す場合、既存メソッドではなく、ブロックでキャッシュ生成する。
+      # * Pass a block to generate the cache from the block instead of an existing method.
       #
       #     cache_class_method method_name_symbol { ... }
       #
-      # * クラスメソッドが生成され、複数の引数を渡すことでまとめて生成することが可能。
+      # * Defines class methods; multiple caches can be generated by passing several args.
       #
       #     cache_class_method(:cache1, :cache2) {
       #       ...
@@ -148,25 +148,25 @@ def cache_class_method(*args, &block)
 
       alias def_custom_cache cache_class_method
 
-      # レコードのロード後に一度メソッドをアクセスする
+      # Access the method once after the record is loaded
       def tap_instance_method(method_name)
         @instance_methods_need_tap ||= []
         @instance_methods_need_tap << method_name
       end
 
-      # * ロード時に生成され、インスタンス変数に保存されるキャッシュ。
-      #   挙動は軽いが、datasetを参照してはいけないので利用時に注意が必要。
-      #   基本的にレコードのattributeで生成するキャッシュとして利用する。
+      # * Cache generated at load time and stored in an instance variable.
+      #   Lightweight, but must not reference the dataset, so use with care.
+      #   Intended for caches derived from record attributes.
       #
       #     cache_attribute method_name_symbol
       #
-      # * defの戻り値を利用すると、下記のようにも宣言可能
+      # * Can also be declared using the return value of a def:
       #
       #     cache_attribute def method_name
       #       ...
       #     end
       #
-      # * ブロックを渡すと、ブロックでキャッシュ生成する。
+      # * Passing a block generates the cache from the block.
       # cache_attribute method_name { ... }
       def cache_attribute(method_name, &)
         calc_method_name = :"_attribute_cache_#{method_name}"
@@ -188,18 +188,18 @@ def #{method_name}
         tap_instance_method method_name
       end
 
-      # * ロード時に生成され、datasetに保存されるキャッシュ。
-      #   datasetを利用するので、cache_attributeより挙動が重い。
+      # * Cache generated at load time and stored in the dataset.
+      #   Heavier than cache_attribute because it uses the dataset.
       #
       #     cache_method method_name_symbol
       #
-      # * defの戻り値を利用すると、下記のようにも宣言可能
+      # * Can also be declared using the return value of a def:
       #
       #     cache_method def method_name
       #       ...
       #     end
       #
-      # * ブロックを渡すと、ブロックでキャッシュ生成する。
+      # * Passing a block generates the cache from the block.
       #
       #     cache_method method_name_symbol { ... }
       def cache_method(method_name, &)
diff --git a/lib/simple_master/master/editable.rb b/lib/simple_master/master/editable.rb
@@ -2,7 +2,7 @@
 
 module SimpleMaster
   class Master
-    # テストデータのために、save!などを提供する
+    # Provide save! helpers for test data
     module Editable
       extend ActiveSupport::Concern
 
@@ -28,7 +28,7 @@ def has_changes_to_save?
       end
 
       def record_to_save
-        # type_not_match?が前提
+        # Assumes type_not_match? has already been checked
         return nil if type.nil?
         return @record_to_save if @record_to_save && @record_to_save.type == type
 
@@ -39,7 +39,7 @@ def type_not_match?
         self.class.sti_class? && type != self.class.to_s
       end
 
-      # IDは全てのクラスで重複しないgeneratorを使用する
+      # Use a generator that avoids ID collisions across classes
       @@generated_id = 0 # rubocop:disable Style/ClassVars
       def generate_id
         loop do
@@ -77,9 +77,9 @@ def save!(**_options)
         end
 
         if @dirty
-          # 自身のテーブルを更新
+          # Update this table
           if type_not_match?
-            # 親クラスでデータを作成してしまう場合、作られたインスタンスを捨て、別途データを保存する
+            # If data would be created on the parent class, discard that instance and save separately
             record_to_save&.update!(attributes)
           else
             if new_record?
@@ -144,7 +144,7 @@ def destroy
       end
 
       def destroy!
-        fail "Destroyしてはいけない"
+        fail "Destroy is not allowed"
       end
 
       # NOTE: no freezing
diff --git a/lib/simple_master/master/filterable.rb b/lib/simple_master/master/filterable.rb
@@ -2,7 +2,7 @@
 
 module SimpleMaster
   class Master
-    # 検索用のメソッド定義
+    # Lookup helper methods
     module Filterable
       def find(id)
         id_hash.fetch(id)
@@ -33,7 +33,7 @@ def all_by!(key, value)
       end
 
       def all_in(key, values)
-        # NOTE: Array#flatten が重いので、使わないようにしています
+        # NOTE: Avoid Array#flatten because it is slow here
         grouped_hash.fetch(key).fetch_values(*values) { EMPTY_ARRAY }.flat_map(&:itself).freeze
       end
 
diff --git a/lib/simple_master/master/validatable.rb b/lib/simple_master/master/validatable.rb
@@ -45,7 +45,7 @@ module Validatable
       #: () -> bool
       def valid?
         _run_validate_callbacks
-        # 大量なerrorsインスタンスを作ることを避けるため errors.empty? ではなく、直接参照する
+        # Refer directly instead of errors.empty? to avoid creating many errors objects
         !Thread.current[:errors]&.[](self).present?
       end
 
diff --git a/lib/simple_master/storage/dataset.rb b/lib/simple_master/storage/dataset.rb
@@ -64,19 +64,19 @@ def load
 
           tables = targets.map(&:base_class).uniq.map { table(_1) }
 
-          timer("MasterDataロード") do
+          timer("MasterData load") do
             tables.each(&:load_records)
           end
 
-          timer("MasterDataキャッシュアップデート") do
+          timer("MasterData cache update") do
             SimpleMaster.use_dataset(self) do
               tables.each(&:update_class_method_cache)
               tables.each(&:tap_instance_methods)
               tables.each(&:freeze_all)
             end
           end
 
-          timer("キャッシュアップデート") do
+          timer("Cache update") do
             SimpleMaster.use_dataset(self) do
               self.class.run_after_load
             end
diff --git a/lib/simple_master/storage/table.rb b/lib/simple_master/storage/table.rb
@@ -26,7 +26,7 @@ def duplicate_for(dataset, table_klass = self.class)
           table.applied_diff = applied_diff
           table.digest = digest
 
-          # ロードされている場合、既存id_hash, grouped_hashをコピー
+          # If already loaded, copy existing id_hash and grouped_hash
           table.id_hash = id_hash if @id_hash
           table.grouped_hash = grouped_hash if @grouped_hash
           table.sub_tables = sub_tables&.transform_values { |sub_table|
@@ -76,7 +76,7 @@ def update_grouped_hash
 
       def update_class_method_cache
         self.class_method_cache = class_method_cache = {}.compare_by_identity
-        # blockだと宣言したクラスのコンテキストになるため、instance_eval を利用する
+        # Use instance_eval so a block runs in the declaring class context
         klass.all_class_method_cache_info.each do |args, initializer|
           result = klass.instance_eval(&initializer)
           if args.length == 1
@@ -163,15 +163,15 @@ def apply_diff_to_id_hash
 
           record_diff.each do |k, v|
             next if metadata_key?(k)
-            # jsonカラムでjsonが展開状態のケースも考慮（キーがstringとなってしまうため、jsonに戻してから代入）
+            # Handle expanded JSON columns by converting keys back to JSON strings before assignment
             if v.is_a?(Hash) || v.is_a?(Array)
               v = v.to_json
             end
             record.send(:"#{k}=", v)
           rescue NoMethodError => _e
-            raise ColumnNotExist, "カラム #{k} が #{klass} に存在しません."
+            raise ColumnNotExist, "Column #{k} does not exist on #{klass}."
           rescue => e
-            raise AssignmentError, "データの代入に失敗: #{klass}.#{k} = #{v.inspect}. Message: #{e.message}."
+            raise AssignmentError, "Failed to assign data: #{klass}.#{k} = #{v.inspect}. Message: #{e.message}."
           end
 
           id_hash[id] = record

Original file line number	Diff line number	Diff line change
`@@ -34,7 +34,7 @@ def code_for_conversion`
`34`	`34`
`35`	`35`	`def code_for_sql_value`
`36`	`36`	`<<-RUBY`
`37`		`- # true, falseに対応しない場合があるので、0, 1に変換する`
	`37`	`+ # Convert to 0/1 for systems that do not support true/false`
`38`	`38`	`case #{name}`
`39`	`39`	`when true`
`40`	`40`	`1`