The files in this repository contain the script files required to run regression tests on RGP/JW Lua. The tests report issues found on the running RGP/JW Lua and Finale versions. Testing on this level is performed to make sure that RGP/JW Lua actually behaves the way it is meant to behave.

The following tests are performed.

• The existence of the constant.
• The value of the constant.

• The property exists in Lua.
• The property also has a getter and setter method available in Lua.
• The property returns the expected Lua type.
• The property can be loaded, set and saved correctly in Finale.

• Properties are checked against actual values in the test template.

• Functions in embedded version of luaosutils.
• Math functions, mainly to compare responses from a new embedded version of Lua.
• Embedded library tests, including bit32, cjson, utf8, and tinyxml2.
• Ability to execute scripts and get return values using FCLuaScriptItem.
• Ability to load an external C library.
• Other miscellaneous internal health tests.

This is useful for testing if a new version of Finale has added unlinkable data entities.

• Properties are tested to see if editing them in the part unlinks them from the score.
• If an older version of Finale does not support unlinking a particular property, that unlinkable test is skipped.
• These tests also exercise the tested properties in a manner similar to the file-specific tests.

1. Put all the files in a folder, making sure the subfolders are extracted.
2. In JW Lua, open the Preferences dialog box (by clicking on the "..." button) and add the folder to the "require" paths. (This step is not necessary for RGP Lua.)
3. In RGP Lua, add the folder to the RGP Lua configuration or load and run the top-level script(s) from the RGP Lua Console. (In JW Lua you can load and run scripts directly from the JW Lua dialog.)

1. Set up ZeroBrane Studio according to the instructions here.
2. Open the folder as a project in ZeroBrane Studio.
3. Start the debugger server by selecting Project->Start Debugger Server.
4. In Finale, open the test file, testtemplate/testtemplate-fin2011format.musx.
5. Run test script. Output appears in the Output window of ZeroBrane Studio.

1. In Finale, open the test file, testtemplate/testtemplate-fin2011format.musx.
2. Open the JW Lua dialog (JW Lua) or the RGP Lua Console (RGP Lua).
3. If using JW Lua, select the Development tab.
4. Open the test script file you wish to run.
5. Select the Run Script button. Output appears in the console window.

Note that with the current version of jwluatesttools, JW Lua generates several hundred errors, since JW Lua has not been updated since 2017. The latest version of RGP Lua should generate no errors.

The following scripts each provide a report as described.

The following scripts in the creation_tools directory create “skeleton” code for a PDK Framework Lua class as described. The skeleton code is put on the clipboard where it can be pasted to another document. Except as noted, these scripts can run on either JW Lua or RGP Lua. For example, create_object_reflection.lua was run in JW Lua to create the Lua framework code for RGP Lua. (But now RGP Lua returns more complete results.)