blertr 0.2.4 → 0.2.6

data/README.textile

@@ -0,0 +1,201 @@
+h1. Blertr
+
+h2. Alerts for long running scripts in bash.
+
+Amazing moving logo found here:
+"Blertr":http://vlandham.github.com/blertr
+
+h2. What is it Good For?
+
+Waiting around for a command to finish sucks. You know you need to start the next run after this script has completed, so you just keep checking that terminal for output. This is no fun. It disrupts what you are working on. It distracts you. It wastes your time.
+
+Why can't the script just tell you when its done, when its done?
+
+That's where Blertr comes in. Want an email when that long @cp@ is finally over? Done. Want a tweet when your custom perl script finally exits? You got it.
+
+Of course, you *could* modify all your custom scripts to add a section to send an email to yourself at the end of execution. That's possible for custom scripts. But tedious and heavy handed. What about just running a straight bash command? No luck. Somebody else's scripts? Edit if you dare.
+
+Blertr side-steps these issues by hooking into bash to do its alerting. Based on a wonderful Mac OSX hint (which I'm having trouble finding the link), Blertr catches terminal commands when they start and when they exit, and sends this information to the Blertr control center which dispatches the appropriate alerts to you based on the amount of time the command has taken to run. Easy.
+
+h2. Blertr Notifications
+
+Blertr comes with a bunch of notifiers that will tell you when a command has finished in a variety of ways.
+
+Each notifier can be told how long a task should be running before you are notified by the notifier.
+
+For example, you might want to get Growl notifications for tasks that run for 10 seconds or more. And then get emails for processes that run over an hour. This way you won't get bogged down in a bunch of emails from all your short processes, but you will be alerted through the correct channel based on how long it took the task to finish.
+
+Here are the current Blertr Notifiers:
+
+h3. Growl
+
+"Growl":http://growl.info/ is a nice clean notification service for Mac OSX. To have Blertr notify you through growl, you'll need the growlnotify application installed, which is included in the "Extras" directory in the Growl dmg.
+
+h3. Notify Send
+
+Notify Send is the Linux version of Growl. It looks to be installed on a number of platforms (Ubuntu, CentOS). Its a nice, simple pop-up notification service.
+
+h3. Email
+
+Blertr can send you an email when a process is done. Great for long running tasks. Step away from your computer, and know with confidence when to come back.
+
+Here is what a typical email from Blertr looks like:
+<pre>
+<code>
+
+  Title: bwa_align.sh is done!
+
+  Message:
+  bwa_align.sh has completed.
+  Command: bwa_align.sh 3 hjaa1 3 ../../files/
+  Time: 1.44 hours
+</code>
+</pre>
+
+So, not only do you get an alert when the command has finished, you get the total time it took to run that command. Need to know how long a particular command runs? With Blertr, you are well on your way to finding that out.
+
+h3. Twitter
+
+Want to know when a process is complete, but don't like extra emails? Blertr can tweet you when your command is done!
+
+(Work in progress).
+
+
+h2. Requirements
+
+All this awesomeness comes at a slight cost. Blertr only works with the Bash shell, and requires Ruby. Blertr currently has only been tested on ruby 1.9.2.
+
+RVM can be used to quickly get up to speed on the ruby environment:
+<pre>
+  bash < <(curl -s https://rvm.beginrescueend.com/install/rvm)
+  rvm install 1.9.2
+  rvm use 1.9.2 --default
+</pre>
+
+Each of the Notifiers need a bit of configuration to work properly as well:
+* *Growl* needs growlnotify installed and available.
+* *Notify Send* needs notify-send installd.
+* *Email* needs openssl support in ruby. On Linux, this might need to be compiled. Follow "these rvm-based steps":http://cjohansen.no/en/ruby/ruby_version_manager_ubuntu_and_openssl to get going quickly.
+* *Twitter* needs some authentication stuff in the twitter notifier's config file. It also users the twitter gem.
+
+But really, for the awesomeness that is Blertr, this setup isn't so bad.
+
+h2. Install
+
+Once you have Ruby 1.9.2 in place (using rvm) and the other stuff setup, installation should be simple:
+
+<pre>
+  gem install blertr
+  blertr install
+</pre>
+
+Then you just need to add this line to the end of your @.bashrc@ file:
+
+<code>
+[[ -s "$HOME/.blertr/app/scripts/blertr" ]] && . "$HOME/.blertr/app/scripts/blertr"
+</code>
+
+This adds the hooks necessary to make Blertr run.
+
+h2. Setup
+
+You probably want to set your defaults up a bit once installed.
+
+h3. Email
+
+Blertr needs to know who to send emails to. Use this command to tell it:
+
+<pre>
+blertr set email to myemail@gmail.com
+</pre>
+
+Of course, use your own email for @myemail@. This command 'sets' the 'to' configuration for the 'email' notifier. 
+
+h3. Twitter
+
+Currently, the twitter config file doesn't come with Blertr by default... We're working on something for that.
+
+h3. Time
+
+Blertr has default times for each notifier. These, you might want to tweak to your liking. You can see the time setting for a particular notifier using the @info@ command:
+
+<pre>
+blertr info growl
+</pre>
+
+Should return something like:
+<pre>
+Configuration for: growl
+time: 10
+</pre>
+
+Meaning Blertr will notify via Growl for tasks that take longer than 10 seconds. 
+
+To change this, you can use the @time@ command:
+
+<pre>
+blertr time growl 20 seconds
+</pre>
+
+The time command takes time in a variety of formats. '5 minutes', '6 hours', '2 days' are all valid time entries. 
+
+
+h3. Exclusions
+
+Alerts are great and all, but there are plenty of commands that you would rather not get emails about. You probably don't need a tweet every time you exit from a ssh connection. That's where Blertr exclusions come in. By default, there are a number of commands excluded from alerting you. You can add to the list using the @exclude@ command:
+
+<pre>
+blertr exclude git push
+</pre>
+
+Blertr won't alert you for any command that starts with 'git push'.
+
+It might take a bit of work to perfect your exclusions, but it should be pretty easy to do.
+
+h2. Commands
+
+We already saw a bunch of commands already. Here is a full listing of what Blertr understands, from the @help@ command:
+
+<pre>
+    help       Output this help message
+
+    install    Add symlinks to your system to allow
+               Blertr to function properly
+
+    uninstall  Remove symlinks and other setup process
+               Effectively uninstalling Blertr
+
+    upgrade    Updates current copy of blertr to latest version
+    
+    info       Pass in a notifier name to get the 
+               information it is using to send notifications
+               Example: blertr info email
+
+    status     For each notifier, Blertr lists if it currently can
+               send notifications and then lists any error messages
+               if it cannot. Useful for debuggin problems with notifiers
+
+    exclude    Pass in a shell command to prevent Blertr from
+               sending notifications when that command is 
+               executed
+               Example: blertr exclude ssh
+   
+    time       Pass in a notifier name and a time string to
+               set the time required to pass before the
+               notifier sends a message for a command
+               Example: blertr time email 5 minutes
+               This would make blertr send an email only if
+               the command executing took longer than 5 mins
+
+    set        Pass in the notifier name, a configuration key, and
+               a value. Blertr will add this key / value to the 
+               notifiers config file.
+               Example: blertr set mail to user@gmail.com
+</pre>
+
+
+h2. Suggestions
+
+Have some feature ideas to make Blertr even more incredible? Send them to me!
+
+Happy Blerting!

data/lib/blertr/message.rb

@@ -13,7 +13,7 @@ module Blertr
     end
 
     def command_short_name
-      self.command.split(/ /)[0]
+      File.basename(self.command.split(/ /)[0])
     end
 
     def time_string

data/lib/blertr/version.rb

@@ -1,3 +1,3 @@
 module Blertr
-  VERSION = "0.2.4".freeze
+  VERSION = "0.2.6".freeze
 end

data/spec/message_spec.rb

@@ -1,6 +1,21 @@
 require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 
 describe Blertr::Message do
+
+  describe "advanced short names" do
+    before(:each) do
+      @seconds = 240
+    end
+    it "should figure out base paths to commands" do
+      path_commands = {"../start.sh 123 -h -o" => "start.sh",
+                       "/usr/bin/ruby -v ./runner.rb" => "ruby",
+                       "../../../commands/bin -kill destroy" => "bin"}
+      path_commands.each do |command, short_name|
+        message = Blertr::Message.new(command, @seconds)
+        message.command_short_name.should == short_name
+      end
+    end
+  end
   describe "basic functionality" do
     before(:each) do
       @command = "cp -r ./ddd/aaa /aaa/ddd"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: blertr
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-07-29 00:00:00.000000000Z
+date: 2011-08-02 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &869520 !ruby/object:Gem::Requirement
+  requirement: &2676140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: '1.0'
   type: :development
   prerelease: false
-  version_requirements: *869520
+  version_requirements: *2676140
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &868760 !ruby/object:Gem::Requirement
+  requirement: &2675820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '2.5'
   type: :development
   prerelease: false
-  version_requirements: *868760
+  version_requirements: *2675820
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &867860 !ruby/object:Gem::Requirement
+  requirement: &2675590 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: '2.3'
   type: :development
   prerelease: false
-  version_requirements: *867860
+  version_requirements: *2675590
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &867350 !ruby/object:Gem::Requirement
+  requirement: &2675320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: '0.4'
   type: :development
   prerelease: false
-  version_requirements: *867350
+  version_requirements: *2675320
 - !ruby/object:Gem::Dependency
   name: twitter
-  requirement: &866540 !ruby/object:Gem::Requirement
+  requirement: &2674970 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,11 +65,10 @@ dependencies:
         version: 1.6.0
   type: :runtime
   prerelease: false
-  version_requirements: *866540
+  version_requirements: *2674970
 description: Automatic alerts for when bash scripts and commands complete
 email: vvv@gmail.com
 executables:
-- blert
 - blertr
 extensions: []
 extra_rdoc_files:
@@ -83,7 +82,6 @@ files:
 - Gemfile.lock
 - LICENSE.textile
 - README.textile
-- bin/blert
 - bin/blertr
 - blertr.gemspec
 - config/blacklist.yaml

data/bin/blert

@@ -1,29 +0,0 @@
-#!/usr/bin/env bash
-
-# Run the command, including arguments with spaces
-"$@"
-status=$?
-
-# decide which status to use
-if [ "$status" == "0" ] ; then
-    result="completed"
-else
-    result="FAILED ($status)"
-fi
-
-# decide which notifier we have
-env growlnotify -h > /dev/null 2> /dev/null
-has_growl=$?
-env notify-send > /dev/null 2> /dev/null
-has_libnotify=$?
-
-# notify the user, growl or libnotify
-if [ "$has_growl" == "0" ] ; then
-    growlnotify -m "Script '$@' $result" -n "Blert Notification"
-elif [ "$has_libnotify" == "0" ] ; then
-    notify-send "Script '$@' $result" "Blert Notification" &
-fi
-
-# exit with the original status
-exit $status
-