pulse-meter 0.0.1

data/lib/pulse-meter/visualize/public/js/underscore-min.js

@@ -0,0 +1,32 @@
+// Underscore.js 1.3.3
+// (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
+// Underscore is freely distributable under the MIT license.
+// Portions of Underscore are inspired or borrowed from Prototype,
+// Oliver Steele's Functional, and John Resig's Micro-Templating.
+// For all details and documentation:
+// http://documentcloud.github.com/underscore
+(function(){function r(a,c,d){if(a===c)return 0!==a||1/a==1/c;if(null==a||null==c)return a===c;a._chain&&(a=a._wrapped);c._chain&&(c=c._wrapped);if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return!1;switch(e){case "[object String]":return a==""+c;case "[object Number]":return a!=+a?c!=+c:0==a?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object RegExp]":return a.source==
+c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if("object"!=typeof a||"object"!=typeof c)return!1;for(var f=d.length;f--;)if(d[f]==a)return!0;d.push(a);var f=0,g=!0;if("[object Array]"==e){if(f=a.length,g=f==c.length)for(;f--&&(g=f in a==f in c&&r(a[f],c[f],d)););}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return!1;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&r(a[h],c[h],d))))break;if(g){for(h in c)if(b.has(c,h)&&!f--)break;
+g=!f}}d.pop();return g}var s=this,I=s._,o={},k=Array.prototype,p=Object.prototype,i=k.slice,J=k.unshift,l=p.toString,K=p.hasOwnProperty,y=k.forEach,z=k.map,A=k.reduce,B=k.reduceRight,C=k.filter,D=k.every,E=k.some,q=k.indexOf,F=k.lastIndexOf,p=Array.isArray,L=Object.keys,t=Function.prototype.bind,b=function(a){return new m(a)};"undefined"!==typeof exports?("undefined"!==typeof module&&module.exports&&(exports=module.exports=b),exports._=b):s._=b;b.VERSION="1.3.3";var j=b.each=b.forEach=function(a,
+c,d){if(a!=null)if(y&&a.forEach===y)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e<f;e++){if(e in a&&c.call(d,a[e],e,a)===o)break}else for(e in a)if(b.has(a,e)&&c.call(d,a[e],e,a)===o)break};b.map=b.collect=function(a,c,b){var e=[];if(a==null)return e;if(z&&a.map===z)return a.map(c,b);j(a,function(a,g,h){e[e.length]=c.call(b,a,g,h)});if(a.length===+a.length)e.length=a.length;return e};b.reduce=b.foldl=b.inject=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(A&&
+a.reduce===A){e&&(c=b.bind(c,e));return f?a.reduce(c,d):a.reduce(c)}j(a,function(a,b,i){if(f)d=c.call(e,d,a,b,i);else{d=a;f=true}});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(B&&a.reduceRight===B){e&&(c=b.bind(c,e));return f?a.reduceRight(c,d):a.reduceRight(c)}var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect=function(a,
+c,b){var e;G(a,function(a,g,h){if(c.call(b,a,g,h)){e=a;return true}});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(C&&a.filter===C)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(D&&a.every===D)return a.every(c,b);j(a,function(a,g,h){if(!(e=e&&c.call(b,
+a,g,h)))return o});return!!e};var G=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(E&&a.some===E)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return o});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;if(q&&a.indexOf===q)return a.indexOf(c)!=-1;return b=G(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck=
+function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a)&&a[0]===+a[0])return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a)&&a[0]===+a[0])return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b<e.computed&&
+(e={value:a,computed:b})});return e.value};b.shuffle=function(a){var b=[],d;j(a,function(a,f){d=Math.floor(Math.random()*(f+1));b[f]=b[d];b[d]=a});return b};b.sortBy=function(a,c,d){var e=b.isFunction(c)?c:function(a){return a[c]};return b.pluck(b.map(a,function(a,b,c){return{value:a,criteria:e.call(d,a,b,c)}}).sort(function(a,b){var c=a.criteria,d=b.criteria;return c===void 0?1:d===void 0?-1:c<d?-1:c>d?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};
+j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a,c,d){d||(d=b.identity);for(var e=0,f=a.length;e<f;){var g=e+f>>1;d(a[g])<d(c)?e=g+1:f=g}return e};b.toArray=function(a){return!a?[]:b.isArray(a)||b.isArguments(a)?i.call(a):a.toArray&&b.isFunction(a.toArray)?a.toArray():b.values(a)};b.size=function(a){return b.isArray(a)?a.length:b.keys(a).length};b.first=b.head=b.take=function(a,b,d){return b!=null&&!d?i.call(a,0,b):a[0]};b.initial=function(a,b,d){return i.call(a,
+0,a.length-(b==null||d?1:b))};b.last=function(a,b,d){return b!=null&&!d?i.call(a,Math.max(a.length-b,0)):a[a.length-1]};b.rest=b.tail=function(a,b,d){return i.call(a,b==null||d?1:b)};b.compact=function(a){return b.filter(a,function(a){return!!a})};b.flatten=function(a,c){return b.reduce(a,function(a,e){if(b.isArray(e))return a.concat(c?e:b.flatten(e));a[a.length]=e;return a},[])};b.without=function(a){return b.difference(a,i.call(arguments,1))};b.uniq=b.unique=function(a,c,d){var d=d?b.map(a,d):a,
+e=[];a.length<3&&(c=true);b.reduce(d,function(d,g,h){if(c?b.last(d)!==g||!d.length:!b.include(d,g)){d.push(g);e.push(a[h])}return d},[]);return e};b.union=function(){return b.uniq(b.flatten(arguments,true))};b.intersection=b.intersect=function(a){var c=i.call(arguments,1);return b.filter(b.uniq(a),function(a){return b.every(c,function(c){return b.indexOf(c,a)>=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1),true);return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=
+i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e<c;e++)d[e]=b.pluck(a,""+e);return d};b.indexOf=function(a,c,d){if(a==null)return-1;var e;if(d){d=b.sortedIndex(a,c);return a[d]===c?d:-1}if(q&&a.indexOf===q)return a.indexOf(c);d=0;for(e=a.length;d<e;d++)if(d in a&&a[d]===c)return d;return-1};b.lastIndexOf=function(a,b){if(a==null)return-1;if(F&&a.lastIndexOf===F)return a.lastIndexOf(b);for(var d=a.length;d--;)if(d in a&&a[d]===b)return d;return-1};b.range=function(a,b,d){if(arguments.length<=
+1){b=a||0;a=0}for(var d=arguments[2]||1,e=Math.max(Math.ceil((b-a)/d),0),f=0,g=Array(e);f<e;){g[f++]=a;a=a+d}return g};var H=function(){};b.bind=function(a,c){var d,e;if(a.bind===t&&t)return t.apply(a,i.call(arguments,1));if(!b.isFunction(a))throw new TypeError;e=i.call(arguments,2);return d=function(){if(!(this instanceof d))return a.apply(c,e.concat(i.call(arguments)));H.prototype=a.prototype;var b=new H,g=a.apply(b,e.concat(i.call(arguments)));return Object(g)===g?g:b}};b.bindAll=function(a){var c=
+i.call(arguments,1);c.length==0&&(c=b.functions(a));j(c,function(c){a[c]=b.bind(a[c],a)});return a};b.memoize=function(a,c){var d={};c||(c=b.identity);return function(){var e=c.apply(this,arguments);return b.has(d,e)?d[e]:d[e]=a.apply(this,arguments)}};b.delay=function(a,b){var d=i.call(arguments,2);return setTimeout(function(){return a.apply(null,d)},b)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(i.call(arguments,1)))};b.throttle=function(a,c){var d,e,f,g,h,i,j=b.debounce(function(){h=
+g=false},c);return function(){d=this;e=arguments;f||(f=setTimeout(function(){f=null;h&&a.apply(d,e);j()},c));g?h=true:i=a.apply(d,e);j();g=true;return i}};b.debounce=function(a,b,d){var e;return function(){var f=this,g=arguments;d&&!e&&a.apply(f,g);clearTimeout(e);e=setTimeout(function(){e=null;d||a.apply(f,g)},b)}};b.once=function(a){var b=false,d;return function(){if(b)return d;b=true;return d=a.apply(this,arguments)}};b.wrap=function(a,b){return function(){var d=[a].concat(i.call(arguments,0));
+return b.apply(this,d)}};b.compose=function(){var a=arguments;return function(){for(var b=arguments,d=a.length-1;d>=0;d--)b=[a[d].apply(this,b)];return b[0]}};b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=L||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&
+c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.pick=function(a){var c={};j(b.flatten(i.call(arguments,1)),function(b){b in a&&(c[b]=a[b])});return c};b.defaults=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return r(a,b,[])};b.isEmpty=
+function(a){if(a==null)return true;if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=p||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){return a===Object(a)};b.isArguments=function(a){return l.call(a)=="[object Arguments]"};b.isArguments(arguments)||(b.isArguments=function(a){return!(!a||!b.has(a,"callee"))});b.isFunction=function(a){return l.call(a)=="[object Function]"};
+b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isFinite=function(a){return b.isNumber(a)&&isFinite(a)};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"};b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,
+b){return K.call(a,b)};b.noConflict=function(){s._=I;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e<a;e++)b.call(d,e)};b.escape=function(a){return(""+a).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#x27;").replace(/\//g,"&#x2F;")};b.result=function(a,c){if(a==null)return null;var d=a[c];return b.isFunction(d)?d.call(a):d};b.mixin=function(a){j(b.functions(a),function(c){M(c,b[c]=a[c])})};var N=0;b.uniqueId=
+function(a){var b=N++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var u=/.^/,n={"\\":"\\","'":"'",r:"\r",n:"\n",t:"\t",u2028:"\u2028",u2029:"\u2029"},v;for(v in n)n[n[v]]=v;var O=/\\|'|\r|\n|\t|\u2028|\u2029/g,P=/\\(\\|'|r|n|t|u2028|u2029)/g,w=function(a){return a.replace(P,function(a,b){return n[b]})};b.template=function(a,c,d){d=b.defaults(d||{},b.templateSettings);a="__p+='"+a.replace(O,function(a){return"\\"+n[a]}).replace(d.escape||
+u,function(a,b){return"'+\n_.escape("+w(b)+")+\n'"}).replace(d.interpolate||u,function(a,b){return"'+\n("+w(b)+")+\n'"}).replace(d.evaluate||u,function(a,b){return"';\n"+w(b)+"\n;__p+='"})+"';\n";d.variable||(a="with(obj||{}){\n"+a+"}\n");var a="var __p='';var print=function(){__p+=Array.prototype.join.call(arguments, '')};\n"+a+"return __p;\n",e=new Function(d.variable||"obj","_",a);if(c)return e(c,b);c=function(a){return e.call(this,a,b)};c.source="function("+(d.variable||"obj")+"){\n"+a+"}";return c};
+b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var x=function(a,c){return c?b(a).chain():a},M=function(a,c){m.prototype[a]=function(){var a=i.call(arguments);J.call(a,this._wrapped);return x(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return x(d,
+this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return x(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain=true;return this};m.prototype.value=function(){return this._wrapped}}).call(this);

data/lib/pulse-meter/visualize/sensor.rb

@@ -0,0 +1,60 @@
+module PulseMeter
+  module Visualize
+    class Sensor
+      attr_reader :name
+      attr_reader :color
+
+      def initialize(args) 
+        raise ArgumentError unless args.respond_to?('[]')
+        @name = args[:sensor] or raise ArgumentError, ":sensor_name not specified"
+        @color = args[:color]
+      end
+
+      def last_value(need_incomplete=false)
+        sensor = real_sensor
+
+        sensor_data = if need_incomplete
+          sensor.timeline(sensor.interval).first
+        else
+          sensor.timeline(sensor.interval * 2).first
+        end
+
+        if sensor_data.is_a?(PulseMeter::SensorData)
+          sensor_data.value
+        else
+          nil
+        end
+      end
+
+      def last_point_data(need_incomplete=false)
+        res = {
+            name: real_sensor.annotation,
+            y: last_value(need_incomplete)
+        }
+        res[:color] = color if color
+        res
+      end
+
+      def timeline_data(time_span, need_incomplete = false)
+        sensor = real_sensor
+        data = sensor.timeline(time_span).map{|sd| {x: sd.start_time.to_i*1000, y: sd.value}}
+        data.pop unless need_incomplete
+        res = {
+            name: sensor.annotation,
+            data: data
+        }
+        res[:color] = color if color
+        res
+      end
+
+      protected
+
+      def real_sensor
+        # TODO add !temporarily! caching if this will be called too frequently
+        PulseMeter::Sensor::Base.restore(@name)
+      end
+
+    end
+  end
+end
+

data/lib/pulse-meter/visualize/views/main.haml

@@ -0,0 +1,40 @@
+!!!
+%head
+  %title= @title
+  :javascript
+    var ROOT = "#{url('/')}";
+  = include_gon
+  - %w{jquery-1.7.2.min.js json2.js underscore-min.js backbone-min.js highcharts.js application.js bootstrap.js}.each do |jsfile|
+    %script{:type => 'text/javascript', :src => url("/js/#{jsfile}")}
+  - %w{bootstrap.min.css application.css}.each do |cssfile|
+    %link{:rel => 'stylesheet', :href => url("/css/#{cssfile}"), :type => 'text/css', :media => 'screen'}
+		
+%body
+  %script#widget-template{type: 'text/template'}
+    #plotarea
+    #chart-controls
+      .form-inline
+        %span#refresh.btn.btn-mini
+          %i.icon-refresh
+          Refresh
+        %span.space
+        Cutoff min:
+        %input.btn-mini#cutoff-min
+        %span.space
+        Cutoff max:
+        %input.btn-mini#cutoff-max
+        %span.space
+        Refresh:
+        %input.btn-mini#need-refresh{type: :checkbox, checked: :true}
+
+    %hr
+
+  .container#main
+    .row
+      .span10.offset1
+        .navbar
+          .navbar-inner
+            .container
+              %span.brand= @title 
+              %ul.nav#page-titles
+        #widgets.row

data/lib/pulse-meter/visualize/widget.rb

@@ -0,0 +1,68 @@
+module PulseMeter
+  module Visualize
+    class Widget
+      attr_reader :sensors
+      attr_reader :title
+      attr_reader :type
+      attr_reader :width
+      attr_reader :values_label
+      attr_reader :show_last_point
+      attr_reader :redraw_interval
+      attr_reader :timespan
+
+      def initialize(args) 
+        raise ArgumentError unless args.respond_to?('[]')
+        @title = args[:title] or raise ArgumentError, ":title not specified"
+        @sensors = args[:sensors] or raise ArgumentError, ":sensors not specified"
+        @type = args[:type] or raise ArgumentError, ":type not specified"
+        @width = args[:width]
+        @values_label = args[:values_label]
+        @show_last_point = args[:show_last_point] || false
+        @redraw_interval = args[:redraw_interval]
+        @timespan = args[:timespan]
+      end
+
+      def data
+        {
+          title: title,
+          type: type,
+          values_title: values_label,
+          width: width,
+          interval: redraw_interval,
+          series: series_data
+        }
+      end
+
+      protected
+
+      def series_data
+        case type
+          when :spline
+            line_series_data
+          when :line
+            line_series_data
+          when :area
+            line_series_data
+          when :pie
+            pie_series_data
+        end
+      end
+
+      def line_series_data
+        sensors.map do |s|
+          s.timeline_data(timespan, show_last_point)
+        end
+      end
+
+      def pie_series_data
+        [{
+          type: type,
+          name: values_label,
+          data: sensors.map{|s| s.last_point_data(show_last_point)}
+        }]
+      end
+
+    end
+  end
+end
+

data/lib/pulse-meter/visualizer.rb

@@ -0,0 +1,30 @@
+require 'pulse-meter'
+
+# DSL
+
+require 'pulse-meter/visualize/dsl/errors'
+require 'pulse-meter/visualize/dsl/sensor'
+require 'pulse-meter/visualize/dsl/widget'
+require 'pulse-meter/visualize/dsl/page'
+require 'pulse-meter/visualize/dsl/layout'
+
+# Visualize
+
+require 'pulse-meter/visualize/sensor'
+require 'pulse-meter/visualize/widget'
+require 'pulse-meter/visualize/layout'
+require 'pulse-meter/visualize/page'
+
+# App
+
+require 'pulse-meter/visualize/app'
+
+module PulseMeter
+  class Visualizer
+    def self.draw(&block)
+      layout_cofigurator = PulseMeter::Visualize::DSL::Layout.new
+      yield(layout_cofigurator)
+      layout_cofigurator.to_layout
+    end
+  end
+end

data/lib/test_helpers/matchers.rb

@@ -0,0 +1,36 @@
+module TestHelpers
+  module Matchers
+
+    class GenerallyEqual
+
+      EPSILON = 0.0001
+
+      def initialize(expected)
+        @expected = expected
+      end
+
+      def matches?(actual)
+        @actual = actual
+
+        if @actual.kind_of?(Float) || @expected.kind_of?(Float)
+          (@expected - EPSILON .. @expected + EPSILON).include? @actual
+        else
+           @expected == @actual
+        end
+      end
+
+      def failure_message_for_should
+        "expected #{@actual.inspect} to be generally equal to #{@expected.inspect}"
+      end
+
+      def failure_message_for_should_not
+        "expected #{@actual.inspect} not to be generally equal to #{@expected.inspect}"
+      end
+    end
+
+    def be_generally_equal(expected)
+      GenerallyEqual.new(expected)
+    end
+
+  end
+end

data/pulse-meter.gemspec

@@ -0,0 +1,39 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/pulse-meter/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Ilya Averyanov", "Sergey Averyanov"]
+  gem.email         = ["av@fun-box.ru", "averyanov@gmail.com"]
+  gem.description   = %q{Lightweight metrics processor}
+  gem.summary       = %q{
+    Lightweight Redis-based metrics aggregator and processor
+    with CLI and simple and customizable WEB interfaces
+  }
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "pulse-meter"
+  gem.require_paths = ["lib"]
+  gem.version       = PulseMeter::VERSION
+
+  gem.add_runtime_dependency('gon-sinatra')
+  gem.add_runtime_dependency('haml')
+  gem.add_runtime_dependency('json')
+  gem.add_runtime_dependency('redis')
+  gem.add_runtime_dependency('sinatra')
+  gem.add_runtime_dependency('terminal-table')
+  gem.add_runtime_dependency('thor')
+
+  gem.add_development_dependency('foreman')
+  gem.add_development_dependency('mock_redis')
+  gem.add_development_dependency('rack-test')
+  gem.add_development_dependency('rake')
+  gem.add_development_dependency('redcarpet')
+  gem.add_development_dependency('rspec')
+  gem.add_development_dependency('simplecov')
+  gem.add_development_dependency('timecop')
+  gem.add_development_dependency('yard')
+
+end

data/spec/pulse_meter/mixins/dumper_spec.rb

@@ -0,0 +1,158 @@
+require 'spec_helper'
+
+describe PulseMeter::Mixins::Dumper do
+  class Base
+    include PulseMeter::Mixins::Dumper
+  end
+
+  class Bad < Base; end
+
+  class Undumpable < Base
+    def name; :name; end
+
+    def redis; PulseMeter.redis; end
+
+    def initialize
+      @socket = Socket.new(:INET, :STREAM)
+    end
+  end
+
+  class Good < Base
+    attr_accessor :foo
+    def name; foo.to_s; end
+
+    def redis; PulseMeter.redis; end
+
+    def initialize(foo)
+      @foo = foo
+    end
+  end
+
+  let(:bad_obj){ Bad.new }
+  let(:undumpable_obj){ Undumpable.new }
+  let(:good_obj){ Good.new(:foo) }
+  let(:another_good_obj){ Good.new(:bar) }
+  let(:redis){ PulseMeter.redis }
+
+  describe '#dump' do
+    context "when class violates dump contract" do
+      context "when it has no name attribute" do
+        it "should raise exception" do
+          def bad_obj.redis; PulseMeter.redis; end
+          expect{ bad_obj.dump! }.to raise_exception(PulseMeter::DumpError)
+        end
+      end
+
+      context "when it has no redis attribute" do
+        it "should raise exception" do
+          def bad_obj.name; :foo; end
+          expect{ bad_obj.dump! }.to raise_exception(PulseMeter::DumpError)
+        end
+      end
+
+      context "when redis is not avalable" do
+        it "should raise exception" do
+          def bad_obj.name; :foo; end
+          def bad_obj.redis; nil; end
+          expect{ bad_obj.dump! }.to raise_exception(PulseMeter::DumpError)
+        end
+      end
+
+      context "when object cannot be dumped" do
+        it "should raise exception" do
+          expect {undumpable_obj.dump!}.to raise_exception(PulseMeter::DumpError)
+        end
+      end
+    end
+
+    context "when class follows dump contract" do
+      it "should not raise dump exception" do
+        expect {good_obj.dump!}.not_to raise_exception(PulseMeter::DumpError)
+      end
+
+      it "should save dump to redis" do
+        expect {good_obj.dump!}.to change {redis.hlen(Good::DUMP_REDIS_KEY)}.by(1)
+      end
+    end
+  end
+
+  describe ".restore" do
+    context "when object has never been dumped" do
+      it "should raise exception" do
+        expect{ Base.restore(:nonexistant) }.to raise_exception(PulseMeter::RestoreError)
+      end
+    end
+
+    context "when object was dumped" do
+      before do
+        good_obj.dump!
+      end
+
+      it "should keep object class" do
+        Base.restore(good_obj.name).should be_instance_of(good_obj.class)
+      end
+
+      it "should restore object data" do
+        restored = Base.restore(good_obj.name)
+        restored.foo.should == good_obj.foo
+      end
+
+      it "should restore last dumped object" do
+        good_obj.foo = :bar
+        good_obj.dump!
+        restored = Base.restore(good_obj.name)
+        restored.foo.should == :bar
+      end
+    end
+  end
+
+  describe ".list_names" do
+    context "when redis is not available" do
+      before do
+        PulseMeter.stub(:redis).and_return(nil)
+      end
+
+      it "should raise exception" do
+        expect {Base.list_names}.to raise_exception(PulseMeter::RestoreError)
+      end
+    end
+
+    context "when redis if fine" do
+      it "should return empty list if nothing is registered" do
+        Base.list_names.should == []
+      end
+
+      it "should return list of registered objects" do
+        good_obj.dump!
+        another_good_obj.dump!
+        Base.list_names.should =~ [good_obj.name, another_good_obj.name]
+      end
+    end
+  end
+
+  describe ".list_objects" do
+    before do
+      good_obj.dump!
+      another_good_obj.dump!
+    end
+
+    it "should return restored objects" do
+      objects = Base.list_objects
+      objects.map(&:name).should =~ [good_obj.name, another_good_obj.name]
+    end
+
+    it "should skip unrestorable objects" do
+      Base.stub(:list_names).and_return([good_obj.name, "scoundrel", another_good_obj.name])
+      objects = Base.list_objects
+      objects.map(&:name).should =~ [good_obj.name, another_good_obj.name]
+    end
+  end
+
+  describe "#cleanup_dump" do
+    it "should remove data from redis" do
+      good_obj.dump!
+      another_good_obj.dump!
+      expect {good_obj.cleanup_dump}.to change{good_obj.class.list_names.count}.by(-1)
+    end
+  end
+end