Module: RactorRailsShim::AppShareabilizer

Defined in:
lib/ractor_rails_shim/roles/app_shareabilizer.rb

Class Method Summary collapse

Class Method Details

.apply_shareable_constants ⇒ Object 



97
98
99
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 97

def self.apply_shareable_constants
  @apply_shareable_constants || RactorRailsShim::ConstantShareabilizer.method(:apply!)
end

.build_shareable_fallback ⇒ Object 



145
146
147
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 145

def self.build_shareable_fallback
  @build_shareable_fallback || RactorRailsShim::FallbackBuilder.method(:build!)
end

.configure(apply_shareable_constants: nil, install_all_framework_patches: nil, precompute_lazy_ivars: nil, precompute_propshaft: nil, generate_ar_attribute_methods: nil, warm_attribute_method_patterns: nil, freeze_declared_callbacks: nil, freeze_shareable_class_ivars: nil, warm_journey_routes: nil, neutralize_logger_io: nil, replace_unshareable_procs: nil, replace_locks_and_concurrent_maps: nil, build_shareable_fallback: nil, make_shareable_fn: nil, reassign_shareable_const: nil) ⇒ Object 



54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 54

def self.configure(apply_shareable_constants: nil, install_all_framework_patches: nil,
                   precompute_lazy_ivars: nil, precompute_propshaft: nil,
                   generate_ar_attribute_methods: nil, warm_attribute_method_patterns: nil,
                   freeze_declared_callbacks: nil, freeze_shareable_class_ivars: nil,
                   warm_journey_routes: nil, neutralize_logger_io: nil,
                   replace_unshareable_procs: nil, replace_locks_and_concurrent_maps: nil,
                   build_shareable_fallback: nil, make_shareable_fn: nil,
                   reassign_shareable_const: nil)
  @apply_shareable_constants = apply_shareable_constants
  @install_all_framework_patches = install_all_framework_patches
  @precompute_lazy_ivars = precompute_lazy_ivars
  @precompute_propshaft = precompute_propshaft
  @generate_ar_attribute_methods = generate_ar_attribute_methods
  @warm_attribute_method_patterns = warm_attribute_method_patterns
  @freeze_declared_callbacks = freeze_declared_callbacks
  @freeze_shareable_class_ivars = freeze_shareable_class_ivars
  @warm_journey_routes = warm_journey_routes
  @neutralize_logger_io = neutralize_logger_io
  @replace_unshareable_procs = replace_unshareable_procs
  @replace_locks_and_concurrent_maps = replace_locks_and_concurrent_maps
  @build_shareable_fallback = build_shareable_fallback
  @make_shareable_fn = make_shareable_fn
  @reassign_shareable_const = reassign_shareable_const
end

.freeze_declared_callbacks ⇒ Object 



121
122
123
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 121

def self.freeze_declared_callbacks
  @freeze_declared_callbacks || RactorRailsShim::CallbackCapture.method(:freeze_declared_callbacks!)
end

.freeze_shareable_class_ivars ⇒ Object 



125
126
127
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 125

def self.freeze_shareable_class_ivars
  @freeze_shareable_class_ivars || RactorRailsShim::Freezers::ShareableClassIvarFreezer.method(:call)
end

.generate_ar_attribute_methods ⇒ Object 



113
114
115
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 113

def self.generate_ar_attribute_methods
  @generate_ar_attribute_methods || RactorRailsShim::ShareabilityTraversal.method(:generate_ar_attribute_methods!)
end

.install_all_framework_patches ⇒ Object 



101
102
103
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 101

def self.install_all_framework_patches
  @install_all_framework_patches || RactorRailsShim::Installer.method(:dispatch_all_framework_patches)
end

.make_shareable!(app) ⇒ Object

Make the app Ractor-shareable. App is mutated in place (frozen). Returns the same (now-frozen) app — Ruby freeze-style. Callers must not assume a new object.



160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 160

def self.make_shareable!(app)
  apply_shareable_constants.call unless RactorRailsShim::ConstantShareabilizer.applied?
  install_all_framework_patches.call
  precompute_lazy_ivars.call(app)
  precompute_propshaft.call(app)
  generate_ar_attribute_methods.call
  warm_attribute_method_patterns.call
  freeze_declared_callbacks.call
  freeze_shareable_class_ivars.call
  warm_journey_routes.call
  neutralize_logger_io.call(app)
  replace_unshareable_procs.call(app)
  replace_locks_and_concurrent_maps.call(app)
  make_shareable_fn.call(app)
  stash!(app)
  build_shareable_fallback.call
  app
end

.make_shareable_fn ⇒ Object 



149
150
151
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 149

def self.make_shareable_fn
  @make_shareable_fn || Ractor.method(:make_shareable)
end

.neutralize_logger_io ⇒ Object 



133
134
135
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 133

def self.neutralize_logger_io
  @neutralize_logger_io || RactorRailsShim::LoggerIONeutralizer.method(:call)
end

.precompute_lazy_ivars ⇒ Object 



105
106
107
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 105

def self.precompute_lazy_ivars
  @precompute_lazy_ivars || RactorRailsShim::ShareabilityTraversal.method(:precompute_lazy_ivars)
end

.precompute_propshaft ⇒ Object 



109
110
111
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 109

def self.precompute_propshaft
  @precompute_propshaft || RactorRailsShim.method(:_precompute_propshaft!)
end

.reassign_shareable_const ⇒ Object 



153
154
155
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 153

def self.reassign_shareable_const
  @reassign_shareable_const || RactorRailsShim.method(:_reassign_shareable_const)
end

.replace_locks_and_concurrent_maps ⇒ Object 



141
142
143
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 141

def self.replace_locks_and_concurrent_maps
  @replace_locks_and_concurrent_maps || RactorRailsShim::ShareabilityTraversal.method(:replace_locks_and_concurrent_maps!)
end

.replace_unshareable_procs ⇒ Object 



137
138
139
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 137

def self.replace_unshareable_procs
  @replace_unshareable_procs || RactorRailsShim::ShareabilityTraversal.method(:replace_unshareable_procs!)
end

.reset_configuration ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 79

def self.reset_configuration
  @apply_shareable_constants = nil
  @install_all_framework_patches = nil
  @precompute_lazy_ivars = nil
  @precompute_propshaft = nil
  @generate_ar_attribute_methods = nil
  @warm_attribute_method_patterns = nil
  @freeze_declared_callbacks = nil
  @freeze_shareable_class_ivars = nil
  @warm_journey_routes = nil
  @neutralize_logger_io = nil
  @replace_unshareable_procs = nil
  @replace_locks_and_concurrent_maps = nil
  @build_shareable_fallback = nil
  @make_shareable_fn = nil
  @reassign_shareable_const = nil
end

.reset_stashed! ⇒ Object 



202
203
204
205
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 202

def self.reset_stashed!
  @stashed = false
  remove_const(:SHAREABLE_APP) if const_defined?(:SHAREABLE_APP, false)
end

.stash!(app) ⇒ Object

One-shot stash of the app as SHAREABLE_APP on this role module. Idempotent: first call wins (via const_defined? guard). Main-Ractor- only by contract — workers must not reassign the constant. Returns the app. Issue #36b: the constant lives on AppShareabilizer, not the facade; the reassign_shareable_const seam is bypassed because it writes to the facade, not the role.



185
186
187
188
189
190
191
192
193
194
195
196
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 185

def self.stash!(app)
  return app if const_defined?(:SHAREABLE_APP, false)
  return app unless Ractor.main?
  verbose, $VERBOSE = $VERBOSE, nil
  begin
    const_set(:SHAREABLE_APP, app)
  ensure
    $VERBOSE = verbose
  end
  @stashed = true
  app
end

.stashed? ⇒ Boolean

Returns:

  • (Boolean) 


198
199
200
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 198

def self.stashed?
  @stashed
end

.warm_attribute_method_patterns ⇒ Object 



117
118
119
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 117

def self.warm_attribute_method_patterns
  @warm_attribute_method_patterns || RactorRailsShim::ShareabilityTraversal.method(:warm_attribute_method_patterns!)
end

.warm_journey_routes ⇒ Object 



129
130
131
 
# File 'lib/ractor_rails_shim/roles/app_shareabilizer.rb', line 129

def self.warm_journey_routes
  @warm_journey_routes || RactorRailsShim.method(:_warm_journey_routes!)
end