Examples projects, more complete documentation, and other beautification. It brings a tear to the eye.

git-svn-id: http://unity.svn.sourceforge.net/svnroot/unity/trunk@4 e7d17a6e-8845-0410-bbbc-c8efb4fdad7e

examples/rakefile

@@ -0,0 +1,60 @@
+$here = File.expand_path( File.dirname( __FILE__ ) )
+
+require 'rake/clean'
+require 'rake/loaders/makefile'
+require 'fileutils'
+require 'set'
+require '../auto/unity_test_summary'
+require '../auto/generate_test_runner'
+require 'rakefile_helper'
+
+include RakefileHelpers
+
+CLEAN.include('build/*')
+
+desc "Build and run all tests, then output results (you can just type \"rake\" to get this."
+task :default => [:clobber, :all, :summary]
+
+task :summary do
+  flush_output
+  summary = UnityTestSummary.new
+  summary.set_root_path($here)
+  summary.set_targets(Dir[BUILD_PATH+'/*.test*'])
+  summary.run
+end
+
+task :all do
+  puts "Starting Test Suite"
+  runner_generator = UnityTestRunnerGenerator.new
+  test_sets = {}
+  
+  #compile unity files
+  Dir[UNITY_PATH+'/*.c'].each do |file|
+    compile(file, BUILD_PATH+'/'+File.basename(file).gsub('.c', OBJ_EXTENSION))
+  end
+  
+  #compile source files
+  Dir[SOURCE_PATH+'/*.c'].each do |file|
+    compile(file, BUILD_PATH+'/'+File.basename(file).gsub('.c', OBJ_EXTENSION))
+  end
+  
+  #compile test files
+  Dir[UNIT_TEST_PATH+'/*.c'].each do |file|
+    compile(file, BUILD_PATH+'/'+File.basename(file).gsub('.c', OBJ_EXTENSION))
+  end
+  
+  #compile runner files
+  Dir[UNIT_TEST_PATH+'/*.c'].each do |file|
+    run_file = BUILD_PATH+'/'+File.basename(file).gsub('.c','_Runner.c')
+    test_set = runner_generator.run(file, run_file)
+    compile(run_file, run_file.gsub('.c', OBJ_EXTENSION))
+    test_sets[run_file.gsub('_Runner.c', BIN_EXTENSION)] = test_set.map {|req_file| BUILD_PATH + '/' + File.basename(req_file).gsub(/\.[c|h]/, OBJ_EXTENSION)}
+  end
+  
+  #link and run each test
+  test_sets.each_pair do |exe_file, obj_files|
+    link(obj_files, exe_file)
+    write_result_file(exe_file, run_test(exe_file))
+  end
+end
+

examples/rakefile_helper.rb

@@ -0,0 +1,103 @@
+HERE = File.expand_path( File.dirname( __FILE__ ) ).gsub(/\//, '\\')
+
+module RakefileConstants
+
+  PROGRAM_FILES_PATH = ENV['ProgramFiles']
+  begin
+    Dir.new PROGRAM_FILES_PATH + '\IAR Systems\Embedded Workbench 4.0\arm'
+    IAR_ROOT = PROGRAM_FILES_PATH + '\IAR Systems\Embedded Workbench 4.0'
+  rescue
+    Dir.new PROGRAM_FILES_PATH + '\IAR Systems\Embedded Workbench 4.0 Kickstart\arm'
+    IAR_ROOT = PROGRAM_FILES_PATH + '\IAR Systems\Embedded Workbench 4.0 Kickstart'
+  end
+  
+  C_EXTENSION = '.c'
+  OBJ_EXTENSION = '.r79'
+  BIN_EXTENSION = '.d79'
+  
+  UNIT_TEST_PATH = 'test'
+  UNITY_PATH = '../src'
+  SOURCE_PATH = 'src'
+  BUILD_PATH = 'build'
+  IAR_PATH = IAR_ROOT + '\common'
+  IAR_BIN = IAR_PATH + '\bin'
+  IAR_INCLUDE = IAR_PATH + '\inc'
+  IAR_CORE_PATH = IAR_ROOT + '\arm'
+  IAR_CORE_BIN = IAR_CORE_PATH + '\bin'
+  IAR_CORE_CONFIG = IAR_CORE_PATH + '\config'
+  IAR_CORE_INCLUDE = IAR_CORE_PATH + '\inc'
+  IAR_CORE_INCLUDE_DLIB = IAR_CORE_INCLUDE + '\lib'
+  IAR_CORE_LIB = IAR_CORE_PATH + '\lib'
+  IAR_CORE_DLIB = IAR_CORE_LIB + '\dl5tpannl8n.r79'
+  IAR_CORE_DLIB_CONFIG = IAR_CORE_LIB + '\dl5tpannl8n.h'
+  IAR_PROCESSOR_SPECIFIC_PATH = HERE + '\proc'
+  SIMULATOR_PROCESSOR = IAR_CORE_BIN + '\armproc.dll'
+  SIMULATOR_DRIVER = IAR_CORE_BIN + '\armsim.dll'
+  SIMULATOR_PLUGIN = IAR_CORE_BIN + '\armbat.dll'
+  SIMULATOR_BACKEND_DDF = IAR_CORE_CONFIG + '\ioat91sam9261.ddf'
+  PROCESSOR_TYPE = "ARM926EJ-S"
+  LINKER_CONFIG = IAR_CORE_CONFIG + '\lnkarm.xcl'
+  
+  UNITY_SRC = UNITY_PATH + '\unity.c'
+  UNITY_HDR = UNITY_PATH + '\unity.h'
+  UNITY_OBJ = BUILD_PATH + '\unity' + OBJ_EXTENSION
+  UNITY_TEST_OBJ = BUILD_PATH + '\testunity' + OBJ_EXTENSION
+  UNITY_TEST_RUNNER_OBJ = BUILD_PATH + '\testunity_Runner' + OBJ_EXTENSION
+  UNITY_TEST_EXEC = UNITY_TEST_OBJ.ext BIN_EXTENSION
+  TEST_RESULTS = UNITY_TEST_OBJ.ext '.testpass'
+  
+  COMPILER = IAR_CORE_BIN + '\iccarm.exe'
+  LINKER = IAR_BIN + '\xlink.exe'
+  SIMULATOR = IAR_BIN + '\CSpyBat.exe'
+  
+end
+
+module RakefileHelpers
+  include RakefileConstants
+
+  def flush_output
+    $stderr.flush
+    $stdout.flush
+  end
+  
+  def report message
+    puts message
+    flush_output
+  end
+
+  def compile src, obj
+    execute "#{COMPILER} --dlib_config \"#{IAR_CORE_DLIB_CONFIG}\" -z3 --no_cse --no_unroll --no_inline --no_code_motion --no_tbaa --no_clustering --no_scheduling --debug --cpu_mode arm --endian little --cpu #{PROCESSOR_TYPE} --stack_align 4 -e --fpu None --diag_suppress Pa050 --diag_suppress Pe111 -I\"#{IAR_CORE_INCLUDE}\" -I\"#{UNITY_PATH}\" -Isrc -Itest #{src} -o#{obj}"
+  end
+
+  def link prerequisites, executable
+    execute "\"#{LINKER}\" -rt \"#{IAR_CORE_DLIB}\" -B -s __program_start -I\"#{IAR_CORE_CONFIG}\" -I\"#{IAR_CORE_LIB}\" -f \"#{LINKER_CONFIG}\" #{prerequisites.join(' ')} -o #{executable}"
+  end
+
+  def run_test executable      
+    execute "\"#{SIMULATOR}\" --silent \"#{SIMULATOR_PROCESSOR}\" \"#{SIMULATOR_DRIVER}\" #{executable} --plugin \"#{SIMULATOR_PLUGIN}\" --backend -B --cpu #{PROCESSOR_TYPE} -p \"#{SIMULATOR_BACKEND_DDF}\" -d sim"
+  end
+  
+  def write_result_file filename, results
+    if (results.include?("OK\n"))
+      output_file = filename.gsub(BIN_EXTENSION, '.testpass')
+    else
+      output_file = filename.gsub(BIN_EXTENSION, '.testfail')
+    end
+    File.open(output_file, 'w') do |f|
+      f.print results
+    end
+  end
+  
+private #####################
+
+  def execute command_string
+    report command_string
+    output = `#{command_string}`
+    report output
+    if $?.exitstatus != 0
+      raise "Command failed. (Returned #{$?.exitstatus})"
+    end
+    output
+  end
+
+end

examples/src/ProductionCode.c

@@ -0,0 +1,24 @@
+
+#include "ProductionCode.h"
+
+int Counter = 0;
+int NumbersToFind[9] = { 0, 34, 55, 66, 32, 11, 1, 77, 888 }; //some obnoxious array to search that is 1-based indexing instead of 0.
+
+// This function is supposed to search through NumbersToFind and find a particular number.  
+// If it finds it, the index is returned.  Otherwise 0 is returned which sorta makes sense since 
+// NumbersToFind is indexed from 1.  Unfortunately it's broken 
+// (and should therefore be caught by our tests)
+int FindFunction_WhichIsBroken(int NumberToFind)
+{
+    int i = 0;
+    while (i <= 8) //Notice I should have been in braces
+        i++;
+        if (NumbersToFind[i] == NumberToFind) //Yikes!  I'm getting run after the loop finishes instead of during it!
+            return i;
+    return 0;
+}
+
+int FunctionWhichReturnsLocalVariable(void)
+{
+    return Counter;
+}

examples/src/ProductionCode.h

@@ -0,0 +1,3 @@
+
+int FindFunction_WhichIsBroken(int NumberToFind);
+int FunctionWhichReturnsLocalVariable(void);

examples/src/ProductionCode2.c

@@ -0,0 +1,8 @@
+
+#include "ProductionCode2.h"
+
+char* ThisFunctionHasNotBeenTested(int Poor, char* LittleFunction)
+{
+  //Since There Are No Tests Yet, This Function Could Be Empty For All We Know.
+  // Which isn't terribly useful... but at least we put in a TEST_IGNORE so we won't forget
+}

examples/src/ProductionCode2.h

@@ -0,0 +1,2 @@
+
+char* ThisFunctionHasNotBeenTested(int Poor, char* LittleFunction);

examples/test/TestProductionCode.c

@@ -0,0 +1,62 @@
+
+#include "ProductionCode.h"
+#include "unity.h"
+
+//sometimes you may want to get at local data in a module.
+//for example: If you plan to pass by reference, this could be useful
+//however, it should often be avoided
+extern int Counter; 
+
+void setUp(void)
+{
+  //This is run before EACH TEST
+  Counter = 0x5a5a;
+}
+
+void tearDown(void)
+{
+}
+
+void test_FindFunction_WhichIsBroken_ShouldReturnZeroIfItemIsNotInList_WhichWorksEvenInOurBrokenCode(void)
+{
+  //All of these should pass
+  TEST_ASSERT_EQUAL(0, FindFunction_WhichIsBroken(78));
+  TEST_ASSERT_EQUAL(0, FindFunction_WhichIsBroken(1));
+  TEST_ASSERT_EQUAL(0, FindFunction_WhichIsBroken(33));
+  TEST_ASSERT_EQUAL(0, FindFunction_WhichIsBroken(999));
+  TEST_ASSERT_EQUAL(0, FindFunction_WhichIsBroken(-1));
+}
+
+void test_FindFunction_WhichIsBroken_ShouldReturnTheIndexForItemsInList_WhichWillFailBecauseOurFunctionUnderTestIsBroken(void)
+{
+  // You should see this line fail in your test summary
+  TEST_ASSERT_EQUAL(1, FindFunction_WhichIsBroken(34));
+  
+  // Notice the rest of these didn't get a chance to run because the line above failed.  
+  // Unit tests abort each test function on the first sign of trouble. 
+  // Then NEXT test function runs as normal.
+  TEST_ASSERT_EQUAL(8, FindFunction_WhichIsBroken(8888));
+}
+
+void test_FunctionWhichReturnsLocalVariable_ShouldReturnTheCurrentCounterValue(void)
+{
+    //This should be true because setUp set this up for us before this test
+    TEST_ASSERT_EQUAL_HEX(0x5a5a, FunctionWhichReturnsLocalVariable());
+    
+    //This should be true because we can still change our answer
+    Counter = 0x1234;
+    TEST_ASSERT_EQUAL_HEX(0x1234, FunctionWhichReturnsLocalVariable());
+}
+
+void test_FunctionWhichReturnsLocalVariable_ShouldReturnTheCurrentCounterValueAgain(void)
+{
+    //This should be true again because setup was rerun before this test (and after we changed it to 0x1234)
+    TEST_ASSERT_EQUAL_HEX(0x5a5a, FunctionWhichReturnsLocalVariable());
+}
+
+void test_FunctionWhichReturnsLocalVariable_ShouldReturnCurrentCounter_ButFailsBecauseThisTestIsActuallyFlawed(void)
+{
+    //Sometimes you get the test wrong.  When that happens, you get a failure too... and a quick look should tell
+    // you what actually happened...which in this case was a failure to setup the initial condition.
+    TEST_ASSERT_EQUAL_HEX(0x1234, FunctionWhichReturnsLocalVariable());
+}

examples/test/TestProductionCode2.c

@@ -0,0 +1,26 @@
+
+#include "ProductionCode2.h"
+#include "unity.h"
+
+void setUp(void)
+{
+}
+
+void tearDown(void)
+{
+}
+
+void test_IgnoredTest(void)
+{
+    TEST_IGNORE_MESSAGE("This Test Was Ignored On Purpose");
+}
+
+void test_AnotherIgnoredTest(void)
+{
+    TEST_IGNORE_MESSAGE("These Can Be Useful For Leaving Yourself Notes On What You Need To Do Yet");
+}
+
+void test_ThisFunctionHasNotBeenTested_NeedsToBeImplemented(void)
+{
+    TEST_IGNORE(); //Like This
+}