Crate nitrokey_test[][src]

A crate providing supporting testing infrastructure for the nitrokey crate and its users.

The crate simplifies test creation by providing an attribute macro that generates code for running a test on up to three devices ( Nitrokey Pro, Nitrokey Storage, and Librem Key), takes care of serializing all tests tagged with this attribute, and causes them to be skipped if the respective device is not present.

It also provides support for running tests belonging to a certain group. There are four groups: “nodev” (representing tests that run when no device is present), “librem” (comprised of all tests that can run on the Librem Key), “pro” (encompassing tests eligible to run on the Nitrokey Pro), and “storage” (for tests running against a Nitrokey Storage device). Running tests of a specific group (and only those) can be accomplished by setting the NITROKEY_TEST_GROUP environment variable to the group of interest. Note that in this mode tests will fail if the respective device is not present.

Right now we make a few simplifying assumptions that, although not changing what can be expressed and tested, can lead to unexpected error messages when not known:

  • the parameter has to be an owned object, not a reference
  • parameter types are pattern matched against “Storage”, “Pro”, and “DeviceWrapper”; that means use ... as declarations will not work properly

Attribute Macros


A procedural macro for the test attribute.