Module: Ploperations::Classification

Defined in:
lib/ploperations/classification.rb

Overview

This module generates facts based off of a nodes’s name

Class Method Summary collapse

Class Method Details

._split_hostname(hostname) ⇒ Array

Split a hostname into its consituent parts and assign a version value based on the format of the hostname.

The version value will be one of:

* `2`: hostname matches group-function-context-stage-#-id
* `1`: hostname matches group-function#-stage
* `0`: hostname doesn't match one of the standards

Examples:

[group, function, number_string, context, stage, id, version]

Parameters:

  • hostname —

    The hostname to split

Returns:

  • (Array) —

    Returns a 7 element array. Some or all values may be empty strings.



20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/ploperations/classification.rb', line 20

def self._split_hostname(hostname)
  # rubocop:disable Style/PerlBackrefs
  group, function, number_string, context, stage, id = []
  version = 0

  case hostname
  when %r{^([a-z0-9]*[a-z][a-z0-9]*)-([a-z0-9]*[a-z]+)(-[a-z0-9]*[a-z][a-z0-9]*)?-([a-z]+)-(\d+)(-[a-z0-9]+)?$}
    version = 2
    # group-function-context-stage-#-id
    group = $1
    function = $2
    stage = $4
    number_string = $5

    # Strip hyphen. This is easier to read than doing it in the regex.
    # If the capture group is nil then the value will be set to nil.
    begin
      context = $3[1..-1]
    rescue
      context = nil.to_s
    end

    begin
      id = $6[1..-1]
    rescue
      nil.to_s
    end

  when %r{^([a-z-]+)-([a-z]+)(\d+)-([a-z]+)$}
    version = 1
    # group-function#-stage
    group = $1
    function = $2
    number_string = $3
    stage = $4

    context = nil.to_s
    id = nil.to_s
  when %r{[0-9-]}
    # Replicate old group and stage facts
    group = hostname.split(%r{[0-9-]}).first

    begin
      stage = if hostname.include? '-'
                hostname.split('-').last
              else
                nil.to_s
              end
    rescue
      stage = nil.to_s
    end

    # set remaining parts of the fact so they are not undefined
    function = nil.to_s
    number_string = nil.to_s
    context = nil.to_s
    id = nil.to_s
  else
    # set all parts of the fact so they are not undefined
    group = nil.to_s
    stage = nil.to_s
    function = nil.to_s
    number_string = nil.to_s
    context = nil.to_s
    id = nil.to_s
  end

  [group, function, number_string, context, stage, id, version]
end

.parse_hostname(hostname) ⇒ Hash

Parse a hostname into a hash of its parts

The version attribute will be one of:

* `2`: hostname matches group-function-context-stage-#-id
* `1`: hostname matches group-function#-stage
* `0`: hostname doesn't match one of the standards

Examples:

{
  'hostname' => hostname,
  'parts' => [group, function, number_string, context, stage, id],
  'version' => version,
  'group' => group,
  'function' => function,
  'number' => number,
  'number_string' => number_string,
  'context' => context,
  'stage' => stage,
  'id' => id,
}

Parameters:

  • hostname —

    The hostname to parse

Returns:

  • (Hash) —

    Some or all the values may be nil.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
 
# File 'lib/ploperations/classification.rb', line 125

def self.parse_hostname(hostname)
  parts = _split_hostname(hostname)
  version = parts.pop
  group, function, number_string, context, stage, id = parts

  number = if number_string && !number_string.empty?
             number_string.to_i
           else
             nil
           end

  {
    'hostname' => hostname,
    'parts' => parts,
    'version' => version,
    'group' => group,
    'function' => function,
    'number' => number,
    'number_string' => number_string,
    'context' => context,
    'stage' => stage,
    'id' => id,
  }
end

.split_hostname(hostname) ⇒ Array

Split a hostname into its consituent parts

Examples:

[group, function, number_string, context, stage, id]

Parameters:

  • hostname —

    The hostname to split

Returns:

  • (Array) —

    Returns a 6 element array. Some or all values may be empty strings.



96
97
98
99
 
# File 'lib/ploperations/classification.rb', line 96

def self.split_hostname(hostname)
  # Drop the version element
  _split_hostname(hostname)[0..5]
end