The best way to document this fact is to make SearchResults inherit from one of the abstract base classes in the collections module. You should choose the minimal one that provides the desired functionality. It looks to me like nothing is used except getting the length and iteration, so Sequence seems appropriate.