stashboard_notifier 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rvmrc

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+ruby_string="ruby-1.8.7-p334"
+gemset_name="stashboard_notifier"
+
+if rvm list strings | grep -q "${ruby_string}" ; then
+
+  # Load or create the specified environment
+  if [[ -d "${rvm_path:-$HOME/.rvm}/environments" \
+    && -s "${rvm_path:-$HOME/.rvm}/environments/${ruby_string}@${gemset_name}" ]] ; then
+    \. "${rvm_path:-$HOME/.rvm}/environments/${ruby_string}@${gemset_name}"
+  else
+    rvm --create  "${ruby_string}@${gemset_name}"
+  fi
+
+else
+
+  # Notify the user to install the desired interpreter before proceeding.
+  echo "${ruby_string} was not found, please run 'rvm install ${ruby_string}' and then cd back into the project directory."
+
+fi

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# CHANGELOG
+
+## 0.0.1 - Initial version
+
+* Initial release
+* Lists services and statuses
+* Enables creation of events for already defined services
+* Config specified in command line, or can be loaded from $HOME/.stashboard_notifier

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in stashboard_notifier.gemspec
+gemspec

data/README.md

@@ -0,0 +1,43 @@
+# Stashboard Notifier
+
+Command line executable for sending messages to a Stashboard instance
+([http://www.stashboard.org]((http://www.stashboard.org)).
+
+Uses the stashboard gem to send messages.
+
+## Intended uses
+
+This is intended for integration with a tool like Nagios, which can be
+configured to call arbitrary commands should certain events happen in your
+server infrastructure. These commands can be anything, but they need some sort
+of command line tool to send the messages.
+
+## Usage
+
+   List services
+
+   $ stashboard_notifier services
+
+   List statuses
+
+   $ stashboard_notifier statuses
+
+   Create a new event for a service
+
+   $ stashboard_notifier events --service=website --status=down "Website is down"
+
+## Configuration
+
+Every command needs at minimum 3 config options: the url to the stashboard
+instance, and an oauth_token and oauth_secret for that stashboard. These can be
+passed in as flags with each command invocation, but for convenience they can
+be specified in a config file, which is written into
+$HOME/.stashboard_notifier.
+
+A skeleton config file can be generated by running:
+
+    $ stashboard_notifier initconfig
+
+Then this file should be edited to add your relevant details.
+
+Subsequently, you won't need to provide any of these details.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/bin/stashboard_notifier

@@ -0,0 +1,160 @@
+#!/usr/bin/env ruby
+# 1.9 adds realpath to resolve symlinks; 1.8 doesn't
+# have this method, so we add it so we get resolved symlinks
+# and compatibility
+unless File.respond_to? :realpath
+  class File #:nodoc:
+    def self.realpath path
+      return realpath(File.readlink(path)) if symlink?(path)
+      path
+    end
+  end
+end
+
+$: << File.expand_path(File.dirname(File.realpath(__FILE__)) + '/../lib')
+
+require 'rubygems'
+require 'bundler/setup'
+require 'gli'
+require 'stashboard_notifier'
+require 'stashboard'
+
+include GLI
+
+version StashboardNotifier::VERSION
+
+desc 'The url of your stashboard instance (should start with https)'
+arg_name '<stashboard_url>'
+flag [:stashboard]
+
+desc 'The oath token for accessing that stashboard'
+arg_name '<oauth_token>'
+flag [:oauth_token]
+
+desc 'The oath secret for accessing that stashboard'
+arg_name '<oauth_secret>'
+flag [:oauth_secret]
+
+config_file '.stashboard_notifier'
+
+desc 'Manage services currently managed by the stashboard instance'
+arg_name 'Describe arguments to services here'
+command :services do |c|
+  c.action do |global_options,options,args|
+
+    stashboard = get_stashboard(global_options)
+
+    services = stashboard.services
+
+    services.each do |service|
+      puts service["id"]
+    end
+
+    # If you have any errors, just raise them
+    # raise "that command made no sense"
+  end
+end
+
+
+desc 'Manage statuses currently managed by the stashboard instance'
+arg_name 'Describe arguments to statuses here'
+command :statuses do |c|
+
+  c.action do |global_options,options,args|
+
+    stashboard = get_stashboard(global_options)
+
+    statuses = stashboard.statuses
+
+    statuses.each do |status|
+      puts status["id"]
+    end
+
+    # If you have any errors, just raise them
+    # raise "that command made no sense"
+  end
+end
+
+desc 'Manage events for services'
+long_desc <<-EOS
+  This is the main command for sending event notifications to the stashboard
+  instance.  The service and status parameters are required, then the remaining
+  parameter is a string sent as a message associated with the event. As the
+  message might contain spaces, then you should wrapp the message in quotes,
+  else you won't get a sensible message.
+
+  Example usage:
+
+  $ stashboard_notifier events --service=website --status=down "The server is down"
+EOS
+command :events do |c|
+  c.desc "Service id this event is for (required)"
+  c.arg_name '<service_id>'
+  c.flag [:service]
+
+  c.desc "Status id for this event (required)"
+  c.arg_name '<status_id>'
+  c.flag [:status]
+
+  c.action do |global_options,options,args|
+    
+    if options[:service].nil?
+      #puts "Must specify a service with --service=<service_name>"
+      raise "Must specify a service" 
+    end
+    
+    if options[:status].nil?
+      raise "Must specify a status"
+    end
+
+    if args.size != 3
+      raise "Too many arguments"
+    end
+
+    stashboard = get_stashboard(global_options)
+
+    stashboard.create_event(options[:service], options[:status], args.last)
+     
+    # If you have any errors, just raise them
+    # raise "that command made no sense"
+  end
+end
+
+pre do |global,command,options,args|
+  # if global[:config_file]
+  #   require 'yaml'
+  #   
+  #   begin
+  #     config = YAML.load_file(global[:config_file])
+
+  #     global[:stashboard] = config["stashboard"] unless config["stashboard"].nil?
+  #     global[:oauth_token] = config["oauth_token"] unless config["oauth_token"].nil?
+  #     global[:oauth_secret] = config["oauth_secret"] unless config["oauth_secret"].nil?
+  #     
+  #   rescue Exception => e
+  #     msg = "Unable to load config file #{global[:config_file]}: #{e.inspect}"
+  #     puts msg
+  #     raise msg
+  #   end
+  # end
+  # Return true to proceed; false to abourt and not call the
+  # chosen command
+  true
+end
+
+post do |global,command,options,args|
+  # Post logic here
+end
+
+on_error do |exception|
+  puts "ERROR: #{exception.message}"
+  # Error logic here
+  # return false to skip default error handling
+  true
+end
+
+def get_stashboard(options)
+  Stashboard::Stashboard.new(options[:stashboard], options[:oauth_token], options[:oauth_secret])
+end
+
+exit GLI.run(ARGV)

data/lib/stashboard_notifier/version.rb

@@ -0,0 +1,3 @@
+module StashboardNotifier
+  VERSION = "0.0.1"
+end

data/lib/stashboard_notifier.rb

@@ -0,0 +1 @@
+require 'stashboard_notifier/version'

data/stashboard_notifier.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "stashboard_notifier/version"
+
+Gem::Specification.new do |s|
+  s.name        = "stashboard_notifier"
+  s.version     = StashboardNotifier::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Samuel Mulube"]
+  s.email       = ["sam@connectedenvironments.com"]
+  s.homepage    = ""
+  s.summary     = %q{Simple executable that will send a message to stashboard when called}
+  s.description = %q{Installs a simple executable to your path that can be used to send a message to a stashboard instance}
+
+  s.rubyforge_project = "stashboard_notifier"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency("stashboard", [">= 0.0.2"])
+  s.add_runtime_dependency("gli", [">= 1.2.6"])
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification 
+name: stashboard_notifier
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Samuel Mulube
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-27 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: stashboard
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 0
+        - 0
+        - 2
+        version: 0.0.2
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: gli
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 1
+        - 2
+        - 6
+        version: 1.2.6
+  type: :runtime
+  version_requirements: *id002
+description: Installs a simple executable to your path that can be used to send a message to a stashboard instance
+email: 
+- sam@connectedenvironments.com
+executables: 
+- stashboard_notifier
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- CHANGELOG.md
+- Gemfile
+- README.md
+- Rakefile
+- bin/stashboard_notifier
+- lib/stashboard_notifier.rb
+- lib/stashboard_notifier/version.rb
+- stashboard_notifier.gemspec
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: stashboard_notifier
+rubygems_version: 1.6.1
+signing_key: 
+specification_version: 3
+summary: Simple executable that will send a message to stashboard when called
+test_files: []
+