Module

analysis.results

Result dataclasses for graph analysis operations.

Replaces complex tuple return values with typed dataclasses for better type safety, readability, and IDE support.

All dataclasses support backward compatibility via iter() methods for tuple unpacking.

See Also:

  • plan/active/rfc-dataclass-improvements.md - Design rationale
View source
1 Class

Classes

PageLayers dataclass
Page layers partitioned by connectivity for streaming builds. Pages are partitioned into three lay…
1

Page layers partitioned by connectivity for streaming builds.

Pages are partitioned into three layers based on their connectivity scores to enable hub-first streaming builds:

  • Hubs: High connectivity pages (top 10%) - process first, keep in memory
  • Mid-tier: Medium connectivity pages (next 30%) - batch processing
  • Leaves: Low connectivity pages (remaining 60%) - stream and release

Attributes

Name Type Description
hubs list[Page]

High connectivity pages (top 10% by connectivity score)
mid_tier list[Page]

Medium connectivity pages (next 30%)
leaves list[Page]

Low connectivity pages (remaining 60%)
Internal Methods 1
__iter__
Allow tuple unpacking for backward compatibility.
0 None 
def __iter__(self)

Allow tuple unpacking for backward compatibility.