1
0
mirror of https://github.com/fadden/6502bench.git synced 2024-10-31 19:04:44 +00:00
6502bench/SourceGen/SGTestData
Andy McFadden e9fbc6c96c Change Merlin 32 output suffix
We append an assembler identifier to generated code.  For Merlin 32,
this was "_Merlin32".  All of the other assemblers use a lower-case
string, which makes Merlin look a little weird, so it has been
changed to "_merlin32".

Windows filesystems are generally case-insensitive, so this won't
likely affect anything.
2020-10-18 15:47:11 -07:00
..
Expected Change Merlin 32 output suffix 2020-10-18 15:47:11 -07:00
FunkyProjects Initial file commit 2018-09-28 10:05:11 -07:00
Source Rename test 10042 2020-10-18 09:16:50 -07:00
Visualization Switch to left-handed coordinate system 2020-03-14 13:59:08 -07:00
10000-allops-value-6502 Regression test rework, part 1 2020-06-06 14:47:19 -07:00
10001-allops-value-65C02 Regression test rework, part 1 2020-06-06 14:47:19 -07:00
10002-allops-value-65816 Regression test rework, part 1 2020-06-06 14:47:19 -07:00
10003-allops-value-W65C02 Add W65C02S support, part 3 2020-10-11 14:35:17 -07:00
10010-allops-zero-6502 Regression test rework, part 1 2020-06-06 14:47:19 -07:00
10011-allops-zero-65C02 Regression test rework, part 1 2020-06-06 14:47:19 -07:00
10012-allops-zero-65816 Regression test rework, part 1 2020-06-06 14:47:19 -07:00
10013-allops-zero-W65C02 Add W65C02S support, part 3 2020-10-11 14:35:17 -07:00
10022-embedded-instructions Regression test rework, part 1 2020-06-06 14:47:19 -07:00
10032-flags-and-branches Regression test rework, part 1 2020-06-06 14:47:19 -07:00
10040-data-recognition Rename test 10042 2020-10-18 09:16:50 -07:00
20000-numeric-types Regression test rework, part 1 2020-06-06 14:47:19 -07:00
20000-numeric-types.cs Regression test rework, part 1 2020-06-06 14:47:19 -07:00
20000-numeric-types.dis65 Regression test rework, part 1 2020-06-06 14:47:19 -07:00
20010-string-types Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20010-string-types.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20020-operand-formats Split 2002x-operand-formats test 2020-06-08 17:47:26 -07:00
20020-operand-formats.dis65 Split 2002x-operand-formats test 2020-06-08 17:47:26 -07:00
20022-operand-formats Split 2002x-operand-formats test 2020-06-08 17:47:26 -07:00
20022-operand-formats.dis65 Split 2002x-operand-formats test 2020-06-08 17:47:26 -07:00
20030-labels-and-symbols Regression test rework, part 3 2020-06-06 17:06:31 -07:00
20030-labels-and-symbols.dis65 Regression test rework, part 3 2020-06-06 17:06:31 -07:00
20030-labels-and-symbols.sym65 Regression test rework, part 3 2020-06-06 17:06:31 -07:00
20032-labels-and-symbols Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20032-labels-and-symbols.dis65 Data Bank Register management, part 6 (of 6) 2020-07-10 15:53:43 -07:00
20040-address-changes Improve handling of C64 PRG header 2020-10-17 16:45:13 -07:00
20040-address-changes.dis65 Improve handling of C64 PRG header 2020-10-17 16:45:13 -07:00
20042-address-changes Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20042-address-changes.dis65 Improve handling of C64 PRG header 2020-10-17 16:45:13 -07:00
20050-branches-and-banks Regression test rework, part 4 2020-06-06 17:30:50 -07:00
20050-branches-and-banks.dis65 Regression test rework, part 4 2020-06-06 17:30:50 -07:00
20050-branches-and-banks.sym65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20052-branches-and-banks Change PLP handling 2020-07-20 11:54:00 -07:00
20052-branches-and-banks.dis65 Change PLP handling 2020-07-20 11:54:00 -07:00
20062-target-adjustment Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20062-target-adjustment.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20070-hinting Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20070-hinting.cs Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20070-hinting.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20081-label-localizer Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20081-label-localizer.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20090-notes-and-comments Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20090-notes-and-comments.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20102-label-dp Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20102-label-dp.dis65 Rename test 10042 2020-10-18 09:16:50 -07:00
20110-64k-nops Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20110-64k-nops.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20122-char-encoding-a Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20122-char-encoding-a.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20132-char-encoding-p Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20132-char-encoding-p.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20142-char-encoding-s Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20142-char-encoding-s.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20152-local-variables Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20152-local-variables.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20162-cycle-counts-65816 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20162-cycle-counts-65816.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20170-external-symbols Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20170-external-symbols-1.sym65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20170-external-symbols-2.sym65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20170-external-symbols-3.sym65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20170-external-symbols.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20180-extension-scripts-a.cs Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20180-extension-scripts-b.cs Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20180-extension-scripts.sym65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20182-extension-scripts Mark flags as indeterminate for inline BRK 2020-08-22 08:56:38 -07:00
20182-extension-scripts.dis65 Mark flags as indeterminate for inline BRK 2020-08-22 08:56:38 -07:00
20190-non-unique-labels Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20190-non-unique-labels.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20200-ui-edge-cases Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20200-ui-edge-cases.dis65 Regression test rework, part 2 2020-06-06 15:36:08 -07:00
20212-reloc-data Update relocation data handling 2020-07-10 17:41:38 -07:00
20212-reloc-data.dis65 Add two options to OMF converter 2020-07-20 13:50:49 -07:00
20222-data-bank Data Bank Register management, part 6 (of 6) 2020-07-10 15:53:43 -07:00
20222-data-bank.dis65 Data Bank Register management, part 6 (of 6) 2020-07-10 15:53:43 -07:00
20233-rockwell Add W65C02S support, part 4 (of 4) 2020-10-11 18:43:00 -07:00
20233-rockwell.dis65 Add W65C02S support, part 4 (of 4) 2020-10-11 18:43:00 -07:00
README.md Add W65C02S support, part 3 2020-10-11 14:35:17 -07:00

SourceGen Test Data

This directory contains various regression tests.

NOTE: some tests may fail if you use a version of the assembler that is different from the one used to generate the expected output. The current set was generated for:

  • 64tass v1.53.1515
  • ACME v0.96.4
  • cc65 v2.18
  • Merlin 32 v1.0

Generator/Assembler Tests

Files with names like "10000-nifty-test" are regression test data files for the code generator. The test harness identifies them by filename pattern: five digits, a hyphen, then one or more alphanumeric and hyphens. Files with a '.' or '_' are ignored.

If the leading number is between 10000 and 19999, inclusive, the test file will be loaded as a new project. A load address of $1000 is assumed. The CPU type is determined by the last digit: 0 for 6502, 1 for 65C02, 2 for 65816, and 3 for W65C02. Undocumented opcodes are enabled. As with all new projects, the first byte will be hinted as a code entry point. The entry flags are currently set to emulation mode, but tests should not rely on that.

If the leading number is 20000 or greater, the test file will be loaded as a saved project. A file with the same name plus a ".dis65" extension will be opened as the project file.

Execution

With debug features enabled, you can open the test runner from the menu with Debug > Source Generation Tests. Click "Run Test" to run all tests.

For each test, the test harness will create a new project or open the project file. For every known assembler, the test harness will generate source code, and compare it to the corresponding entry in the Expected directory. If they don't match exactly, a failure is reported for the generation phase. (These are text files, so the line terminators are not required to match.) Next, the generated sources are fed to the appropriate cross-assembler, whether or not the sources matched expectations. If the assembler reports success, the output file is compared to the original data file. If these match, success is reported for the assembly phase.

The top window in the test harness shows a summary of success or failure. The bottom window shows details reported for each individual test. Use the drop list to select which test is shown.

The generated sources and assembled output is placed into a temporary directory inside SGTestData that is named after the test. For example, test 10000-allops-value-6502 will have all of its generated output in a directory called "tmp10000". If all parts of the test are successful, the directory will be removed. If generation or assembly fails, or if you check the "retain output" box in the test harness, the directory and its contents will remain. This allows you to examine the outputs when investigating failures.

As a safety measure, the directory will NOT be removed if it contains files that the test harness doesn't recognize.

Updating Tests

If you want to add or update a test, follow these steps:

  1. Make the changes to the test data file and test project file.
  2. Run the test harness. The generation test will fail and leave output in the tmpNNNNN directory. Make sure the assembly test is succeeding.
  3. After verifying that the generated sources look correct, copy them into the Expected directory, replacing any existing copies.
  4. Run the test harness. This should now report success, and will remove the tmpNNNNN directory.

Be sure to have the version of the cross-assembler identified at the top of this document configured.

Other Notes

The original source code used to generate the test cases can be found in the Source directory. The test harness does not use these files. If you want to update a test file, you will need to run the assembler yourself. The assembler used is noted in a comment at the top of the file.

The code is not required to do anything useful. Many of the test cases would crash or hang if executed.

FunkyProjects

This is a collection of project files with deliberate errors. These exist to exercise the load-time error reporting. See the README in that directory for a full explanation.

Visualization

Some test projects and data files for exercising the visualization generators. Not part of a formal test; load the projects and eyeball the results.