shopify-junos-ez-stdlib 1.0.0

data/lib/junos-ez/stdlib.rb

@@ -0,0 +1,18 @@
+
+require 'junos-ez/provider'             # framework code
+require 'junos-ez/facts'                # fact keeper
+require 'junos-ez/system'               # various system resources
+require 'junos-ez/l1_ports'             # physical ports
+require 'junos-ez/vlans'                # vlans
+require 'junos-ez/l2_ports'             # switch ports
+require 'junos-ez/ip_ports'             # ip ports (v4)
+require 'junos-ez/lag_ports'            # Link Aggregation Groups
+require 'junos-ez/group'
+
+# -------------------------------------------------------------------
+# utility libraries, not providers
+# -------------------------------------------------------------------
+
+require 'junos-ez/utils/re'
+require 'junos-ez/utils/fs'
+require 'junos-ez/utils/config'

data/lib/junos-ez/system.rb

@@ -0,0 +1,48 @@
+
+require "junos-ez/provider"
+require 'junos-ez/system/st_hosts'
+require 'junos-ez/system/st_routes'
+require 'junos-ez/system/users'
+require 'junos-ez/system/userauths'
+
+### -----------------------------------------------------------------
+### the 'syscfg' is a work in progress, do not use ...
+### -----------------------------------------------------------------
+
+module Junos::Ez::SysConfig
+  
+  PROPERTIES = [
+    :host_name,             # String, host-name
+    :domain_name,           # domain name, string or array
+    :domain_search,         # array of dns name suffix values
+    :dns_servers,           # array of ip-addrs
+    :ntp_servers,           # array NTP servers HASH of
+                            #   :version
+                            #   :key
+    :timezone,              # String time-zone
+    :date,                  # String format: YYYYMMDDhhmm.ss
+    :location,              # location HASH with properties
+                            #   :countrycode
+                            #   :building,
+                            #   :floor,
+                            #   :rack
+  ]
+  
+  def self.Provider( ndev, varsym )            
+    raise ArgumentError "work-in-progress ..."
+    
+    newbie = Junos::Ez::SysConfig::Provider.new( ndev )      
+    newbie.properties = Junos::Ez::Provider::PROPERTIES + PROPERTIES
+    Junos::Ez::Provider.attach_instance_variable( ndev, varsym, newbie )    
+  end  
+  
+  class Provider < Junos::Ez::Provider::Parent
+  end
+    
+end
+
+require 'junos-ez/system/syscfg'
+
+
+
+

data/lib/junos-ez/system/st_hosts.rb

@@ -0,0 +1,92 @@
+module Junos::Ez::StaticHosts
+  
+  PROPERTIES = [
+    :ip,                    # ipv4 address :String
+    :ip6,                   # ipv6 address :String
+  ]
+  
+  def self.Provider( ndev, varsym )            
+    newbie = Junos::Ez::StaticHosts::Provider.new( ndev )      
+    newbie.properties = Junos::Ez::Provider::PROPERTIES + PROPERTIES
+    Junos::Ez::Provider.attach_instance_variable( ndev, varsym, newbie )    
+  end  
+  
+  class Provider < Junos::Ez::Provider::Parent
+  end
+  
+end
+
+class Junos::Ez::StaticHosts::Provider
+  
+  ### ---------------------------------------------------------------
+  ### XML top placement
+  ### ---------------------------------------------------------------
+  
+  def xml_at_top
+    xml = Nokogiri::XML::Builder.new {|xml| xml.configuration {
+      xml.system { xml.send('static-host-mapping') {
+        xml.name @name
+        return xml
+      }}
+    }}
+  end
+  
+  ### ---------------------------------------------------------------
+  ### XML property readers
+  ### ---------------------------------------------------------------  
+
+  def xml_get_has_xml( xml )  
+    xml.xpath('//static-host-mapping')[0]
+  end
+  
+  def xml_read_parser( as_xml, as_hash )    
+    set_has_status( as_xml, as_hash )  
+    
+    ip_v4 = as_xml.xpath('inet').text
+    as_hash[:ip] = ip_v4 unless ip_v4.empty?
+    
+    ip_v6 = as_xml.xpath('inet6').text
+    as_hash[:ip6] = ip_v6 unless ip_v6.empty?
+  end
+  
+  ### ---------------------------------------------------------------
+  ### XML property writers
+  ### ---------------------------------------------------------------  
+  
+  def xml_change_ip( xml )
+    xml_set_or_delete( xml, 'inet', @should[:ip] )
+  end
+  
+  def xml_change_ip6( xml )
+    xml_set_or_delete( xml, 'inet6', @should[:ip6] )
+  end  
+  
+end
+
+##### ---------------------------------------------------------------
+##### Provider collection methods
+##### ---------------------------------------------------------------
+
+class Junos::Ez::StaticHosts::Provider
+  
+  def build_list
+    @ndev.rpc.get_configuration{|xml| xml.system {
+      xml.send(:'static-host-mapping')
+    }}.xpath('system/static-host-mapping/name').collect do |item|
+      item.text
+    end    
+  end
+  
+  def build_catalog
+    @catalog = {}
+    @ndev.rpc.get_configuration{ |xml| xml.system {
+      xml.send(:'static-host-mapping')
+    }}.xpath('system/static-host-mapping').each do |item|
+      name = item.xpath('name').text
+      @catalog[name] = {}
+      xml_read_parser( item, @catalog[name] )
+    end    
+    @catalog
+  end
+  
+end

data/lib/junos-ez/system/st_routes.rb

@@ -0,0 +1,159 @@
+module Junos::Ez::StaticRoutes
+  
+    PROPERTIES = [
+      :gateway,             # next-hop gateway, could be single or Array
+      :metric,              # number or nil
+      :action,              # one-of [ :reject, :discard, :receive ]
+      :active,              # flag [ true, nil | false ]
+      :retain,              # no-flag [ nil, true, false ]
+      :install,             # no-flag [ nil, true, false ]
+      :readvertise,         # no-flag [ nil, true, false ]
+      :resolve,             # no-flag [ nil, true, false ]
+    ]
+    
+  def self.Provider( ndev, varsym )            
+    newbie = Junos::Ez::StaticRoutes::Provider.new( ndev )      
+    newbie.properties = Junos::Ez::Provider::PROPERTIES + PROPERTIES
+    Junos::Ez::Provider.attach_instance_variable( ndev, varsym, newbie )    
+  end  
+  
+  class Provider < Junos::Ez::Provider::Parent
+  end
+    
+end
+
+class Junos::Ez::StaticRoutes::Provider
+  
+  ### ---------------------------------------------------------------
+  ### XML top placement
+  ### ---------------------------------------------------------------
+  
+  def xml_at_top
+    @name = "0.0.0.0/0" if @name == :default
+    
+    Nokogiri::XML::Builder.new {|xml| xml.configuration {
+      xml.send('routing-options') {
+        xml.static { xml.route {
+          xml.name @name
+          return xml
+        }}
+      }
+    }}
+  end
+    
+  ### ---------------------------------------------------------------
+  ### XML property readers
+  ### ---------------------------------------------------------------  
+
+  def xml_get_has_xml( xml )  
+    xml.xpath('routing-options/static/route')[0]
+  end
+  
+  def xml_read_parser( as_xml, as_hash )    
+    set_has_status( as_xml, as_hash )
+    
+    ## :gateway
+    unless (next_hop = as_xml.xpath('next-hop')).empty?
+      if next_hop.count == 1
+        as_hash[:gateway] = next_hop.text    
+      else
+        as_hash[:gateway] = next_hop.collect{|i| i.text }
+      end
+    end
+    
+    unless (active = as_xml.xpath('active')).empty?
+      as_hash[:active] = true
+    end
+    
+    unless (action = as_xml.xpath( 'reject | discard | receive' )).empty?
+      as_hash[:action] = action[0].name.to_sym
+    end
+    
+    unless (metric = as_xml.xpath('metric')).empty?
+      as_hash[:metric] = metric.text.to_i
+    end
+    
+    xml_read_parse_noele( as_xml, 'retain', as_hash, :retain )
+    xml_read_parse_noele( as_xml, 'install', as_hash, :install )
+    xml_read_parse_noele( as_xml, 'resolve', as_hash, :resolve )
+    xml_read_parse_noele( as_xml, 'readvertise', as_hash, :readvertise )        
+  end
+  
+  
+  ### ---------------------------------------------------------------
+  ### XML property writers
+  ### ---------------------------------------------------------------  
+    
+  def xml_change_action( xml )
+    
+    if @should[:action].nil?
+      xml.send( @has[:action], Netconf::JunosConfig::DELETE )
+      return true
+    end
+    
+    xml.send( @should[:action] )
+  end
+  
+  def xml_change_active( xml )
+    xml_set_or_delete_element( xml, 'active', @should[:active] )
+  end
+  
+  def xml_change_gateway( xml )
+    # delete existing entries
+    ele_nh = :'next-hop'    
+    
+    # clear any existing values, and return unless there are any new ones ...
+    xml.send(ele_nh, Netconf::JunosConfig::DELETE) if @has[:gateway]    
+    return true unless @should[:gateway]      
+    
+    ## adding back the ones we want now ... 
+    if @should[:gateway].kind_of? String
+      xml.send( ele_nh, @should[:gateway] )
+    else       
+      @should[:gateway].each{ |gw| xml.send( ele_nh, gw ) }
+    end
+  end
+  
+  def xml_change_retain( xml )
+    xml_set_or_delete_noele( xml, 'retain' )
+  end
+  
+  def xml_change_install( xml )
+    xml_set_or_delete_noele( xml, 'install' )
+  end
+  
+  def xml_change_resolve( xml )
+    xml_set_or_delete_noele( xml, 'resolve' )
+  end
+  
+  def xml_change_readvertise( xml )
+    xml_set_or_delete_noele( xml, 'readvertise' )
+  end
+  
+  def xml_change_metric( xml )
+    xml_set_or_delete( xml, 'metric', @should[:metric] )
+  end
+  
+    
+end
+
+##### ---------------------------------------------------------------
+##### Provider collection methods
+##### ---------------------------------------------------------------
+
+class Junos::Ez::StaticRoutes::Provider
+  
+  def build_list
+    @ndev.rpc.get_configuration{|xml| xml.send(:'routing-options') {
+      xml.static { xml.route }
+    }}.xpath('//route/name').collect do |item|
+      item.text
+    end    
+  end
+  
+  def build_catalog
+    @catalog = {}
+    @catalog
+  end
+  
+end

data/lib/junos-ez/system/syscfg.rb

@@ -0,0 +1,103 @@
+class Junos::Ez::SysConfig::Provider 
+  
+  ### ---------------------------------------------------------------
+  ### XML top placement
+  ### ---------------------------------------------------------------
+  
+  def xml_at_top
+    xml = Nokogiri::XML::Builder.new {|xml| xml.configuration {
+      xml.system {
+        return xml
+      }
+    }}
+  end
+  
+  def xml_config_read!    
+    xml = xml_at_top
+    xml.send(:'host-name')
+    xml.send(:'domain-name')
+    xml.send(:'domain-search')
+    xml.send(:'time-zone')
+    xml.location
+    xml.send(:'name-server')
+    xml.ntp
+    @ndev.rpc.get_configuration( xml )
+  end
+  
+  ### ---------------------------------------------------------------
+  ### XML property readers
+  ### ---------------------------------------------------------------  
+
+  def xml_get_has_xml( xml )  
+    xml.xpath('system')[0]
+  end
+  
+  def xml_read_parser( as_xml, as_hash )    
+    set_has_status( as_xml, as_hash )      
+    as_hash[:host_name] = as_xml.xpath('host-name').text
+    unless (data = as_xml.xpath('domain-name')).empty?
+      as_hash[:domain_name] = data.text
+    end
+    unless (data = as_xml.xpath('domain-search')).empty?
+      as_hash[:domain_search] = data.collect{|i| i.text}
+    end
+    unless (data = as_xml.xpath('time-zone')).empty?
+      as_hash[:timezone] = data.text
+    end
+    unless (data = as_xml.xpath('name-server/name')).empty?
+      as_hash[:dns_servers] = data.collect{|i| i.text}
+    end
+    unless (data = as_xml.xpath('ntp/server/name')).empty?
+      as_hash[:ntp_servers] = data.collect{|i| i.text}
+    end
+    unless (location = as_xml.xpath('location')).empty?
+      as_hash[:location] = {}  
+      unless (data = location.xpath('building')).empty?
+        as_hash[:location][:building] = data.text
+      end
+      unless (data = location.xpath('country-code')).empty?
+        as_hash[:location][:countrycode] = data.text
+      end
+      unless (data = location.xpath('floor')).empty?
+        as_hash[:location][:floor] = data.text
+      end
+      unless (data = location.xpath('rack')).empty?
+        as_hash[:location][:rack] = data.text
+      end
+    end
+  end
+  
+  ### ---------------------------------------------------------------
+  ### XML property writers
+  ### ---------------------------------------------------------------    
+  
+  def xml_change_host_name( xml )
+    xml.send(:'host-name', @should[:host_name] )
+  end
+
+  def xml_change_domain_name( xml )
+    xml.send(:'domain-name', @should[:domain_name] )
+  end
+
+  def xml_change_domain_search( xml )
+  end
+  
+  def xml_change_timezone( xml )
+    xml.send(:'time-zone', @should[:timezone])
+  end
+  
+  def xml_change_dns_servers( xml )
+  end
+  
+  def xml_change_ntp_servers( xml )
+  end
+  
+  def xml_change_date( xml )
+  end
+  
+  def xml_change_location( xml )
+  end
+    
+end
+
+

data/lib/junos-ez/system/userauths.rb

@@ -0,0 +1,84 @@
+=begin
+=end
+
+module Junos::Ez::UserAuths
+  
+  VALID_KEY_TYPES = ['ssh-rsa','ssh-dsa']
+
+  def self.Provider( ndev, varsym )            
+    newbie = Junos::Ez::UserAuths::Provider.new( ndev )            
+    newbie.properties = Junos::Ez::Provider::PROPERTIES
+    Junos::Ez::Provider.attach_instance_variable( ndev, varsym, newbie )
+  end
+  
+  class Provider < Junos::Ez::Provider::Parent
+  end
+    
+end
+
+##### ---------------------------------------------------------------
+##### Resource Property Methods
+##### ---------------------------------------------------------------
+
+class Junos::Ez::UserAuths::Provider
+  
+  ### ---------------------------------------------------------------
+  ### XML top placement
+  ### ---------------------------------------------------------------
+  
+  def xml_at_top
+    Nokogiri::XML::Builder.new{|x| x.configuration{ 
+      x.system { x.login { x.user { 
+        x.name @name[:user]
+        x.authentication {          
+          x.send( @name[:keytype].to_sym ) {
+            x.name @name[:publickey]
+            return x
+          }
+        }
+      }}}
+    }}
+  end
+  
+  ### ---------------------------------------------------------------
+  ### XML readers
+  ### ---------------------------------------------------------------
+
+  def xml_get_has_xml( xml )
+    @should[:_active] = true              # mark it so it will write!    
+    xml.xpath('//user/authentication/*')[0]    
+  end
+        
+  def xml_read_parser( as_xml, as_hash )
+    set_has_status( as_xml, as_hash )
+  end    
+  
+  ### ---------------------------------------------------------------
+  ### XML writers
+  ### ---------------------------------------------------------------
+  
+  ## !! since we're not actually modifying any properties, we need
+  ## !! to overload the xml_build_change method to simply return
+  ## !! the config at-top (includes ssh name)
+  
+  def xml_build_change( xml_at_here = nil )
+    xml_at_top.doc.root
+  end  
+  
+end
+
+##### ---------------------------------------------------------------
+##### Provider Collection Methods
+##### ---------------------------------------------------------------
+
+class Junos::Ez::UserAuths::Provider
+  def build_list
+    []
+  end
+  
+  def build_catalog
+    {}
+  end
+end
+
+