custodian 0.0.1 → 0.0.2

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2012 Johannes Gorset
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -1,23 +1,39 @@
 # Custodian
 
-Custodian is a lightweight resource monitor that is easy to use and augment.
+Custodian is a lightweight resource monitor that makes it really easy
+and really awesome to sample metrics.
 
 ## Usage
 
-Start Custodian and configure it to sample metrics every 60 seconds and expose
-them on port 5100:
+### Server
 
-    $ custodian start 127.0.0.1:5100 --interval=60
+Start Custodian and configure it to expose its metrics on port 5100:
 
-## Augmenting Custodian
+    $ custodian --port=5100
 
-Custodian convenes statistics from *samplers*, which are just simple Ruby classes:
+![Example](https://github.com/jgorset/custodian/raw/master/docs/images/example.png)
 
-    class Who << Custodian::Sampler
+#### Samplers
 
-      # Return a list of usernames describing logged-in users.
-      def sample
-        `who`.lines.collect { |line| line.split.first }
-      end
+Custodian aggregates metrics from *samplers*, and ships with samplers for popular figures
+such as logged in users and load averages. That's interesting and all, but custom
+samplers are all the rage.
 
-    end
+```ruby
+class RegisteredUsers < Custodian::Samplers::Sampler
+  describe "Registered users"
+
+  def self.sample
+    Users.count
+  end
+end
+```
+
+You can load your own samplers with the `--samplers` option.
+
+    $ custodian --samplers=~/.samplers
+
+### Clients
+
+Unless you're crazy about JSON, you'll want to consume Custodian's API with a
+*client*. Unfortunately, there are no clients for Custodian yet — you should make one!

data/Rakefile

@@ -1 +1,7 @@
 require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList["test/*_test.rb"]
+  t.verbose    = true
+end

data/bin/custodian

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "custodian"
+
+Custodian::CLI.new ARGV

data/custodian.gemspec

@@ -19,6 +19,8 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   # specify any dependencies here; for example:
-  # s.add_development_dependency "rspec"
-  # s.add_runtime_dependency "rest-client"
+  s.add_development_dependency "rspec"
+  s.add_runtime_dependency "thin"
+  s.add_runtime_dependency "rack"
+  s.add_runtime_dependency "active_support"
 end

data/lib/custodian.rb

@@ -1,5 +1,7 @@
-require "custodian/version"
-
 module Custodian
-  # Your code goes here...
+  autoload :VERSION,      "custodian/version"
+  autoload :Samplers,     "custodian/samplers"
+  autoload :API,          "custodian/api"
+  autoload :CLI,          "custodian/cli"
+  autoload :OS,           "custodian/os"
 end

data/lib/custodian/api.rb

@@ -0,0 +1,33 @@
+require "json"
+
+module Custodian
+
+  # The API class is a Rack-compatible* application that encapsulates
+  # Custodian's interface.
+  # 
+  # * http://rack.rubyforge.org/doc/files/SPEC.html.
+  class API
+
+    # Render the JSON representation of each sample.
+    #
+    # env - A Hash of CGI-like headers describing the
+    #       environment under which the request was received.
+    #
+    # Returns an Array describing the HTTP response.
+    def call(env)
+      status = 200
+
+      headers = {
+        "Content-Type" => "application/json"
+      }
+
+      body = Custodian::Samplers.list.collect do |sampler|
+        { description: sampler.description, sample: sampler.sample } if sampler.compatible?
+      end.compact.to_json
+
+      [status, headers, [body]]
+    end
+
+  end
+
+end

data/lib/custodian/cli.rb

@@ -0,0 +1,158 @@
+require "thin"
+require "rack"
+require "rack/auth/basic"
+require "optparse"
+
+module Custodian
+
+  # The CLI class encapsulates Custodian's command-line interface.
+  class CLI
+    DEFAULT_PORT = 5100
+
+    # Create a new command-line interface.
+    #
+    # arguments - An Array of String objects describing arguments
+    #             passed to the program (see CLI#parse).
+    def initialize(arguments)
+      options = parse arguments
+
+      if samplers = options[:samplers]
+        load_samplers samplers
+      end
+
+      if options.include? :daemonize
+        deamonize
+      end
+
+      if pidfile = options[:pidfile]
+        write_pidfile pidfile
+      end
+
+      log "Custodian is accepting connections on port #{options[:port]}"
+
+      compatible_samplers   = Custodian::Samplers.compatible
+      incompatible_samplers = Custodian::Samplers.incompatible
+
+      log "#{compatible_samplers.count} compatible samplers."
+      compatible_samplers.each do |s|
+        log "   - #{s.description}"
+      end
+
+      log "#{incompatible_samplers.count} incompatible samplers."
+      incompatible_samplers.each do |s|
+        log "   - #{s.description}"
+      end
+
+      log "CTRL+C to stop"
+
+      Thin::Logging.silent = true
+      Thin::Server.start '0.0.0.0', options[:port] do
+        use Rack::CommonLogger
+        use Rack::ShowExceptions
+        use Rack::Auth::Basic do |username, password|
+          [username, password] == [options[:username], options[:password]]
+        end if options.include? :username
+
+        run Custodian::API.new
+      end
+    end
+
+    private
+
+    # Load samplers from the given directories.
+    #
+    # directories - An Array of Strings describing paths to directories
+    #               that contain samplers.
+    #
+    # Returns nothing.
+    def load_samplers(directories)
+      directories.each do |directory|
+        Custodian::Samplers.load directory
+      end
+    end
+
+    # Write the process id to the given file.
+    #
+    # file - A String describing a path to a file. If the file does not exist, it
+    #        will be created. If the file already exists, it will be overwritten.
+    #
+    # Returns nothing.
+    def write_pidfile(file)
+      File.open file, "w" do |file|
+        file << Process.id
+      end
+    end
+
+    # Daemonize the process.
+    def deamonize
+      Process.daemon
+    end
+
+    # Parse the given arguments or exit with an error if they are malformed and/or invalid.
+    #
+    # arguments - An Array of String objects describing arguments passed to the program.
+    #
+    # Returns a Hash of options derived from the given arguments:
+    #   :port      - An Integer describing the port to listen on.
+    #   :samplers  - An Array of String objects describing paths to load samplers from.
+    #   :daemonize - A Boolean describing whether or not to daemonize the process.
+    #   :pidfile   - A String describing a path to a file.
+    #   :username  - A String describing a username required by HTTP Basic authentication.
+    #   :password  - A String describing a password required by HTTP Basic authentication.
+    def parse(arguments)
+      options = {
+        port: DEFAULT_PORT
+      }
+
+      OptionParser.new do |o|
+        o.banner  = "Usage: custodian [options]"
+        o.version = Custodian::VERSION
+
+        o.on "-p PORT", "--port PORT", "Listen on PORT (default #{options[:port]})" do |port|
+          options[:port] = port
+        end
+
+        o.on "-s DIR", "--samplers DIR", "Load samplers from DIR" do |samplers|
+          options[:samplers] = samplers.split(":")
+        end
+
+        o.on "--daemonize", "Daemonize the process" do
+          options[:daemonize] = true
+        end
+
+        o.on "--pidfile FILE", "Write the process id to FILE" do |pidfile|
+          options[:pidfile] = pidfile
+        end
+
+        o.on "--authenticate USERNAME:PASSWORD", "Authenticate clients with the given USERNAME and PASSWORD" do |credentials|
+          unless credentials.include? ":"
+            raise OptionParser::InvalidArgument, "must be a colon-separated string of username and password"
+          end
+
+          options[:username], options[:password] = credentials.split(":")
+        end
+      end.parse! arguments
+
+      options
+    rescue OptionParser::ParseError => e
+      error e
+    end
+
+    # Log a message to STDOUT.
+    #
+    # message - A String describing a message.
+    def log(message)
+      puts ">> #{message}"
+    end
+
+    # Print a message and exit with the given code.
+    #
+    # message - A String describing the message to print.
+    # code    - An Integer describing the exit code (defaults to 1).
+    def error(message, code = 1)
+      puts "custodian: #{message}"
+      exit code
+    end
+  end
+
+end

data/lib/custodian/os.rb

@@ -0,0 +1,25 @@
+module Custodian
+
+  # The OS module encapsulates Custodian's operating
+  # system detection algorithms.
+  module OS
+
+    # Determine whether the operating system is darwin.
+    #
+    # Returns a boolean describing whether the operating system
+    # is darwin.
+    def self.darwin?
+      RUBY_PLATFORM.downcase.include? "darwin"
+    end
+
+    # Determine whether the operating system is linux.
+    #
+    # Returns a boolean describing whether the operating system
+    # is linux.
+    def self.linux?
+      RUBY_PLATFORM.downcase.include? "linux"
+    end
+
+  end
+
+end

data/lib/custodian/samplers.rb

@@ -0,0 +1,100 @@
+require "pathname"
+
+module Custodian
+
+  # The Samplers module encapsulates a collection of samplers
+  # for various metrics.
+  module Samplers    
+    autoload :Sampler,    "custodian/samplers/sampler"
+    autoload :Utilities,  "custodian/samplers/utilities"
+
+    @samplers = []
+
+    # List all samplers.
+    #
+    # Returns an Array of Sampler objects.
+    def self.list
+      @samplers
+    end
+
+    # List compatible samplers.
+    #
+    # Returns an Array of Sampler objects that are compatible
+    # with this system.
+    def self.compatible
+      @samplers.select { |s| s.compatible? }
+    end
+
+    # List incompatible samplers.
+    #
+    # Returns an Array of Sampler objects that are incompatible
+    # with this system.
+    def self.incompatible
+      @samplers.reject { |s| s.compatible? }
+    end
+
+    # Register the given sampler.
+    #
+    # sampler - An object that inherits from Sampler.
+    #
+    # Returns nothing.
+    def self.register(sampler)
+      @samplers << sampler
+    end
+
+    # Remove the given sampler.
+    #
+    # sampler - An object that inherits from Sampler.
+    def self.remove(sampler)
+      @samplers.delete(sampler)
+    end
+
+    # Replace one sampler with another.
+    #
+    # a - An object that inherits from Sampler.
+    # b - Another object that inherits from Sampler.
+    #
+    # Returns nothing.
+    def self.replace(a, b)
+      remove a
+      register b
+    end
+
+    # Clear all samplers.
+    def self.clear
+      @samplers = []
+    end
+
+    # Restore stock samplers.
+    def self.stock
+      load File.dirname(__FILE__) + "/samplers/darwin" if OS.darwin?
+      load File.dirname(__FILE__) + "/samplers/linux" if OS.linux?
+    end
+
+    # Load samplers from the given directory.
+    #
+    # directory - A String describing a path to a directory. If the path is relative,
+    #             it will be expanded from the current working directory. If the path
+    #             is prefixed with a tilde, it will be expanded from the current user's
+    #             home directory. If the path is prefixed with a tilde immediately followed
+    #             by a username, it will be expanded from that user's home directory.
+    #
+    # Returns nothing.
+    def self.load(directory)
+      path = Pathname.new directory
+
+      # Allow referencing directories by relative and home path.
+      path = path.expand_path unless path.absolute?
+
+      unless path.directory?
+        raise StandardError, "#{directory} is not a directory"
+      end
+
+      path.each_child do |child|
+        require child if child.file?
+      end
+    end
+
+    stock
+  end
+end

data/lib/custodian/samplers/darwin/cpu.rb

@@ -0,0 +1,19 @@
+module Custodian
+  module Samplers
+
+    class CPU < Custodian::Samplers::Sampler
+      describe "CPU usage"
+
+      def self.sample
+        cpu = `top -l 1`.match /CPU usage: ([0-9]+\.[0-9]+%) user, ([0-9]+\.[0-9]+%) sys, ([0-9]+\.[0-9]+%) idle/
+        
+        {
+          "User"    => cpu[1],
+          "System"  => cpu[2],
+          "Idle"    => cpu[3]
+        }
+      end
+    end
+
+  end
+end

data/lib/custodian/samplers/darwin/load.rb

@@ -0,0 +1,19 @@
+module Custodian
+  module Samplers
+
+    class Load < Custodian::Samplers::Sampler
+      describe "Load averages"
+
+      def self.sample
+        uptime = `uptime`[/load averages: (.*)/, 1].split
+        
+        {
+          "Last 5 minutes"    => uptime[0],
+          "Last 10 minutes"   => uptime[1],
+          "Last 15 minutes"   => uptime[2]
+        }
+      end
+    end
+
+  end
+end

data/lib/custodian/samplers/darwin/ram.rb

@@ -0,0 +1,29 @@
+module Custodian
+  module Samplers
+
+    class RAM < Custodian::Samplers::Sampler
+      describe "RAM usage"
+
+      def self.sample
+        vmstat = `vm_stat`
+
+        pages_free      = vmstat[/Pages free: +([0-9]+)/, 1].to_i + vmstat[/Pages speculative: +([0-9]+)/, 1].to_i
+        pages_inactive  = vmstat[/Pages inactive: +([0-9]+)/, 1].to_i
+        pages_active    = vmstat[/Pages active: +([0-9]+)/, 1].to_i
+        pages_wired     = vmstat[/Pages wired down: +([0-9]+)/, 1].to_i
+        page_ins        = vmstat[/Pageins: +([0-9]+)/, 1].to_i
+        page_outs       = vmstat[/Pageouts: +([0-9]+)/, 1].to_i
+
+        {
+          "Free"      => "#{pages_free * 4096 / 1024 / 1024} MB",
+          "Inactive"  => "#{pages_inactive * 4096 / 1024 / 1024} MB",
+          "Active"    => "#{pages_active * 4096 / 1024 / 1024} MB",
+          "Wired"     => "#{pages_wired * 4096 / 1024 / 1024} MB",
+          "Page ins"  => "#{page_ins * 4096 / 1024 / 1024} MB",
+          "Page outs" => "#{page_outs * 4096 / 1024 / 1024} MB"
+        }
+      end
+    end
+
+  end
+end

data/lib/custodian/samplers/darwin/who.rb

@@ -0,0 +1,13 @@
+module Custodian
+  module Samplers
+
+    class Who < Custodian::Samplers::Sampler
+      describe "Logged in users"
+
+      def self.sample
+        `who`.lines.collect { |line| line.split.first }.uniq
+      end
+    end
+
+  end
+end

data/lib/custodian/samplers/linux/cpu.rb

@@ -0,0 +1,29 @@
+module Custodian
+  module Samplers
+
+    class CPU < Custodian::Samplers::Sampler
+      describe "CPU usage"
+
+      def self.sample
+        top = `top -b -n1`.match /Cpu\(s\): +([0-9.]+)%us, +([0-9.]+)%sy, +([0-9.%]+)ni, +([0-9.]+)%id, +([0-9.]+)%wa, +([0-9.]+)%hi, +([0-9.]+)%si, +([0-9.]+)%st/
+
+        us = top[1].to_f # User CPU time: The time the CPU has spent running users' processes that are not niced.
+        sy = top[2].to_f # System CPU time: The time the CPU has spent running the kernel and its processes.
+        ni = top[3].to_f # Nice CPU time: The time the CPU has spent running users' proccess that have been niced.
+        id = top[4].to_f # Hardware IRQ: The amount of time the CPU has been servicing hardware interrupts.
+        wa = top[5].to_f # iowait: Amount of time the CPU has been waiting for I/O to complete.
+        hi = top[6].to_f # Hardware IRQ: The amount of time the CPU has been servicing hardware interrupts.
+        si = top[7].to_f # Hardware Interrupts: The amount of time the CPU has been servicing software interrupts.
+        st = top[8].to_f # Steal Time: The amount of CPU 'stolen' from this virtual machine by the hypervisor for other tasks.
+
+        {
+          "User"   => "#{us + ni}%",
+          "System" => "#{sy + wa + hi + si + st}%",
+          "Idle"   => "#{id}%"
+        }
+      end
+    end
+
+  end
+end
+

data/lib/custodian/samplers/linux/load.rb

@@ -0,0 +1,19 @@
+module Custodian
+  module Samplers
+
+    class Load < Custodian::Samplers::Sampler
+      describe "Load averages"
+
+      def self.sample
+        uptime = `uptime`.match /load average: ([0-9.]+), ([0-9.]+), ([0-9.]+)/
+
+        {
+          "Last 5 minutes"    => uptime[1],
+          "Last 10 minutes"   => uptime[2],
+          "Last 15 minutes"   => uptime[3]
+        }
+      end
+    end
+
+  end
+end

data/lib/custodian/samplers/linux/ram.rb

@@ -0,0 +1,21 @@
+module Custodian
+  module Samplers
+
+    class RAM < Custodian::Samplers::Sampler
+      describe "RAM usage"
+
+      def self.sample
+        free = `free -m`.match /Mem: +([0-9]+) +([0-9]+) +([0-9]+) +([0-9]+) +([0-9]+) +([0-9]+)/
+
+        {
+          "Total"   => "#{free[1]} MB",
+          "Used"    => "#{free[2]} MB",
+          "Free"    => "#{free[3]} MB",
+          "Buffers" => "#{free[4]} MB",
+          "Cached"  => "#{free[5]} MB"
+        }        
+      end
+    end
+
+  end
+end

data/lib/custodian/samplers/sampler.rb

@@ -0,0 +1,58 @@
+module Custodian
+  module Samplers
+
+    # Base class for samplers.
+    class Sampler
+      include Custodian::Samplers::Utilities
+
+      class << self
+
+        # Describe the sampler.
+        #
+        # description - A String describing the sampler.
+        #
+        # Returns nothing.
+        def describe(description)
+          @description = description
+        end
+
+        # Returns the sampler's description.
+        def description
+          @description
+        end
+
+        # Make a sample from this sampler.
+        #
+        # Examples
+        #
+        #   CPU.sample # => { "User" => "10%", "System" => "5%", "Idle" => "85%" }
+        #
+        # Returns an Integer, Symbol, String, Hash or Array (or any combination thereof)
+        # describing the outcome of the sample.
+        def sample
+          nil
+        end
+
+        # Determine whether the sampler is compatible with this system.
+        #
+        # Returns true if it is compatible, or false if it isn't.
+        def compatible?
+          true
+        end
+
+      end
+
+      private
+
+      # Register samplers for classes that inherit from this class.
+      #
+      # sampler - The Class that inherited this class.
+      #
+      # Returns nothing.
+      def self.inherited(sampler)
+        Custodian::Samplers.register(sampler)
+      end
+    end
+
+  end
+end

data/lib/custodian/samplers/utilities.rb

@@ -0,0 +1,37 @@
+module Custodian
+  module Samplers
+
+    # Utility methods for samplers.
+    module Utilities
+
+      # Determine whether the given program exists.
+      #
+      # program - A String describing the name of a program.
+      #
+      # Returns true if the program exists, or false if it doesn't.
+      def self.program_exists?(program)
+        system "which #{command} > /dev/null 2>&1"
+      end
+
+      # Determine whether the given directory exists.
+      #
+      # directory - A String describing the path to a directory.
+      #
+      # Returns true if the directory exists, or false if it doesn't.
+      def self.directory_exists?(directory)
+        Pathname.new(directory).directory?
+      end
+
+      # Determine whether the given file exists.
+      #
+      # file - A String describing the path to a file.
+      #
+      # Returns true if the file exists, or false if it doesn't.
+      def self.file_exists?(file)
+        Pathname.new(file).file?
+      end
+
+    end
+
+  end
+end

data/lib/custodian/version.rb

@@ -1,3 +1,3 @@
 module Custodian
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/test/cli_test.rb

@@ -0,0 +1,24 @@
+require "custodian"
+require "minitest/spec"
+require "minitest/autorun"
+require "rack/test"
+
+describe Custodian::API do
+  include Rack::Test::Methods
+
+  def app
+    Custodian::API.new
+  end
+
+  it "responds with HTTP 200 OK" do
+    get "/"
+
+    last_response.ok?.must_equal true
+  end
+
+  it "responds with valid JSON" do
+    get "/"
+
+    JSON.parse(last_response.body).must_be_instance_of Array
+  end
+end

data/test/sampler_test.rb

@@ -0,0 +1,23 @@
+require "custodian"
+require "minitest/spec"
+require "minitest/autorun"
+
+describe Custodian::Samplers::Sampler do
+
+  before do
+    @sampler = Custodian::Samplers::Sampler
+  end
+
+  it "can sample" do
+    @sampler.sample
+  end
+
+  it "can be described" do
+    @sampler.description.must_equal nil
+  end
+
+  it "can determine whether its compatible" do
+    @sampler.compatible?.must_equal true
+  end
+
+end

data/test/samplers_test.rb

@@ -0,0 +1,47 @@
+require "custodian"
+require "minitest/spec"
+require "minitest/autorun"
+
+describe Custodian::Samplers do
+
+  before do
+    Custodian::Samplers.clear
+  end
+  
+  after do
+    Custodian::Samplers.stock
+  end
+  
+  it "can list samplers" do
+    Custodian::Samplers.list.must_be_instance_of Array
+  end
+
+  it "can list compatible samplers" do
+    Custodian::Samplers.compatible.must_be_instance_of Array
+  end
+
+  it "can list incompatible samplers" do
+    Custodian::Samplers.incompatible.must_be_instance_of Array
+  end
+
+  it "can register new samplers" do
+    Custodian::Samplers::register Custodian::Samplers::CPU
+
+    Custodian::Samplers.list.must_include Custodian::Samplers::CPU
+  end
+
+  it "can remove samplers" do
+    Custodian::Samplers::remove Custodian::Samplers::CPU
+
+    Custodian::Samplers.list.wont_include Custodian::Samplers::CPU
+  end
+
+  it "can replace samplers" do
+    Custodian::Samplers.register Custodian::Samplers::CPU
+    Custodian::Samplers.replace Custodian::Samplers::CPU, Custodian::Samplers::RAM
+
+    Custodian::Samplers.list.must_include Custodian::Samplers::RAM
+    Custodian::Samplers.list.wont_include Custodian::Samplers::CPU
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: custodian
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,22 +9,86 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-24 00:00:00.000000000 Z
-dependencies: []
+date: 2012-02-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70234530717300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70234530717300
+- !ruby/object:Gem::Dependency
+  name: thin
+  requirement: &70234530713980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70234530713980
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: &70234530708540 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70234530708540
+- !ruby/object:Gem::Dependency
+  name: active_support
+  requirement: &70234536390620 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70234536390620
 description: Custodian is a lightweight resource monitor that is easy to use and augment
 email:
 - jgorset@gmail.com
-executables: []
+executables:
+- custodian
 extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
 - Gemfile
+- LICENSE
 - README.md
 - Rakefile
+- bin/custodian
 - custodian.gemspec
+- docs/images/example.png
 - lib/custodian.rb
+- lib/custodian/api.rb
+- lib/custodian/cli.rb
+- lib/custodian/os.rb
+- lib/custodian/samplers.rb
+- lib/custodian/samplers/darwin/cpu.rb
+- lib/custodian/samplers/darwin/load.rb
+- lib/custodian/samplers/darwin/ram.rb
+- lib/custodian/samplers/darwin/who.rb
+- lib/custodian/samplers/linux/cpu.rb
+- lib/custodian/samplers/linux/load.rb
+- lib/custodian/samplers/linux/ram.rb
+- lib/custodian/samplers/sampler.rb
+- lib/custodian/samplers/utilities.rb
 - lib/custodian/version.rb
+- test/cli_test.rb
+- test/sampler_test.rb
+- test/samplers_test.rb
 homepage: http://github.com/jgorset/custodian
 licenses: []
 post_install_message: 
@@ -49,4 +113,7 @@ rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: Lightweight resource monitor
-test_files: []
+test_files:
+- test/cli_test.rb
+- test/sampler_test.rb
+- test/samplers_test.rb