Samples Overview - Revision history

Timd: /* What you need to do */

2011-06-13T21:13:58Z

What you need to do

← Older revision		Revision as of 21:13, 13 June 2011
Line 8:		Line 8:
	In order to get the full benefit from the '''samples''', we recommend you do the following:		In order to get the full benefit from the '''samples''', we recommend you do the following:

	* follow the ''reference wiki links''' we provide in the main sample articles. These links provide rich technical information on the topics covered by the sample. These are also articles you will likely refer to in the future when you are implementing your own tests.		* follow the '''reference wiki links''' we provide in the main sample articles. These links provide rich technical information on the topics covered by the sample. These are also articles you will likely refer to in the future when you are implementing your own tests.
	* read/review all sample source code prior to running. The samples consist almost entirely of source code, so it makes sense to use a source code editor (one you are familiar with) for this purpose.		* read/review all sample source code prior to running. The samples consist almost entirely of source code, so it makes sense to use a source code editor (one you are familiar with) for this purpose.
	* build and execute the samples using the off-target framework. If you completed your installation as instructed above, it should be fully functional when you do the training.		* build and execute the samples using the off-target framework. If you completed your installation as instructed above, it should be fully functional when you do the training.

Marku at 16:00, 9 June 2011

2011-06-09T16:00:50Z

← Older revision		Revision as of 16:00, 9 June 2011
Line 1:		Line 1:
	= Introduction =		= Introduction =
	The samples are [[Desktop_Installation#Directories_and_Files \| provided with]] with the Desktop installation package. They are self-documented (using doxygen or perldoc) and this content will be attached to the test report whenever a sample is executed. They are ~~also~~ readily executable using our [[STRIDE Off-Target Environment \| off-target (desktop) environment]].		The samples are [[Desktop_Installation#Directories_and_Files \| provided with]] with the Desktop installation package. They are self-documented (using doxygen or perldoc) and this content will be attached to the test report whenever a sample is executed. They are readily executable using our [[STRIDE Off-Target Environment \| off-target (desktop) environment]] and can easily be [[Building_an_Off-Target_Test_App \| built and executed]]. In every case, you can include a sample(s) simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.

	The samples were created to be as simple as possible while sufficiently demonstrating the topic at hand. In particular, the samples are '''very light on core application logic (that is, the source under test)''' -- they focus instead on the code that leverages STRIDE to define and execute tests. As you review the sample code, if you find yourself confused about which code is the test logic and which is the source under test, try reading the source file comments to discern this.		The samples were created to be as simple as possible while sufficiently demonstrating the topic at hand. In particular, the samples are '''very light on core application logic (that is, the source under test)''' -- they focus instead on the code that leverages STRIDE to define and execute tests. As you review the sample code, if you find yourself confused about which code is the test logic and which is the source under test, try reading the source file comments to discern this.
Line 20:		Line 20:
	; [[C/C%2B%2B_Samples \| test_in_c_cpp]] : These are samples that implement the test logic using native code that executes on target. This functionality is focused at developers interested in writing tests in c/c++.		; [[C/C%2B%2B_Samples \| test_in_c_cpp]] : These are samples that implement the test logic using native code that executes on target. This functionality is focused at developers interested in writing tests in c/c++.
	; [[Script Samples \| test_in_script]] : These are the introductory samples for the STRIDE Framework that illustrate how to do expectation testing of instrumented source under test using script test modules on the host.		; [[Script Samples \| test_in_script]] : These are the introductory samples for the STRIDE Framework that illustrate how to do expectation testing of instrumented source under test using script test modules on the host.

	Once you have established a [[STRIDE Off-Target_Environment \| Off-Target Environment]] on your desktop, you can easily [[Building_an_Off-Target_Test_App \| build and run]] any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.

	[[Category: Samples]]		[[Category: Samples]]

Marku at 14:57, 9 June 2011

2011-06-09T14:57:18Z

← Older revision		Revision as of 14:57, 9 June 2011
Line 22:		Line 22:

	Once you have established a [[STRIDE Off-Target_Environment \| Off-Target Environment]] on your desktop, you can easily [[Building_an_Off-Target_Test_App \| build and run]] any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.		Once you have established a [[STRIDE Off-Target_Environment \| Off-Target Environment]] on your desktop, you can easily [[Building_an_Off-Target_Test_App \| build and run]] any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.

	~~= Tests in C/C++ =~~
	How you package your tests refers to how functions or methods implementing test cases are included into test units. It's possible for different packaging options to coexist, but for consistency and simplicity, we recommend that you decide early on in your test creation cycle what kind of test unit package you will use for your test units and then stick with that for all of your test units.

	~~== [[Test Intro Sample]] ==~~
	~~This sample is an introduction to some of the testing features and techniques from a C only perspective. For C++ environments we recommend the [[Test Intro Cpp Sample]].~~


	~~== [[Test Class Sample]] (packaging) ==~~
	If your compiler supports standard C++, the Test Class packaging is preferred as it allows the greatest functionality and flexibility with no added complexity for the simplest use cases.[1] (Note that the Test Class packaging can be used even if the software under test is written in C.) Demonstrates features available when [[Test Units \| test units]] are created as C++ classes.

	~~== [[Test_CClass_Sample \| Test C Class Sample]] (packaging) ==~~
	~~Demonstrates how to create and use [[Test Units\|test units]] that are C structures~~

	~~== [[Test_Function_List_Sample \| Test Function List Sample]] (packaging) ==~~
	~~Demonstrates how to create and use [[Test Units\|test units]] that are free C functions~~

	~~== [[Test_Macros_Sample \| Test Macros Sample]] ==~~
	Pass/Fail Macros simplify the task of setting a test case's status to pass or fail. They comprise a set of ASSERTs and EXPECTs that test a condition (e.g. equailty, less than, strings equal, etc.) and set the currently running test to the appropriate pass or fail status. ASSERTs cause the currently executing function to immediately return if fail status is set; EXPECTs do not return.
	~~This sample demonstrates the use of the [[Test Code Macros]]. This sample is implemented using Test Classes (''c++ only''), but these macros also work in C compilation units.~~

	~~== [[Test_Point_Sample \| Test Point Sample]] ==~~
	Test points are a unique STRIDE feature that greatly simplifies testing of multi-threaded software as well as single-threaded software that employs callbacks. This Sample demonstrates techniques and syntax for implementing [[Test Point Testing in C/C++ \|Test Points]]. With this technique, STRIDE makes it possible to observe and verify activity occurring another thread (e.g. a state machine).

	~~== [[Test_Double_Sample \| Test Double Sample]] ==~~
	Test doubles provide a means to intercept function calls so that alternate implementations can be substituted at runtime under the control of your test code. This enables sophisticated mocking, faking, and stubbing.
	This Sample demonstrates techniques and syntax for implementing [[Using Test Doubles\|Test Doubles]]. STRIDE's unique implementation makes it possible to dynamically switch in function mocks, stubs, and fakes at runtime. This sample is implemented using Test Classes (''c++ only''), but the techniques demonstrated work equally well in C compilation units.

	~~== [[File_Services_Sample \| File Services Sample]] ==~~
	The STRIDE File Services APIs provide a means to perform basic filesystem operations on the host filesystem from test code running on a device. This Sample demonstrates techniques and syntax for performing basic tasks using the [[File Transfer Services\|File Transfer Services API]].

	~~= Tests in Script =~~
	~~The following samples are available to illustrate the use of host scripting with the STRIDE Framework.~~

	~~== [[Expectations Sample]] ==~~
	This sample provides some pre-instrumented source code that include [[Test Point\|STRIDE Test Points]] and [[Test Log\|Test Logs]]. A single perl test module is included that implements a few examples of expectation testing based on the software under test.

	~~== [[FileTransfer Sample]] ==~~
	This sample shows an example of how you might use helper functions on the target to invoke [[File Transfer Services\|STRIDE File Transfer services]]. The example is driven by host script logic that invokes remote target functions to actuate a file transfer to the target.

	~~== [[FunctionRemoting Sample]] ==~~
	~~This sample shows some examples of invoking [[Function_Capturing\|remote functions]] for the purpose of fixturing your behavior tests written in script on the host.~~


	~~=Notes=~~
	~~<references/>~~


	[[Category: Samples]]		[[Category: Samples]]

Marku: /* Organization */

2011-06-09T14:45:53Z

Organization

← Older revision		Revision as of 14:45, 9 June 2011
Line 21:		Line 21:
	; [[Script Samples \| test_in_script]] : These are the introductory samples for the STRIDE Framework that illustrate how to do expectation testing of instrumented source under test using script test modules on the host.		; [[Script Samples \| test_in_script]] : These are the introductory samples for the STRIDE Framework that illustrate how to do expectation testing of instrumented source under test using script test modules on the host.

	Once you have established a [[STRIDE Off-Target_Environment \| Off-Target Environment]] on your desktop, you can easily build and run any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.		Once you have established a [[STRIDE Off-Target_Environment \| Off-Target Environment]] on your desktop, you can easily [[Building_an_Off-Target_Test_App \| build and run]] any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.

	= Tests in C/C++ =		= Tests in C/C++ =

Marku: /* What you need to do */

2011-06-09T14:22:57Z

What you need to do

← Older revision		Revision as of 14:22, 9 June 2011
Line 8:		Line 8:
	In order to get the full benefit from the '''samples''', we recommend you do the following:		In order to get the full benefit from the '''samples''', we recommend you do the following:

	* follow the wiki links we provide in the ~~training~~ articles. These links provide rich technical information on the topics covered by the ~~training~~. These are also articles you will likely refer to in the future when you are implementing your own tests.		* follow the ''reference wiki links''' we provide in the main sample articles. These links provide rich technical information on the topics covered by the sample. These are also articles you will likely refer to in the future when you are implementing your own tests.
	* read/review all sample source code prior to running. The samples consist almost entirely of source code, so it makes sense to use a source code editor (one you are familiar with) for this purpose.		* read/review all sample source code prior to running. The samples consist almost entirely of source code, so it makes sense to use a source code editor (one you are familiar with) for this purpose.
	* build and execute the samples using the off-target framework. If you completed your installation as instructed above, it should be fully functional when you do the training.		* build and execute the samples using the off-target framework. If you completed your installation as instructed above, it should be fully functional when you do the training.

Marku: /* Organization */

2011-06-09T14:20:26Z

Organization

← Older revision		Revision as of 14:20, 9 June 2011
Line 18:		Line 18:
	The samples are a collection of native and script source code that demonstrate the techniques for creating and executing tests using the STRIDE Framework. The samples are grouped into two top-level directories:		The samples are a collection of native and script source code that demonstrate the techniques for creating and executing tests using the STRIDE Framework. The samples are grouped into two top-level directories:

	; test_in_c_cpp : These are samples that implement the test logic using native code that executes on target. This functionality is focused at developers interested in writing tests in c/c++.		; [[C/C%2B%2B_Samples \| test_in_c_cpp]] : These are samples that implement the test logic using native code that executes on target. This functionality is focused at developers interested in writing tests in c/c++.
	; test_in_script : These are the introductory samples for the STRIDE Framework that illustrate how to do expectation testing of instrumented source under test using script test modules on the host.		; [[Script Samples \| test_in_script]] : These are the introductory samples for the STRIDE Framework that illustrate how to do expectation testing of instrumented source under test using script test modules on the host.

	Once you have established a [[Off-~~Target_Environment_Setup~~ \| Off-Target Environment]] on your desktop, you can easily build and run any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.		Once you have established a [[STRIDE Off-Target_Environment \| Off-Target Environment]] on your desktop, you can easily build and run any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.

	= Tests in C/C++ =		= Tests in C/C++ =

Marku: /* Introduction */

2011-06-09T14:01:29Z

Introduction

← Older revision		Revision as of 14:01, 9 June 2011
Line 1:		Line 1:
	= Introduction =		= Introduction =
	The samples are [[Desktop_Installation#Directories_and_Files \| provided with]] with the Desktop installation package. They are self-documented (using doxygen or perldoc) and this content will be attached to the test report whenever a sample is executed. They are also readily executable using our [[Off-~~Target_Environment_Setup~~ \| off-target (desktop) environment]].		The samples are [[Desktop_Installation#Directories_and_Files \| provided with]] with the Desktop installation package. They are self-documented (using doxygen or perldoc) and this content will be attached to the test report whenever a sample is executed. They are also readily executable using our [[STRIDE Off-Target Environment \| off-target (desktop) environment]].

	The samples were created to be as simple as possible while sufficiently demonstrating the topic at hand. In particular, the samples are '''very light on core application logic (that is, the source under test)''' -- they focus instead on the code that leverages STRIDE to define and execute tests. As you review the sample code, if you find yourself confused about which code is the test logic and which is the source under test, try reading the source file comments to discern this.		The samples were created to be as simple as possible while sufficiently demonstrating the topic at hand. In particular, the samples are '''very light on core application logic (that is, the source under test)''' -- they focus instead on the code that leverages STRIDE to define and execute tests. As you review the sample code, if you find yourself confused about which code is the test logic and which is the source under test, try reading the source file comments to discern this.

Marku: /* What you need to do */

2011-06-07T17:40:11Z

What you need to do

← Older revision		Revision as of 17:40, 7 June 2011
Line 6:		Line 6:
	= What you need to do =		= What you need to do =

	In order to get the full benefit from ~~these training articles~~, we recommend you do the following:		In order to get the full benefit from the '''samples''', we recommend you do the following:

	* follow the wiki links we provide in the training articles. These links provide rich technical information on the topics covered by the training. These are also articles you will likely refer to in the future when you are implementing your own tests.		* follow the wiki links we provide in the training articles. These links provide rich technical information on the topics covered by the training. These are also articles you will likely refer to in the future when you are implementing your own tests.

Marku at 23:13, 6 June 2011

2011-06-06T23:13:43Z

← Older revision		Revision as of 23:13, 6 June 2011
Line 21:		Line 21:
	; test_in_script : These are the introductory samples for the STRIDE Framework that illustrate how to do expectation testing of instrumented source under test using script test modules on the host.		; test_in_script : These are the introductory samples for the STRIDE Framework that illustrate how to do expectation testing of instrumented source under test using script test modules on the host.

	Once you have established a [[Off-Target Environment]] on your desktop, you can easily build and run any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.		Once you have established a [[Off-Target_Environment_Setup \| Off-Target Environment]] on your desktop, you can easily build and run any combination of these samples. In every case, you can include a sample simply by copying its source files to the SDK's [[Desktop_Installation#SDK \| sample_src]] directory and rebuilding the testapp.

	= Tests in C/C++ =		= Tests in C/C++ =
	How you package your tests refers to how functions or methods implementing test cases are included into test units. It's possible for different packaging options to coexist, but for consistency and simplicity, we recommend that you decide early on in your test creation cycle what kind of test unit package you will use for your test units and then stick with that for all of your test units.		How you package your tests refers to how functions or methods implementing test cases are included into test units. It's possible for different packaging options to coexist, but for consistency and simplicity, we recommend that you decide early on in your test creation cycle what kind of test unit package you will use for your test units and then stick with that for all of your test units.

			== [[Test Intro Sample]] ==
			This sample is an introduction to some of the testing features and techniques from a C only perspective. For C++ environments we recommend the [[Test Intro Cpp Sample]].


	== [[Test Class Sample]] (packaging) ==		== [[Test Class Sample]] (packaging) ==
Line 53:		Line 57:

	== [[Expectations Sample]] ==		== [[Expectations Sample]] ==
	This sample provides some pre-instrumented source code that include [[Test Point\|STRIDE Test Points]] and [[Test Log\|Test Logs]]. A single perl test module is included that implements a few examples of expectation testing based on the software under test~~. The process of including this sample as well as running it and publishing results is covered in [[Running and Publishing the Expectations Sample]]~~.		This sample provides some pre-instrumented source code that include [[Test Point\|STRIDE Test Points]] and [[Test Log\|Test Logs]]. A single perl test module is included that implements a few examples of expectation testing based on the software under test.

	== [[FileTransfer Sample]] ==		== [[FileTransfer Sample]] ==

Marku: /* Introduction */

2011-06-06T21:50:50Z

Introduction

← Older revision		Revision as of 21:50, 6 June 2011
Line 1:		Line 1:
	= Introduction =		= Introduction =
	The samples are [[Desktop_Installation#Directories_and_Files \| provided with]] with the Desktop installation package. They are self-documented (using doxygen or perldoc) and this content will be attached to the test report whenever a sample is executed. They are also readily executable using our [[Off-~~Target Environment~~ \| off-target (desktop) environment]].		The samples are [[Desktop_Installation#Directories_and_Files \| provided with]] with the Desktop installation package. They are self-documented (using doxygen or perldoc) and this content will be attached to the test report whenever a sample is executed. They are also readily executable using our [[Off-Target_Environment_Setup \| off-target (desktop) environment]].

	The samples were created to be as simple as possible while sufficiently demonstrating the topic at hand. In particular, the samples are '''very light on core application logic (that is, the source under test)''' -- they focus instead on the code that leverages STRIDE to define and execute tests. As you review the sample code, if you find yourself confused about which code is the test logic and which is the source under test, try reading the source file comments to discern this.		The samples were created to be as simple as possible while sufficiently demonstrating the topic at hand. In particular, the samples are '''very light on core application logic (that is, the source under test)''' -- they focus instead on the code that leverages STRIDE to define and execute tests. As you review the sample code, if you find yourself confused about which code is the test logic and which is the source under test, try reading the source file comments to discern this.