Class: Rbeapi::Api::StpInterfaces

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

Overview

The StpInterfaces class provides a class instance for working with spanning-tree interfaces in EOS

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(name) ⇒ nil, Hash<Symbol, Object>

get returns the configured stp interfaces from the nodes running configuration as a resource hash. If the specified interface is not configured as a switchport then this method will return nil

Examples:

{
  portfast: <boolean>,
  portfast_type: <string>,
  bpduguard: <boolean>
}

Parameters:

  • :name (String) —

    The interface name to return a resource for from the nodes configuration

Returns:

  • (nil, Hash<Symbol, Object>) —

    returns the stp interface as a resource hash



291
292
293
294
295
296
297
298
299
300
 
# File 'lib/rbeapi/api/stp.rb', line 291

def get(name)
  config = get_block("interface #{name}")
  return nil unless config
  return nil if /no switchport$/ =~ config
  response = {}
  response.merge!(parse_portfast(config))
  response.merge!(parse_portfast_type(config))
  response.merge!(parse_bpduguard(config))
  response
end

#getall ⇒ Hash<Symbol, Object>

getall returns all of the configured stp interfaces parsed from the nodes current running configuration. The returned hash is keyed by the interface name

Examples:

{
  <name>: {
    portfast: <boolean>,
    portfast_type: <string>,
    bpduguard: <boolean>
  },
  <name>: {
    portfast: <boolean>,
    portfast_type: <string>,
    bpduguard: <boolean>
  },
  ...
}

Returns:

  • (Hash<Symbol, Object>) —

    returns the stp interfaces config as a resource hash from the nodes running configuration



324
325
326
327
328
329
330
331
 
# File 'lib/rbeapi/api/stp.rb', line 324

def getall
  interfaces = config.scan(/(?<=^interface\s)[Et|Po].+/)
  resp = interfaces.each_with_object({}) do |name, hsh|
    values = get(name)
    hsh[name] = values if values
  end
  resp
end

#set_bpduguard(name, opts = {}) ⇒ Boolean

Configures the interface bpdu guard value

Parameters:

  • name (String) —

    The name of the interface to configure

  • opts (Hash) (defaults to: {}) —

    The configuration parameters for bpduguard

Options Hash (opts):

  • :value (Boolean) —

    The value to set bpduguard

  • :enable (Boolean) —

    If false then the bpduguard is disabled. If true then the bpduguard is enabled. Default is true.

  • :default (Boolean) —

    The value should be set to default

Returns:

  • (Boolean) —

    True if the commands succeed otherwise False



439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
 
# File 'lib/rbeapi/api/stp.rb', line 439

def set_bpduguard(name, opts = {})
  enable = opts.fetch(:enable, true)
  default = opts[:default] || false

  case default
  when true
    cmds = 'default spanning-tree bpduguard'
  when false
    if enable
      cmds = 'spanning-tree bpduguard enable'
    else
      cmds = 'spanning-tree bpduguard disable'
    end
  end
  configure_interface(name, cmds)
end

#set_portfast(name, opts = {}) ⇒ Boolean

Configures the interface portfast value

Parameters:

  • name (String) —

    The name of the interface to configure

  • opts (Hash) (defaults to: {}) —

    The configuration parameters for portfast

  • :opts (Hash) —

    a customizable set of options

Options Hash (opts):

  • :value (Boolean) —

    The value to set portfast

  • :default (Boolean) —

    The value should be set to default

Returns:

  • (Boolean) —

    True if the commands succeed otherwise False



392
393
394
395
 
# File 'lib/rbeapi/api/stp.rb', line 392

def set_portfast(name, opts = {})
  cmd = command_builder('spanning-tree portfast', opts)
  configure_interface(name, cmd)
end

#set_portfast_type(name, opts = {}) ⇒ Boolean

Configures the interface portfast type value

Parameters:

  • name (String) —

    The name of the interface to configure

  • opts (Hash) (defaults to: {}) —

    The configuration parameters for portfast type

Options Hash (opts):

  • :value (String) —

    The value to set portfast type to. The value must be set for calls to this method.

  • :enable (Boolean) —

    If false then the command is negated. Default is true.

  • :default (Boolean) —

    The value should be set to default

Returns:

  • (Boolean) —

    True if the commands succeed otherwise False



409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
 
# File 'lib/rbeapi/api/stp.rb', line 409

def set_portfast_type(name, opts = {})
  value = opts[:value]
  fail ArgumentError, 'value must be set' unless value
  enable = opts.fetch(:enable, true)
  default = opts[:default] || false

  case default
  when true
    cmds = "default spanning-tree portfast #{value}"
  when false
    if enable
      cmds = "spanning-tree portfast #{value}"
    else
      cmds = "no spanning-tree portfast #{value}"
    end
  end
  configure_interface(name, cmds)
end