bvisin / rooibos

simple, flexible, fun brightscript test framework for roku scenegraph apps

Simple, mocha-inspired, flexible, fun Brightscript test framework for ROKU apps

Links

• Documentation
• API Documentaiton
• Release notes / History / Changes
• Roku dev forum topic
• Roku developer slack group
• Issue tracker
• Roadmap

Development

Rooibos is an independent open-source project, maintained exclusively by volunteers.

You might want to help! Get in touch via the slack group, or raise issues.

Thanks

Rooibos was hacked together from the official roku unit testing framework. I'd like to say a big thank you to the guys at roku who gave me permission to build upon their work. The original framework can be found here : https://github.com/rokudev/unit-testing-framework

Also thanks to the guys who made and maintain mochaJs, on which many of my changes are based upon, as well as the structure of the documentation.

FAQ

Is Rooibos ready for production use?

Rooibos has so far been used on a couple of production projects, running CI with over 800 tests between them. It does however, use the same test running mechanism of the official roku unit testing framework, which has been in circulation for several years.

Is Rooibos actively maintained?

I am actively invovled in Rooibos's development, and add more features and fixes on a weekly basis. You can expect rapid responses to issues.

Why did you not just merge back your changes to roku's unit testing framework

1. It does rewrite quite a lot of the original unit test framework code, so I doubt that roku would've merged it all back any time soon
2. It's conceptually entirely different: e.g. using annotations instead of naming conventions and boiler-plate code, completely different test reporting output, assertions and test cases maintain their own state, runs in a scenegraph scene, to name but a few
3. It has many more features than the original framework, not limited to : node specific assertions, exact assertion line failure reporting, better error messaging, easier setup, groupings, only and ignore for tests, mocks and stubs, etc, etc
4. Being completely frank, I enjoy roku work and want to do more of it, so it's useful to me to own this project, rather than lose control and wait on other's to merge my changes. On that note, email me at george[AT]tantawowa.com, or pm me (georgejecook) on the roku slack group to discuss any roku development requirements
5. I poured a lot of work into the project (> 100 hours and counting), and expect to continue to do so. If I own the project, then I can do what I want, when I want. That goes for you guys as well, so get in touch with feature requests and PR's :)

Is Rooibos itself unit tested?

At this point, no. It is on the roadmap though!