paper_trail_diff 0.16.0 → 0.17.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +581 -1
- data/README.md +42 -7
- data/docs/architecture.md +7 -5
- data/docs/performance.md +86 -38
- data/docs/reference.md +309 -92
- data/docs/testing.md +240 -32
- data/lib/paper_trail_diff/activity_belongs_to_event_applier.rb +2 -16
- data/lib/paper_trail_diff/activity_boundary.rb +55 -34
- data/lib/paper_trail_diff/activity_child_candidate_loader.rb +46 -57
- data/lib/paper_trail_diff/activity_collection_event_applier.rb +3 -13
- data/lib/paper_trail_diff/activity_collection_route_updater.rb +1 -1
- data/lib/paper_trail_diff/activity_event.rb +33 -21
- data/lib/paper_trail_diff/activity_event_record_resolver.rb +16 -116
- data/lib/paper_trail_diff/activity_event_route_finder.rb +29 -29
- data/lib/paper_trail_diff/activity_event_snapshot_refresher.rb +2 -7
- data/lib/paper_trail_diff/activity_history.rb +90 -49
- data/lib/paper_trail_diff/activity_range.rb +9 -35
- data/lib/paper_trail_diff/activity_root_snapshot_refresher.rb +74 -40
- data/lib/paper_trail_diff/activity_root_steps.rb +10 -13
- data/lib/paper_trail_diff/activity_scope_filter.rb +77 -0
- data/lib/paper_trail_diff/activity_snapshot_delta.rb +12 -15
- data/lib/paper_trail_diff/activity_snapshot_sequence.rb +37 -15
- data/lib/paper_trail_diff/activity_target_candidate_loader.rb +35 -43
- data/lib/paper_trail_diff/activity_timeline_builder.rb +194 -249
- data/lib/paper_trail_diff/activity_transaction_grouper.rb +3 -1
- data/lib/paper_trail_diff/activity_tree_filter.rb +54 -13
- data/lib/paper_trail_diff/activity_version_collector.rb +72 -138
- data/lib/paper_trail_diff/activity_view.rb +22 -11
- data/lib/paper_trail_diff/analysis.rb +19 -5
- data/lib/paper_trail_diff/analysis_batch.rb +16 -58
- data/lib/paper_trail_diff/approximate_paths.rb +4 -8
- data/lib/paper_trail_diff/association_activity_edge.rb +5 -24
- data/lib/paper_trail_diff/association_activity_selection.rb +10 -18
- data/lib/paper_trail_diff/association_discovery.rb +1 -6
- data/lib/paper_trail_diff/association_key.rb +9 -6
- data/lib/paper_trail_diff/association_traversal.rb +49 -6
- data/lib/paper_trail_diff/batch_boundary_resolver.rb +33 -42
- data/lib/paper_trail_diff/batch_preload.rb +2 -12
- data/lib/paper_trail_diff/batched_root_analyses.rb +72 -0
- data/lib/paper_trail_diff/batched_root_analyzer.rb +16 -14
- data/lib/paper_trail_diff/batched_root_versions.rb +25 -20
- data/lib/paper_trail_diff/branch_snapshot_refresher.rb +27 -31
- data/lib/paper_trail_diff/change_attribution.rb +329 -0
- data/lib/paper_trail_diff/change_row.rb +30 -10
- data/lib/paper_trail_diff/comparison_batch.rb +3 -4
- data/lib/paper_trail_diff/configuration.rb +1 -1
- data/lib/paper_trail_diff/deleted_analysis_batch.rb +22 -37
- data/lib/paper_trail_diff/deleted_root_filter.rb +3 -6
- data/lib/paper_trail_diff/deprecation.rb +4 -43
- data/lib/paper_trail_diff/diagnostics.rb +1 -2
- data/lib/paper_trail_diff/direct_record_state_loader.rb +8 -1
- data/lib/paper_trail_diff/endpoint.rb +78 -44
- data/lib/paper_trail_diff/errors.rb +2 -9
- data/lib/paper_trail_diff/fallback_paths.rb +2 -5
- data/lib/paper_trail_diff/habtm_transaction_owners.rb +5 -3
- data/lib/paper_trail_diff/historical_association_reifier.rb +3 -1
- data/lib/paper_trail_diff/historical_filter.rb +40 -15
- data/lib/paper_trail_diff/historical_snapshot_store.rb +80 -38
- data/lib/paper_trail_diff/instrumentation.rb +0 -8
- data/lib/paper_trail_diff/live_endpoint_batch_loader.rb +11 -7
- data/lib/paper_trail_diff/live_endpoint_provider.rb +7 -23
- data/lib/paper_trail_diff/live_graph_collector.rb +3 -3
- data/lib/paper_trail_diff/nested_comparator.rb +46 -19
- data/lib/paper_trail_diff/net_change.rb +276 -0
- data/lib/paper_trail_diff/own_window.rb +35 -0
- data/lib/paper_trail_diff/paper_trail_adapter.rb +40 -45
- data/lib/paper_trail_diff/prepared_activity_index.rb +197 -45
- data/lib/paper_trail_diff/prepared_child_candidates.rb +58 -0
- data/lib/paper_trail_diff/prepared_edge_loader.rb +43 -107
- data/lib/paper_trail_diff/prepared_history.rb +20 -31
- data/lib/paper_trail_diff/prepared_history_loader.rb +46 -9
- data/lib/paper_trail_diff/prepared_record_index.rb +137 -47
- data/lib/paper_trail_diff/prepared_snapshot_builder.rb +16 -0
- data/lib/paper_trail_diff/prepared_state_association_reader.rb +17 -19
- data/lib/paper_trail_diff/read_snapshot.rb +41 -19
- data/lib/paper_trail_diff/recorded_changes.rb +10 -11
- data/lib/paper_trail_diff/recorded_changes_reader.rb +60 -0
- data/lib/paper_trail_diff/recorded_class.rb +14 -19
- data/lib/paper_trail_diff/recorded_columns.rb +33 -0
- data/lib/paper_trail_diff/root_version_plan.rb +20 -22
- data/lib/paper_trail_diff/root_version_selection.rb +39 -29
- data/lib/paper_trail_diff/scope_condition.rb +7 -17
- data/lib/paper_trail_diff/scope_ranking.rb +16 -22
- data/lib/paper_trail_diff/scoped_analysis.rb +27 -4
- data/lib/paper_trail_diff/scoped_analysis_builder.rb +4 -3
- data/lib/paper_trail_diff/scoped_root_selection.rb +60 -41
- data/lib/paper_trail_diff/snapshot_normalizer.rb +18 -3
- data/lib/paper_trail_diff/stored_json_values.rb +52 -0
- data/lib/paper_trail_diff/stored_time_precision.rb +30 -18
- data/lib/paper_trail_diff/stored_values.rb +20 -0
- data/lib/paper_trail_diff/support.rb +185 -35
- data/lib/paper_trail_diff/time_of_day.rb +39 -0
- data/lib/paper_trail_diff/time_range.rb +37 -20
- data/lib/paper_trail_diff/time_version_range.rb +5 -10
- data/lib/paper_trail_diff/timeline_builder.rb +3 -3
- data/lib/paper_trail_diff/timeline_range.rb +18 -12
- data/lib/paper_trail_diff/timeline_snapshot_provider.rb +1 -1
- data/lib/paper_trail_diff/total_order.rb +55 -0
- data/lib/paper_trail_diff/transaction_cut.rb +192 -91
- data/lib/paper_trail_diff/traversal_preparer.rb +5 -8
- data/lib/paper_trail_diff/value_objects.rb +8 -4
- data/lib/paper_trail_diff/version.rb +1 -1
- data/lib/paper_trail_diff/version_association_candidate_scope.rb +27 -16
- data/lib/paper_trail_diff/version_boundary.rb +37 -21
- data/lib/paper_trail_diff/version_query.rb +25 -25
- data/lib/paper_trail_diff/version_range.rb +12 -16
- data/lib/paper_trail_diff/version_sequence_diagnostics.rb +32 -0
- data/lib/paper_trail_diff/version_table.rb +12 -8
- data/lib/paper_trail_diff.rb +28 -42
- data/sig/generated/paper_trail_diff/activity_belongs_to_event_applier.rbs +0 -8
- data/sig/generated/paper_trail_diff/activity_boundary.rbs +39 -17
- data/sig/generated/paper_trail_diff/activity_child_candidate_loader.rbs +19 -22
- data/sig/generated/paper_trail_diff/activity_collection_event_applier.rbs +0 -5
- data/sig/generated/paper_trail_diff/activity_event.rbs +25 -9
- data/sig/generated/paper_trail_diff/activity_event_record_resolver.rbs +6 -34
- data/sig/generated/paper_trail_diff/activity_event_route_finder.rbs +11 -4
- data/sig/generated/paper_trail_diff/activity_event_snapshot_refresher.rbs +0 -3
- data/sig/generated/paper_trail_diff/activity_history.rbs +54 -19
- data/sig/generated/paper_trail_diff/activity_range.rbs +6 -20
- data/sig/generated/paper_trail_diff/activity_root_snapshot_refresher.rbs +36 -2
- data/sig/generated/paper_trail_diff/activity_root_steps.rbs +6 -6
- data/sig/generated/paper_trail_diff/activity_scope_filter.rbs +51 -0
- data/sig/generated/paper_trail_diff/activity_snapshot_delta.rbs +5 -3
- data/sig/generated/paper_trail_diff/activity_snapshot_sequence.rbs +21 -3
- data/sig/generated/paper_trail_diff/activity_target_candidate_loader.rbs +19 -24
- data/sig/generated/paper_trail_diff/activity_timeline_builder.rbs +121 -127
- data/sig/generated/paper_trail_diff/activity_tree_filter.rbs +41 -8
- data/sig/generated/paper_trail_diff/activity_version_collector.rbs +42 -35
- data/sig/generated/paper_trail_diff/activity_view.rbs +16 -8
- data/sig/generated/paper_trail_diff/analysis.rbs +15 -6
- data/sig/generated/paper_trail_diff/analysis_batch.rbs +6 -24
- data/sig/generated/paper_trail_diff/association_activity_edge.rbs +0 -13
- data/sig/generated/paper_trail_diff/association_activity_selection.rbs +6 -9
- data/sig/generated/paper_trail_diff/association_discovery.rbs +0 -3
- data/sig/generated/paper_trail_diff/association_key.rbs +5 -0
- data/sig/generated/paper_trail_diff/association_traversal.rbs +26 -2
- data/sig/generated/paper_trail_diff/batch_boundary_resolver.rbs +17 -17
- data/sig/generated/paper_trail_diff/batch_preload.rbs +0 -4
- data/sig/generated/paper_trail_diff/batched_root_analyses.rbs +47 -0
- data/sig/generated/paper_trail_diff/batched_root_analyzer.rbs +9 -8
- data/sig/generated/paper_trail_diff/batched_root_versions.rbs +10 -6
- data/sig/generated/paper_trail_diff/branch_snapshot_refresher.rbs +11 -5
- data/sig/generated/paper_trail_diff/change_attribution.rbs +194 -0
- data/sig/generated/paper_trail_diff/change_row.rbs +22 -7
- data/sig/generated/paper_trail_diff/deleted_analysis_batch.rbs +11 -12
- data/sig/generated/paper_trail_diff/deleted_root_filter.rbs +0 -2
- data/sig/generated/paper_trail_diff/deprecation.rbs +4 -24
- data/sig/generated/paper_trail_diff/direct_record_state_loader.rbs +4 -0
- data/sig/generated/paper_trail_diff/endpoint.rbs +40 -16
- data/sig/generated/paper_trail_diff/errors.rbs +2 -11
- data/sig/generated/paper_trail_diff/habtm_transaction_owners.rbs +2 -1
- data/sig/generated/paper_trail_diff/historical_filter.rbs +20 -9
- data/sig/generated/paper_trail_diff/historical_snapshot_store.rbs +40 -10
- data/sig/generated/paper_trail_diff/instrumentation.rbs +0 -3
- data/sig/generated/paper_trail_diff/live_endpoint_batch_loader.rbs +3 -0
- data/sig/generated/paper_trail_diff/live_endpoint_provider.rbs +5 -8
- data/sig/generated/paper_trail_diff/live_graph_collector.rbs +2 -2
- data/sig/generated/paper_trail_diff/nested_comparator.rbs +20 -4
- data/sig/generated/paper_trail_diff/net_change.rbs +168 -0
- data/sig/generated/paper_trail_diff/own_window.rbs +22 -0
- data/sig/generated/paper_trail_diff/paper_trail_adapter.rbs +9 -6
- data/sig/generated/paper_trail_diff/prepared_activity_index.rbs +114 -14
- data/sig/generated/paper_trail_diff/prepared_child_candidates.rbs +39 -0
- data/sig/generated/paper_trail_diff/prepared_edge_loader.rbs +18 -35
- data/sig/generated/paper_trail_diff/prepared_history.rbs +9 -12
- data/sig/generated/paper_trail_diff/prepared_history_loader.rbs +28 -3
- data/sig/generated/paper_trail_diff/prepared_record_index.rbs +68 -14
- data/sig/generated/paper_trail_diff/prepared_snapshot_builder.rbs +12 -0
- data/sig/generated/paper_trail_diff/prepared_state_association_reader.rbs +6 -7
- data/sig/generated/paper_trail_diff/read_snapshot.rbs +27 -8
- data/sig/generated/paper_trail_diff/recorded_changes.rbs +4 -2
- data/sig/generated/paper_trail_diff/recorded_changes_reader.rbs +41 -0
- data/sig/generated/paper_trail_diff/recorded_class.rbs +7 -6
- data/sig/generated/paper_trail_diff/recorded_columns.rbs +21 -0
- data/sig/generated/paper_trail_diff/root_version_plan.rbs +8 -4
- data/sig/generated/paper_trail_diff/root_version_selection.rbs +27 -13
- data/sig/generated/paper_trail_diff/scope_condition.rbs +0 -2
- data/sig/generated/paper_trail_diff/scope_ranking.rbs +10 -10
- data/sig/generated/paper_trail_diff/scoped_analysis.rbs +19 -0
- data/sig/generated/paper_trail_diff/scoped_analysis_builder.rbs +2 -2
- data/sig/generated/paper_trail_diff/scoped_root_selection.rbs +37 -14
- data/sig/generated/paper_trail_diff/snapshot_normalizer.rbs +7 -0
- data/sig/generated/paper_trail_diff/stored_json_values.rbs +35 -0
- data/sig/generated/paper_trail_diff/stored_time_precision.rbs +19 -5
- data/sig/generated/paper_trail_diff/stored_values.rbs +13 -0
- data/sig/generated/paper_trail_diff/support.rbs +120 -23
- data/sig/generated/paper_trail_diff/time_of_day.rbs +21 -0
- data/sig/generated/paper_trail_diff/time_range.rbs +15 -8
- data/sig/generated/paper_trail_diff/time_version_range.rbs +2 -5
- data/sig/generated/paper_trail_diff/timeline_builder.rbs +2 -2
- data/sig/generated/paper_trail_diff/timeline_range.rbs +12 -7
- data/sig/generated/paper_trail_diff/total_order.rbs +32 -0
- data/sig/generated/paper_trail_diff/transaction_cut.rbs +111 -52
- data/sig/generated/paper_trail_diff/traversal_preparer.rbs +2 -2
- data/sig/generated/paper_trail_diff/value_objects.rbs +5 -1
- data/sig/generated/paper_trail_diff/version_association_candidate_scope.rbs +10 -9
- data/sig/generated/paper_trail_diff/version_boundary.rbs +15 -8
- data/sig/generated/paper_trail_diff/version_query.rbs +17 -10
- data/sig/generated/paper_trail_diff/version_range.rbs +6 -9
- data/sig/generated/paper_trail_diff/version_sequence_diagnostics.rbs +13 -0
- data/sig/generated/paper_trail_diff/version_table.rbs +3 -0
- data/sig/generated/paper_trail_diff.rbs +16 -16
- metadata +28 -6
- data/lib/paper_trail_diff/preloaded_endpoint_batch_loader.rb +0 -60
- data/sig/generated/paper_trail_diff/preloaded_endpoint_batch_loader.rbs +0 -32
|
@@ -18,13 +18,10 @@ module PaperTrailDiff
|
|
|
18
18
|
# share these snapshots too, and the caches their refresher builds. They
|
|
19
19
|
# are the same for any root with that history, so reusing them depends on
|
|
20
20
|
# nothing but the history.
|
|
21
|
+
#
|
|
22
|
+
# A `start_at` is a window's; a range of versions starts at its first.
|
|
21
23
|
#: (untyped, Array[untyped], ?start_at: untyped, ?end_at: untyped) -> PreparedActivitySnapshots
|
|
22
|
-
def prepare(
|
|
23
|
-
record,
|
|
24
|
-
root_versions,
|
|
25
|
-
start_at: root_versions.first.created_at,
|
|
26
|
-
end_at: root_versions.last.created_at
|
|
27
|
-
)
|
|
24
|
+
def prepare(record, root_versions, start_at: nil, end_at: root_versions.last.created_at)
|
|
28
25
|
history = @store.prepare(record, root_versions, start_at: start_at, end_at: end_at)
|
|
29
26
|
last = @last
|
|
30
27
|
return last if last && last.history.equal?(history)
|
|
@@ -63,6 +60,11 @@ module PaperTrailDiff
|
|
|
63
60
|
@history&.activity_index
|
|
64
61
|
end
|
|
65
62
|
|
|
63
|
+
#: () -> Array[Array[untyped]]
|
|
64
|
+
def opening_transactions
|
|
65
|
+
@history&.opening_transactions || []
|
|
66
|
+
end
|
|
67
|
+
|
|
66
68
|
#: (untyped, untyped) -> RecordSnapshot?
|
|
67
69
|
def call(root_endpoint, context_endpoint)
|
|
68
70
|
@snapshotter.call(root_endpoint, context_endpoint, history: @history)
|
|
@@ -86,6 +88,13 @@ module PaperTrailDiff
|
|
|
86
88
|
history: @history)
|
|
87
89
|
end
|
|
88
90
|
|
|
91
|
+
# The state this root's snapshot at an endpoint is built from, where
|
|
92
|
+
# prepared history builds it.
|
|
93
|
+
#: (untyped) -> PreparedRecordState?
|
|
94
|
+
def root_state(root_endpoint)
|
|
95
|
+
@store.root_state(root_endpoint) if @history
|
|
96
|
+
end
|
|
97
|
+
|
|
89
98
|
#: (untyped, habtm_version: untyped) -> untyped
|
|
90
99
|
def association_reader(context_version, habtm_version:)
|
|
91
100
|
@store.association_reader(context_version, habtm_version: habtm_version, history: @history)
|
|
@@ -115,17 +124,12 @@ module PaperTrailDiff
|
|
|
115
124
|
@events = events
|
|
116
125
|
@snapshotter = snapshotter
|
|
117
126
|
@current = current
|
|
118
|
-
@transaction_groups = ActivityTransactionGroups.new(
|
|
127
|
+
@transaction_groups = ActivityTransactionGroups.new(
|
|
128
|
+
events, opening: snapshotter.opening_transactions
|
|
129
|
+
)
|
|
119
130
|
@root_endpoints = build_root_endpoints
|
|
120
131
|
end
|
|
121
132
|
|
|
122
|
-
#: () -> Array[RecordSnapshot?]
|
|
123
|
-
def call
|
|
124
|
-
snapshots = [] #: Array[RecordSnapshot?]
|
|
125
|
-
each { |_event, snapshot| snapshots << snapshot }
|
|
126
|
-
snapshots
|
|
127
|
-
end
|
|
128
|
-
|
|
129
133
|
#: () { (ActivityEvent, RecordSnapshot?) -> void } -> void
|
|
130
134
|
def each
|
|
131
135
|
first = @events.first
|
|
@@ -156,7 +160,7 @@ module PaperTrailDiff
|
|
|
156
160
|
incremental_root?(previous_event)
|
|
157
161
|
|
|
158
162
|
branches = @transaction_groups.branches_for(previous_event)
|
|
159
|
-
return
|
|
163
|
+
return rebuilt_snapshot(previous_event, event, previous_snapshot) unless branches
|
|
160
164
|
|
|
161
165
|
@snapshotter.refresh(
|
|
162
166
|
root_endpoint(event.version),
|
|
@@ -168,6 +172,24 @@ module PaperTrailDiff
|
|
|
168
172
|
)
|
|
169
173
|
end
|
|
170
174
|
|
|
175
|
+
# A transaction with a root event is read whole once it ends. Until then,
|
|
176
|
+
# PT-AT reads the records it saved as they stood before it began, so from
|
|
177
|
+
# one descendant's event to the next in the same transaction the snapshot
|
|
178
|
+
# is the same, and from the root's event to a descendant's only the root's
|
|
179
|
+
# own version applies, as when it is alone in its transaction. A create
|
|
180
|
+
# leaves nothing to advance. The root's version can record what the
|
|
181
|
+
# transaction changed, such as HABTM membership, so a snapshot at a root
|
|
182
|
+
# event is rebuilt.
|
|
183
|
+
#: (ActivityEvent, ActivityEvent, RecordSnapshot?) -> RecordSnapshot?
|
|
184
|
+
def rebuilt_snapshot(previous_event, event, previous_snapshot)
|
|
185
|
+
return full_snapshot(event) if event.root?
|
|
186
|
+
return full_snapshot(event) unless @transaction_groups.shared?(previous_event, event)
|
|
187
|
+
return previous_snapshot unless previous_event.root?
|
|
188
|
+
return full_snapshot(event) unless previous_snapshot
|
|
189
|
+
|
|
190
|
+
advance_root(previous_event, event, previous_snapshot)
|
|
191
|
+
end
|
|
192
|
+
|
|
171
193
|
#: (ActivityEvent) -> bool
|
|
172
194
|
def incremental_root?(event)
|
|
173
195
|
event.root? && @transaction_groups.isolated?(event)
|
|
@@ -2,14 +2,13 @@
|
|
|
2
2
|
# rbs_inline: enabled
|
|
3
3
|
|
|
4
4
|
module PaperTrailDiff
|
|
5
|
-
# Loads the `belongs_to` targets owners pointed at
|
|
6
|
-
#
|
|
5
|
+
# Loads the `belongs_to` targets owners pointed at from a start onward: at
|
|
6
|
+
# the start, after each change since, and in the live row.
|
|
7
7
|
#
|
|
8
8
|
# PT-AT records a version's foreign keys as they stood after its change, so
|
|
9
|
-
# the target at the start comes from the latest version before it
|
|
10
|
-
#
|
|
11
|
-
#
|
|
12
|
-
# change there -- an author renamed under an article nobody edited.
|
|
9
|
+
# the target at the start comes from the latest version before it. Reading
|
|
10
|
+
# only the owners' versions after the start misses a target whose owner did
|
|
11
|
+
# not change there -- an author renamed under an article nobody edited.
|
|
13
12
|
class ActivityTargetCandidateLoader
|
|
14
13
|
# A plain class rather than Data.define, which arrived in Ruby 3.2 while this
|
|
15
14
|
# gem supports 3.1.
|
|
@@ -19,48 +18,40 @@ module PaperTrailDiff
|
|
|
19
18
|
attr_reader :foreign_type #: String?
|
|
20
19
|
attr_reader :created_at #: untyped
|
|
21
20
|
attr_reader :event #: String?
|
|
22
|
-
attr_reader :version_id #: untyped
|
|
23
21
|
|
|
24
|
-
#: (untyped, untyped, String?, ?untyped, ?String
|
|
25
|
-
def initialize(owner_id, foreign_key_id, foreign_type, created_at = nil, event = nil
|
|
26
|
-
version_id = nil)
|
|
22
|
+
#: (untyped, untyped, String?, ?untyped, ?String?) -> void
|
|
23
|
+
def initialize(owner_id, foreign_key_id, foreign_type, created_at = nil, event = nil)
|
|
27
24
|
@owner_id = owner_id
|
|
28
25
|
@foreign_key_id = foreign_key_id
|
|
29
26
|
@foreign_type = foreign_type
|
|
30
27
|
@created_at = created_at
|
|
31
28
|
@event = event
|
|
32
|
-
@version_id = version_id
|
|
33
29
|
freeze
|
|
34
30
|
end
|
|
35
31
|
end
|
|
36
32
|
|
|
37
|
-
#: (untyped, Array[untyped], untyped,
|
|
38
|
-
def initialize(owner_class, owner_ids, reflection,
|
|
33
|
+
#: (untyped, Array[untyped], untyped, untyped) -> void
|
|
34
|
+
def initialize(owner_class, owner_ids, reflection, start_at)
|
|
39
35
|
@owner_class = owner_class
|
|
40
36
|
@owner_ids = owner_ids
|
|
41
37
|
@reflection = reflection
|
|
42
|
-
@
|
|
38
|
+
@start_at = start_at
|
|
43
39
|
end
|
|
44
40
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
rows = historical_rows.select do |row|
|
|
48
|
-
@range.recorded_before_end?(row.created_at, row.version_id)
|
|
49
|
-
end
|
|
50
|
-
@range.current_end? ? rows + current_rows : rows
|
|
51
|
-
end
|
|
52
|
-
|
|
53
|
-
# One shared query keeps the owner and timestamp needed to partition a
|
|
54
|
-
# batch's candidates back into each root's exact activity range.
|
|
41
|
+
# Queries shared by a batch's roots keep the owner and timestamp needed to
|
|
42
|
+
# partition its candidates back into each root's exact activity range.
|
|
55
43
|
#: () -> Array[Row]
|
|
56
44
|
def historical_rows
|
|
57
45
|
return [] if composite_foreign_key?
|
|
58
46
|
|
|
59
47
|
version_class = @owner_class.paper_trail.version_class
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
48
|
+
scope = VersionAssociationCandidateScope.new(version_class, @start_at)
|
|
49
|
+
owner_slices.flat_map do |owners|
|
|
50
|
+
relation = scope.call(historical_relation(version_class, owners))
|
|
51
|
+
historical_columns(relation, version_class).map do |row|
|
|
52
|
+
owner_id, id, type, created_at, event = row
|
|
53
|
+
Row.new(Support.record_id(@owner_class, owner_id), id, type, created_at, event)
|
|
54
|
+
end
|
|
64
55
|
end
|
|
65
56
|
end
|
|
66
57
|
|
|
@@ -79,14 +70,20 @@ module PaperTrailDiff
|
|
|
79
70
|
# @rbs @owner_class: untyped
|
|
80
71
|
# @rbs @owner_ids: Array[untyped]
|
|
81
72
|
# @rbs @reflection: untyped
|
|
82
|
-
# @rbs @
|
|
73
|
+
# @rbs @start_at: untyped
|
|
83
74
|
|
|
84
|
-
|
|
85
|
-
|
|
75
|
+
# Each statement reads the targets of 500 owners.
|
|
76
|
+
#: () -> Enumerator[Array[untyped], untyped]
|
|
77
|
+
def owner_slices
|
|
78
|
+
@owner_ids.each_slice(Support::IDS_PER_STATEMENT)
|
|
79
|
+
end
|
|
80
|
+
|
|
81
|
+
#: (untyped, Array[untyped]) -> untyped
|
|
82
|
+
def historical_relation(version_class, owners)
|
|
86
83
|
VersionTable.joined(association_class, version_class)
|
|
87
84
|
.where(foreign_key_name: @reflection.foreign_key)
|
|
88
85
|
.where(version_class.table_name => {
|
|
89
|
-
item_type: @owner_class.base_class.name, item_id:
|
|
86
|
+
item_type: @owner_class.base_class.name, item_id: owners
|
|
90
87
|
})
|
|
91
88
|
end
|
|
92
89
|
|
|
@@ -95,8 +92,7 @@ module PaperTrailDiff
|
|
|
95
92
|
versions = version_class.arel_table
|
|
96
93
|
associations = association_class.arel_table
|
|
97
94
|
relation.pluck(versions[:item_id], associations[:foreign_key_id],
|
|
98
|
-
associations[:foreign_type], versions[:created_at], versions[:event]
|
|
99
|
-
versions[:id])
|
|
95
|
+
associations[:foreign_type], versions[:created_at], versions[:event])
|
|
100
96
|
end
|
|
101
97
|
|
|
102
98
|
# A polymorphic key names its target in a type column; any other names it
|
|
@@ -105,17 +101,13 @@ module PaperTrailDiff
|
|
|
105
101
|
# the owners of an association through one subclass.
|
|
106
102
|
#: () -> Array[Array[untyped]]
|
|
107
103
|
def live_rows
|
|
108
|
-
relation = @owner_class.base_class.unscoped.where(@owner_class.primary_key => @owner_ids)
|
|
109
104
|
key = @reflection.foreign_key
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
end
|
|
105
|
+
owner_slices.flat_map do |owners|
|
|
106
|
+
relation = @owner_class.base_class.unscoped.where(@owner_class.primary_key => owners)
|
|
107
|
+
next relation.pluck(@owner_class.primary_key, key) unless @reflection.polymorphic?
|
|
114
108
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
VersionAssociationCandidateScope.new(version_class, @range.start_time,
|
|
118
|
-
end_at: @range.end_time)
|
|
109
|
+
relation.pluck(@owner_class.primary_key, key, @reflection.foreign_type)
|
|
110
|
+
end
|
|
119
111
|
end
|
|
120
112
|
|
|
121
113
|
#: () -> untyped
|