Crate nom_test_helpers

Macros for testing nom parsers

Often when I’m testing nom parsers, I end up defining a lot of little macros like this, so I thought I would bundle them all up into a crate so I didn’t have to define them over and over.

This crate was first created back when nom had the concept of “Done” vs “Finished”, which might seem a little out of place now but I still find it useful when testing. Basically, macros that test for “Done” check that the parser completed successfully, while macros that test for “Finished” check that the parser completed successfully while also asserting that the input is empty.

Modules

prelude

Instead of importing the helper macros individually, this can be star-imported to get all of them

Macros

assert_done

This macro checks to make sure that the IResult it is passed is Done. That is, it checks that the parser completed successfully but doesn’t make any assumptions about the remaining input.

assert_done_and_eq

This checks that the IResult is Done, and lets you check that the value returned as the O type of the IResult is equal to the second parameter

assert_error

This asserts that the IResult is an Err

assert_error_and_eq

This asserts that the IResult is an Err and that the error is what is expected

assert_finished

This does the same thing as assert_done!, except that this also asserts that the input slice is empty

assert_finished_and_eq

Same as assert_done_and_eq!, but asserts that the input slice is empty

assert_needed

This asserts that the IResult is an Incomplete

assert_needs

This lets the user specify how much input the parser should need