Unit testing approach for nginx modules

Yichun Zhang (agentzh) agentzh at gmail.com
Tue Nov 24 14:10:31 UTC 2015


On Sun, Nov 22, 2015 at 5:40 AM, Ritesh Jha <ritesh.jha at hotmail.com> wrote:
> Hello everyone,
> We are developing nginx modules to implement few usecases in our product.
> Most of the other usecases cases have been implemented using Java. At my
> office we follow TDD for Java development. TDD for Java development is easy
> due to availability of unit-testing and mocking frameworks. We are wondering
> if we can follow TDD for development of nginx modules as well. We have tried
> couple of unit-testing frameworks for C (Unity and CMocka) but we have found
> it very difficult to write useful testcases using these frameworks.
> Can you please suggest a suitable approach? Also if unit testing is not the
> way to go, then what should be the approach for developing, testing and
> maintaining large nginx modules?

I've been using my Test::Nginx module on CPAN for all my nginx
modules' test suite for years:


We've also been using subclasses of this test framework to drive
CloudFlare's Lua business systems' test suites :)

Almost all the test suites of the NGINX components listed in the
following page for my Amazon EC2 test cluster's test report are driven
by Test::Nginx:


All these opensource modules' test suites can serve as live examples.

Oh yeah, we definitely need more hands-on tutorials to explain all the
powerful features of this test framework. I'll write up something soon

Best regards,

More information about the nginx-devel mailing list