Class: Rbeapi::Api::Stp

Inherits:
Entity
  • Object
show all
Defined in:
lib/rbeapi/api/stp.rb

Overview

The Stp class provides a base class instance for working with the EOS spanning-tree configuration

Instance Attribute Summary

Attributes inherited from Entity

#config, #error, #node

Instance Method Summary collapse

Methods inherited from Entity

#command_builder, #configure, #configure_interface, #get_block, #initialize, instance

Constructor Details

This class inherits a constructor from Rbeapi::Api::Entity

Instance Method Details

#get ⇒ Hash

get returns the current stp configuration parsed from the nodes current running configuration.

Examples:

{
  mode: <string>
  instances: {...}
  interfaces: {...}
}

Returns:

  • (Hash) —

    returns a Hash of attributes derived from eAPI

See Also:



59
60
61
62
63
64
65
 
# File 'lib/rbeapi/api/stp.rb', line 59

def get
  response = {}
  response.merge!(parse_mode)
  response[:instances] = instances.getall
  response[:interfaces] = interfaces.getall
  response
end

#instances ⇒ StpInstances

instances returns a memoized instance of StpInstances for configuring individual stp instances.

Returns:



86
87
88
89
90
 
# File 'lib/rbeapi/api/stp.rb', line 86

def instances
  return @instances if @instances
  @instances = StpInstances.new(node)
  @instances
end

#interfaces ⇒ StpInterfaces

interfaces returns a memoized instance of StpInterfaces for configuring individual stp interfaces

Returns:



97
98
99
100
101
 
# File 'lib/rbeapi/api/stp.rb', line 97

def interfaces
  return @interfaces if @interfaces
  @interfaces = StpInterfaces.new(node)
  @interfaces
end

#parse_mode ⇒ Hash<Symbol, Object>

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

parse_mode scans the nodes running configuration and extracts the value of the spanning-tree mode. The spanning tree mode is expected to be always be available in the running config. The return value is intended to be merged into the stp resource hash

Returns:

  • (Hash<Symbol, Object>) —

    resource hash attribute



76
77
78
79
 
# File 'lib/rbeapi/api/stp.rb', line 76

def parse_mode
  mdata = /(?<=spanning-tree\smode\s)(\w+)$/.match(config)
  { mode: mdata[1] }
end

#set_mode(opts = {}) ⇒ Boolean

set_mode configures the stp mode in the global nodes running configuration. If the enable option is false, then the stp mode is configured with the no keyword argument. If the default option is specified then the mode is configured with the default keyword argument. The default keyword argument takes precedence over the enable option if both are provided

Parameters:

  • :opts (Hash) —

    Optional keyword arguments

Returns:

  • (Boolean) —

    returns true if the command completed successfully



131
132
133
134
 
# File 'lib/rbeapi/api/stp.rb', line 131

def set_mode(opts = {})
  cmd = command_builder('spanning-tree mode', opts)
  configure cmd
end