nest_expect: Extract and Structure Expectations from Parsed Test Blocks

In test.assessr: Assessing Package Test Reliability and Quality

Extract and Structure Expectations from Parsed Test Blocks

Description

This internal helper takes a list of parsed test blocks (as produced by nest_test()) and extracts expectation calls from each block using get_expect(). It then assembles all detected expectations into a structured data frame that associates each expectation with its corresponding test label.

Usage

nest_expect(x)

Arguments

x	A named list of parsed test blocks, typically produced by nest_test(). Each element should contain parse data suitable for expectation extraction via get_expect().

Details

For each block in x, the function:

• calls get_expect() to extract expectation function calls and their line ranges,

• removes blocks with no expectations,

• attaches a test label using the block's list name, and

• binds all expectation results into a single consolidated data frame.

If no expectations are found in any block, the function returns NULL.

Value

A data.frame in which each row corresponds to an expectation extracted from the supplied test blocks. Typical columns include:

expectation

Name of the expectation function (e.g., "expect_equal").

line1

Starting line number of the expectation expression.

line2

Ending line number of the expectation expression.

test

Label identifying the test block the expectation belongs to.

Returns NULL if no expectations are detected.

test.assessr documentation built on March 3, 2026, 1:06 a.m.