arXiv · 2609.31820
Hypothesis-awkward: Property-Based Testing Strategies for Awkward Array
Abstract
Hypothesis-awkward is a collection of Hypothesis strategies for Awkward Array. Awkward Array can represent a wide variety of nested, variable-length, mixed-type data. Many tools that process Awkward Arrays are widely used and actively developed. The unit test cases of many of these tools list predefined input samples. In practice, such samples can cover only a small portion of the vast combinatorial space of Awkward Array instances. Hypothesis, a Python property-based testing library, generates test data that can make test cases fail and automatically explores edge cases. The main strategy of Hypothesis-awkward generates nearly all possible Awkward Arrays, with options to control the layout, data types, missing values, masks, and other array attributes. Property-based tests written with these strategies have begun to run in the continuous integration of Awkward Array; to date, they cover a small part of Awkward Array and have found 37 bugs in it, as well as one in Hypothesis itself. These strategies make the tests of Awkward Array and of the tools that use it more reliable.
Explore related subjects
Keep this discovery
Explore connections, maps & timelines
Tai Sakuma, Ianna Osborne, Peter Elmer. 2026-09-25. Hypothesis-awkward: Property-Based Testing Strategies for Awkward Array. https://arxiv.org/abs/2609.31820
Cite the original work for its findings. Save a collection to share your selection of sources.