NPL's EUnit Test Harness for Microsoft Excel 
---------------------------------------------- 

This file describes the files that constitute release beta 1.3 of 
NPL's EUnit test harness for Microsoft Excel. 

EUnit was developed at NPL by Robin Barker and Graeme Parkin, and 
beta 1.3 was released in 2007. Since release, however, no further 
development of EUnit has taken place. Although it was developed 
for use with earlier versions of Microsoft Excel, it is possible 
to use EUnit in more recent versions such as 2010 and 2013. 
While support for EUnit is limited as its developers no longer work 
at NPL, it remains available for download. 

Release beta 1.3 of EUnit constitutes the following files: 
	readme.txt								this file 
	EUnit.xls								the EUnit test harness modules 
	eunit-manual-appendixB.pdf				the manual for EUnit 
	example.xls								a simple example 
	EUnit_licence_MSC_L_15_009.pdf			software user licence agreement 

The manual for EUnit is Appendix B of 
	Software Support for Metrology Best Practice Guide No. 7 - 
	Development and Testing of Spreadsheet Applications 
	R M Barker, P M Harris and G I Parkin 
	Revised: December 2006 
available from 
	http://www.npl.co.uk/publications/development-and-testing-of-spreadsheet-applications.

[It is possible that an updated version of the above guide will be 
developed.] 

The software is provided with a software licence agreement (REF: MSC/L/15/009) and 
the use of the software is subject to the terms laid out in that agreement. By running 
the software, the user accepts the terms of the agreement. 

Instructions for running the example in example.xls (Microsoft Excel 2010 or 2013) 
---------------------------------------------------------------------------------- 

To run the example in example.xls (a single test of the multiplication of two 
numbers), the software must be unzipped to a local folder and a reference to 
EUnit.xls must be established. 

  1. Open EUnit.xls. If the Security Warning stating that "Macros have been 
     disabled" is displayed, click on "Enable Content". Save the file. 

  2. Open example.xls. If the Security Warning stating that "Macros have been 
     disabled" is displayed, click on "Enable Content". 
	 
  3. Open the Microsoft Visual Basic for Applications editor by pressing 
     Alt-F11. 
	 
  4. Establish a reference to EUnit.xls as follows: 
     - Click on Tools > References... > Browse...,  
     - Navigate to the folder containing EUnit.xls, 
	 - Select "Microsoft Excel Files (*.xlsm,*.xlam,*.xls,*.xla)" from the 
	   "Files of type:" dropdown menu. 
	 - Select EUnit.xls, click on "Open", then click on "OK". 
	 
  5. Open the EUnit GUI as follows: 
     - Click on Tools > Macros..., 
     - Select "Eunit (Eunit.xls)" from the "Macros In:" dropdown menu, 
     - Click on "showallresults", then click on "Run". 
	 
  6. Select test module "Tests" and click on "Run tests". The single test 
     should pass. 

Contact details 
--------------- 
Enquiries about the software should be directed to 

Keith Lines (keith.lines@npl.co.uk) 

or 

Ian Smith (ian.smith@npl.co.uk). 

As noted above, support for EUnit is currently limited. 