Class: Lich::Util::MemoryReleaser::Manager

Inherits:
Object
  • Object
show all
Defined in:
documented/util/memoryreleaser.rb

Overview

Manages the memory releaser settings and operations.

See Also:

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Manager

Initializes a new Manager instance.



120
121
122
123
 
# File 'documented/util/memoryreleaser.rb', line 120

def initialize
  load_settings
  @enabled = true
end

Instance Attribute Details

#enabled ⇒ Object

Returns the value of attribute enabled.



110
111
112
 
# File 'documented/util/memoryreleaser.rb', line 110

def enabled
  @enabled
end

#interval ⇒ Object

Returns the value of attribute interval.



112
113
114
 
# File 'documented/util/memoryreleaser.rb', line 112

def interval
  @interval
end

#settings ⇒ Object (readonly)

Returns the value of attribute settings.



116
117
118
 
# File 'documented/util/memoryreleaser.rb', line 116

def settings
  @settings
end

#verbose ⇒ Object

Returns the value of attribute verbose.



114
115
116
 
# File 'documented/util/memoryreleaser.rb', line 114

def verbose
  @verbose
end

Instance Method Details

#auto_disable! ⇒ Object 



158
159
160
161
162
 
# File 'documented/util/memoryreleaser.rb', line 158

def auto_disable!
  @settings[:auto_start] = false
  save_settings
  stop if running?
end

#auto_start! ⇒ Object 



152
153
154
155
156
 
# File 'documented/util/memoryreleaser.rb', line 152

def auto_start!
  @settings[:auto_start] = true
  save_settings
  start
end

#benchmark ⇒ void

This method returns an undefined value.

Runs a benchmark to measure memory usage before and after release.



275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
 
# File 'documented/util/memoryreleaser.rb', line 275

def benchmark
  respond "=" * 60
  respond "Memory Usage Before Release:"
  respond "=" * 60
  before = print_memory_stats

  respond "\nReleasing memory..."
  release

  respond "\n" + "=" * 60
  respond "Memory Usage After Release:"
  respond "=" * 60
  after = print_memory_stats

  respond "\n" + "=" * 60
  respond "Change:"
  respond "=" * 60
  print_memory_diff(before, after)
end

#interval!(seconds) ⇒ Object 



164
165
166
167
168
169
170
171
172
173
174
175
176
177
 
# File 'documented/util/memoryreleaser.rb', line 164

def interval!(seconds)
  seconds = [seconds, 60].max # Minimum 60 seconds
  @settings[:interval] = seconds
  @interval = seconds
  save_settings

  # If currently running, restart with new interval
  if running?
    log "Restarting with new interval: #{seconds}s"
    start
  end

  seconds
end

#load_settings ⇒ Object 



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
 
# File 'documented/util/memoryreleaser.rb', line 125

def load_settings
  # Load from InstanceSettings with per-character scope
  stored_settings = Lich::Common::InstanceSettings['memoryreleaser'] || {}
  @settings = DEFAULT_SETTINGS.merge(stored_settings)

  # Apply loaded settings to instance variables
  @interval = @settings[:interval]
  @verbose = @settings[:verbose]

  @settings
rescue => e
  # If there's an error loading settings, use defaults
  respond "[MemoryReleaser] Error loading settings: #{e.message}, using defaults"
  @settings = DEFAULT_SETTINGS.dup
  @interval = @settings[:interval]
  @verbose = @settings[:verbose]
  @settings
end

#release ⇒ void

This method returns an undefined value.

Perform a complete memory release cycle

Perform a complete memory release cycle.



190
191
192
193
194
195
196
197
198
 
# File 'documented/util/memoryreleaser.rb', line 190

def release
  before = print_memory_stats if @verbose
  Lich::Common::GameObj.prune_index!(ttl: @interval, verbose: @verbose)
  run_gc
  release_to_os
  after = print_memory_stats if @verbose
  print_memory_diff(before, after) if @verbose
  log "Memory release completed"
end

#running? ⇒ Boolean

Checks if the memory releaser worker is currently running.

Returns:

  • (Boolean) 


255
256
257
258
 
# File 'documented/util/memoryreleaser.rb', line 255

def running?
  worker = MemoryReleaser.worker_thread
  worker&.alive? || false
end

#save_settings ⇒ Object 



144
145
146
147
148
149
150
 
# File 'documented/util/memoryreleaser.rb', line 144

def save_settings
  # Save current settings back to InstanceSettings with per-character scope
  Lich::Common::InstanceSettings['memoryreleaser'] = @settings
rescue => e
  respond "[MemoryReleaser] Error saving settings: #{e.message}"
  @settings
end

#start(interval: nil, verbose: nil) ⇒ void

This method returns an undefined value.

Starts the memory releaser worker thread.

Parameters:

  • interval (Integer, nil) (defaults to: nil) —

    optional interval in seconds

  • verbose (Boolean, nil) (defaults to: nil) —

    optional verbose output setting



205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
 
# File 'documented/util/memoryreleaser.rb', line 205

def start(interval: nil, verbose: nil)
  stop if running?

  # Use provided values or fall back to settings
  @interval = interval || @settings[:interval]
  @verbose = verbose.nil? ? @settings[:verbose] : verbose
  @enabled = true

  # Update settings with current values
  @settings[:interval] = @interval
  @settings[:verbose] = @verbose
  save_settings

  # Send command to persistent launcher thread
  MemoryReleaser.command_queue << {
    action: :start_worker,
    interval: @interval,
    verbose: @verbose,
    manager: self
  }

  # Wait for worker to start
  timeout = 0
  until running?
    sleep 0.1
    timeout += 1
    if timeout > 50
      respond "[MemoryReleaser] ERROR: Worker thread failed to start"
      return nil
    end
  end

  MemoryReleaser.worker_thread
end

#status ⇒ Hash

Returns the current status of the memory releaser.

Returns:

  • (Hash) —

    status information including running, enabled, auto_start, interval, verbose, and platform.



262
263
264
265
266
267
268
269
270
271
 
# File 'documented/util/memoryreleaser.rb', line 262

def status
  {
    running: running?,
    enabled: @enabled,
    auto_start: @settings[:auto_start],
    interval: @interval,
    verbose: @verbose,
    platform: RbConfig::CONFIG['host_os']
  }
end

#stop ⇒ void

This method returns an undefined value.

Stops the memory releaser worker thread.



242
243
244
245
246
247
248
249
250
251
 
# File 'documented/util/memoryreleaser.rb', line 242

def stop
  @enabled = false

  MemoryReleaser.command_queue << {
    action: :stop_worker
  }

  sleep 0.2
  log "Memory releaser stopped"
end

#verbose!(enabled) ⇒ Object 



179
180
181
182
183
184
 
# File 'documented/util/memoryreleaser.rb', line 179

def verbose!(enabled)
  @settings[:verbose] = enabled
  @verbose = enabled
  save_settings
  enabled
end