asa_console 0.1.2

data/script/test_names.rb

@@ -0,0 +1,33 @@
+
+#
+# Test configuring IP to name mappings.
+#
+ASAConsole::Test.script do |asa|
+  asa.connect
+
+  def reset_test(asa)
+    rc = asa.running_config('names').select('name', '192.0.2.1')
+    asa.config_exec!('no name 192.0.2.1') unless rc.nil?
+    rc = asa.running_config('names').select('name', '192.0.2.2')
+    asa.config_exec!('no name 192.0.2.2') unless rc.nil?
+  end
+
+  reset_test(asa)
+
+  # Are question marks being escaped?
+  asa.config_exec!("name 192.0.2.1 ASATest1 description What's in a name? That which we call a rose...")
+  asa.config_exec!("name 192.0.2.2 ASATest2")
+
+  asa.running_config('names').select('name') do |rc|
+    m = /(?<addr>[\d\.]+) (?<name>[\w\-]+)(?: description (?<desc>.*))?/.match(rc.config_data)
+    if m[:desc]
+      log "#{m[:addr]} is called \"#{m[:name]}\" and its description is \"#{m[:desc]}\""
+    else
+      log "#{m[:addr]} is called \"#{m[:name]}\" and it has no description"
+    end
+  end
+
+  reset_test(asa)
+
+  asa.disconnect
+end

data/script/test_object.rb

@@ -0,0 +1,50 @@
+
+#
+# Test configuring a network object to demonstrate the difference between
+# #config_exec! and #config_exec without the "!".
+#
+ASAConsole::Test.script do |asa|
+  asa.connect
+
+  if asa.version? '< 8.3(1)'
+    log "Objects are not supported in version #{asa.version}"
+  else
+    id = 'TestObject-192.0.2.1'
+
+    # This command will return an "ERROR: " message if the object does not
+    # already exist, so we need to pass a flag to ignore it.
+    asa.config_exec!('no object network ' + id, ignore_errors: true)
+
+    asa.config_exec!('object network ' + id)
+
+    # We are now in a configuration submode.
+    asa.config_exec('description My network object', require_config_mode: 'config-network-object')
+    asa.config_exec('host 192.0.2.1', require_config_mode: 'config-network-object')
+
+    # There is no "config-object" mode so let's use that to make sure that the
+    # config mode requiremnt is actually being checked.
+    begin
+      asa.config_exec('description Something went wrong', require_config_mode: 'config-object')
+    rescue ASAConsole::Error::ConfigModeError => e
+      log "Rescued config mode error: #{e.message}"
+    end
+
+    rc = asa.running_config('object id ' + id).select('object')
+    desc = rc.select('description').config_data
+    host = rc.select('host').config_data
+
+    log "Network object #{id} has description #{desc.dump}"
+    log "Network object #{id} has host #{host}"
+
+    asa.config_exec!('no object network ' + id)
+
+    rc = asa.running_config('object id ' + id).select('object')
+    if rc.nil?
+      log "Object #{id} has been removed"
+    else
+      log "Object #{id} still exists"
+    end
+  end
+
+  asa.disconnect
+end

data/script/test_terminal.rb

@@ -0,0 +1,25 @@
+
+#
+# Test the behavior of the running config cache by repeatedly querying for the
+# terminal width.
+#
+ASAConsole::Test.script do |asa|
+  asa.connect
+
+  def terminal_width(asa)
+    asa.running_config('terminal').select('terminal width').config_data
+  end
+
+  # This will send a "show running-config" command to the device.
+  tw = terminal_width(asa)
+  log "Terminal width is #{tw}"
+
+  asa.config_exec! "terminal width 40"
+  log "Terminal width is now #{terminal_width(asa)}"     # This will send another "show running-config".
+  asa.config_exec! "terminal width #{tw}"
+  log "Terminal width is back to #{terminal_width(asa)}" # This will send another "show running-config".
+  log "Checking again..."
+  log "Terminal width is still #{terminal_width(asa)}"   # This time the value will be pulled from the cache.
+
+  asa.disconnect
+end

data/script/test_version.rb

@@ -0,0 +1,31 @@
+
+#
+# Test various methods for checking the ASA software version.
+#
+ASAConsole::Test.script do |asa|
+  asa.connect
+
+  log asa.version?('=7') ? 'This is version 7' : 'This is not version 7'
+
+  log asa.version?('<8') ? 'Version is less than 8' : 'Version is not less than 8'
+
+  if asa.version?('7.x(x)') || asa.version?('<=8.3(x)')
+    log 'Running an old version'
+  end
+
+  asa.version? '!8.x', '!9.x' do
+    log 'Not running version 8 or 9'
+  end
+
+  asa.version? '>7', '8.x' do
+    log 'Version 8!'
+  end
+
+  asa.version? '>7', '9.x' do
+    log 'Version 9!'
+  end
+
+  log 'Version string is ' + asa.version
+
+  asa.disconnect
+end

metadata

@@ -0,0 +1,209 @@
+--- !ruby/object:Gem::Specification
+name: asa_console
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Henry Goodman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.9.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.9.2
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.35'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.35'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: This gem lets a program interact with a Cisco ASA using CLI commands.
+  It includes a minimal set of functions for issuing commands and parsing the results.
+email: github@henrygoodman.com
+executables:
+- asatest
+extensions: []
+extra_rdoc_files: []
+files:
+- .yardopts
+- LICENSE.md
+- README.md
+- asa_console.gemspec
+- bin/asatest
+- lib/asa_console.rb
+- lib/asa_console/config.rb
+- lib/asa_console/error.rb
+- lib/asa_console/terminal.rb
+- lib/asa_console/terminal/fake_ssh.rb
+- lib/asa_console/terminal/ssh.rb
+- lib/asa_console/test.rb
+- lib/asa_console/test/script.rb
+- lib/asa_console/util.rb
+- script/test_clock.rb
+- script/test_connect.rb
+- script/test_error_command.rb
+- script/test_error_connect.rb
+- script/test_error_enable.rb
+- script/test_names.rb
+- script/test_object.rb
+- script/test_terminal.rb
+- script/test_version.rb
+homepage: https://github.com/hgoodman/asa-console/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.0
+signing_key: 
+specification_version: 4
+summary: Cisco ASA management via an interactive terminal session
+test_files: []
+has_rdoc: yard