dbtop 0.0.0

data/.bnsignore

@@ -0,0 +1,18 @@
+# The list of files that should be ignored by Mr Bones.
+# Lines that start with '#' are comments.
+#
+# A .gitignore file can be used instead by setting it as the ignore
+# file in your Rakefile:
+#
+#   Bones {
+#     ignore_file  '.gitignore'
+#   }
+#
+# For a project with a C extension, the following would be a good set of
+# exclude patterns (uncomment them if you want to use them):
+# *.[oa]
+# *~
+announcement.txt
+coverage
+doc
+pkg

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gem "terminal-table"

data/Gemfile.lock

@@ -0,0 +1,10 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    terminal-table (1.4.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  terminal-table

data/History.txt

@@ -0,0 +1,4 @@
+== 1.0.0 / 2012-05-24
+
+* 1 major enhancement
+  * Birthday!

data/README.md

@@ -0,0 +1,104 @@
+dbtop
+===========
+
+Similar to the Unix 'top' tool, this Ruby gem will provide process
+monitoring for your MySQL database instance.
+
+By using command line arguments or environmental variables, dbtop will
+connect to your db and return your current process list (minus Sleep
+processes) on screen, in a terminal Curses buffer.
+
+By default, the port used will be 3306 unless the environment
+variable for MYSQL_PORT is specified.
+
+Features
+--------
+
+Easy out-of-the-box connectivity to your database if you use
+environmental variables.
+
+Won't make a mess of your terminal (drawn to a Curses buffer).
+
+Examples
+--------
+
+If you don't have environmental variables set for your MySQL database,
+run dbtop with command line arguments:
+
+```bash
+  ruby dbtop.rb -u #{user} -p #{pass} -h #{host} -d #{database} -i 1
+```
+
+If you have environmental variables set for your MySQL database already,
+just run dbtop :)
+
+```bash
+  ruby dbtop.rb
+```
+
+```bash
+  ruby dbtop.rb -i 1
+```
+
+Note: You can quit the application by pressing 'q'
+
+Requirements
+------------
+
+Ruby 1.9.2+
+
+If you're using ENV variables:
+
+MYSQL_USER
+MYSQL_PASSWORD
+MYSQL_HOST
+MYSQL_DATABASE
+MYSQL_PORT
+
+Install
+-------
+
+Install all required gems by running:
+
+```bash
+bundle install
+```
+
+Install the gem manually by running:
+
+```bash
+rake gem:install
+```
+
+in the application folder.
+
+Author
+------
+
+Original author: Alfred Moreno
+
+License
+-------
+
+(The MIT License)
+
+Copyright (c) 2012 Alfred Moreno
+
+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/Rakefile

@@ -0,0 +1,17 @@
+
+begin
+  require 'bones'
+rescue LoadError
+  abort '### Please install the "bones" gem ###'
+end
+
+task :default => 'test:run'
+task 'gem:release' => 'test:run'
+
+Bones {
+  name     'dbtop'
+  authors  'Alfred Moreno'
+  email    'kryptek@kryptek.org'
+  url      'http://github.com/kryptek'
+}
+

data/bin/dbtop

@@ -0,0 +1,157 @@
+#!/usr/bin/env ruby
+#          :::::::::  :::::::::: :::     :::  ::::::::  :::::::::   ::::::::
+#        :+:    :+: :+:        :+:     :+: :+:    :+: :+:    :+: :+:    :+:
+#       +:+    +:+ +:+        +:+     +:+ +:+    +:+ +:+    +:+ +:+
+#      +#+    +:+ +#++:++#   +#+     +:+ +#+    +:+ +#++:++#+  +#++:++#++
+#     +#+    +#+ +#+         +#+   +#+  +#+    +#+ +#+               +#+
+#    #+#    #+# #+#          #+#+#+#   #+#    #+# #+#        #+#    #+#
+#   #########  ##########     ###      ########  ###         ########
+#
+#                                                @ Zumba Fitness, LLC
+# ------------------------------------------------------------------------------
+# filename: dbtop.rb
+# author: alfred.moreno@zumba.com
+# purpose: Process monitor for MySQL Databases; ignores 'Sleep' processes.
+# ------------------------------------------------------------------------------
+require 'curses'
+require 'terminal-table'
+require 'optparse'
+include Curses
+
+class MysqlTop
+
+  #############################################################################
+  # Public: Initialize the MysqlTop class and screen buffer
+  #
+  # Returns: nothing
+  #############################################################################
+  def initialize(options)
+
+    @user = options[:user] || ENV['MYSQL_USER']
+    @pass = options[:pass] || ENV['MYSQL_PASSWORD']
+    @host = options[:host] || ENV['MYSQL_HOST']
+    @db = options[:db] || ENV['MYSQL_DATABASE']
+    @port = 3306 || ENV['MYSQL_PORT']
+    @interval = options[:interval] || 5
+    validate
+
+    tbl = Terminal::Table.new headings: [
+      'Time',
+      'User',
+      'Host',
+      'DB',
+      'State',
+      'Cmd'
+    ]
+
+    begin
+      Curses.timeout=0
+    loop do
+
+      case getch
+      when 'q'
+        exit
+      end
+
+      %x[mysql -A -u #@user -p#@pass -h #@host #@db -e "show processlist"].lines.each do |line|
+        next if line.include?('Sleep')
+
+        line = line.split(' ')
+
+        row = {
+          id: line[0],
+          user: line[1],
+          host: line[2],
+          db: line[3],
+          cmd: line[4],
+          time: line[5],
+          state: line[6],
+          info: line[7]
+        }
+        tbl << [line[5], line[1], line[2], line[3], line[6], line[4]]
+      end
+
+      write(0,0,tbl.to_s)
+      tbl.rows = tbl.rows.clear
+      sleep @interval
+
+    end
+    ensure
+      close_screen
+    end
+
+  end
+
+  #############################################################################
+  # Public: Validates that credentials for connecting to the DB are complete
+  #
+  # Returns: nothing
+  #############################################################################
+  def validate
+    [@user,@pass,@host,@db].each { |param|
+      raise "Insufficient parameters to connect to MySQL Database!" if param.nil?
+    }
+  end
+
+  #############################################################################
+  # Public: Initializes the screen buffer with specified options.
+  # 
+  # Returns: nothing
+  #############################################################################
+  def init_screen
+    nl
+    Curses.noecho                 # Don't echo characters to the screen.
+    crmode
+    Curses.init_screen            # Initialize the screen buffer.
+    Curses.start_color
+    #Curses.color_set(COLOR_GREEN)
+    Curses.stdscr.keypad(true)    # Enable arrow keys.
+    Curses.doupdate
+    curs_set(0,0)
+    begin
+      yield
+    ensure
+      Curses.close_screen
+    end
+  end
+
+  #############################################################################
+  # Public: Writes text at a specific set of coordinates on your screen
+  #
+  # Returns: nothing
+  #############################################################################
+  def write(x,y,text)
+    Curses.setpos(x,y)
+    Curses.addstr(text)
+    for x in 1..Curses.lines
+      Curses.deleteln
+    end
+    Curses.setpos(text.lines.count-1,0)
+    Curses.addstr(text.lines.take(3)[2])
+    Curses.refresh
+  end
+
+end
+
+options = {}
+opts = OptionParser.new do |opts|
+  opts.on('-u U', String, 'Database username') do |user|
+    options[:user] = user
+  end
+  opts.on('-p P', String, 'Database password') do |password|
+    options[:pass] = password
+  end
+  opts.on('-h H', String, 'Database hostname') do |hostname|
+    options[:host] = hostname
+  end
+  opts.on('-d D', String, 'Database to use') do |database|
+    options[:db] = database
+  end
+  opts.on('-i I', Integer, 'Integer for refresh') do |interval|
+    options[:interval] = interval
+  end
+end
+opts.parse!(ARGV)
+
+mysqltop = MysqlTop.new(options)
+

data/lib/dbtop.rb

@@ -0,0 +1,60 @@
+
+module Dbtop
+
+  # :stopdoc:
+  LIBPATH = ::File.expand_path('..', __FILE__) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  VERSION = ::File.read(PATH + 'version.txt').strip
+  # :startdoc:
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args )
+    rv =  args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+    if block_given?
+      begin
+        $LOAD_PATH.unshift LIBPATH
+        rv = yield
+      ensure
+        $LOAD_PATH.shift
+      end
+    end
+    return rv
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    rv = args.empty? ? PATH : ::File.join(PATH, args.flatten)
+    if block_given?
+      begin
+        $LOAD_PATH.unshift PATH
+        rv = yield
+      ensure
+        $LOAD_PATH.shift
+      end
+    end
+    return rv
+  end
+
+  # Utility method used to require all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+        ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+
+    Dir.glob(search_me).sort.each {|rb| require rb}
+  end
+
+end  # module Dbtop
+
+Dbtop.require_all_libs_relative_to(__FILE__)
+

data/spec/dbtop_spec.rb

@@ -0,0 +1,6 @@
+
+require File.expand_path('../spec_helper', __FILE__)
+
+describe Dbtop do
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+
+require 'rubygems'
+require 'rspec'
+
+require File.expand_path('../../lib/dbtop', __FILE__)
+
+RSpec.configure do |config|
+  # == Mock Framework
+  #
+  # RSpec uses it's own mocking framework by default. If you prefer to
+  # use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_framework = :mocha
+  # config.mock_framework = :flexmock
+  # config.mock_framework = :rr
+end
+

data/version.txt

@@ -0,0 +1 @@
+0.0.0

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: dbtop
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Alfred Moreno
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-24 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bones
+  requirement: &70169320893340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.8.0
+  type: :development
+  prerelease: false
+  version_requirements: *70169320893340
+description: ! 'Similar to the Unix ''top'' tool, this Ruby gem will provide process
+
+  monitoring for your MySQL database instance.'
+email: kryptek@kryptek.org
+executables:
+- dbtop
+extensions: []
+extra_rdoc_files:
+- History.txt
+- bin/dbtop
+files:
+- .bnsignore
+- Gemfile
+- Gemfile.lock
+- History.txt
+- README.md
+- Rakefile
+- bin/dbtop
+- lib/dbtop.rb
+- spec/dbtop_spec.rb
+- spec/spec_helper.rb
+- test/test_dbtop.rb
+- version.txt
+homepage: http://github.com/kryptek
+licenses: []
+post_install_message: 
+rdoc_options:
+- --main
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: dbtop
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Similar to the Unix 'top' tool, this Ruby gem will provide process monitoring
+  for your MySQL database instance.
+test_files:
+- test/test_dbtop.rb