Class: Usps::Imis::Config

Inherits:
Object
  • Object
show all
Defined in:
lib/usps/imis/config.rb

Overview

API Configuration

Constant Summary collapse

IMIS_ROOT_URL_PROD = 
'https://portal.americasboatingclub.org'
IMIS_ROOT_URL_DEV = 
'https://abcdev.imiscloud.com'
DEFAULT_GLOBAL_LOG_PATH = 
'/var/log/imis/imis.log'
REQUIRED = 
%w[imis_id_query_name username password].freeze
OPTIONAL = 
%w[environment logger_file global_log_path].freeze
SETTABLE = 
(REQUIRED + OPTIONAL).freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize {|_self| ... } ⇒ Config

Returns a new instance of Config.

Yields:

  • (_self)

Yield Parameters:



24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/usps/imis/config.rb', line 24

def initialize
  @environment = default_environment
  @imis_id_query_name = ENV.fetch('IMIS_ID_QUERY_NAME', nil)
  @username = ENV.fetch('IMIS_USERNAME', nil)
  @password = ENV.fetch('IMIS_PASSWORD', nil)
  @base_logger = Logger.new($stdout, level: :info)
  @logger = ActiveSupport::TaggedLogging.new(@base_logger)

  yield self if block_given?

  @logger_level = logger.class::SEV_LABEL[logger.level].downcase.to_sym
end

Instance Attribute Details

#environment ⇒ Object

Returns the value of attribute environment.



22
23
24
 
# File 'lib/usps/imis/config.rb', line 22

def environment
  @environment
end

#imis_id_query_name ⇒ Object

Returns the value of attribute imis_id_query_name.



21
22
23
 
# File 'lib/usps/imis/config.rb', line 21

def imis_id_query_name
  @imis_id_query_name
end

#logger ⇒ Object

Returns the value of attribute logger.



22
23
24
 
# File 'lib/usps/imis/config.rb', line 22

def logger
  @logger
end

#logger_file ⇒ Object

Returns the value of attribute logger_file.



22
23
24
 
# File 'lib/usps/imis/config.rb', line 22

def logger_file
  @logger_file
end

#logger_level ⇒ Object (readonly)

Returns the value of attribute logger_level.



22
23
24
 
# File 'lib/usps/imis/config.rb', line 22

def logger_level
  @logger_level
end

#password ⇒ Object

Returns the value of attribute password.



21
22
23
 
# File 'lib/usps/imis/config.rb', line 21

def password
  @password
end

#username ⇒ Object

Returns the value of attribute username.



21
22
23
 
# File 'lib/usps/imis/config.rb', line 21

def username
  @username
end

Instance Method Details

#filtered_parameters ⇒ Object

Parameters to filter out of logging



92
 
# File 'lib/usps/imis/config.rb', line 92

def filtered_parameters = %i[password]

#global_log_path ⇒ Object 



60
61
62
63
64
 
# File 'lib/usps/imis/config.rb', line 60

def global_log_path
  return @global_log_path if defined?(@global_log_path)

  self.global_log_path = DEFAULT_GLOBAL_LOG_PATH
end

#global_log_path=(path) ⇒ Object 



66
67
68
69
 
# File 'lib/usps/imis/config.rb', line 66

def global_log_path=(path)
  @global_log_path = path
  @global_logger = build_global_logger
end

#global_logger ⇒ Object 



53
54
55
56
57
58
 
# File 'lib/usps/imis/config.rb', line 53

def global_logger
  return @global_logger if @global_logger

  global_log_path
  @global_logger
end

#hostname ⇒ Object

Environment-specific API endpoint hostname

Returns:

  • The API hostname for the current environment

Raises:



79
80
81
82
83
84
 
# File 'lib/usps/imis/config.rb', line 79

def hostname
  return IMIS_ROOT_URL_PROD if environment.production?
  return IMIS_ROOT_URL_DEV if environment.development?

  raise Errors::ConfigError, "Unexpected API environment: #{environment}"
end

#instance_variables_to_inspect ⇒ Object

Ruby 3.5 instance variable filter



88
 
# File 'lib/usps/imis/config.rb', line 88

def instance_variables_to_inspect = instance_variables - %i[@password @base_logger @logger @global_logger]

#silence! ⇒ Object 



71
72
73
 
# File 'lib/usps/imis/config.rb', line 71

def silence!
  self.logger = Logger.new(nil)
end

#validate! ⇒ Object

Raises:



94
95
96
97
98
99
 
# File 'lib/usps/imis/config.rb', line 94

def validate!
  missing_config = REQUIRED.filter_map { it if public_send(it).nil? }
  return if missing_config.empty?

  raise Errors::ConfigError, "Missing required configuration: #{missing_config.join(', ')}"
end