cosmos 3.0.0

data/spec/packets/telemetry_spec.rb

@@ -0,0 +1,535 @@
+# encoding: ascii-8bit
+
+# Copyright 2014 Ball Aerospace & Technologies Corp.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'spec_helper'
+require 'cosmos'
+require 'cosmos/packets/telemetry'
+require 'tempfile'
+
+module Cosmos
+
+  describe Telemetry do
+
+    describe "initialize" do
+      it "should have no warnings" do
+        Telemetry.new(PacketConfig.new).warnings.should be_empty
+      end
+    end
+
+    before(:each) do
+      tf = Tempfile.new('unittest')
+      tf.puts '# This is a comment'
+      tf.puts '#'
+      tf.puts 'TELEMETRY tgt1 pkt1 LITTLE_ENDIAN "TGT1 PKT1 Description"'
+      tf.puts '  APPEND_ID_ITEM item1 8 UINT 1 "Item1"'
+      tf.puts '    LIMITS DEFAULT 1 ENABLED 1 2 4 5'
+      tf.puts '  APPEND_ITEM item2 8 UINT "Item2"'
+      tf.puts '    LIMITS DEFAULT 1 ENABLED 1 2 4 5'
+      tf.puts '  APPEND_ITEM item3 8 UINT "Item3"'
+      tf.puts '    POLY_READ_CONVERSION 0 2'
+      tf.puts '  APPEND_ITEM item4 8 UINT "Item4"'
+      tf.puts '    POLY_READ_CONVERSION 0 2'
+      tf.puts 'TELEMETRY tgt1 pkt2 LITTLE_ENDIAN "TGT1 PKT2 Description"'
+      tf.puts '  APPEND_ID_ITEM item1 8 UINT 2 "Item1"'
+      tf.puts '  APPEND_ITEM item2 8 UINT "Item2"'
+      tf.puts 'TELEMETRY tgt2 pkt1 LITTLE_ENDIAN "TGT2 PKT1 Description"'
+      tf.puts '  APPEND_ID_ITEM item1 8 UINT 3 "Item1"'
+      tf.puts '  APPEND_ITEM item2 8 UINT "Item2"'
+      tf.close
+
+      pc = PacketConfig.new
+      pc.process_file(tf.path, "SYSTEM")
+      @tlm = Telemetry.new(pc)
+      tf.unlink
+    end
+
+    describe "target_names" do
+      it "should return an array with just UNKNOWN if no targets" do
+        Telemetry.new(PacketConfig.new).target_names.should eql ["UNKNOWN"]
+      end
+
+      it "should return all target names" do
+        @tlm.target_names.should eql ["TGT1","TGT2","UNKNOWN"]
+      end
+    end
+
+    describe "packets" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.packets("tgtX") }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should return all packets target TGT1" do
+        pkts = @tlm.packets("TGT1")
+        pkts.length.should eql 2
+        pkts.keys.should include("PKT1")
+        pkts.keys.should include("PKT2")
+      end
+
+      it "should return all packets target TGT2" do
+        pkts = @tlm.packets("TGT2")
+        pkts.length.should eql 1
+        pkts.keys.should include("PKT1")
+      end
+    end
+
+    describe "packet" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.packet("tgtX","pkt1") }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant packets" do
+        expect { @tlm.packet("TGT1","PKTX") }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 PKTX' does not exist")
+      end
+
+      it "should complain about the 'LATEST' packet" do
+        expect { @tlm.packet("TGT1","LATEST") }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 LATEST' does not exist")
+      end
+
+      it "should return the specified packet" do
+        pkt = @tlm.packet("TGT1","PKT1")
+        pkt.target_name.should eql "TGT1"
+        pkt.packet_name.should eql "PKT1"
+      end
+    end
+
+    describe "items" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.items("tgtX","pkt1") }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant packets" do
+        expect { @tlm.items("TGT1","PKTX") }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 PKTX' does not exist")
+      end
+
+      it "should complain about the 'LATEST' packet" do
+        expect { @tlm.items("TGT1","LATEST") }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 LATEST' does not exist")
+      end
+
+      it "should return all items from packet TGT1/PKT1" do
+        items = @tlm.items("TGT1","PKT1")
+        items.length.should eql 7
+        items[0].name.should eql "RECEIVED_TIMESECONDS"
+        items[1].name.should eql "RECEIVED_TIMEFORMATTED"
+        items[2].name.should eql "RECEIVED_COUNT"
+        items[3].name.should eql "ITEM1"
+        items[4].name.should eql "ITEM2"
+        items[5].name.should eql "ITEM3"
+        items[6].name.should eql "ITEM4"
+      end
+    end
+
+    describe "item_names" do
+      it "should return all the items for a given target and packet" do
+        items = @tlm.item_names("TGT1","PKT1")
+        expect(items).to contain_exactly('RECEIVED_TIMEFORMATTED','RECEIVED_TIMESECONDS','RECEIVED_COUNT','ITEM1','ITEM2','ITEM3','ITEM4')
+
+        items = @tlm.item_names("TGT1","LATEST")
+        expect(items).to contain_exactly('ITEM1','ITEM2','ITEM3','ITEM4')
+      end
+    end
+
+    describe "packet_and_item" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.packet_and_item("tgtX","pkt1","item1") }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant packets" do
+        expect { @tlm.packet_and_item("TGT1","PKTX","ITEM1") }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 PKTX' does not exist")
+      end
+
+      it "should complain about non-existant items" do
+        expect { @tlm.packet_and_item("TGT1","PKT1","ITEMX") }.to raise_error(RuntimeError, "Packet item 'TGT1 PKT1 ITEMX' does not exist")
+      end
+
+      it "should return the packet and item" do
+        pkt,item = @tlm.packet_and_item("TGT1","PKT1","ITEM1")
+        item.name.should eql "ITEM1"
+      end
+
+      it "should return the LATEST packet and item if it exists" do
+        pkt,item = @tlm.packet_and_item("TGT1","LATEST","ITEM1")
+        pkt.packet_name.should eql "PKT2"
+        item.name.should eql "ITEM1"
+      end
+    end
+
+    describe "latest_packets" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.latest_packets("tgtX","item1") }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant items" do
+        expect { @tlm.latest_packets("TGT1","ITEMX") }.to raise_error(RuntimeError, "Telemetry item 'TGT1 LATEST ITEMX' does not exist")
+      end
+
+      it "should return the packets that contain the item" do
+        pkts = @tlm.latest_packets("TGT1","ITEM1")
+        pkts.length.should eql 2
+        pkts[0].packet_name.should eql "PKT1"
+        pkts[1].packet_name.should eql "PKT2"
+      end
+    end
+
+    describe "newest_packet" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.newest_packet("tgtX","item1") }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant items" do
+        expect { @tlm.newest_packet("TGT1","ITEMX") }.to raise_error(RuntimeError, "Telemetry item 'TGT1 LATEST ITEMX' does not exist")
+      end
+
+      context "with two valid timestamps" do
+        it "should return the latest packet (PKT1)" do
+          time = Time.now
+          @tlm.packet("TGT1","PKT1").received_time = time + 1
+          @tlm.packet("TGT1","PKT2").received_time = time
+          pkt = @tlm.newest_packet("TGT1","ITEM1")
+          pkt.packet_name.should eql "PKT1"
+          pkt.received_time.should eql(time + 1)
+        end
+
+        it "should return the latest packet (PKT2)" do
+          time = Time.now
+          @tlm.packet("TGT1","PKT1").received_time = time
+          @tlm.packet("TGT1","PKT2").received_time = time + 1
+          pkt = @tlm.newest_packet("TGT1","ITEM1")
+          pkt.packet_name.should eql "PKT2"
+          pkt.received_time.should eql(time + 1)
+        end
+
+        it "should return the last packet if timestamps are equal" do
+          time = Time.now
+          @tlm.packet("TGT1","PKT1").received_time = time
+          @tlm.packet("TGT1","PKT2").received_time = time
+          pkt = @tlm.newest_packet("TGT1","ITEM1")
+          pkt.packet_name.should eql "PKT2"
+          pkt.received_time.should eql(time)
+        end
+      end
+
+      context "with one or more nil timestamps" do
+        it "should return the last packet if neither has a timestamp" do
+          pkt = @tlm.newest_packet("TGT1","ITEM1")
+          pkt.packet_name.should eql "PKT2"
+          pkt.received_time.should be_nil
+        end
+
+        it "should return the packet with a timestamp (PKT1)" do
+          time = Time.now
+          @tlm.packet("TGT1","PKT1").received_time = time
+          pkt = @tlm.newest_packet("TGT1","ITEM1")
+          pkt.packet_name.should eql "PKT1"
+          pkt.received_time.should eql time
+        end
+
+        it "should return the packet with a timestamp (PKT2)" do
+          time = Time.now
+          @tlm.packet("TGT1","PKT2").received_time = time
+          pkt = @tlm.newest_packet("TGT1","ITEM1")
+          pkt.packet_name.should eql "PKT2"
+          pkt.received_time.should eql time
+        end
+      end
+    end
+
+    describe "identify!" do
+      it "should return nil with a nil buffer" do
+        @tlm.identify!(nil).should be_nil
+      end
+
+      it "should only check the targets given" do
+        buffer = "\x01\x02\x03\x04"
+        @tlm.identify!(buffer,["TGT1"])
+        pkt = @tlm.packet("TGT1","PKT1")
+        pkt.enable_method_missing
+        pkt.item1.should eql 1
+        pkt.item2.should eql 2
+        pkt.item3.should eql 6.0
+        pkt.item4.should eql 8.0
+      end
+
+      it "should return nil with unknown targets given" do
+        buffer = "\x01\x02\x03\x04"
+        @tlm.identify!(buffer,["TGTX"]).should be_nil
+      end
+
+      context "with an unknown buffer" do
+        it "should log an invalid sized buffer" do
+          capture_io do |stdout|
+            buffer = "\x01\x02\x03\x04\x05"
+            @tlm.identify!(buffer)
+            pkt = @tlm.packet("TGT1","PKT1")
+            pkt.enable_method_missing
+            pkt.item1.should eql 1
+            pkt.item2.should eql 2
+            pkt.item3.should eql 6.0
+            pkt.item4.should eql 8.0
+            stdout.string.should match(/ERROR: TGT1 PKT1 received with actual packet length of 5 but defined length of 4/)
+          end
+        end
+
+        it "should identify TGT1 PKT1" do
+          buffer = "\x01\x02\x03\x04"
+          @tlm.identify!(buffer)
+          pkt = @tlm.packet("TGT1","PKT1")
+          pkt.enable_method_missing
+          pkt.item1.should eql 1
+          pkt.item2.should eql 2
+          pkt.item3.should eql 6.0
+          pkt.item4.should eql 8.0
+        end
+
+        it "should identify TGT1 PKT2" do
+          buffer = "\x02\x02"
+          @tlm.identify!(buffer)
+          pkt = @tlm.packet("TGT1","PKT2")
+          pkt.enable_method_missing
+          pkt.item1.should eql 2
+          pkt.item2.should eql 2
+        end
+
+        it "should identify TGT2 PKT1" do
+          buffer = "\x03\x02"
+          @tlm.identify!(buffer)
+          pkt = @tlm.packet("TGT2","PKT1")
+          pkt.enable_method_missing
+          pkt.item1.should eql 3
+          pkt.item2.should eql 2
+        end
+      end
+    end
+
+    describe "update!" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.update!("TGTX","PKT1","\x00") }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant packets" do
+        expect { @tlm.update!("TGT1","PKTX","\x00") }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 PKTX' does not exist")
+      end
+
+      it "should complain about the 'LATEST' packet" do
+        expect { @tlm.update!("TGT1","LATEST","\x00") }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 LATEST' does not exist")
+      end
+
+      it "should complain with a nil buffer" do
+        expect { @tlm.update!("TGT1","PKT1",nil) }.to raise_error(ArgumentError, "Buffer class is NilClass but must be String")
+      end
+
+      it "should log an invalid sized buffer" do
+        capture_io do |stdout|
+          buffer = "\x01\x02\x03\x04\x05"
+          @tlm.update!("TGT1","PKT1",buffer)
+          pkt = @tlm.packet("TGT1","PKT1")
+          pkt.enable_method_missing
+          pkt.item1.should eql 1
+          pkt.item2.should eql 2
+          pkt.item3.should eql 6.0
+          pkt.item4.should eql 8.0
+          stdout.string.should match(/ERROR: TGT1 PKT1 received with actual packet length of 5 but defined length of 4/)
+        end
+      end
+
+      it "should update a packet with the given data" do
+        @tlm.update!("TGT1","PKT1","\x01\x02\x03\x04")
+        pkt = @tlm.packet("TGT1","PKT1")
+        pkt.enable_method_missing
+        pkt.item1.should eql 1
+        pkt.item2.should eql 2
+        pkt.item3.should eql 6.0
+        pkt.item4.should eql 8.0
+      end
+    end
+
+    describe "limits_change_callback" do
+      it "should assign a callback to each packet" do
+        callback = Object.new
+        expect(callback).to receive(:call).twice
+        @tlm.limits_change_callback = callback
+        @tlm.update!("TGT1","PKT1","\x01\x02\x03\x04")
+        @tlm.update!("TGT1","PKT2","\x05\x06")
+        @tlm.update!("TGT2","PKT1","\x07\x08")
+        @tlm.packet("TGT1","PKT1").check_limits
+        @tlm.packet("TGT1","PKT2").check_limits
+        @tlm.packet("TGT2","PKT1").check_limits
+      end
+    end
+
+    describe "check_stale" do
+      it "should check each packet for staleness" do
+        @tlm.check_stale
+        @tlm.packet("TGT1","PKT1").stale.should be_truthy
+        @tlm.packet("TGT1","PKT2").stale.should be_truthy
+        @tlm.packet("TGT2","PKT1").stale.should be_truthy
+
+        @tlm.packet("TGT1","PKT1").check_limits
+        @tlm.packet("TGT1","PKT2").check_limits
+        @tlm.packet("TGT2","PKT1").check_limits
+        @tlm.check_stale
+        @tlm.packet("TGT1","PKT1").stale.should be_falsey
+        @tlm.packet("TGT1","PKT2").stale.should be_falsey
+        @tlm.packet("TGT2","PKT1").stale.should be_falsey
+      end
+    end
+
+    describe "clear_counters" do
+      it "should clear each packet's receive count " do
+        @tlm.packet("TGT1","PKT1").received_count = 1
+        @tlm.packet("TGT1","PKT2").received_count = 2
+        @tlm.packet("TGT2","PKT1").received_count = 3
+        @tlm.clear_counters
+        @tlm.packet("TGT1","PKT1").received_count.should eql 0
+        @tlm.packet("TGT1","PKT2").received_count.should eql 0
+        @tlm.packet("TGT2","PKT1").received_count.should eql 0
+      end
+    end
+
+    describe "value" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.value("TGTX","PKT1","ITEM1") }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant packets" do
+        expect { @tlm.value("TGT1","PKTX","ITEM1") }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 PKTX' does not exist")
+      end
+
+      it "should complain about non-existant items" do
+        expect { @tlm.value("TGT1","PKT1","ITEMX") }.to raise_error(RuntimeError, "Packet item 'TGT1 PKT1 ITEMX' does not exist")
+      end
+
+      it "should return the value" do
+        @tlm.value("TGT1","PKT1","ITEM1").should eql 0
+      end
+
+      it "should return the value using LATEST" do
+        @tlm.value("TGT1","LATEST","ITEM1").should eql 0
+      end
+    end
+
+    describe "set_tlm" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.set_value("TGTX","PKT1","ITEM1", 1) }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant packets" do
+        expect { @tlm.set_value("TGT1","PKTX","ITEM1", 1) }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 PKTX' does not exist")
+      end
+
+      it "should complain about non-existant items" do
+        expect { @tlm.set_value("TGT1","PKT1","ITEMX", 1) }.to raise_error(RuntimeError, "Packet item 'TGT1 PKT1 ITEMX' does not exist")
+      end
+
+      it "should set the value" do
+        @tlm.set_value("TGT1","PKT1","ITEM1",1)
+        @tlm.value("TGT1","PKT1","ITEM1").should eql 1
+      end
+
+      it "should set the value using LATEST" do
+        @tlm.set_value("TGT1","LATEST","ITEM1",1)
+        @tlm.value("TGT1","PKT1","ITEM1").should eql 0
+        @tlm.value("TGT1","PKT2","ITEM1").should eql 1
+      end
+    end
+
+    describe "values_and_limits_states" do
+      it "should complain about non-existant targets" do
+        expect { @tlm.values_and_limits_states([["TGTX","PKT1","ITEM1"]]) }.to raise_error(RuntimeError, "Telemetry target 'TGTX' does not exist")
+      end
+
+      it "should complain about non-existant packets" do
+        expect { @tlm.values_and_limits_states([["TGT1","PKTX","ITEM1"]]) }.to raise_error(RuntimeError, "Telemetry packet 'TGT1 PKTX' does not exist")
+      end
+
+      it "should complain about non-existant items" do
+        expect { @tlm.values_and_limits_states([["TGT1","PKT1","ITEMX"]]) }.to raise_error(RuntimeError, "Packet item 'TGT1 PKT1 ITEMX' does not exist")
+      end
+
+      it "should complain about non-existant value_types" do
+        expect { @tlm.values_and_limits_states([["TGT1","PKT1","ITEM1"]],:MINE) }.to raise_error(ArgumentError, "Unknown value type on read: MINE")
+      end
+
+      it "should complain if passed a single array" do
+        expect { @tlm.values_and_limits_states(["TGT1","PKT1","ITEM1"]) }.to raise_error(ArgumentError, /item_array must be a nested array/)
+      end
+
+      it "should complain about the wrong number of parameters" do
+        expect { @tlm.values_and_limits_states([["TGT1","PKT1","ITEM1"]],:RAW,:RAW) }.to raise_error(ArgumentError, /wrong number of arguments/)
+      end
+
+      it "should read all the specified values" do
+        @tlm.update!("TGT1","PKT1","\x01\x02\x03\x04")
+        @tlm.update!("TGT1","PKT2","\x05\x06")
+        @tlm.update!("TGT2","PKT1","\x07\x08")
+        @tlm.packet("TGT1","PKT1").check_limits
+        @tlm.packet("TGT1","PKT2").check_limits
+        @tlm.packet("TGT2","PKT1").check_limits
+        items = []
+        items << %w(TGT1 PKT1 ITEM1)
+        items << %w(TGT1 PKT2 ITEM2)
+        items << %w(TGT2 PKT1 ITEM1)
+        vals = @tlm.values_and_limits_states(items)
+        vals[0][0].should eql 1
+        vals[0][1].should eql 6
+        vals[0][2].should eql 7
+        vals[1][0].should eql :RED_LOW
+        vals[1][1].should be_nil
+        vals[1][2].should be_nil
+        vals[2][0].should eql [1.0, 2.0, 4.0, 5.0]
+        vals[2][1].should be_nil
+        vals[2][2].should be_nil
+      end
+
+      it "should read all the specified values with specified value_types" do
+        @tlm.update!("TGT1","PKT1","\x01\x02\x03\x04")
+        @tlm.update!("TGT1","PKT2","\x05\x06")
+        @tlm.update!("TGT2","PKT1","\x07\x08")
+        @tlm.packet("TGT1","PKT1").check_limits
+        @tlm.packet("TGT1","PKT2").check_limits
+        @tlm.packet("TGT2","PKT1").check_limits
+        items = []
+        items << %w(TGT1 PKT1 ITEM1)
+        items << %w(TGT1 PKT1 ITEM2)
+        items << %w(TGT1 PKT1 ITEM3)
+        items << %w(TGT1 PKT1 ITEM4)
+        items << %w(TGT1 PKT2 ITEM2)
+        items << %w(TGT2 PKT1 ITEM1)
+        formats = [:CONVERTED, :RAW, :CONVERTED, :RAW, :CONVERTED, :CONVERTED]
+        vals = @tlm.values_and_limits_states(items,formats)
+        vals[0][0].should eql 1
+        vals[0][1].should eql 2
+        vals[0][2].should eql 6.0
+        vals[0][3].should eql 4
+        vals[0][4].should eql 6
+        vals[0][5].should eql 7
+        vals[1][0].should eql :RED_LOW
+        vals[1][1].should eql :YELLOW_LOW
+        vals[1][2].should be_nil
+        vals[1][3].should be_nil
+        vals[1][4].should be_nil
+        vals[1][5].should be_nil
+        vals[2][0].should eql [1.0, 2.0, 4.0, 5.0]
+        vals[2][1].should eql [1.0, 2.0, 4.0, 5.0]
+        vals[2][2].should be_nil
+        vals[2][3].should be_nil
+        vals[2][4].should be_nil
+        vals[2][5].should be_nil
+      end
+    end
+
+    describe "all" do
+      it "should return all packets" do
+        @tlm.all.keys.should eql %w(UNKNOWN TGT1 TGT2)
+      end
+    end
+
+  end
+end
+

data/spec/processors/new_packet_log_processor_spec.rb

@@ -0,0 +1,39 @@
+# encoding: ascii-8bit
+
+# Copyright 2014 Ball Aerospace & Technologies Corp.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'spec_helper'
+require 'cosmos/processors/processor'
+
+module Cosmos
+
+  describe NewPacketLogProcessor do
+
+    describe "initialize" do
+      it "should take a packet log writer name" do
+        a = NewPacketLogProcessor.new('MINE')
+        a.value_type.should eql :CONVERTED
+      end
+    end
+
+    describe "call" do
+      it "should start logging" do
+        log_name = nil
+        allow(CmdTlmServer).to receive_message_chain(:instance,:start_logging) do |name|
+          log_name = name
+        end
+        a = NewPacketLogProcessor.new()
+        a.call(nil, nil)
+        log_name.should eql('ALL')
+      end
+    end
+
+  end
+end
+

data/spec/processors/processor_spec.rb

@@ -0,0 +1,55 @@
+# encoding: ascii-8bit
+
+# Copyright 2014 Ball Aerospace & Technologies Corp.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'spec_helper'
+require 'cosmos/processors/processor'
+
+module Cosmos
+
+  describe Processor do
+
+    describe "initialize" do
+      it "should store an optional value_type" do
+        a = Processor.new(:RAW)
+        a.value_type.should eql :RAW
+        b = Processor.new
+        b.value_type.should eql :CONVERTED
+      end
+    end
+
+    describe "call" do
+      it "should raise an exception" do
+        expect { Processor.new.call(0, 0) }.to raise_error("call method must be defined by subclass")
+      end
+    end
+
+    describe "to_s" do
+      it "should return a String" do
+        Processor.new.to_s.should eql "Processor"
+      end
+    end
+
+    describe "name" do
+      it "should have an assignable name" do
+        a = Processor.new
+        a.name = "Test"
+        a.name.should eql "TEST"
+      end
+    end
+
+    describe "reset" do
+      it "should have a reset method" do
+        a = Processor.new
+        expect { a.reset }.not_to raise_error
+      end
+    end
+  end
+end
+

data/spec/processors/statistics_processor_spec.rb

@@ -0,0 +1,60 @@
+# encoding: ascii-8bit
+
+# Copyright 2014 Ball Aerospace & Technologies Corp.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'spec_helper'
+require 'cosmos'
+require 'cosmos/processors/statistics_processor'
+
+module Cosmos
+
+  describe StatisticsProcessor do
+
+    describe "initialize" do
+      it "should take an item_name, samples_to_average, and value_type" do
+        p = StatisticsProcessor.new('TEST', '5', 'RAW')
+        p.value_type.should eql :RAW
+        p.instance_variable_get("@item_name").should eql 'TEST'
+        p.instance_variable_get("@samples_to_average").should eql 5
+      end
+    end
+
+    describe "call and reset" do
+      it "should generate statistics" do
+        p = StatisticsProcessor.new('TEST', '5', 'RAW')
+        packet = Packet.new("tgt","pkt")
+        packet.append_item("TEST", 8, :UINT)
+        packet.buffer= "\x01"
+        p.call(packet, packet.buffer)
+        p.results[:MAX].should eql 1
+        p.results[:MIN].should eql 1
+        p.results[:MEAN].should be_within(0.001).of(1.0)
+        p.results[:STDDEV].should be_within(0.001).of(0.0)
+        packet.buffer= "\x02"
+        p.call(packet, packet.buffer)
+        p.results[:MAX].should eql 2
+        p.results[:MIN].should eql 1
+        p.results[:MEAN].should be_within(0.001).of(1.5)
+        p.results[:STDDEV].should be_within(0.001).of(0.7071)
+        packet.buffer= "\x00"
+        p.call(packet, packet.buffer)
+        p.results[:MAX].should eql 2
+        p.results[:MIN].should eql 0
+        p.results[:MEAN].should be_within(0.001).of(1.0)
+        p.results[:STDDEV].should be_within(0.001).of(1.0)
+        p.reset
+        p.results[:MAX].should eql nil
+        p.results[:MIN].should eql nil
+        p.results[:MEAN].should eql nil
+        p.results[:STDDEV].should eql nil
+      end
+    end
+  end
+end
+