Justin Edmund
7d164b540c
* Add sigs and docs to transformers * Add sigs and docs to downloaders * Adds sigs and docs to importers
95 lines
2.9 KiB
Ruby
95 lines
2.9 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
module Granblue
|
|
module Transformers
|
|
class TransformerError < StandardError
|
|
attr_reader :details
|
|
|
|
def initialize(message, details = nil)
|
|
@details = details
|
|
super(message)
|
|
end
|
|
end
|
|
|
|
# Base class for transforming game data into standardized format
|
|
# @abstract
|
|
class BaseTransformer
|
|
# Mapping of game element IDs to internal element IDs
|
|
# @return [Hash<Integer, Integer?>]
|
|
ELEMENT_MAPPING = {
|
|
0 => nil,
|
|
1 => 4, # Wind -> Earth
|
|
2 => 2, # Fire -> Fire
|
|
3 => 3, # Water -> Water
|
|
4 => 1, # Earth -> Wind
|
|
5 => 6, # Dark -> Light
|
|
6 => 5 # Light -> Dark
|
|
}.freeze
|
|
|
|
# Initialize a new transformer
|
|
# @param data [Object] Raw game data to transform
|
|
# @param options [Hash<Symbol, Object>] Optional configuration settings
|
|
# @option options [String] :language ('en') Language code for transformations
|
|
# @option options [Boolean] :debug (false) Enable debug logging
|
|
# @return [void]
|
|
def initialize(data, options = {})
|
|
@data = data
|
|
@options = options
|
|
@language = options[:language] || 'en'
|
|
Rails.logger.info "[TRANSFORM] Initializing #{self.class.name} with data: #{data.class}"
|
|
validate_data
|
|
end
|
|
|
|
# Transform the raw data into standardized format
|
|
# @abstract Subclasses must implement this method
|
|
# @return [Object] Transformed data
|
|
def transform
|
|
raise NotImplementedError, "#{self.class} must implement #transform"
|
|
end
|
|
|
|
protected
|
|
|
|
attr_reader :data, :options, :language
|
|
|
|
# Validate the input data structure
|
|
# @return [Boolean] true if valid, false otherwise
|
|
def validate_data
|
|
Rails.logger.info "[TRANSFORM] Validating data: #{data.inspect[0..100]}..."
|
|
|
|
if data.nil?
|
|
Rails.logger.info "[TRANSFORM] Data is nil"
|
|
return true
|
|
end
|
|
|
|
if data.empty?
|
|
Rails.logger.info "[TRANSFORM] Data is empty"
|
|
return true
|
|
end
|
|
|
|
# Data validation successful
|
|
true
|
|
end
|
|
|
|
# Extract master and parameter data from an object
|
|
# @param obj [Hash<String, Object>] Object containing master/param data
|
|
# @return [Array<(Hash?, Hash?)>] Array containing master and param data
|
|
def get_master_param(obj)
|
|
return [nil, nil] unless obj.is_a?(Hash)
|
|
|
|
master = obj['master']
|
|
param = obj['param']
|
|
Rails.logger.debug "[TRANSFORM] Extracted master: #{!!master}, param: #{!!param}"
|
|
|
|
[master, param]
|
|
end
|
|
|
|
# Log a debug message if debug mode is enabled
|
|
# @param message [String] Message to log
|
|
# @return [void]
|
|
def log_debug(message)
|
|
return unless options[:debug]
|
|
Rails.logger.debug "[TRANSFORM-DEBUG] #{self.class.name}: #{message}"
|
|
end
|
|
end
|
|
end
|
|
end
|