stashboard 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+pkg/*
+*.gem
+.bundle
+doc/*
+.yardoc

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,22 @@
+PATH
+  remote: .
+  specs:
+    stashboard (0.0.1)
+      oauth (>= 0.4.4)
+      yajl-ruby (>= 0.8.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    oauth (0.4.4)
+    yajl-ruby (0.8.1)
+    yard (0.6.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  oauth (>= 0.4.4)
+  stashboard!
+  yajl-ruby (>= 0.8.1)
+  yard (>= 0.6.4)

data/README.md

@@ -0,0 +1,25 @@
+# Stashboard gem
+
+Simple little ruby library for interacting with a Stashboard instance
+([http://www.stashboard.org]((http://www.stashboard.org)).
+
+Stashboard is a Python application designed to be run on the Google App Engine,
+which provides a system status type page for your application similar to the
+status pages offered by [Amazon AWS](http://status.aws.amazon.com/), or 
+[Google Apps](http://www.google.com/appsstatus).
+
+This library doesn't address setting up your Stashboard instance, but
+simplifies interacting with it from Ruby.
+
+# Usage
+
+    stashboard = Stashboard.new("https://your-app.appspot.com", "<stashboard_oauth_token>", "<stashboard_oauth_secret>")
+
+    # get all services
+    stashboard.services
+
+    # get individual service details
+    stashboard.service("website")
+
+    # create new event for a service
+    stashboard.create_event("website", "down", "Server unavailable, attempting to restart")

data/Rakefile

@@ -0,0 +1,28 @@
+require 'rake/clean'
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+CLEAN.include("pkg")
+CLOBBER.include("doc")
+
+namespace :doc do
+  project_root = File.expand_path(File.dirname(__FILE__))
+  doc_destination = File.join(project_root, 'doc', 'rdoc')
+
+  begin
+    require 'yard'
+    require 'yard/rake/yardoc_task'
+
+    YARD::Rake::YardocTask.new(:generate) do |yt|
+      yt.files = Dir.glob(File.join(project_root, 'lib', '**', '*.rb')) + 
+        [File.join(project_root, 'README.md') ]
+      yt.options = ['--output-dir', doc_destination, '--readme', 'README.md']
+    end
+  rescue LoadError
+    desc "Generate YARD Documentation"
+    task :generate do
+      abort "Please install the YARD gem to generate rdoc."
+    end
+  end
+end

data/lib/stashboard/stashboard.rb

@@ -0,0 +1,162 @@
+require 'rubygems'
+require 'oauth'
+require 'yajl/json_gem'
+
+module Stashboard
+  # Main class for interacting with Stashboard.
+  class Stashboard
+    
+    # Create a new Stashboard instance.
+    #
+    # @param [String] the url of your stashboard instance (this should use https)
+    # @param [String] the oauth_token generated by your Stashboard instance (this is the long one)
+    # @param [String] the oauth_secret generated by your Stashboard instance (this is the shorter one)
+    def initialize(base_url, oauth_token, oauth_secret)
+      @consumer = OAuth::Consumer.new("anonymous", "anonymous", { :site => base_url })
+      @client = OAuth::AccessToken.new(@consumer, oauth_token, oauth_secret)
+    end
+  
+    # Gets a list of all services currently managed by the Stashboard instance
+    # 
+    # @return [Array] an array of service detail hashes
+    def services
+      response = @client.get("/api/v1/services")
+      return JSON.parse(response.body)
+    end
+  
+    # Get the details of an individual service managed by the Stashboard instance.
+    #
+    # @param [String] the unique id of the service (generated by Stashboard)
+    # @return [Hash] hash containing the service details
+    def service(service_id)
+      response = @client.get("/api/v1/services/#{service_id}")
+      return JSON.parse(response.body)
+    end
+  
+    # Create a new service.
+    #
+    # @param [String] the name of the service
+    # @param [String] the description of the service
+    # @return [Hash] response containing the complete service details generated by Stashboard
+    def create_service(name, description)
+      response = @client.post("/api/v1/services", { "name" => name, "description" => description })
+      return JSON.parse(response.body)
+    end
+  
+    # Delete a service. This will delete all alerts for this service, so be careful.
+    #
+    # @param [String] the service id to delete
+    # @return [Hash] details of the service we've just deleted
+    def delete_service(service_id)
+      response = @client.delete("/api/v1/services/#{service_id}")
+      return JSON.parse(response.body)
+    end
+  
+    # Updates details of an existing service with a new name or description.
+    # You can't change the service_id however.
+    #
+    # @param [String] the id of the service to update
+    # @param [String] the new name
+    # @param [String] the new description
+    # @return [Hash] the updated service details
+    def update_service(service_id, name, description)
+      response = @client.post("/api/v1/services/#{service_id}", { "name" => name, "description" => description })
+      return JSON.parse(response.body)
+    end
+  
+    # Returns the different levels that new statuses can use.
+    # 
+    # @return [Array] an array of the level strings
+    def levels
+      response = @client.get("/api/v1/levels")
+      return JSON.parse(response.body)["levels"]
+    end
+  
+    # Get events for the specified service.
+    #
+    # @param [String] the service id we wer interested in
+    # @param [Hash] optional hash that restricts the returned events. Only keys that do anything are "start" and "end" which can be used to constrain the time period from which events will be returned.
+    # @return [Array] an array of event hashes describing events for the service
+    def events(service_id, options = {})
+      response = @client.get("/api/v1/services/#{service_id}/events", options)
+      return JSON.parse(response.body)
+    end
+  
+    # Create an event of a service. Events are the main way we
+    # indicate problems or resolutions of issues.
+    #
+    # @param [String] the id of the service
+    # @param [String] the id of an already existing status (i.e. "up", "down", "warning")
+    # @param [String] a descriptive message
+    # @return [Hash] the event details
+    def create_event(service_id, status_id, message)
+      response = @client.post("/api/v1/services/#{service_id}/events", { "status" => status_id, "message" => message })
+      return JSON.parse(response.body)
+    end
+  
+    # Get the current event for the specified service.
+    #
+    # @param [String] the id of the service
+    # @return [Hash] hash containing the current event details
+    def current_event(service_id)
+      response = @client.get("/api/v1/services/#{service_id}/events/current")
+      return JSON.parse(response.body)
+    end
+  
+    # Get details of an individual event
+    #
+    # @param [String] the id of the service
+    # @param [String] the sid of the event. This is a unique key returned in the response when an event is created
+    # @return [Hash] hash containing the current event details
+    def event(service_id, event_sid)
+      response = @client.get("/api/v1/services/#{service_id}/events/#{event_sid}")
+      return JSON.parse(response.body)
+    end
+  
+    # Delete an event.
+    #
+    # (see #event)
+    def delete_event(service_id, event_sid)
+      response = @client.delete("/api/v1/services/#{service_id}/events/#{event_sid}")
+      return JSON.parse(response.body)
+    end
+  
+    # Get all statuses.
+    #
+    # @return [Array] an array of status hashes, each hash is an individual status
+    def statuses
+      response = @client.get("/api/v1/statuses")
+      return JSON.parse(response.body)
+    end
+  
+    # Get the details of the individual status.
+    #
+    # @param [String] the id of the status
+    # @return [Hash] hash containing the status details
+    def status(status_id)
+      response = @client.get("/api/v1/statuses/#{status_id}")
+      return JSON.parse(response.body)
+    end
+  
+    # Create a new status. Statuses exist independently of any Service, and are
+    # required before creating any events that use this status
+    #
+    # @param [String] the name of this status
+    # @param [String] description of the status
+    # @param [String] level string. Must be one of the levels returned from #levels
+    # @param [String] name of an image to use for this status. The complete list of images can be retrieved using #status_images, and this value should just be the image name without the directory name or the file extension.
+    # @return [Hash] hash containing the created statuses details
+    def create_status(name, description, level, image)
+      response = @client.post("/api/v1/statuses", { "name" => name, "description" => description, "level" => level, "image" => image })
+      return JSON.parse(response.body)
+    end
+  
+    # Return a list of all the status images that the Stashboard server knows about.
+    #
+    # @return [Array] array of image hashes
+    def status_images
+      response = @client.get("/api/v1/status-images")
+      return JSON.parse(response.body)["images"]
+    end
+  end
+end

data/lib/stashboard/version.rb

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

data/lib/stashboard.rb

@@ -0,0 +1,4 @@
+$:.unshift(File.expand_path(File.dirname(__FILE__)))
+
+require "stashboard/version"
+require "stashboard/stashboard"

data/stashboard.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "stashboard/version"
+
+Gem::Specification.new do |s|
+  s.name        = "stashboard"
+  s.version     = Stashboard::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Sam Mulube"]
+  s.email       = ["sam@connectedenvironments.com"]
+  s.homepage    = "http://github.com/smulube/stashboard"
+  s.summary     = %q{Library for interacting with the Stashboard api.}
+  s.description = %q{Little library written to make interacting with the stashboard api a bit easier}
+
+  s.rubyforge_project = "stashboard"
+  s.rubygems_version = ">= 1.3.6"
+
+  s.add_dependency('yajl-ruby', '>= 0.8.1')
+  s.add_dependency('oauth', '>= 0.4.4')
+
+  s.add_development_dependency('yard', '>= 0.6.4')
+
+  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"]
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: stashboard
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Sam Mulube
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-04 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 61
+        segments: 
+        - 0
+        - 8
+        - 1
+        version: 0.8.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: oauth
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 4
+        - 4
+        version: 0.4.4
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 0
+        - 6
+        - 4
+        version: 0.6.4
+  type: :development
+  version_requirements: *id003
+description: Little library written to make interacting with the stashboard api a bit easier
+email: 
+- sam@connectedenvironments.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- lib/stashboard.rb
+- lib/stashboard/stashboard.rb
+- lib/stashboard/version.rb
+- stashboard.gemspec
+has_rdoc: true
+homepage: http://github.com/smulube/stashboard
+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
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Library for interacting with the Stashboard api.
+test_files: []
+