apisum

Documentation

Overview

apisum parses and aggregates Go SIMD vector and mask type signatures from an internal Go SIMD architecture package (such as archsimd).

The program operates in four main phases:

1. AST Parsing: Reads exportable functions and methods into MethodMeta metadata structs.
2. Classification: Categorizes rows into logical groupings (e.g., Mask, Crypto, Numeric conversion).
3. Normalization: Discovers equivalence classes across methods by canonicalizing identifiers, types, and lane counts (accounting for 128-bit hardware limits). AST nodes are safely cloned during this process to guarantee non-destructive iteration.
4. Aggregation & Output: Sorts deduplicated rows and renders formatted Markdown implementation tables complete with hardware-caveat footnotes.