Studio:WorkspaceSetup.pl - Revision history

Ivailop at 04:54, 7 May 2010

2010-05-07T04:54:05Z

← Older revision		Revision as of 04:54, 7 May 2010
Line 97:		Line 97:
	== Prerequisites ==		== Prerequisites ==

	This component is written in the Perl scripting language and therefore requires that Perl be installed. See [[Desktop Installation#Third Party Requirements\|Perl requirements]] for more information.		This component is written in the Perl scripting language and therefore requires that Perl be installed. See [[Studio:Desktop Installation#Third Party Requirements\|Perl requirements]] for more information.

	[[Category:Studio:Scripts]]		[[Category:Studio:Scripts]]

Timd at 23:23, 20 August 2009

2009-08-20T23:23:14Z

← Older revision		Revision as of 23:23, 20 August 2009
Line 99:		Line 99:
	This component is written in the Perl scripting language and therefore requires that Perl be installed. See [[Desktop Installation#Third Party Requirements\|Perl requirements]] for more information.		This component is written in the Perl scripting language and therefore requires that Perl be installed. See [[Desktop Installation#Third Party Requirements\|Perl requirements]] for more information.

	[[Category: Scripts]]		[[Category:Studio:Scripts]]

Timd: WorkspaceSetup.pl moved to Studio:WorkspaceSetup.pl

2009-08-18T22:02:46Z

WorkspaceSetup.pl moved to Studio:WorkspaceSetup.pl

← Older revision	Revision as of 22:02, 18 August 2009
(No difference)

Ivailop at 17:49, 12 February 2009

2009-02-12T17:49:51Z

← Older revision		Revision as of 17:49, 12 February 2009
Line 1:		Line 1:
	The WorkspaceSetup.pl script (found in the STRIDE ''scripts'' directory) provides a command line tool for creating canonical STRIDE Studio workspaces suitable for organizing your test scripts. This script requires perl for execution as well as the STRIDE Test Utilities.		The WorkspaceSetup.pl script (found in the STRIDE ''scripts'' directory) provides a command line tool for creating canonical [[STRIDE Studio]] workspaces suitable for organizing your test scripts. This script requires perl for execution as well as the STRIDE Test Utilities.

	==Usage==		==Usage==

Ivailop: /* s2OnError.pl */

2008-12-12T01:05:06Z

s2OnError.pl

← Older revision		Revision as of 01:05, 12 December 2008
Line 94:		Line 94:

	Once the device connection is determined to be healthy, the script attempts to verify that the intercept module thread is active by calling a stock function called ''__strideIMProbe__''. If this function exists and returns an expected value when returned, the target is deemed to be functional and ready for more tests. Otherwise, the device is assumed to be non-functional and testing is halted.		Once the device connection is determined to be healthy, the script attempts to verify that the intercept module thread is active by calling a stock function called ''__strideIMProbe__''. If this function exists and returns an expected value when returned, the target is deemed to be functional and ready for more tests. Otherwise, the device is assumed to be non-functional and testing is halted.

			== Prerequisites ==

			This component is written in the Perl scripting language and therefore requires that Perl be installed. See [[Desktop Installation#Third Party Requirements\|Perl requirements]] for more information.

	[[Category: Scripts]]		[[Category: Scripts]]

Mikee: /* s2OnError.pl */

2008-12-04T18:46:01Z

s2OnError.pl

← Older revision		Revision as of 18:46, 4 December 2008
Line 91:		Line 91:
	===s2OnError.pl===		===s2OnError.pl===

	~~TODO: describe~~ the ~~policy implemented~~ in the ~~default OnError~~ script.		This script demonstrates how one might implement a recovery script for use in STRIDE Studio (as an OnError or OnTimeout property). This implementation verifies that the connection to the device is still active. If the connection has been lost, it attempts to "restart" the device by running the scripts in the '''setup''' and '''teardown''' folders. For most devices, the restart logic should probably be customized to better suit the device.

			Once the device connection is determined to be healthy, the script attempts to verify that the intercept module thread is active by calling a stock function called ''__strideIMProbe__''. If this function exists and returns an expected value when returned, the target is deemed to be functional and ready for more tests. Otherwise, the device is assumed to be non-functional and testing is halted.

	[[Category: Scripts]]		[[Category: Scripts]]

Mikee at 22:33, 2 December 2008

2008-12-02T22:33:16Z

← Older revision		Revision as of 22:33, 2 December 2008
Line 6:		Line 6:

	:{\|		:{\|
	\|style="background:linen" \| <font face="courier">WorkspaceSetup.pl -w MyWorkspace -d "MyDir" ~~-f fxname~~ [~~-g fxdir -p pkg -q pkgdir -s customsettings~~ -c customconfig -l]</font>		\|style="background:linen" \| <font face="courier">WorkspaceSetup.pl -w MyWorkspace -d "MyDir" [-c customconfig -l]</font>
	\|}		\|}

Line 15:		Line 15:
	:Specifies the directory in which to create the new workspace. Defaults to the current directory.		:Specifies the directory in which to create the new workspace. Defaults to the current directory.
	;-c \| --workspaceconfig = MyConfig.pm		;-c \| --workspaceconfig = MyConfig.pm
	:Allows users to specify a different an optional [[#WorkspaceConfig.pm]] file to use when creating the workspace. This allows users to generate a workspace with custom config parameters.		:Allows users to specify a different an optional [[#WorkspaceConfig.pm\|WorkspaceConfig.pm]] file to use when creating the workspace. This allows users to generate a workspace with custom config parameters.
	;-l \| --launch		;-l \| --launch
	:Launches STRIDE Studio and opens the newly created workspace.		:Launches STRIDE Studio and opens the newly created workspace.
Line 83:		Line 83:
	===s2StopPrintLog.pl===		===s2StopPrintLog.pl===

	This script processes the content of the traceview(s) that were created by [[#~~StartPrintLog~~.pl\|~~StartPrintLog~~.pl]]. The contents of the traceview(s) is added to the resulting test report as annotations.		This script processes the content of the traceview(s) that were created by [[#s2StartPrintLog.pl\|s2StartPrintLog.pl]]. The contents of the traceview(s) is added to the resulting test report as annotations.

	===s2TweakResults.pl===		===s2TweakResults.pl===
Line 92:		Line 92:

	TODO: describe the policy implemented in the default OnError script.		TODO: describe the policy implemented in the default OnError script.


	[[Category: Scripts]]		[[Category: Scripts]]

Mikee at 22:11, 2 December 2008

2008-12-02T22:11:52Z

← Older revision		Revision as of 22:11, 2 December 2008
Line 15:		Line 15:
	:Specifies the directory in which to create the new workspace. Defaults to the current directory.		:Specifies the directory in which to create the new workspace. Defaults to the current directory.
	;-c \| --workspaceconfig = MyConfig.pm		;-c \| --workspaceconfig = MyConfig.pm
	:Allows users to specify a different WorkspaceConfig file to use when creating the workspace. This allows ~~framework~~ users to generate a workspace with custom config parameters.		:Allows users to specify a different an optional [[#WorkspaceConfig.pm]] file to use when creating the workspace. This allows users to generate a workspace with custom config parameters.
	;-l \| --launch		;-l \| --launch
	:Launches STRIDE Studio and opens the newly created workspace.		:Launches STRIDE Studio and opens the newly created workspace.
Line 25:		Line 25:
	'''< Script Files >'''		'''< Script Files >'''
	'''<[[#setup Folder\|setup]]>'''		'''<[[#setup Folder\|setup]]>'''
	[[~~Creating Frameworks~~#~~StartPrintLog~~.pl\|~~StartPrintLog~~.pl]]		[[#s2StartPrintLog.pl\|s2StartPrintLog.pl]]
	'''<[[#test Folder\|test]]>'''		'''<[[#test Folder\|test]]>'''
	'''<[[#teardown Folder\|teardown]]>'''		'''<[[#teardown Folder\|teardown]]>'''
	[[~~Creating Frameworks~~#~~StopPrintLog~~.pl\|~~StopPrintLog~~.pl]]		[[#s2StopPrintLog.pl\|s2StopPrintLog.pl]]
	[[~~Creating Frameworks~~#~~TweakResults~~.pl\|~~TweakResults~~.pl]]		[[#s2TweakResults.pl\|s2TweakResults.pl]]
	'''<[[#utility Folder\|utility]]>'''		'''<[[#utility Folder\|utility]]>'''
	'''<[[#recovery Folder\|recovery]]>'''		'''<[[#recovery Folder\|recovery]]>'''
	[[~~Creating Frameworks~~#~~OnError~~.pl ~~(framework)~~\|s2OnError.pl]]		[[#s2OnError.pl\|s2OnError.pl]]

	'''< Source Files >'''		'''< Source Files >'''
Line 57:		Line 57:
	This folder contains the sample s2OnError script that we provide. This is intended as a template for customization depending on your device's needs.		This folder contains the sample s2OnError script that we provide. This is intended as a template for customization depending on your device's needs.

	== ~~See Also~~ ==		==WorkspaceConfig.pm==

			WorkspaceSetup.pl provides a limited way to configure the settings used when creating the new workspace. This file (WorkspaceConfig.pm), if specified, is executed during workspace creation and is used to configure the compiler, target, and workspace level settings for each new workspace.

			WorkspaceConfig must define, at a minimum, a single hash variable named %WorkspaceConfig::Settings (i.e., the hash is called Settings and is in the WorkspaceConfig package namespace). This hash may contain any or all of the following members:

			*Compiler
			*Target
			*Database
			*Workspace

			Each of these elements are themselves hashes (anonymous), each of which has entries that correspond to the properties of the corresponding automation studio automation model, e.g.:

			*Compiler corresponds to studio.Workspace.Settings.Compiler
			*Target corresponds to studio.Workspace.Settings.Target
			*Database corresponds to studio.Workspace.Settings.Database
			*Workspace corresponds to studio.Workspace

			==Provided Scripts==

			===s2StartPrintLog.pl===

			This script creates one or more traceviews to capture messages from the STRIDE Runtime.

			===s2StopPrintLog.pl===

			This script processes the content of the traceview(s) that were created by [[#StartPrintLog.pl\|StartPrintLog.pl]]. The contents of the traceview(s) is added to the resulting test report as annotations.

			===s2TweakResults.pl===

			Since the workspace organization includes several folders that produce no test results, this script consolidates the result from the test folder into a more convenient test report hierarchy. The final report that is generated contains all test results from the test folder under the top-level workspace suite.

			===s2OnError.pl===

			TODO: describe the policy implemented in the default OnError script.

	*[[Creating Frameworks]]
	*[[Using Frameworks]]
	*[[Provided Frameworks]]

	[[Category: Scripts]]		[[Category: Scripts]]

Mikee at 22:04, 2 December 2008

2008-12-02T22:04:04Z

Show changes

Mikee: /* See Also */

2008-08-13T23:58:26Z

← Older revision		Revision as of 23:58, 13 August 2008
Line 113:		Line 113:
	== See Also ==		== See Also ==

	[[Creating Frameworks]]		*[[Creating Frameworks]]
	[[Using Frameworks]]		*[[Using Frameworks]]
	[[Provided Frameworks]]		*[[Provided Frameworks]]

	[[Category: Scripts]]		[[Category: Scripts]]