xUnitRevit: a test runner for Revit

xUnitRevit: a test runner for Revit

Unit tests are one of those things in life that you try avoid as long as you can but, eventuality, you surrender to and start to accept.

Written by Matteo Cominetti on

Unit tests are one of those things in life that you try to avoid for as long as you can but, eventually, you surrender to and start to accept. With the release of Speckle 2.0 we're aiming at >90% test coverage, and we are doing everything we can to get there. This is why we developed a set of open source tools to help us run unit tests inside Revit.

Prior beginning this effort we did a preliminary search and found a couple of existing solutions:

These either weren't really fit for our needs or hadn't been updated in a very long time, so we decided to develop our own. So here it is, we're pleased to announce:

xUnitRevit

an xUnit runner for Revit. This little tool has been invaluable for us as we are currently developing the Revit connector for Speckle 2.0, it lets us test conversion routines to and from Speckkle in a breeze. We hope you can find it useful too!

xunit2

The runner is made up by three parts:

WPF xUnit runner: speckle.xunit.runner.wpf

In order to run, manage and visually explore tests we needed an xUnit runner with some sort of UI that could be displayed in Revit. We came across an existing effort xunit.runner.wpf, but since out of the box it didn't work when loaded inside of Revit we had to fork it and tweak it to load assemblies via reflection.

Our fork is hosted at speckle.xunit.runner.wpf.

We also made it into a NuGet package you can easily reference and use to develop xUnit runners for other host applications:

Revit Addin: xUnitRevit

We then made a simple Revit addin that references speckle.xunit.runner.wpf and exposes its WPF interface form within Revit: xUnitRevit

The addin has already been configured to have build configurations for Revit 2019, 2020 and 2021, so you can just clone the repo and click debug/build to test it.

More info on how to use it in the project readme.

Utility library: xUnitRevitUtils

This is a very simple class library that contains methods and data structures to help you access Revit data and methods from your tests. For instance you can use it to trigger opening and closing of files, retrieving the Revit Document, running transactions etc...

This library is part of the xUnitRevit project and can be referenced via NuGet for the latest Revit versions:

More on how to use it on its readme file.

Getting started

To get started please visit the xUnitRevit repo and read the docs! There are very few steps required to create your first unit tests:

Sample Tests Library

To help you get started even faster, we've also made a sample test library. Check it out!

Feeback or comments? We'd love to hear from you in our community forum!

logo
Speckle

The world runs on 3D: Speckle enables you to deliver better designs, together.

© Aec Systems Ltd. Speckle and Speckle Systems are trademarks of AEC Systems Ltd., registered in the UK and in other countries. Company No. 12403784.

Terms of service | Privacy policy