mustella/README

Mustella README

	See the Mustella Wiki Page for more details at:
	https://cwiki.apache.org/confluence/display/FLEX/Mustella+Overview
	
	(Note: This includes information on how to run AIR and mobile tests.)

Install Prerequisites
=====================

	Mustella requires some variables set: AIR_HOME, FLASHPLAYER_DEBUGGER, PLAYERGLOBAL_HOME, and ANT_HOME. Use absolute file paths
	when setting these values as relative path names can cause compilation errors.

	There are several places you can set these values (in order of preference):

	* from ../env.properties in the main Flex source directory. See ../env-template.properties for details.
	* from shell environment variables.
	* from ./local.properties in the Mustella main directory. See ./local-template.properties. This file can set or override 
	the environment variables as well as setting Mustella-specific values. 


Trust Files
===========

	Before running any tests, be sure to set up the Flash Player trust configuration. Create or edit a file called
	dev.trust.cfg and add a line for the full path to the Mustella tests directory according to your platform. This will make the Flash
	Player trust all SWFs in that directory structure.

	Mac OS X location: /Library/Application Support/Macromedia/FlashPlayerTrust

		example: /Users/YourUser/apache/flex/mustella/tests

	Windows XP location: C:\Documents and Settings\YourUser\Application Data\Macromedia\Flash Player\#Security\FlashPlayerTrust

		example: c:\apache\flex\mustella\tests
	
	Windows 7 location: C:\Users\YourUser\AppData\Roaming\Macromedia\Flash Player\#Security\FlashPlayerTrust

		example: c:\cygwin\home\YourAccount\apache\flex\mustella\tests

Basic Commands
==============

	Run Mustella tests from the mustella directory using the mini_run.sh script. Windows users must use a 
	Unix-compatible shell application. The mini_run.sh script produces console output, results.txt (for the list of tests that
	pass), and failures.txt (for the list of tests that fail); but passes and failures are also reported on the console log.

		./mini_run.sh -all

	This command will run all of the tests.

		./mini_run.sh -failures

	This command will run all of the tests reported in failures.txt; tests that fail will 'timed out' will not be re-run, however.

		./mini_run.sh tests/components/Label

	This command will run just the tests in the components/Label test directory.

		./mini_run.sh -caseName=datagrid_properties_columns_0 tests/components/DataGrid/DataGrid_SparkSkin/Properties/datagrid_properties_columns.mxml

	This command runs a specific test case from a specific test file.