Method sort

src/licensedcode/spans.py:235–260

Return a new sorted sequence of spans given a sequence of spans. The primary sort is on start. The secondary sort is on length. If two spans have the same start, the longer span will sort first. For example: >>> spans = [Span([5, 6, 7, 8, 9, 10]), Span([1, 2

(cls, spans)

    @classmethod
    def sort(cls, spans):
        """
        Return a new sorted sequence of spans given a sequence of spans.
        The primary sort is on start. The secondary sort is on length.
        If two spans have the same start, the longer span will sort first.

        For example:
        >>> spans = [Span([5, 6, 7, 8, 9, 10]), Span([1, 2]), Span([3, 4, 5]), Span([3, 4, 5, 6]), Span([8, 9, 10])]
        >>> Span.sort(spans)
        [Span(1, 2), Span(3, 6), Span(3, 5), Span(5, 10), Span(8, 10)]

        >>> spans = [Span([1, 2]), Span([3, 4, 5]), Span([3, 4, 5, 6]), Span([8, 9, 10])]
        >>> Span.sort(spans)
        [Span(1, 2), Span(3, 6), Span(3, 5), Span(8, 10)]

        >>> spans = [Span([1, 2]), Span([4, 5]), Span([7, 8]), Span([11, 12])]
        >>> Span.sort(spans)
        [Span(1, 2), Span(4, 5), Span(7, 8), Span(11, 12)]

        >>> spans = [Span([1, 2]), Span([7, 8]), Span([5, 6]), Span([12, 13])]
        >>> Span.sort(spans)
        [Span(1, 2), Span(5, 6), Span(7, 8), Span(12, 13)]

        """
        key = lambda s: (s.start, -len(s),)
        return sorted(spans, key=key)

    def magnitude(self):
        """