Struct TestCase

pub struct TestCase { /* private fields */ }

A test case. A test case consists of a set of named attributes. Every attribute in the test case must be consumed exactly once; this helps catch typos and omissions.

Requires the alloc default feature to be enabled.

Implementations

impl TestCase

pub fn consume_bool(&mut self, key: &str) -> bool

Maps the string “true” to true and the string “false” to false.

pub fn consume_digest_alg(&mut self, key: &str) -> Option<&'static Algorithm>

Maps the strings “SHA1”, “SHA256”, “SHA384”, and “SHA512” to digest algorithms, maps “SHA224” to None, and panics on other (erroneous) inputs. “SHA224” is mapped to None because ring intentionally does not support SHA224, but we need to consume test vectors from NIST that have SHA224 vectors in them.

pub fn consume_bytes(&mut self, key: &str) -> Vec<u8>

Returns the value of an attribute that is encoded as a sequence of an even number of hex digits, or as a double-quoted UTF-8 string. The empty (zero-length) value is represented as “”.

pub fn consume_optional_bytes(&mut self, key: &str) -> Option<Vec<u8>>

Like consume_bytes() except it returns None if the test case doesn’t have the attribute.

pub fn consume_usize(&mut self, key: &str) -> usize

Returns the value of an attribute that is an integer, in decimal notation.

pub fn consume_usize_bits(&mut self, key: &str) -> BitLength

Returns the value of an attribute that is an integer, in decimal notation, as a bit length.

pub fn consume_string(&mut self, key: &str) -> String

Returns the raw value of an attribute, without any unquoting or other interpretation.

pub fn consume_optional_string(&mut self, key: &str) -> Option<String>

Like consume_string() except it returns None if the test case doesn’t have the attribute.

Trait Implementations

impl Debug for TestCase

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.