exwiw 1.1.4 → 1.1.6

data/lib/exwiw/runner.rb

@@ -203,6 +203,7 @@ module Exwiw
       AfterInsertHook.run(
         path: @after_insert_hook_path,
         cli_options: @cli_options,
+        dump_target: @dump_target,
         output_dir: @output_dir,
         next_idx: total_size + 1,
         output_extension: adapter.output_extension,

data/lib/exwiw/table_config.rb

@@ -38,6 +38,9 @@ module Exwiw
     # different column name on this table).
     attribute :scope_exempt, Serdes::OptionalType.new(Serdes::ConcreteType.new(Boolean)), skip_serializing_if_nil: true
     attribute :scope_column, optional(String), skip_serializing_if_nil: true
+    # The ID space (Exwiw::DumpTarget#ids) the `scope_column` values belong to.
+    # nil means `default`. User-configured, never generated.
+    attribute :id_space, optional(String), skip_serializing_if_nil: true
 
     # `reverse_scope` opts a table into multi-referencer reverse scoping (see
     # Exwiw::ReverseScope and QueryAstBuilder#build_referenced_by_clause): a
@@ -175,6 +178,7 @@ module Exwiw
         merged_table.bulk_insert_chunk_size = bulk_insert_chunk_size
         merged_table.scope_exempt = scope_exempt
         merged_table.scope_column = scope_column
+        merged_table.id_space = id_space
         merged_table.reverse_scope = reverse_scope
         merged_table.batch_scope = batch_scope
 
@@ -250,6 +254,19 @@ module Exwiw
                 "Table '#{name}': reverse_scope.column '#{reverse_scope.column}' is not a declared column."
         end
 
+        if id_space
+          unless id_space.match?(ID_SPACE_NAME_PATTERN)
+            raise ArgumentError,
+                  "Table '#{name}': id_space '#{id_space}' must start with a lowercase letter and " \
+                  "contain only lowercase letters, digits and underscores."
+          end
+          if scope_column.nil?
+            raise ArgumentError,
+                  "Table '#{name}': id_space names the ID space of the scope_column values, " \
+                  "so it requires scope_column."
+          end
+        end
+
         columns.each { |column| validate_ruby_side_masking!(column) }
       end
     end

data/lib/exwiw/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Exwiw
-  VERSION = "1.1.4"
+  VERSION = "1.1.6"
 end

data/lib/exwiw.rb

@@ -64,7 +64,46 @@ module Exwiw
   # (`scope_column IN ids`) and tables lacking it are reached by walking
   # belongs_to up to the nearest table that has it. When set, `table_name` is
   # nil. SQL adapters only.
-  DumpTarget = Struct.new(:table_name, :ids, :ids_field, :scope_column, keyword_init: true)
+  #
+  # `ids` maps an ID space name to its values. A table's `scope_column` values
+  # belong to the ID space it declares (`id_space`, `default` when omitted), so
+  # groups of tables keyed by unrelated kinds of id can be scoped in one run. An
+  # Array is taken as the values of the `default` space. Single-target mode and
+  # the mongodb adapter use the `default` space only.
+  DEFAULT_ID_SPACE = "default"
+  ID_SPACE_NAME_PATTERN = /\A[a-z][a-z0-9_]*\z/
+
+  DumpTarget = Struct.new(:table_name, :ids, :ids_field, :scope_column, keyword_init: true) do
+    def self.normalize_ids(ids)
+      case ids
+      when nil then {}
+      when Hash then ids.to_h { |space, values| [space.to_s, Array(values)] }
+      else { DEFAULT_ID_SPACE => Array(ids) }
+      end
+    end
+
+    def initialize(**kwargs)
+      super
+      self.ids = ids
+    end
+
+    def ids=(value)
+      self[:ids] = self.class.normalize_ids(value)
+    end
+
+    def ids_for(id_space)
+      ids.fetch(id_space, [])
+    end
+
+    def default_ids
+      ids_for(DEFAULT_ID_SPACE)
+    end
+
+    # ID spaces other than `default` that were given, with or without values.
+    def named_id_spaces
+      ids.keys - [DEFAULT_ID_SPACE]
+    end
+  end
   # `uri` is an optional full connection string (currently only honored by the
   # mongodb adapter, e.g. `mongodb+srv://...`). When present it is the source of
   # truth for the connection — host/port/user/password are ignored — so TLS,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exwiw
 version: !ruby/object:Gem::Version
-  version: 1.1.4
+  version: 1.1.6
 platform: ruby
 authors:
 - Shia
@@ -47,6 +47,7 @@ extensions:
 - ext/exwiw/ext_json/extconf.rb
 extra_rdoc_files: []
 files:
+- AGENTS.md
 - CHANGELOG.md
 - LICENSE.txt
 - README.md