Class: Kamaze::Project::Version

Inherits:
Object
  • Object
show all
Defined in:
lib/kamaze/project/version.rb

Overview

Describe version using a YAML file.

See Also:

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(file_name = self.class.file_name) ⇒ Version

Returns a new instance of Version.

Parameters:

  • file_name (String) (defaults to: self.class.file_name) 


25
26
27
28
29
30
31
 
# File 'lib/kamaze/project/version.rb', line 25

def initialize(file_name = self.class.file_name)
  @file_name = file_name.freeze

  self.load_file
      .map { |k, v| self.attr_set(k, v) }
      .yield_self { |loaded| @data_loaded = loaded.to_h }
end

Instance Attribute Details

#data_loaded ⇒ Object (readonly, protected)

Returns the value of attribute data_loaded.



74
75
76
 
# File 'lib/kamaze/project/version.rb', line 74

def data_loaded
  @data_loaded
end

#file_name ⇒ Pathname|String (readonly)

Get filepath used to parse version (YAML file).

Returns:

  • (Pathname|String) 


22
23
24
 
# File 'lib/kamaze/project/version.rb', line 22

def file_name
  @file_name
end

Class Method Details

.file_name ⇒ Pathname

Get default filename.

Returns:

  • (Pathname) 


67
68
69
 
# File 'lib/kamaze/project/version.rb', line 67

def file_name
  Pathname.new(__dir__).join('version.yml')
end

Instance Method Details

#attr_set(attr_name, attr_value) ⇒ Array (protected)

Define attribute (as ro attr) and set value.

Parameters:

  • attr_name (String|Symbol)
  • attr_value (Object)

Returns:

  • (Array) 


90
91
92
93
94
95
96
97
98
99
100
101
102
103
 
# File 'lib/kamaze/project/version.rb', line 90

def attr_set(attr_name, attr_value)
  inflector = Dry::Inflector.new
  attr_name = inflector.underscore(attr_name.to_s)

  self.singleton_class.class_eval do
    attr_accessor attr_name

    protected "#{attr_name}="
  end

  self.__send__("#{attr_name}=", attr_value.freeze)

  [attr_name, attr_value.freeze].freeze
end

#load_file ⇒ Hash (protected)

Returns:

  • (Hash) 


77
78
79
80
81
82
83
 
# File 'lib/kamaze/project/version.rb', line 77

def load_file
  YAML.load_file(file_name).yield_self do |data|
    data == false ? {} : data
  end
rescue Errno::ENOENT
  {}
end

#to_h ⇒ Hash

Returns:

  • (Hash) 


51
52
53
 
# File 'lib/kamaze/project/version.rb', line 51

def to_h
  data_loaded.clone.freeze
end

#to_path ⇒ String

Return the path as a String.

Returns:

  • (String)

See Also:



59
60
61
 
# File 'lib/kamaze/project/version.rb', line 59

def to_path
  file_name.to_s
end

#to_s ⇒ String

Returns:

  • (String) 


46
47
48
 
# File 'lib/kamaze/project/version.rb', line 46

def to_s
  [major, minor, patch].join('.')
end

#valid? ⇒ Boolean

Denote version has enough (mninimal) attributes defined.

Returns:

  • (Boolean) 


36
37
38
39
40
41
42
43
 
# File 'lib/kamaze/project/version.rb', line 36

def valid?
  ![:major, :minor, :patch]
    .map { |method| public_send(method) }
    .map { |v| v.to_s.empty? ? nil : v }
    .include?(nil)
rescue NameError
  false
end