cosmos 3.8.3 → 3.9.1

data/spec/tools/cmd_tlm_server/cmd_tlm_server_spec.rb

@@ -269,6 +269,10 @@ module Cosmos
     end
 
     describe "self.subscribe_packet_data" do
+      it "rejects bad queue sizes" do
+        expect{ CmdTlmServer.subscribe_packet_data([["COSMOS","VERSION"]], true) }.to raise_error(ArgumentError)
+      end
+
       it "subscribes to packets" do
         version = System.telemetry.packet("COSMOS","VERSION")
         allow_any_instance_of(Interface).to receive(:read) do

data/spec/tools/launcher/launcher_config_spec.rb

@@ -19,7 +19,7 @@ module Cosmos
   describe LauncherConfig do
     describe "initialize" do
       it "checks for a given filename" do
-        expect { LauncherConfig.new('blah_file.txt') }.to raise_error
+        expect { LauncherConfig.new('blah_file.txt') }.to raise_error(/file does not exist/)
       end
 
       it "raises on unknown parameters" do

data/spec/tools/table_manager/table_config_spec.rb

@@ -0,0 +1,226 @@
+# 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/tools/table_manager/table_config'
+require 'tempfile'
+
+module Cosmos
+
+  describe TableConfig do
+    let(:tc) { TableConfig.new }
+
+    describe "tables" do
+      it "returns the tables hash" do
+        tf = Tempfile.new('unittest')
+        tf.puts("TABLE table1 BIG_ENDIAN ONE_DIMENSIONAL")
+        tf.puts("TABLE table2 BIG_ENDIAN TWO_DIMENSIONAL 2")
+        tf.puts("TABLE table3 BIG_ENDIAN ONE_DIMENSIONAL")
+        tf.close
+        tc.process_file(tf.path)
+        expect(tc.tables.keys).to eql %w(TABLE1 TABLE2 TABLE3)
+        expect(tc.tables.values[0]).to be_a Table
+        tf.unlink
+      end
+    end
+
+    describe "table_names" do
+      it "returns the table names" do
+        tf = Tempfile.new('unittest')
+        tf.puts("TABLE table1 BIG_ENDIAN ONE_DIMENSIONAL")
+        tf.puts("TABLE table2 BIG_ENDIAN TWO_DIMENSIONAL 2")
+        tf.puts("TABLE table3 BIG_ENDIAN ONE_DIMENSIONAL")
+        tf.close
+        tc.process_file(tf.path)
+        expect(tc.table_names).to eql %w(TABLE1 TABLE2 TABLE3)
+        tf.unlink
+      end
+    end
+
+    describe "table" do
+      it "returns a table" do
+        tf = Tempfile.new('unittest')
+        tf.puts("TABLE table1 BIG_ENDIAN ONE_DIMENSIONAL")
+        tf.puts("TABLE table2 BIG_ENDIAN TWO_DIMENSIONAL 2")
+        tf.puts("TABLE table3 BIG_ENDIAN ONE_DIMENSIONAL")
+        tf.close
+        tc.process_file(tf.path)
+        expect(tc.table("TABLE1").table_name).to eql "TABLE1"
+        expect(tc.table("TABLE1").type).to eql :ONE_DIMENSIONAL
+        expect(tc.table("TABLE2").table_name).to eql "TABLE2"
+        expect(tc.table("TABLE2").type).to eql :TWO_DIMENSIONAL
+        expect(tc.table("TABLE3").table_name).to eql "TABLE3"
+        expect(tc.table("TABLE3").type).to eql :ONE_DIMENSIONAL
+        tf.unlink
+      end
+    end
+
+    describe "process_file" do
+      it "complains about unknown keywords" do
+        tf = Tempfile.new('unittest')
+        tf.puts("BLAH")
+        tf.close
+        expect { tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Unknown keyword 'BLAH'/)
+        tf.unlink
+      end
+
+      it "handles errors in processing elements" do
+        tf = Tempfile.new('unittest')
+        tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Table"'
+        tf.puts '  APPEND_PARAMETER item1'
+        tf.close
+        expect { tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Not enough parameters/)
+        tf.unlink
+      end
+
+      context "with TABLEFILE" do
+        it "complains if not enough parameters" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'TABLEFILE'
+          tf.close
+          expect { tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Not enough parameters/)
+          tf.unlink
+        end
+
+        it "complains if too many parameters" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'TABLEFILE table_file table_file'
+          tf.close
+          expect { tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Too many parameters/)
+          tf.unlink
+        end
+
+        it "complains if the table file does not exist" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'TABLEFILE table_file'
+          tf.close
+          expect { tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /not found/)
+          tf.unlink
+        end
+
+        it "parses the table definition file" do
+          tf = Tempfile.new('test_table')
+          tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Table"'
+          tf.puts '  APPEND_PARAMETER item1 16 UINT 0 0 0 "Item"'
+          tf.close
+          tf1 = Tempfile.new('unittest')
+          tf1.puts "TABLEFILE #{File.basename(tf.path)}"
+          tf1.close
+          tc.process_file(tf1.path)
+          tbl = tc.table("TABLE")
+          expect(tbl.get_item("ITEM1").description).to eql "Item"
+          tf1.unlink
+          tf.unlink
+        end
+      end
+
+      context "with SELECT_TABLE" do
+        it "complains if the table is not found" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'SELECT_TABLE table'
+          tf.puts 'SELECT_ITEM ITEM1'
+          tf.puts '  DESCRIPTION "New description"'
+          tf.close
+          expect { tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Table TABLE not found/)
+          tf.unlink
+        end
+
+        it "selects a table for modification" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Table"'
+          tf.puts '  APPEND_PARAMETER item1 16 UINT 0 0 0 "Item"'
+          tf.close
+          tc.process_file(tf.path)
+          tbl = tc.table("TABLE")
+          expect(tbl.get_item("ITEM1").description).to eql "Item"
+          tf.unlink
+
+          tf = Tempfile.new('unittest')
+          tf.puts 'SELECT_TABLE table'
+          tf.puts 'SELECT_PARAMETER ITEM1'
+          tf.puts '  DESCRIPTION "New description"'
+          tf.close
+          tc.process_file(tf.path)
+          tbl = tc.table("TABLE")
+          expect(tbl.get_item("ITEM1").description).to eql "New description"
+          tf.unlink
+        end
+      end
+
+      context "with SELECT_PARAMETER" do
+        it "complains if the parameter is not found" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Table"'
+          tf.puts '  APPEND_PARAMETER PARAM 16 UINT 0 0 0 "Param"'
+          tf.close
+          tc.process_file(tf.path)
+          tbl = tc.table("TABLE")
+          expect(tbl.get_item("PARAM").description).to eql "Param"
+          expect(tbl.get_item("PARAM").editable).to eql true
+          tf.unlink
+
+          tf = Tempfile.new('unittest')
+          tf.puts 'SELECT_TABLE table'
+          tf.puts '  SELECT_PARAMETER PARAMX'
+          tf.puts '    DESCRIPTION "New description"'
+          tf.close
+          expect { tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /PARAMX not found in table TABLE/)
+          tf.unlink
+        end
+      end
+
+      context "with TWO_DIMESIONAL tables" do
+        it "duplicates parameters to create rows" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'TABLE table LITTLE_ENDIAN TWO_DIMENSIONAL 2 "Table"'
+          tf.puts '  APPEND_PARAMETER item1 16 UINT 0 0 0 "Item"'
+          tf.puts '  APPEND_PARAMETER item2 16 UINT 0 0 0 "Item"'
+          tf.close
+          tc.process_file(tf.path)
+          tbl = tc.table("TABLE")
+          names = []
+          tbl.sorted_items.each {|item| names << item.name }
+          expect(names).to eql %w(ITEM10 ITEM20 ITEM11 ITEM21)
+          tf.unlink
+        end
+      end
+
+      context "with UNEDITABLE" do
+        it "sets editable to false" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Table"'
+          tf.puts '  PARAMETER item1 0 16 UINT 0 0 0 "Item"'
+          tf.puts '    UNEDITABLE'
+          tf.close
+          tc.process_file(tf.path)
+          tbl = tc.table("TABLE")
+          expect(tbl.get_item("ITEM1").editable).to eql false
+          tf.unlink
+        end
+      end
+
+      context "with HIDDEN" do
+        it "sets hidden to true" do
+          tf = Tempfile.new('unittest')
+          tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Table"'
+          tf.puts '  PARAMETER item1 0 16 UINT 0 0 0 "Item"'
+          tf.puts '    HIDDEN'
+          tf.close
+          tc.process_file(tf.path)
+          tbl = tc.table("TABLE")
+          expect(tbl.get_item("ITEM1").hidden).to eql true
+          tf.unlink
+        end
+      end
+
+    end # describe "process_file"
+  end
+end

data/spec/tools/table_manager/table_item_spec.rb

@@ -0,0 +1,57 @@
+# 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/tools/table_manager/table_item'
+
+module Cosmos
+
+  describe TableItem do
+    before(:each) do
+      @ti = TableItem.new("test", 0, 32, :UINT, :BIG_ENDIAN, nil)
+    end
+
+    describe "editable=" do
+      it "sets the editable flag" do
+        @ti.editable = true
+        expect(@ti.editable).to eql true
+        @ti.editable = false
+        expect(@ti.editable).to eql false
+      end
+
+      it "complains about non boolean values" do
+        expect { @ti.editable = 5 }.to raise_error(ArgumentError, "#{@ti.name}: editable must be a boolean but is a Fixnum")
+      end
+    end
+
+    describe "clone" do
+      it "duplicates the entire TableItem" do
+        pi2 = @ti.clone
+        expect(@ti == pi2).to be true
+      end
+    end
+
+    describe "to_hash" do
+      it "converts to a Hash" do
+        hash = @ti.to_hash
+        # Check the values from StructureItem
+        expect(hash.keys).to include('editable')
+        expect(hash["editable"]).to eql true
+
+        @ti.editable = false
+
+        hash = @ti.to_hash
+        expect(hash["editable"]).to eql false
+      end
+    end
+  end
+end
+

data/spec/tools/table_manager/table_parser_spec.rb

@@ -0,0 +1,96 @@
+# 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/tools/table_manager/table_config'
+require 'cosmos/tools/table_manager/table_parser'
+require 'tempfile'
+
+module Cosmos
+
+  describe TableParser do
+
+    describe "process_file" do
+      before(:each) do
+        @tc = TableConfig.new
+      end
+
+      it "complains if there are not enough parameters" do
+        tf = Tempfile.new('unittest')
+        tf.puts("TABLE table")
+        tf.close
+        expect { @tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Not enough parameters for TABLE/)
+        tf.unlink
+
+        tf = Tempfile.new('unittest')
+        tf.puts("TABLE table BIG_ENDIAN TWO_DIMENSIONAL")
+        tf.close
+        expect { @tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Not enough parameters for TABLE/)
+        tf.unlink
+      end
+
+      it "complains if there are too many parameters" do
+        tf = Tempfile.new('unittest')
+        tf.puts "TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL 'Table' extra"
+        tf.close
+        expect { @tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Too many parameters for TABLE/)
+        tf.unlink
+
+        tf = Tempfile.new('unittest')
+        tf.puts "TABLE table LITTLE_ENDIAN TWO_DIMENSIONAL 2 'Table' extra"
+        tf.close
+        expect { @tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Too many parameters for TABLE/)
+        tf.unlink
+      end
+
+      it "complains about invalid type" do
+        tf = Tempfile.new('unittest')
+        tf.puts 'TABLE table LITTLE_ENDIAN FOUR_DIMENSIONAL "Table"'
+        tf.close
+        expect { @tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Invalid display type FOUR_DIMENSIONAL/)
+        tf.unlink
+      end
+
+      it "complains about invalid endianness" do
+        tf = Tempfile.new('unittest')
+        tf.puts 'TABLE table MIDDLE_ENDIAN ONE_DIMENSIONAL "Table"'
+        tf.close
+        expect { @tc.process_file(tf.path) }.to raise_error(ConfigParser::Error, /Invalid endianness MIDDLE_ENDIAN/)
+        tf.unlink
+      end
+
+      it "processes table, endianness, type, description" do
+        tf = Tempfile.new('unittest')
+        tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Table"'
+        tf.close
+        @tc.process_file(tf.path)
+        tbl = @tc.table("TABLE")
+        expect(tbl.table_name).to eql "TABLE"
+        expect(tbl.default_endianness).to eql :LITTLE_ENDIAN
+        expect(tbl.type).to eql :ONE_DIMENSIONAL
+        expect(tbl.description).to eql "Table"
+        tf.unlink
+      end
+
+      it "complains if a table is redefined" do
+        tf = Tempfile.new('unittest')
+        tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Packet 1"'
+        tf.puts 'TABLE table LITTLE_ENDIAN ONE_DIMENSIONAL "Packet 2"'
+        tf.close
+        @tc.process_file(tf.path)
+        expect(@tc.warnings).to include("Table TABLE redefined.")
+        tf.unlink
+      end
+
+    end # describe "process_file"
+  end
+end
+

data/spec/tools/table_manager/table_spec.rb

@@ -0,0 +1,90 @@
+# 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/tools/table_manager/table'
+
+module Cosmos
+
+  describe Table do
+
+    describe "table_name" do
+      it "returns the table name upcased" do
+        t = Table.new("table", :BIG_ENDIAN, :ONE_DIMENSIONAL, "description", "filename")
+        expect(t.table_name).to eql "TABLE"
+      end
+    end
+
+    describe "type" do
+      it "must be :ONE_DIMENSIONAL or :TWO_DIMENSIONAL" do
+        t = Table.new("table", :BIG_ENDIAN, :ONE_DIMENSIONAL, "description", "filename")
+        expect(t.type).to eql :ONE_DIMENSIONAL
+        t = Table.new("table", :BIG_ENDIAN, :TWO_DIMENSIONAL, "description", "filename")
+        expect(t.type).to eql :TWO_DIMENSIONAL
+        expect { Table.new("table", :BIG_ENDIAN, :BIG, "description", "filename") }.to raise_error(ArgumentError, /Invalid type 'BIG' for table 'table'/)
+      end
+    end
+
+    describe "filename" do
+      it "stores the filename" do
+        t = Table.new("table", :BIG_ENDIAN, :ONE_DIMENSIONAL, "description", File.join(Dir.pwd, "filename"))
+        expect(t.filename).to eql File.join(Dir.pwd, "filename")
+      end
+    end
+
+    describe "num_rows=" do
+      it "raises an error for ONE_DIMENTIONAL" do
+        t = Table.new("table", :BIG_ENDIAN, :ONE_DIMENSIONAL, "description", "filename")
+        expect { t.num_rows = 2 }.to raise_error(/Rows are fixed/)
+      end
+
+      it "sets num_rows for TWO_DIMENTIONAL" do
+        t = Table.new("table", :BIG_ENDIAN, :TWO_DIMENSIONAL, "description", "filename")
+        t.num_rows = 2
+        expect(t.num_rows).to eql 2
+      end
+    end
+
+    describe "num_rows" do
+      it "initializes to 0" do
+        t = Table.new("table", :BIG_ENDIAN, :ONE_DIMENSIONAL, "description", "filename")
+        expect(t.num_rows).to eql 0
+      end
+
+      it "equals the number of visible items in ONE_DIMENSIONAL" do
+        t = Table.new("table", :BIG_ENDIAN, :ONE_DIMENSIONAL, "description", "filename")
+        ti1 = TableItem.new("test1", 0, 32, :UINT, :BIG_ENDIAN, nil)
+        ti2 = TableItem.new("test2", 0, 32, :UINT, :BIG_ENDIAN, nil)
+        ti2.hidden = true
+        ti3 = TableItem.new("test3", 0, 32, :UINT, :BIG_ENDIAN, nil)
+        t.append(ti1)
+        expect(t.num_rows).to eql 1
+        t.append(ti2)
+        expect(t.num_rows).to eql 1
+        t.append(ti3)
+        expect(t.num_rows).to eql 2
+      end
+    end
+
+    describe "num_columns" do
+      it "initializes to 1 for ONE_DIMENSIONAL" do
+        t = Table.new("table", :BIG_ENDIAN, :ONE_DIMENSIONAL, "description", "filename")
+        expect(t.num_columns).to eql 1
+      end
+      it "initializes to 0 for TWO_DIMENSIONAL" do
+        t = Table.new("table", :BIG_ENDIAN, :TWO_DIMENSIONAL, "description", "filename")
+        expect(t.num_columns).to eql 0
+      end
+    end
+
+  end # describe Table
+end
+