Class: CFA::BaseModel
- Inherits:
-
Object
- Object
- CFA::BaseModel
- Defined in:
- lib/cfa/base_model.rb
Overview
A base class for models. Represents a configuration file as an object with domain-specific attributes/methods. For persistent storage, use load and save, Non-responsibilities: actual storage and parsing (both delegated). There is no caching involved.
Class Method Summary collapse
-
.attributes(attrs) ⇒ Object
Generates accessors for trivial key-value attributes.
-
.default_file_handler ⇒ Object
Gets default file handler used when nil passed as file_handler in constructor.
-
.default_file_handler=(value) ⇒ Object
Sets default file handler.
Instance Method Summary collapse
-
#generic_get(key, tree = data) ⇒ Object
powerfull method that gets unformatted any value in config.
-
#generic_set(key, value, tree = data) ⇒ Object
powerfull method that sets any value in config.
-
#initialize(parser, file_path, file_handler: nil) ⇒ BaseModel
constructor
A new instance of BaseModel.
-
#load ⇒ void
Reads a String using file_handler and parses it with parser, storing the result in data.
-
#loaded? ⇒ Boolean
rubocop:disable Style/TrivialAccessors Returns if configuration was already loaded.
-
#save(changes_only: false) ⇒ void
Serializes data using parser and writes the resulting String using file_handler.
Constructor Details
#initialize(parser, file_path, file_handler: nil) ⇒ BaseModel
Returns a new instance of BaseModel.
17 18 19 20 21 22 23 |
# File 'lib/cfa/base_model.rb', line 17 def initialize(parser, file_path, file_handler: nil) @file_handler = file_handler || BaseModel.default_file_handler @parser = parser @file_path = file_path @loaded = false self.data = parser.empty end |
Class Method Details
.attributes(attrs) ⇒ Object
Generates accessors for trivial key-value attributes
98 99 100 101 102 103 104 105 106 107 108 |
# File 'lib/cfa/base_model.rb', line 98 def self.attributes(attrs) attrs.each_pair do |method_name, key| define_method(method_name) do generic_get(key) end define_method(:"#{method_name.to_s}=") do |value| generic_set(key, value) end end end |
.default_file_handler ⇒ Object
Gets default file handler used when nil passed as file_handler in constructor
75 76 77 |
# File 'lib/cfa/base_model.rb', line 75 def self.default_file_handler @default_file_handler ||= File end |
.default_file_handler=(value) ⇒ Object
Sets default file handler. Useful when needed to change default like if whole program use non standard file reading.
82 83 84 |
# File 'lib/cfa/base_model.rb', line 82 def self.default_file_handler=(value) @default_file_handler = value end |
Instance Method Details
#generic_get(key, tree = data) ⇒ Object
prefer to use specialized methods of children
powerfull method that gets unformatted any value in config.
63 64 65 |
# File 'lib/cfa/base_model.rb', line 63 def generic_get(key, tree = data) tree[key] end |
#generic_set(key, value, tree = data) ⇒ Object
prefer to use specialized methods of children
powerfull method that sets any value in config. It try to be smart to at first modify existing value, then replace commented out code and if even that doesn’t work, then append it at the end
56 57 58 59 |
# File 'lib/cfa/base_model.rb', line 56 def generic_set(key, value, tree = data) modify(key, value, tree) || uncomment(key, value, tree) || add_new(key, value, tree) end |
#load ⇒ void
This method returns an undefined value.
Reads a String using file_handler and parses it with parser, storing the result in data.
47 48 49 50 |
# File 'lib/cfa/base_model.rb', line 47 def load self.data = @parser.parse(@file_handler.read(@file_path)) @loaded = true end |
#loaded? ⇒ Boolean
rubocop:disable Style/TrivialAccessors Returns if configuration was already loaded
69 70 71 |
# File 'lib/cfa/base_model.rb', line 69 def loaded? @loaded end |
#save(changes_only: false) ⇒ void
This method returns an undefined value.
Serializes data using parser and writes the resulting String using file_handler.
34 35 36 37 |
# File 'lib/cfa/base_model.rb', line 34 def save(changes_only: false) merge_changes if changes_only @file_handler.write(@file_path, @parser.serialize(data)) end |