Fallout 4
0 of 0

File information

Last updated

Original upload

Created by

Chesko

Uploaded by

Chesko

Virus scan

Safe to use

About this mod

Lilac is a unit and end-to-end testing framework for Papyrus. It has a simple and direct syntax so that you can easily write tests to increase the quality of your mods.

Permissions and credits
Donations


A Papyrus Testing Framework

Lilac is a unit testing framework for Papyrus. It has a simple and direct syntax so that you can easily write tests to increase the quality of your mods.

It is inspired by Jasmine for Javascript. It is currently available for Skyrim and Fallout 4.

Lilac can be built into your mod and distributed with it. Your tests will only run when you decide to run them; your users will most likely never know they exist.

Documentation

Documentation can be found on the Lilac GitHub Wiki: https://github.com/chesko256/LilacFO4/wiki. If you use Lilac for Skyrim, there are a few minor differences between these two versions, which are detailed in the wiki.


Requirements

There are no special requirements, just the latest version of Fallout 4.


Installation

All of Lilac is contained in a single script file, Lilac.psc. There is no complex set-up or installation.

Download and install the latest release using a mod manager, or just drop Lilac.psc into your Scripts/Source directory. Then, create a new script that extends Lilac and away you go:

scriptname MyTests extends Lilac

Writing Tests

Lilac allows you to write tests in a clear and expressive syntax.

function MonsterSpawnerSuite()

it ( "should spawn monsters", MonsterSpawnerTest() )

endFunction


function MonsterSpawnerTest()

spawner.SpawnMonsters()
expect ( spawner.SpawnedMonsterCount, to, beEqualTo, 20 )
expect ( spawner.LastSpawnedMonster, notTo, beNone )
expect ( spawner.LastSpawnedMonsterType, to, beEqualTo, MegaDragon )

endFunction


Running Tests

Lilac test scripts are attached to quests. To run your tests, just start the quest:

startquest MyTestQuest

The results will be printed to your Papyrus log.

FAQ

An FAQ is available here.

License

Lilac is released under the MIT License.

Contact
Contact Chesko at [email protected]