rubicante 0.0.1

data/History.txt

@@ -0,0 +1,7 @@
+=== 0.0.1 / 2009-04-08
+
+* Initial alpha release
+* Support adding hosts with
+  * ports
+  * websites
+* Report 'what is wrong'

data/Manifest.txt

@@ -0,0 +1,26 @@
+History.txt
+Manifest.txt
+README.rdoc
+README.txt
+Rakefile
+bin/rubicante
+lib/rubicante.rb
+lib/rubicante/cli.rb
+lib/rubicante/environment.rb
+lib/rubicante/host.rb
+lib/rubicante/host_error.rb
+lib/rubicante/host_group.rb
+lib/rubicante/type.rb
+lib/rubicante/type_group.rb
+lib/rubicante/website.rb
+lib/rubicante/website_error.rb
+spec/environment_spec.rb
+spec/helper.rb
+spec/host_error_spec.rb
+spec/host_group_spec.rb
+spec/host_spec.rb
+spec/type_group_spec.rb
+spec/type_spec.rb
+spec/website_error_spec.rb
+spec/website_spec.rb
+test/test_rubicante.rb

data/README.rdoc

@@ -0,0 +1,118 @@
+= rubicante
+
+* RubyForge http://rubicante.rubyforge.org
+* GitHub http://github.com/avanderhook/rubicante
+
+== DESCRIPTION:
+
+Rubicante is a business natural language (BNL) for System Administrators (SAs).
+It allows SAs to define their networks in terms of servers, what those servers
+provide (websites, Win32 services), and what ports they listen on.  Once the
+network is defined, SAs can type in natural language questions about the network
+and receive answers.
+
+== FEATURES/PROBLEMS:
+
+* Describe a network of computer systems
+  * Hosts
+    * Ports it should be listening on
+    * Critical web sites hosted
+* Query the network
+  * What is wrong: returns items (hosts, websites) that are not functioning
+
+== SYNOPSIS:
+
+There are several ways that you can run Rubicante:
+* An interactive shell
+* An interactive shell with source file
+* Cron mode
+* All of the above in DEBUG mode
+
+=== Interactive Shell:
+
+Interactive shell mode allows you to specify hosts and run Rubicante queries against them.
+
+  $ rubicante
+  rubicante> Host webserver provides website www.my-intranet.com
+  rubicante> Host webserver provides website www.good-website.com, website www.bad-website.com
+  rubicante> What is wrong?
+  [webserver] is returning code 500 for website www.bad-website.com
+
+=== Interactive Shell with Source File
+
+Interactive shell mode with files allows you to define your network's resources
+in a file, load them in to rubicante, and obtain the interactive shell prompt
+so you can use Rubicante queries to examine the network.
+
+  $ cat 'my-network.bnl'
+  Host webserver listens on port 80, provides website www.example.com
+  Host shellserver listens on port 22
+  $ rubicante -r my-network.bnl
+  rubicante> What is wrong?
+  [shellserver] port 22 is closed.
+
+=== Cron Mode
+
+Cron mode reads in the specified file and then asks Rubicante
+"what is wrong?".  Any problems discovered will be logged to STDOUT
+(making this ideal for calling periodically with cron), and then exiting.
+
+  $ cat 'my-network.bnl'
+  host web1 website www.mycompany.com
+  host web2 website intranet.mycompany.com
+  host web3 website wiki.mycompnay.com
+  $ rubicante -c my-network.bnl
+  [web2] is returning code 500 for website intranet.mycompany.com
+  $
+
+=== DEBUG mode
+
+Use the '-d' flag when executing Rubicante to obtain debug output.
+
+== BASIC LANGUAGE SPECIFICATION:
+
+=== Conventions used
+* <parameter> is a required parameter
+* [optional] is an optional word (i.e., a "bubble" word for readability)
+
+=== HOST language
+
+* Host <hostname> [provides] website <fqdn>
+  * Defines host <hostname> (if not previously defined) and registers the website a <fqdn> with it
+  * Example:
+	host www provides website www.example.com
+* Host <hostname> [listens] [on] port <port #>
+  * Defined host <hostname> (if not previously defined) and registers the port <port #> to it
+  * Example:
+	host www listens on port 80"
+* COMBINE HOST SUBCOMMANDS IN ONE LINE
+  * Example:
+	host www listens on port 80, port 443, provides website www.mycompany.com, website intranet.mycompany.com
+
+=== WHAT language
+
+* What [is] wrong[?]
+  * checks all defined hosts for problems and reports them
+
+== REQUIREMENTS:
+
+* Ruby 1.8+
+* logging (>= 0.9.7)
+* trollop (>= 1.13)
+
+== INSTALL:
+
+* sudo gem install rubicante
+
+== LICENSE:
+
+Copyright (c) 2009, Adam VanderHook
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of the Rubicante nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.txt

@@ -0,0 +1,118 @@
+= rubicante
+
+* RubyForge http://rubicante.rubyforge.org
+* GitHub http://github.com/avanderhook/rubicante
+
+== DESCRIPTION:
+
+Rubicante is a business natural language (BNL) for System Administrators (SAs).
+It allows SAs to define their networks in terms of servers, what those servers
+provide (websites, Win32 services), and what ports they listen on.  Once the
+network is defined, SAs can type in natural language questions about the network
+and receive answers.
+
+== FEATURES/PROBLEMS:
+
+* Describe a network of computer systems
+  * Hosts
+    * Ports it should be listening on
+    * Critical web sites hosted
+* Query the network
+  * What is wrong: returns items (hosts, websites) that are not functioning
+
+== SYNOPSIS:
+
+There are several ways that you can run Rubicante:
+* An interactive shell
+* An interactive shell with source file
+* Cron mode
+* All of the above in DEBUG mode
+
+=== Interactive Shell:
+
+Interactive shell mode allows you to specify hosts and run Rubicante queries against them.
+
+  $ rubicante
+  rubicante> Host webserver provides website www.my-intranet.com
+  rubicante> Host webserver provides website www.good-website.com, website www.bad-website.com
+  rubicante> What is wrong?
+  [webserver] is returning code 500 for website www.bad-website.com
+
+=== Interactive Shell with Source File
+
+Interactive shell mode with files allows you to define your network's resources
+in a file, load them in to rubicante, and obtain the interactive shell prompt
+so you can use Rubicante queries to examine the network.
+
+  $ cat 'my-network.bnl'
+  Host webserver listens on port 80, provides website www.example.com
+  Host shellserver listens on port 22
+  $ rubicante -r my-network.bnl
+  rubicante> What is wrong?
+  [shellserver] port 22 is closed.
+
+=== Cron Mode
+
+Cron mode reads in the specified file and then asks Rubicante
+"what is wrong?".  Any problems discovered will be logged to STDOUT
+(making this ideal for calling periodically with cron), and then exiting.
+
+  $ cat 'my-network.bnl'
+  host web1 website www.mycompany.com
+  host web2 website intranet.mycompany.com
+  host web3 website wiki.mycompnay.com
+  $ rubicante -c my-network.bnl
+  [web2] is returning code 500 for website intranet.mycompany.com
+  $
+
+=== DEBUG mode
+
+Use the '-d' flag when executing Rubicante to obtain debug output.
+
+== BASIC LANGUAGE SPECIFICATION:
+
+=== Conventions used
+* <parameter> is a required parameter
+* [optional] is an optional word (i.e., a "bubble" word for readability)
+
+=== HOST language
+
+* Host <hostname> [provides] website <fqdn>
+  * Defines host <hostname> (if not previously defined) and registers the website a <fqdn> with it
+  * Example:
+	host www provides website www.example.com
+* Host <hostname> [listens] [on] port <port #>
+  * Defined host <hostname> (if not previously defined) and registers the port <port #> to it
+  * Example:
+	host www listens on port 80"
+* COMBINE HOST SUBCOMMANDS IN ONE LINE
+  * Example:
+	host www listens on port 80, port 443, provides website www.mycompany.com, website intranet.mycompany.com
+
+=== WHAT language
+
+* What [is] wrong[?]
+  * checks all defined hosts for problems and reports them
+
+== REQUIREMENTS:
+
+* Ruby 1.8+
+* logging (>= 0.9.7)
+* trollop (>= 1.13)
+
+== INSTALL:
+
+* sudo gem install rubicante
+
+== LICENSE:
+
+Copyright (c) 2009, Adam VanderHook
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of the Rubicante nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/Rakefile

@@ -0,0 +1,14 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/rubicante.rb'
+
+Hoe.new('rubicante', Rubicante::VERSION) do |p|
+  p.remote_rdoc_dir = '' # Release to root
+  p.developer('Adam VanderHook', 'avanderhook@gmail.com')
+  p.extra_deps << ['logging', '>= 0.9.7']
+  p.extra_deps << ['trollop', '>= 1.13']
+end
+
+# vim: syntax=Ruby

data/bin/rubicante

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+require 'rubicante/cli'
+
+require 'trollop'
+
+opts = Trollop::options do
+  banner <<-EOS
+A business natural language for Systems Administrators
+
+Usage:
+  rubicante [options]
+where [options] are:
+EOS
+  
+  opt :cron,  "Check the network described in the specified file and exit", :type => :string
+  opt :debug, "Turn debugging ON", :default => false
+  opt :read,  "Read in and process a file", :type => :string
+end
+
+# Create the CLI interface with requested debug options
+app = Rubicante::CLI.new(opts[:debug])
+
+# If requested, load in the specified file
+app.load(opts[:read]) if opts[:read]
+
+# Validate the current network if cron mode is used
+if opts[:cron]
+  app.load opts[:cron]
+  app.handle("what wrong")
+end
+
+# Display the command line unless cron mode has been turned on
+app.run if not opts[:cron]

data/lib/rubicante.rb

@@ -0,0 +1,6 @@
+#require 'rubicante/type'
+#require 'rubicante/type_group'
+
+class Rubicante
+  VERSION = '0.0.1'
+end

data/lib/rubicante/cli.rb

@@ -0,0 +1,89 @@
+require 'rubicante/environment'
+
+require 'logging'
+
+module Rubicante
+  # A command-line interface for Rubicante
+  class CLI
+    def initialize(debug = false)
+      # Set up the logger for this CLI session
+      @log = Logging::Logger['rubicante']
+      @log.add_appenders(Logging::Appender.stdout)
+      @log.level = debug ? :debug : :info
+
+      # Set up logger for Environment
+      Logging::Appender['rubicante'] = Logging::Appender.stdout
+      Logging::Logger['Rubicante::Environment'].add_appenders(Logging::Appender['rubicante'])
+      Logging::Logger['Rubicante::Environment'].level = @log.level
+
+      # Prepare Environment
+      @env = Environment.new
+    end
+
+    def process(resp)
+      if resp.kind_of? HostError
+        process_host_error(resp)
+      end
+    end
+
+    def process_host_error(resp)
+      if not resp.ping
+        puts_error(resp.hostname, "is unreachable.")
+      else
+        process_port_errors(resp)
+        process_website_errors(resp)
+      end
+    end
+
+    def process_port_errors(resp)
+      resp.bad_ports.each do |bad_port|
+        puts_error(resp.hostname, "port #{bad_port} is closed.")
+      end
+    end
+
+    def process_website_errors(resp)
+      resp.website_errors.each do |website_error|
+        puts_error(resp.hostname, "is returning code #{website_error.code} for website #{website_error.url}.")
+      end
+    end
+
+    def puts_error(hostname, error)
+      @log.info "[#{hostname}] #{error}"
+    end
+
+    # Load in a file, executing each line
+    def load(file)
+      cmds = File.new(file)
+      cmds.each_line { |cmd| handle(cmd) }
+    end
+
+    # Handles sending the command to the Environment and dealing
+    # with any return values that require output to the user
+    def handle(cmd)
+      exit if cmd == "exit"
+
+      begin
+        result = @env.eval_command(cmd)
+      rescue NotImplementedError
+        @log.error "Unrecognized command '#{cmd.split[0]}'."
+      end
+
+      # 'what' commands return Arrays
+      if result.kind_of? Array
+        result.each do |response|
+          process(response)
+        end
+      end
+    end
+
+    def run
+      while true do
+        print 'rubicante> '
+
+        cmd = gets.downcase.strip
+
+        handle(cmd)
+      end
+    end
+  end
+end

data/lib/rubicante/environment.rb

@@ -0,0 +1,78 @@
+require 'rubicante/host_group'
+
+require 'logging'
+
+module Rubicante
+  class Environment
+    attr_accessor :host
+
+    def initialize
+      @host = HostGroup.instance
+
+      @log = Logging::Logger[self]
+
+      # Prepare Host logger
+      @appender = Logging::Appender['rubicante']
+      Logging::Logger['Rubicante::Host'].add_appenders(Logging::Appender['rubicante']) if not @appender.nil?
+      Logging::Logger['Rubicante::Host'].level = @log.level
+    end
+
+    # Evaluate a command, sending it off to the appropriate
+    # 'eval_*' method.  Otherwise, through a NotImplementedError
+    def eval_command(cmd)
+      @log.debug "Received command: #{cmd}"
+
+      cmd_root = 'eval_' + cmd.split[0].downcase
+      @log.debug "Determined command root to be: #{cmd_root}"
+
+      if self.respond_to?(cmd_root)
+        self.send(cmd_root, cmd)
+      else
+        raise NotImplementedError
+      end
+    end
+
+    # Perform polish on a command starting with 'host' and
+    # evaluate it
+    def eval_host(cmd)
+      @log.debug "Polishing 'host' command"
+      cmd.gsub!(/^[Hh]ost\s([\S]+)\s/, 'host["\1"]')
+      cmd.gsub!(/website\s([^,]+)/, '.website("\1")')
+      cmd.gsub!(/port\s([^,]+)/, '.port(\1)')
+
+      # Clean up some bubble words
+      cmd.gsub!(/listens\son\s/, '')
+      cmd.gsub!(/provides\s/, '')
+      cmd.gsub!(/,/, '')    # clean up commas
+      cmd.gsub!(/[\s]/, '') # clean up white space
+
+      @log.debug "Evaluating polished 'host' command: #{cmd}"
+      instance_eval cmd
+    end
+
+    # Perform polish on a command starting with 'what' and
+    # evaluate it
+    def eval_what(cmd)
+      @log.debug "Polishing 'what' command"
+      # Clean up some bubble words
+      cmd.gsub!(/^[Ww]hat\s/, '')
+      cmd.gsub!(/is\s/, '')
+
+      @log.debug "Evaluating polished 'what' command: #{cmd}"
+      instance_eval cmd
+    end
+
+    def wrong?
+      @log.debug "Checking environment for things that are wrong"
+      result = []
+
+      host.hosts.keys.each do |key|
+        @log.debug "Checking host #{host[key].name}..."
+        result << host[key].wrong?
+      end
+
+      return result
+    end
+    alias_method :wrong, :wrong?
+  end
+end