dock_driver 0.1.0

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/.hgignore

@@ -0,0 +1,2 @@
+doc/.*
+pkg/.*

data/History.txt

@@ -0,0 +1,26 @@
+=== 0.1.0 / 2012-05-15
+
+* 3 minor enhancements
+
+  * bin/dock_driver completed
+  * RSpec tests completed & passing
+  * Several bugs fixed
+
+=== 0.0.3 / 2012-05-15
+
+* 1 minor enhancement
+
+  * Doc & Manifest Updates
+
+=== 0.0.2 / 2012-05-15
+
+* 1 minor enhancement
+
+  * 100% documentation coverage
+
+=== 0.0.1 / 2012-05-15
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Ideas.txt

@@ -0,0 +1,20 @@
+= Ideas
+
+== Without Dependencies
+
+* Graphing
+* Automatic Coloring (with definable syntax)
+* Logging
+
+== With Dependencies
+
+* Maildir support
+* SNMP Poller
+* gateway / internet latency
+
+== dzen2 Ideas
+
+* buttons
+* events
+* text window
+

data/Manifest.txt

@@ -0,0 +1,17 @@
+.autotest
+.hgignore
+History.txt
+Ideas.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/dock_driver
+data/example.dock_driver.yml
+lib/dock_driver.rb
+lib/dock_driver/laika_hashutils.rb
+lib/dock_driver/poll.rb
+lib/dock_driver/data_rate_poll.rb
+lib/dock_driver/dock.rb
+spec/dock_driver/dock_spec.rb
+spec/dock_driver/poll_spec.rb
+spec/dock_driver_spec.rb

data/README.txt

@@ -0,0 +1,74 @@
+= dock_driver
+
+* http://hg.musl.org/projects/dock_driver/
+
+== DESCRIPTION:
+
+Provides a simple executable to drive a dzen2 (or similar) dock with a
+single YAML config file.
+
+Read +example.dock_driver.yml+ for more information about how to get
+started. It's located in this gem's data directory, which is usually:
+	$GEM_HOME/gems/dock_driver-x.y.z/data/
+
+== FEATURES/PROBLEMS:
+
+=== Features:
+
+* easy, flexible configuration
+* field extraction with +scan_regex+ (no grep or pipes necessary)
+
+=== Problems:
+
+* undiscovered bugs
+* unwritten test cases
+* cleanup
+
+== SYNOPSIS:
+
+There really isn't an API or interface other than the YAML config file.
+
+== REQUIREMENTS:
+
+* This gem proudly has zero dependencies besides ruby and rubygems.
+
+== INSTALL:
+
+* sudo gem install dock_driver
+* copy <gemdir>/etc/example.dock_driver.yml to ~/.dock_driver.yml
+* edit ~/.dock_driver.yml to taste
+* run dock_driver from your xsession or ~/.i3/config file. 
+
+== DEVELOPERS:
+
+After checking out the source, run:
+
+  $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the RDoc.
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2012 Michael Hix
+
+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,12 @@
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.plugin :mercurial
+
+Hoe.spec 'dock_driver' do
+	developer 'Michael Hix', 'mike@musl.org'
+	require_ruby_version '>= 1.8.7'
+	require_rubygems_version '>= 1.8'
+end
+

data/bin/dock_driver

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'dock_driver/dock'
+
+include Signal
+
+opts = {}
+parser = OptionParser.new do |p|
+
+	p.on(
+		'-c',
+		'--conf FILE',
+		'Specify an alternate config file. (Default: ~/.dock_driver.yml)'
+	) do |file|
+		opts[:conf] = file
+	end
+
+	p.on(
+		'-d',
+		'--dock COMMAND',
+		'Override the dock command from the config file.'
+	) do |command|
+		opts[:dock] = command
+	end
+
+	p.on( '-e', '--debug', 'Enable $DEBUG' ) { |debug| $DEBUG = true }
+
+	p.on( '-h', '--help', 'Print this help text.' ) do
+		cmd = File.basename( $0 )
+		puts "\n%s\n%s\n\nVersion: %s\n%s\n\n" % [
+			cmd,
+			'=' * cmd.length,
+			DockDriver::VERSION,
+			DockDriver::REVISION,
+		]
+		puts p
+		puts "\nAuthors:\n\t%s\n\n" % [
+			DockDriver::AUTHORS.join( '\n\t' ),
+		]
+		exit
+	end
+
+end.parse!
+
+puts "Options: %p" % opts if $DEBUG
+
+dock = DockDriver::Dock.new( opts[:conf], opts[:dock] )
+
+trap 'INT' do
+	dock.kill
+	puts "\nKilled!" if $DEBUG
+end
+
+dock.run
+

data/data/example.dock_driver.yml

@@ -0,0 +1,80 @@
+---
+# Specify a program to run here. This bit of code was initially meant to run
+# dzen2 but other docks are certainly appropriate, provided they accept commands
+# and data over standard input. You'll probably need to adjust your formats and
+# templates below if you use a different dock program.
+#
+dock_command: 
+    dzen2 -dock -ta r -x 0 -y 0 -w 1680 -h 24 -bg black -fg white 
+    -fn "-*-terminus-medium-r-*-*-12-*-*-*-*-*-*-*"
+    -e "button3="
+
+# See the manpages for strftime and dzen2.
+#
+time_format: 
+    ^fg(white)%A ^fg(gray80)%Y-%m-%d ^fg(gray60)%H:%M:%S ^fg(gray30)%Z
+
+# Determines the layout and styling of the dock.
+#
+# Processed by +ERB+. +Poll+ objects as defined by the 'commands' section are
+# available. Since +Poll+ objects respond to to_s intelligently, it's usually
+# sufficient to just specify the object name. Since they're also subclasses of
+# +OpenStruct+, you can also reference any method or member here.
+#
+# See the dzen2 documentation.
+#
+template:
+    ^fg(white)rx ^fg(gray60)<%= eth0_rx %> ^fg(gray30)<%= eth0_rx.unit %> ·
+    ^fg(white)tx ^fg(gray60)<%= eth0_tx %> ^fg(gray30)<%= eth0_tx.unit %> ·
+    ^fg(white)cpu0 ^fg(gray60)<%= cpu0_temp %>^fg(gray30) C ·
+    ^fg(white)cpu1 ^fg(gray60)<%= cpu1_temp %>^fg(gray30) C ·
+    ^fg(white)gpu ^fg(gray60)<%= gpu_temp %>^fg(gray30) C ·
+    ^fg(white)mail <%= mail %>^fg(gray30) ·
+    ^fg(gray60)<%= time %>^fg(gray30) ·
+
+# Commands to poll. Each command will be polled every second, but specifying a
+# +delay+ greater than one will cache the value and only run the command every
+# +delay+ seconds. This defaults to evaluating a string with a shell, but if
+# your YAML fu is strong enough, you can specify a Proc here too.
+#
+# To narrow down the output, you may use +scan_regex+. A single-quoted regex
+# without forward slashes works great. Since scan returns an array, using one
+# or more capture groups will allow you to pull multiple values from a single
+# command's output - the values returned will be joined with single spaces.
+#
+# To change the class used to poll the command, you can specify a +type+.
+# Right now, only 'rate' is recognized. It uses a separate class that expects
+# a string containing a single number. Best to use +scan_regex+ here. It
+# calculates a running average based on the changes in the value over time.
+# A unit of measurement (b, kb, mb, gb, tb, pb, eb, zb, yb) or its full name
+# (bits, kibibits, mebibits, ...) is also useful here. You may also specify a
+# +number_format+ here if you don't like the default. See +sprintf+ for details
+# on the format string.
+#
+commands:
+    mail:
+        cmd: '/home/joeuser/bin/dockmail'
+        delay: 5
+    cpu0_temp:
+        cmd: 'sensors'
+        scan_regex: 'Core 0:\s+\+(\d+\.\d+)'
+        delay: 30
+    cpu1_temp:
+        cmd: 'sensors'
+        scan_regex: 'Core 1:\s+\+(\d+\.\d+)'
+        delay: 30
+    gpu_temp:
+        cmd: 'nvidia-smi -q -d TEMPERATURE'
+        scan_regex: '(\d+) C'
+        delay: 30    
+    eth0_rx:
+        cmd: 'ifconfig eth0'
+        scan_regex: 'RX bytes:(\d+)'
+        type: rate
+        unit: mb
+    eth0_tx:
+        cmd: 'ifconfig eth0'
+        scan_regex: 'TX bytes:(\d+)'
+        type: rate
+        unit: mb
+

data/lib/dock_driver/data_rate_poll.rb

@@ -0,0 +1,141 @@
+
+require 'ostruct'
+
+require 'dock_driver' unless defined? DockDriver
+require 'dock_driver/poll'
+
+# A class to provide simple, periodic command execution, caching, and a
+# running average in changes in a value.
+#
+class DockDriver::DataRatePoll < DockDriver::Poll
+
+	# Default values to populate the OpenStruct with.
+	#
+	DEFAULTS = {
+		:unit => :mb,
+		:history_size => 2,
+		:number_format => '%0.3f',
+	}.freeze
+
+	# Create a new DataRatePoll.
+	#
+	# === Arguments:
+	#
+	# +opts+ - A hash containing options. Merged with DEFAULTS.
+	#
+	# +block+ - If a block is given, replace :cmd with that block.
+	#
+	# === Options:
+	#
+	# +:delay+ - Determines the minimum amount of time to let elapse between executions.
+	#
+	# +:cmd+ - A string or block to execute.
+	#
+	# +:scan_regex+ - A bare string to be interpreted as a regex for use with +scan+. Any
+	# capture group matches will be joined with single spaces.
+	#
+	# +:history_size+ - How many samples to keep
+	#
+	# +:unit+ - The unit to use. See the methods and aliases available.
+	# (b, kb, mb, gb, tb, pb, eb, zb, yb, and full names: bits, kibibits, mebibits, ...)
+	#
+	# +:number_format+ - The format used by +to_s+ to turn a number into a string. See: +printf+ 
+	#
+	def initialize( opts = {} )
+		super DEFAULTS.merge( opts )
+
+		@last_sample = nil
+		@history = Array.new( @table[:history_size] ) { 0 }
+		@average = 0
+	end
+
+	# Runs the command if enough time has elapsed since the last
+	# poll. "Enough Time" is defined by the :delay option. Maintains the
+	# history of output, average and formatting.
+	#
+	def poll
+		return false unless super
+
+		@sample = @sample.to_s.to_f unless @sample.is_a? Float
+		@last_sample ||= @sample
+		sample = 8 * ( @sample - @last_sample )
+		@history.shift if @history.length >= @table[:history_size]
+		@history.push sample
+		@last_sample = @sample
+		@average = @table[:number_format] % send( @table[:unit] )
+
+		true
+	end
+
+	# Returns the average value in bits.
+	#
+	def bits
+		@history.inject( :+ ) / @history.count.to_f
+	end
+	alias :b :bits
+
+	# Returns the average value in kibibits.
+	#
+	def kibibits
+		bits / 1024.0
+	end
+	alias :kb :kibibits
+
+	# Returns the average value in mebibits.
+	#
+	def mebibits
+		kibibits / 1024.0
+	end
+	alias :mb :mebibits
+
+	# Returns the average value in gibibits.
+	#
+	def gibibits
+		mebibits / 1024.0
+	end
+	alias :gb :gibibits
+
+	# Returns the average value in tebibits.
+	#
+	def tebibits
+		gibibits / 1024.0
+	end
+	alias :tb :tebibits
+
+	# Returns the average value in pebibits.
+	#
+	def pebibits
+		tebibits / 1024.0
+	end
+	alias :pb :pebibits
+
+	# Returns the average value in exbibits.
+	#
+	def exbibits
+		pebibits / 1024.0
+	end
+	alias :eb :exbibits
+
+	# Returns the average value in zebibits.
+	#
+	def zebibits
+		exbibits / 1024.0
+	end
+	alias :zb :zebibits
+
+	# Returns the average value in yobibits.
+	#
+	def yobibits
+		zebibits / 1024.0
+	end
+	alias :yb :yobibits
+
+	# Returns the output of the command this Poll runs, formated as per the
+	# option :number_format.
+	#
+	def to_s
+		@average
+	end
+
+end
+

data/lib/dock_driver/dock.rb

@@ -0,0 +1,126 @@
+
+require 'erb'
+require 'yaml'
+require 'ostruct'
+
+require 'dock_driver' unless defined? DockDriver
+require 'dock_driver/laika_hashutils'
+require 'dock_driver/poll'
+require 'dock_driver/data_rate_poll'
+
+# An object that represents and drives a dock program, periodically
+# updating what it displays.
+#
+class DockDriver::Dock < OpenStruct
+
+	include LAIKA::HashUtilities
+
+	# Default values to populate this OpenStruct with.
+	#
+	DEFAULTS = {
+		:polls => {},
+		:time_format => '%Y-%m-%d %H:%M:%S %Z',
+		:config_file => File.expand_path( '~/.dock_driver.yml' ),
+		:template => '',
+	}.freeze
+
+	# Create and start a new Dock.
+	#
+	# === Arguments:
+	#
+	# +:config_file+ - Provide a path to a config file different from
+	# the default: ~/.dock_driver.yml
+	#
+	# +:dock_command+ - Override the dock command from the config file.
+	#
+	def initialize( config_file = nil, dock_command = nil )
+		super DEFAULTS
+		@worker = nil
+		@table[:config_file] = config_file if config_file
+		load_config
+		@table[:dock_command] = dock_command if dock_command
+	end
+
+	# Returns the result of the template.
+	#
+	def to_s()
+		# Poll everything.
+		@table[:polls].values.map( &:poll )
+
+		# Prepare a binding and render the ERB template.
+		vbind = OpenStruct.new( @table[:polls] ).send( :binding )
+		@table[:template].result( vbind ).gsub( /\s+/, ' ' )
+	end
+
+	# Start thiis Dock if it isn't already running, does nothing otherwise.
+	#
+	def run
+		@worker ||= Thread.new do
+			while true
+				File.popen( @table[:dock_command], 'w' ) do |pipe|
+					while true
+						pipe.puts self
+						pipe.flush
+						sleep 1
+						break if load_config
+					end
+				end
+			end
+		end
+		@worker.run unless @worker.status
+		@worker.join
+	end
+
+	# Forcibly stops this Dock if it is running, does nothing otherwise.
+	#
+	def kill
+		@worker.kill if @worker.status
+	end
+
+	#########
+	protected
+	#########
+
+	# Loads the configuration file defined by the option +:config_file+ if it has
+	# changed since this method was last called. If not, returns false.
+	#
+	# === Arguments:
+	#
+	# +force+ - If true, force a reload, even if the config file hasn't changed.
+	#
+	def load_config( force = false )
+
+		mtime = File.mtime @table[:config_file]
+		return false if not force and mtime == @table[:config_mtime]
+
+		@table.delete :template
+		hash = symbolify_keys( YAML.load_file( @table[:config_file] ) )
+		hash.delete :config_file
+		@table.merge! hash
+		@table[:config_mtime] = mtime
+
+		@table[:polls] = {}
+
+		if @table[:commands] and @table[:commands].is_a? Hash
+			@table[:commands].each do |name,hash|
+				klass = DockDriver::Poll
+				case hash[:type]
+				when /rate/i
+					klass = DockDriver::DataRatePoll
+				end
+				@table[:polls][name] = klass.new( hash )
+			end
+		end
+
+		if @table[:polls]['time'].nil?
+			@table[:polls]['time'] = DockDriver::Poll.new( { :delay => 1 } ) do
+				Time.now.strftime( @table[:time_format] )
+			end
+		end
+
+		@table[:template] = ERB.new( @table[:template] )
+
+		return true
+	end
+
+end

data/lib/dock_driver/laika_hashutils.rb

@@ -0,0 +1,74 @@
+# A module borrowed from my coworkers at LAIKA. 
+#
+module LAIKA
+
+	### A collection of utilities for working with Hashes.
+	module HashUtilities
+
+		###############
+		module_function
+		###############
+
+		### Return a version of the given +hash+ with its keys transformed
+		### into Strings from whatever they were before.
+		def stringify_keys( hash )
+			newhash = {}
+
+			hash.each do |key,val|
+				if val.is_a?( Hash )
+					newhash[ key.to_s ] = stringify_keys( val )
+				else
+					newhash[ key.to_s ] = val
+				end
+			end
+
+			return newhash
+		end
+
+
+		### Return a duplicate of the given +hash+ with its identifier-like keys
+		### transformed into symbols from whatever they were before.
+		def symbolify_keys( hash )
+			newhash = {}
+
+			hash.each do |key,val|
+				keysym = key.to_s.dup.untaint.to_sym
+
+				if val.is_a?( Hash )
+					newhash[ keysym ] = symbolify_keys( val )
+				else
+					newhash[ keysym ] = val
+				end
+			end
+
+			return newhash
+		end
+		alias_method :internify_keys, :symbolify_keys
+
+
+		# Recursive hash-merge function
+		def merge_recursively( key, oldval, newval )
+			case oldval
+			when Hash
+				case newval
+				when Hash
+					oldval.merge( newval, &method(:merge_recursively) )
+				else
+					newval
+				end
+
+			when Array
+				case newval
+				when Array
+					oldval | newval
+				else
+					newval
+				end
+
+			else
+				newval
+			end
+		end
+
+	end # HashUtilities
+end

data/lib/dock_driver/poll.rb

@@ -0,0 +1,72 @@
+
+require 'ostruct'
+
+require 'dock_driver' unless defined? DockDriver
+
+# A class to provide simple, periodic command execution and caching.
+#
+class DockDriver::Poll < OpenStruct
+
+	# Default values to populate the OpenStruct with.
+	#
+	DEFAULTS = {
+		:delay => 1,
+	}.freeze
+
+	# Create a new Poll.
+	#
+	# === Arguments:
+	#
+	# +opts+ - A hash containing options. Merged with DEFAULTS.
+	#
+	# +block+ - If a block is given, replace :cmd with that block.
+	#
+	# === Options:
+	#
+	# +:delay+ - Determines the minimum amount of time to let elapse between executions.
+	#
+	# +:cmd+ - A string or block to execute.
+	#
+	# +:scan_regex+ - A bare string to be interpreted as a regex for use with +scan+. Any
+	# capture group matches will be joined with single spaces.
+	#
+	def initialize( opts = {}, &block )
+		super DEFAULTS.merge( opts )
+		@sample = nil
+
+		if block_given?
+			@table[:cmd] = block
+		end
+	end
+
+	# Runs the command if enough time has elapsed since the last poll. "Enough Time" is
+	# defined by the :delay option.
+	#
+	def poll
+		return false if @sample and (Time.now - (@table[:last_poll] || 0 )) < @table[:delay]
+
+		@table[:last_poll] = Time.now
+
+		case @table[:cmd]
+		when Proc
+			@sample = @table[:cmd].call
+		else
+			@sample = `#{@table[:cmd].to_s}`
+		end
+
+		if @table[:scan_regex]
+			extract = @sample.scan( Regexp.new( @table[:scan_regex] ) ).flatten
+			@sample = extract.join( ' ' ) unless extract.empty?
+		end
+
+		true
+	end
+
+	# Returns the output of the command this Poll runs.
+	#
+	def to_s
+		@sample
+	end
+
+end
+

data/lib/dock_driver.rb

@@ -0,0 +1,16 @@
+
+# A namespace for the project.
+#
+module DockDriver
+
+	# Version Constant
+	VERSION = '0.1.0'
+
+	# Revision Constant
+    REVISION = %q$Revision: d17549778789 $
+
+	# Behold the author(s) responsible for this mess.
+	AUTHORS = [ 'Mike Hix <mike@musl.org>' ]
+
+end
+

data/spec/dock_driver/dock_spec.rb

@@ -0,0 +1,40 @@
+
+require 'pathname'
+require 'fileutils'
+require 'dock_driver/dock'
+
+describe DockDriver::Dock do
+
+	subject do
+		conf = Pathname( __FILE__ ).parent.parent.parent + 'data'
+		conf += 'example.dock_driver.yml'
+		dock = Dock.new conf, 'cat'
+		dock
+	end
+
+	it 'should be able to load a config file properly' do
+		subject.dock_command.should_not be nil
+		subject.template.should_not be nil
+		subject.polls.should have_at_least( 2 ).things
+		subject.polls.values.each { |p| p.should be_a_kind_of Poll }
+	end
+
+	it 'should only attempt to reload a config file with a more recent mtime' do
+		subject.send( :load_config ).should be false
+		FileUtils.touch subject.config_file
+		subject.send( :load_config ).should be true
+		subject.send( :load_config ).should be false
+	end
+
+	it 'should produce a string properly' do
+
+		# make sure we don't fail if a particular binary for an example doesn't exist.
+		subject.polls.values.each { |p| p.cmd = 'echo' }
+
+		string = subject.to_s
+		string.should be_a_kind_of String
+		string.should_not be ''
+	end
+
+end
+

data/spec/dock_driver/poll_spec.rb

@@ -0,0 +1,51 @@
+
+require 'dock_driver/poll'
+require 'dock_driver/data_rate_poll'
+
+include DockDriver
+
+shared_examples 'Poll' do |klass|
+
+	it 'should be able to execute shell commands' do
+		p = Poll.new( :cmd => "echo" )
+		lambda { p.poll }.should_not raise_error
+	end
+
+	it 'should be able to execute blocks' do
+		p = Poll.new do; end
+		lambda { p.poll }.should_not raise_error
+	end
+
+	it 'should return the same object if polled quickly' do
+		p = Poll.new( :cmd => "echo" )
+		p.poll
+		a = p.to_s
+		p.poll
+		b = p.to_s
+		a.object_id.should == b.object_id
+	end
+
+	it 'should return a different object if polled slowly' do
+		p = Poll.new( :cmd => "echo", :delay => 0.1 )
+		p.poll
+		a = p.to_s
+		sleep 0.5
+		p.poll
+		b = p.to_s
+		a.object_id.should_not == b.object_id
+	end
+
+end
+
+describe Poll do
+
+	include_examples 'Poll', Poll
+
+end
+
+describe DataRatePoll do
+
+	include_examples 'Poll', DataRatePoll
+
+end
+

data/spec/dock_driver_spec.rb

@@ -0,0 +1,17 @@
+
+require 'dock_driver'
+
+describe DockDriver do
+
+	it 'should have a standard version number' do
+		defined?( VERSION ).should == 'constant'
+		VERSION.should =~ /^\d+\.\d+\.\d+$/
+	end
+
+	it 'should have a mercurial revision' do
+		defined?( REVISION ).should == 'constant'
+		REVISION.should =~ /^Revision: [[:xdigit:]]+ $/
+	end
+
+end
+

data.tar.gz.sig

@@ -0,0 +1 @@
+3k�S���^���p���

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification 
+name: dock_driver
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Michael Hix
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDKDCCAhCgAwIBAgIBADANBgkqhkiG9w0BAQUFADA6MQ0wCwYDVQQDDARtaWtl
+  MRQwEgYKCZImiZPyLGQBGRYEbXVzbDETMBEGCgmSJomT8ixkARkWA29yZzAeFw0x
+  MjA0MjUxODM4MjdaFw0xMzA0MjUxODM4MjdaMDoxDTALBgNVBAMMBG1pa2UxFDAS
+  BgoJkiaJk/IsZAEZFgRtdXNsMRMwEQYKCZImiZPyLGQBGRYDb3JnMIIBIjANBgkq
+  hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAyYKo5tTirdfMTksMM5DnnwLtGUnAPE++
+  pTPOenB29rVurrI2Vw8ndjbiWtaBOwb6jVdMzEwxBwVBa4r4FdSQO8rzEm1jV/+B
+  LEbl5xvOy/PRAXKvaUrQYCvuYtJA1py1mGIC8evNiH4jxZl0Fn9GrjNzzuRoSi/O
+  nLA4dcI5InCWAtUTUtMkMPn9mz9eZRnqd2yxziciwHzHkXBqVDACeAvo4PZUtTEL
+  aAs/yP3Hc/AH7StrwXb2KUJexSJximkAGg1J0iMCuKTBE9e534OXnE0NgCuyOrle
+  lpPTxF5umMpkiTwHLrmBWez3/JyAt1wt+5YWXamQBO1bGqzG/aGU1QIDAQABozkw
+  NzAdBgNVHQ4EFgQUPdX0JADsZMOtODSP0KlgqTgMG1cwCQYDVR0TBAIwADALBgNV
+  HQ8EBAMCBLAwDQYJKoZIhvcNAQEFBQADggEBADnlpP5hNPaM2x1q/lumvpHi1NU5
+  n1TJ13ZdVbRT1e9HbCs2nQ6TahIdf/1vdVlVldeNRDWxe2yXSG8RrpFZV1ATu+L/
+  mCGPM2NBUh3zT52kMiVJFh4jqI6SWLU/6vojxZms8jpghT7giA5KNQYN6ZK3jrTK
+  yocRBh/rTKHm7C207qTf/iLZj4kG60ozVdkYkZPlrP6/DkfyamnTHrmtN0W30xWC
+  V9AGPfVm7XVfb/wPkWPD3jgA77/j4KJrIH0ML0W9qypcYgH11X3RS0hBM+cx1WcX
+  Edc7ShBTME9+u6K/HFwVxTOH8WJVxkwGTmxKgCevr5mZzbINH/C6LbkmfEA=
+  -----END CERTIFICATE-----
+
+date: 2012-05-16 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe-mercurial
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 4
+        - 0
+        version: 1.4.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rdoc
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 3
+        - 10
+        version: "3.10"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :development
+  version_requirements: *id003
+description: |-
+  Provides a simple executable to drive a dzen2 (or similar) dock with a
+  single YAML config file.
+  
+  Read +example.dock_driver.yml+ for more information about how to get
+  started. It's located in this gem's data directory, which is usually:
+  	$GEM_HOME/gems/dock_driver-x.y.z/data/
+email: 
+- mike@musl.org
+executables: 
+- dock_driver
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Ideas.txt
+- Manifest.txt
+- README.txt
+files: 
+- .autotest
+- .hgignore
+- History.txt
+- Ideas.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/dock_driver
+- data/example.dock_driver.yml
+- lib/dock_driver.rb
+- lib/dock_driver/laika_hashutils.rb
+- lib/dock_driver/poll.rb
+- lib/dock_driver/data_rate_poll.rb
+- lib/dock_driver/dock.rb
+- spec/dock_driver/dock_spec.rb
+- spec/dock_driver/poll_spec.rb
+- spec/dock_driver_spec.rb
+- .gemtest
+homepage: http://hg.musl.org/projects/dock_driver/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 57
+      segments: 
+      - 1
+      - 8
+      - 7
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 31
+      segments: 
+      - 1
+      - 8
+      version: "1.8"
+requirements: []
+
+rubyforge_project: dock_driver
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Provides a simple executable to drive a dzen2 (or similar) dock with a single YAML config file
+test_files: []
+