adams-visiona 1.0.0

data/spec/core_ext/class_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/core_ext/class'
+
+describe Class do
+
+  describe "instance_attr_reader" do
+    it "adds instance attribute readers for class variables" do
+      class MyClass
+        instance_attr_reader :test
+        @@instance = nil
+        def self.instance
+          @@instance ||= self.new
+          return @@instance
+        end
+        def initialize
+          @test = "Test"
+          @@instance = self
+        end
+      end
+
+      my = MyClass.new
+      expect(MyClass.test).to eql "Test"
+      expect(my.test).to eql "Test"
+      # No accessor methods are created
+      expect { my.test = "Blah" }.to raise_error(NoMethodError)
+    end
+
+    it "does not allow arbitrary code" do
+      expect {
+        class MyClass
+          instance_attr_reader "test;puts 'HI'"
+        end
+      }.to raise_error(ArgumentError)
+
+      expect {
+        class MyClass
+          instance_attr_reader "test\nputs 'HI'"
+        end
+      }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "instance_attr_accessor" do
+    it "adds instance attribute readers for class variables" do
+      class MyClass
+        instance_attr_accessor :test
+        @@instance = nil
+        def self.instance
+          @@instance ||= self.new
+          return @@instance
+        end
+        def initialize
+          @test = "Test"
+          @@instance = self
+        end
+      end
+
+      my = MyClass.new
+      expect(MyClass.test).to eql "Test"
+      expect(my.test).to eql "Test"
+      my.test = "Blah"
+      expect(MyClass.test).to eql "Blah"
+      expect(my.test).to eql "Blah"
+    end
+
+    it "does not allow arbitrary code" do
+      expect {
+        class MyClass
+          instance_attr_accessor "test;puts 'HI'"
+        end
+      }.to raise_error(ArgumentError)
+
+      expect {
+        class MyClass
+          instance_attr_accessor "test\nputs 'HI'"
+        end
+      }.to raise_error(ArgumentError)
+    end
+  end
+end

data/spec/core_ext/cosmos_io_spec.rb

@@ -0,0 +1,77 @@
+# 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/core_ext/cosmos_io'
+
+class StringIO
+  include CosmosIO
+end
+
+describe StringIO do
+
+  describe "read_length_bytes" do
+    it "returns nil if length field is not 1, 2 or 4" do
+      io = StringIO.new
+      io.write "\x01\x01\x01\x01\x01\x01\x01\x01"
+      io.rewind
+      expect(io.read_length_bytes(0)).to be_nil
+      io.rewind
+      expect(io.read_length_bytes(3)).to be_nil
+      io.rewind
+      expect(io.read_length_bytes(8)).to be_nil
+    end
+
+    it "returns nil if there aren't enough bytes to read the length field" do
+      io = StringIO.new
+      io.write ""
+      io.rewind
+      expect(io.read_length_bytes(1)).to be_nil
+
+      io = StringIO.new
+      io.write "\x01"
+      io.rewind
+      expect(io.read_length_bytes(2)).to be_nil
+
+      io = StringIO.new
+      io.write "\x01\x01"
+      io.rewind
+      expect(io.read_length_bytes(4)).to be_nil
+    end
+
+    it "returns nil if there aren't enough bytes to read the string" do
+      io = StringIO.new
+      io.write "\x02\x01"
+      io.rewind
+      expect(io.read_length_bytes(1)).to be_nil
+    end
+
+    it "reads the bytes with length field size 1" do
+      io = StringIO.new
+      io.write "\x02\x01\x02"
+      io.rewind
+      expect(io.read_length_bytes(1)).to eql "\x01\x02"
+    end
+
+    it "reads the bytes with length field size 2" do
+      io = StringIO.new
+      io.write "\x00\x03\x01\x02\x03"
+      io.rewind
+      expect(io.read_length_bytes(2)).to eql "\x01\x02\x03"
+    end
+
+    it "reads the bytes with length field size 4" do
+      io = StringIO.new
+      io.write "\x00\x00\x00\x03\x01\x02\x03"
+      io.rewind
+      expect(io.read_length_bytes(4)).to eql "\x01\x02\x03"
+    end
+  end
+end

data/spec/core_ext/exception_spec.rb

@@ -0,0 +1,91 @@
+# 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/core_ext/exception'
+
+describe Exception do
+
+  describe "formatted" do
+    it "formats an Exception" do
+      begin
+        raise "My message"
+      rescue => err
+        expect(err.formatted).to match(/RuntimeError : My message/)
+        expect(err.formatted).to match(/#{File.expand_path(__FILE__)}/)
+      end
+    end
+
+    it "formats an Exception without RuntimeError class" do
+      begin
+        raise "My message"
+      rescue => err
+        expect(err.formatted(true)).not_to match(/RuntimeError/)
+        expect(err.formatted(true)).to match(/My message/)
+        expect(err.formatted(true)).to match(/#{File.expand_path(__FILE__)}/)
+      end
+
+      # If it's not a RuntimeError then we should still see the class
+      begin
+        raise ArgumentError.new("My message")
+      rescue => err
+        expect(err.formatted(true)).to match(/ArgumentError/)
+        expect(err.formatted(true)).to match(/My message/)
+        expect(err.formatted(true)).to match(/#{File.expand_path(__FILE__)}/)
+      end
+    end
+
+    it "formats an Exception without stack trace" do
+      begin
+        raise "My message"
+      rescue => err
+        expect(err.formatted(false, false)).to match(/RuntimeError : My message/)
+        expect(err.formatted(false, false)).not_to match(/#{File.expand_path(__FILE__)}/)
+      end
+
+      begin
+        raise "My message"
+      rescue => err
+        expect(err.formatted(true, false)).to match(/My message/)
+        expect(err.formatted(true, false)).not_to match(/#{File.expand_path(__FILE__)}/)
+      end
+    end
+  end
+
+  describe "source" do
+    it "returns the file and line number of the exception" do
+      begin
+        line = __LINE__; raise "My message"
+      rescue => err
+        file, line = err.source
+        expect(file).to eql __FILE__
+        expect(line).to eql line
+      end
+    end
+
+    it "returns the file and line number of the exception" do
+      begin
+        line = __LINE__; raise "My message"
+      rescue => err
+        # Check to simulate being on UNIX or Windows
+        if err.backtrace[0].include?(':') # windows
+          err.backtrace[0].gsub!(/[A-Z]:/,'')
+          file_name = __FILE__.gsub(/[A-Z]:/,'')
+        else
+          err.backtrace[0] = "C:" + err.backtrace[0]
+          file_name = "C:#{__FILE__}"
+        end
+        file, line = err.source
+        expect(file).to eql file_name
+        expect(line).to eql line
+      end
+    end
+  end
+end

data/spec/core_ext/file_spec.rb

@@ -0,0 +1,72 @@
+# 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/core_ext/file'
+require 'tempfile'
+
+describe File do
+
+  describe "is_ascii?" do
+    it "returns true if a file only contains printable ASCII characters" do
+      tf = Tempfile.new('unittest')
+      (32..126).each do |val|
+        tf.puts(val.chr)
+      end
+      tf.close
+      expect(File.is_ascii?(tf.path)).to be true
+      tf.unlink
+    end
+
+    it "returns false if a file contains non-ASCII characters" do
+      tf = Tempfile.new('unittest')
+      (0..255).each do |val|
+        tf.puts(val.chr)
+      end
+      tf.close
+      expect(File.is_ascii?(tf.path)).to be false
+      tf.unlink
+    end
+  end
+
+  describe "build_timestamped_filename" do
+    it "formats the time" do
+      time = Time.now
+      timestamp = sprintf("%04u_%02u_%02u_%02u_%02u_%02u", time.year, time.month, time.mday, time.hour, time.min, time.sec)
+      expect(File.build_timestamped_filename(nil,".txt",time)).to match(timestamp)
+    end
+
+    it "allows empty tags" do
+      expect(File.build_timestamped_filename([])).to match(/\d\d\.txt/)
+    end
+
+    it "allows nil tags" do
+      expect(File.build_timestamped_filename(nil)).to match(/\d\d\.txt/)
+    end
+
+    it "includes the tags" do
+      expect(File.build_timestamped_filename(['this','is','a','test'])).to match('this_is_a_test')
+    end
+
+    it "changes the extension" do
+      expect(File.build_timestamped_filename(nil,".bin")).to match(".bin")
+    end
+  end
+
+  describe "find_in_search_path" do
+    it "returns the path to the file" do
+      expect(File.find_in_search_path("cosmos.rb")).to match("lib/cosmos.rb")
+    end
+
+    it "returns nil if the file can't be found" do
+      expect(File.find_in_search_path("blah_blah_blah.rb")).to be_nil
+    end
+  end
+end

data/spec/core_ext/hash_spec.rb

@@ -0,0 +1,24 @@
+# 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/core_ext/hash'
+
+describe Hash do
+
+  describe "inspect" do
+    it "limits the number of items to 10" do
+      hash = {'1'=>1,'2'=>2,'3'=>3,'4'=>4,'5'=>5,'6'=>6,'7'=>7,'8'=>8,'9'=>9,'10'=>10}
+      expect(hash.inspect).to eql '{"1"=>1, "2"=>2, "3"=>3, "4"=>4, "5"=>5, "6"=>6, "7"=>7, "8"=>8, "9"=>9, "10"=>10}'
+      hash['11'] = 11
+      expect(hash.inspect).to match(/#<Hash:\d+>/)
+    end
+  end
+end

data/spec/core_ext/io_spec.rb

@@ -0,0 +1,46 @@
+# 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/core_ext/io'
+
+describe IO do
+
+  describe "fast_select" do
+    before(:all) do
+      @server = TCPServer.new('127.0.0.1', 23456)
+    end
+    after(:all) do
+      @server.close
+    end
+
+    it "selects on read sockets" do
+      # Three different timeout values cause different code paths
+
+      socket = TCPSocket.open('localhost', 23456)
+      expect(IO.fast_read_select([socket], 0.0005)).to be_nil
+      socket.close
+
+      socket = TCPSocket.open('localhost', 23456)
+      expect(IO.fast_read_select([socket], 0.01)).to be_nil
+      socket.close
+
+      socket = TCPSocket.open('localhost', 23456)
+      expect(IO.fast_read_select([socket], 0.5)).to be_nil
+      socket.close
+    end
+
+    it "selects on write sockets" do
+      socket = TCPSocket.open('localhost', 23456)
+      expect(IO.fast_write_select([socket], 0.5)).not_to be_nil
+      socket.close
+    end
+  end
+end

data/spec/core_ext/kernel_spec.rb

@@ -0,0 +1,54 @@
+# 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/core_ext/kernel'
+
+describe Kernel do
+
+  describe "is_windows?" do
+    it "returns true if running on Windows" do
+      # Check for a letter drive to determine Windows
+      if $:[0] =~ /[a-zA-Z]:/
+        expect(is_windows?).to be true
+      else
+        expect(is_windows?).to be false
+      end
+    end
+  end
+
+  describe "is_mac?" do
+    it "returns true if running on Mac OS X" do
+      # Check for a letter drive to determine Windows
+      if $:[0] =~ /[a-zA-Z]:/
+        expect(is_mac?).to be false
+      else
+        if RUBY_PLATFORM =~/darwin/
+          expect(is_mac?).to be true
+        else
+          expect(is_mac?).to be false
+        end
+      end
+    end
+  end
+
+  describe "calling_method" do
+    it "returns the calling method" do
+      def test(start)
+        test2(start)
+      end
+      def test2(start)
+        calling_method(start)
+      end
+      expect(test(0)).to eql :test2
+      expect(test(1)).to eql :test
+    end
+  end
+end

data/spec/core_ext/math_spec.rb

@@ -0,0 +1,116 @@
+# 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/core_ext/math'
+include Math
+
+describe Math do
+
+  describe "sin_squared" do
+    it "calculates sin squared" do
+      expect(sin_squared(10)).to be_within(0.00000001).of(sin(10)**2)
+    end
+  end
+
+  describe "cos_squared" do
+    it "calculates cos squared" do
+      expect(cos_squared(10)).to be_within(0.00000001).of(cos(10)**2)
+    end
+  end
+
+  describe "variance_population" do
+    it "returns 0 if the same value" do
+      mean, var = variance_population([1,1,1,1])
+      expect(mean).to eql 1.0
+      expect(var).to eql 0.0
+    end
+
+    it "returns population variance" do
+      mean, var = variance_population([1,2,3])
+      expect(mean).to eql 2.0
+      expect(var).to eql 2.0/3.0
+    end
+
+    it "handles an empty data set" do
+      mean, var = variance_population([])
+      expect(mean).to eql 0.0
+      expect(var).to eql 0.0
+    end
+  end
+
+  describe "variance_sample" do
+    it "returns 0 if the same value" do
+      mean, var = variance_sample([1,1,1,1])
+      expect(mean).to eql 1.0
+      expect(var).to eql 0.0
+    end
+
+    it "returns sample variance" do
+      mean, var = variance_sample([1,2,3])
+      expect(mean).to eql 2.0
+      expect(var).to eql 1.0
+    end
+
+    it "handles an empty data set" do
+      mean, var = variance_sample([])
+      expect(mean).to eql 0.0
+      expect(var).to eql 0.0
+    end
+
+    it "handles a single item data set" do
+      mean, var = variance_sample([1])
+      expect(mean).to eql 1.0
+      expect(var).to eql 0.0
+    end
+  end
+
+  describe "stddev_population" do
+    it "returns 0 if the same value" do
+      mean, var = stddev_population([1,1,1,1])
+      expect(mean).to eql 1.0
+      expect(var).to eql 0.0
+    end
+
+    it "returns population stddev" do
+      mean, var = stddev_population([1,2,3])
+      expect(mean).to eql 2.0
+      expect(var).to eql sqrt(2.0/3.0)
+    end
+  end
+
+  describe "stddev_sample" do
+    it "returns 0 if the same value" do
+      mean, var = stddev_sample([1,1,1,1])
+      expect(mean).to eql 1.0
+      expect(var).to eql 0.0
+    end
+
+    it "returns sample stddev" do
+      mean, var = stddev_sample([1,2,3])
+      expect(mean).to eql 2.0
+      expect(var).to eql 1.0
+    end
+  end
+
+  describe "luma_from_rgb_max_255" do
+    it "returns 0 with 0 RGB" do
+      expect(luma_from_rgb_max_255(0,0,0)).to eql 0.0
+    end
+
+    it "returns 1.0 with 255 RGB" do
+      expect(luma_from_rgb_max_255(255,255,255)).to eql 1.0
+    end
+
+    it "returns about 0.5 with 127 RGB" do
+      expect(luma_from_rgb_max_255(127,127,127)).to be_within(0.01).of(0.5)
+    end
+  end
+end

data/spec/core_ext/matrix_spec.rb

@@ -0,0 +1,127 @@
+# 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/core_ext/matrix'
+require 'ostruct'
+
+describe Matrix do
+
+  describe "[]" do
+    it "returns an entire row" do
+      matrix = Matrix[[1,2,3],[4,5,6],[7,8,9]]
+      expect(matrix[0]).to eql [1,2,3]
+      expect(matrix[1]).to eql [4,5,6]
+      expect(matrix[2]).to eql [7,8,9]
+    end
+
+    it "returns an element" do
+      matrix = Matrix[[1,2,3],[4,5,6],[7,8,9]]
+      expect(matrix[0,0]).to eql 1
+      expect(matrix[1,1]).to eql 5
+      expect(matrix[2,2]).to eql 9
+    end
+  end
+
+  describe "[]=" do
+    it "sets an element" do
+      matrix = Matrix[[1,2,3],[4,5,6],[7,8,9]]
+      matrix[0,0] = -1
+      expect(matrix[0,0]).to eql -1
+    end
+  end
+
+  describe "rot" do
+    it "creates a rotation about x" do
+      expect(Matrix.rot(:X, Math::PI / 2)).to eql Matrix[[1,0,0],[0,cos(Math::PI / 2),sin(Math::PI / 2)],[0,-sin(Math::PI / 2),cos(Math::PI / 2)]]
+      expect(Matrix.rot(:X, 90)).to eql Matrix.rot(:x, 90)
+      expect(Matrix.rot(:x, 90)).to eql Matrix.rot(1, 90)
+    end
+
+    it "creates a rotation about y" do
+      expect(Matrix.rot(:Y, Math::PI / 2)).to eql Matrix[[cos(Math::PI / 2),0,-sin(Math::PI / 2)],[0,1,0],[sin(Math::PI / 2),0, cos(Math::PI / 2)]]
+    end
+
+    it "creates a rotation about z" do
+      expect(Matrix.rot(:Z, Math::PI / 2)).to eql Matrix[[cos(Math::PI / 2),sin(Math::PI / 2),0],[-sin(Math::PI / 2),cos(Math::PI / 2),0],[0,0,1]]
+    end
+  end
+
+  describe "trace" do
+    it "sums the diagonal" do
+      expect(Matrix[[1,2,3],[4,5,6],[7,8,9]].trace).to eql 15.0
+    end
+
+    it "handles rectangular matrices" do
+      expect(Matrix[[1,2],[4,5],[7,8]].trace).to eql 6.0
+    end
+  end
+
+  describe "cfromq" do
+    it "calculates the rotational matrix from the quaternion" do
+      quaternion = OpenStruct.new
+      quaternion.w = 1
+      quaternion.x = 0
+      quaternion.y = 0
+      quaternion.z = 0
+      expect(Matrix.cfromq(quaternion)).to eql Matrix[[1.0,0.0,0.0],[0.0,1.0,0.0],[0.0,0.0,1.0]]
+
+      quaternion.w = Math.sqrt(0.5)
+      quaternion.x = Math.sqrt(0.5)
+      quaternion.y = 0
+      quaternion.z = 0
+      matrix = Matrix.cfromq(quaternion)
+      expect(matrix[0]).to eql [1.0, 0.0, 0.0]
+      expect(matrix[1][0]).to eql 0.0
+      expect(matrix[1][1]).to be_within(1e-10).of(0.0)
+      expect(matrix[1][2]).to be_within(1e-10).of(1.0)
+      expect(matrix[2][0]).to eql 0.0
+      expect(matrix[2][1]).to be_within(1e-10).of(-1.0)
+      expect(matrix[2][2]).to be_within(1e-10).of(0.0)
+    end
+  end
+
+  describe "trans4" do
+    it "translates the matrix by x,y,z" do
+      matrix = Matrix[[4,4,4,4],[3,3,3,3],[2,2,2,2],[1,1,1,1]]
+      expect(matrix.trans4(1,1,1)).to eql Matrix[[4,4,4,4],[3,3,3,3],[2,2,2,2],[10,10,10,10]]
+    end
+  end
+
+  describe "scale4" do
+    it "scales the matrix by x,y,z" do
+      matrix = Matrix[[5,5,5,5],[4,4,4,4],[3,3,3,3],[2,2,2,2]]
+      expect(matrix.scale4(2,4,6)).to eql Matrix[[10,10,10,10],[16,16,16,16],[18,18,18,18],[2,2,2,2]]
+    end
+  end
+
+  describe "rot4" do
+    it "rotates the matrix about the quaternion" do
+      matrix = Matrix[[4,4,4,4],[3,3,3,3],[2,2,2,2],[1,1,1,1]]
+      quaternion = OpenStruct.new
+      quaternion.w = Math.sqrt(0.5)
+      quaternion.x = Math.sqrt(0.5)
+      quaternion.y = 0
+      quaternion.z = 0
+      matrix = matrix.rot4(quaternion)
+      expect(matrix[0]).to eql [4.0, 4.0, 4.0, 4.0]
+      expect(matrix[1][0]).to be_within(1e-10).of(2.0)
+      expect(matrix[1][1]).to be_within(1e-10).of(2.0)
+      expect(matrix[1][2]).to be_within(1e-10).of(2.0)
+      expect(matrix[1][3]).to be_within(1e-10).of(2.0)
+      expect(matrix[2][0]).to be_within(1e-10).of(-3.0)
+      expect(matrix[2][1]).to be_within(1e-10).of(-3.0)
+      expect(matrix[2][2]).to be_within(1e-10).of(-3.0)
+      expect(matrix[2][3]).to be_within(1e-10).of(-3.0)
+      expect(matrix[3]).to eql [1.0, 1.0, 1.0, 1.0]
+    end
+  end
+end
+