)g2SSKrSSKrSSKrSSKJrJrJr \(a SSKJr SSKJ r 0r \RS:aS\ S'\R"SSS0\ D6"S S 55r \R"SSS0\ D6"S S 55r\ "SS5r\ "SS 5r\ "S S5r\R%\\5r\R%\\5r"SS5rg)N)Optional TYPE_CHECKINGIterable)Self) Deb822Element) TslotsfrozencT\rSrSr%Sr\\S'\\S'\S\4Sj5rS Sjr Sr g ) PositionzDescribes a "cursor" position inside a file It consists of a line position (0-based line number) and a cursor position. This is modelled after the "Position" in Language Server Protocol (LSP). line_positioncursor_positionreturnc URS-$)z'The line number as human would count it)rselfs @/usr/lib/python3/dist-packages/debian/_deb822_repro/locatable.py line_numberPosition.line_number's!!A%%cXURS:XaURS:XaU$URS:XaURS:XaU$URS:Xa&URnURUR-nO%URUR-nURn[UU5$)amOffsets the position relative to another position This is useful to avoid the `position_in_file()` method by caching where the parents position and then for its children you use `range_in_parent()` plus `relative_to()` to rebase the range. >>> parent: Locatable = ... # doctest: +SKIP >>> children: Iterable[Locatable] = ... # doctest: +SKIP >>> # This will expensive >>> parent_pos = parent.position_in_file() # doctest: +SKIP >>> for child in children: # doctest: +SKIP ... child_pos = child.position_in_parent() ... # Avoid a position_in_file() for each child ... child_pos_in_file = child_pos.relative_to(parent_pos) ... ... # Use the child_pos_in_file for something :param new_base: The position that should have been the origin rather than (0, 0). :returns: The range offset relative to the base position. r)rrr )rnew_baserline_char_offsets r relative_toPosition.relative_to,s*    "t';';q'@O  ! !Q &8+C+Cq+HK    ""00K'77$:N:NN ,,x/E/EEK#33     rN)rr rr ) __name__ __module__ __qualname____firstlineno____doc__int__annotations__propertyrr__static_attributes__rrrr r sA  &S&&" rr cX\rSrSr%Sr\\S'\\S'\S\4Sj5r \S\4Sj5r \S\4Sj5r \S\4S j5r \S\4S j5r \S\4S j5r\S\4S j5r\S \S\SS4Sj5rS\SS4SjrSSjr\S\SSSS4Sj5r\S\S\SSS4Sj5rSrg)RangeQaDescribes a range inside a file This can be useful to describe things like "from line 4, cursor position 2 to line 7 to cursor position 10". When describing a full line including the newline, use line N, cursor position 0 to line N+1. cursor position 0. It is also used to denote the size of objects (in that case, the start position is set to START_POSITION as a convention if the precise location is not specified). This is modelled after the "Range" in Language Server Protocol (LSP). start_posend_posrc.URR$)z{Describes the start line position as a 0-based line number See start_line_number if you want a human-readable line number )r,rrs rstart_line_positionRange.start_line_positionbs ~~+++rc.URR$)zDescribes the starting cursor position When this value is 0, the position is at the start of a line. When it is 1, then the position is between the first and the second character (etc.). )r,rrs rstart_cursor_positionRange.start_cursor_positionjs~~---rc.URR$)z-The start line number as human would count it)r,rrs rstart_line_numberRange.start_line_numberss~~)))rc.URR$)zwDescribes the end line position as a 0-based line number See end_line_number if you want a human-readable line number )r-rrs rend_line_positionRange.end_line_positionxs ||)))rc.URR$)z+The end line number as human would count it)r-rrs rend_line_numberRange.end_line_numbers||'''rc.URR$)zDescribes the end cursor position When this value is 0, the position is at the start of a line. When it is 1, then the position is between the first and the second character (etc.). )r-rrs rend_cursor_positionRange.end_cursor_positions||+++rc4URUR- $)ziThe number of lines (newlines) spanned by this range. Will be zero when the range fits inside one line. )r8r/rs r line_countRange.line_counts %%(@(@@@rabrcURUR:d4URUR:XaURUR:aX!p!U"UU5$)aNComputes the range between two positions Unlike the constructor, this will always create a "positive" range. That is, the "earliest" position will always be the start position regardless of the order they were passed to `between`. When using the Range constructor, you have freedom to do "inverse" ranges in case that is ever useful )rr)clsrCrDs rbetween Range.betweensO ??Q__ , OOq .13D3DqGXGX3Xq   rrcU[:XaU$[URRU5URRU55$)aoOffsets the range relative to another position This is useful to avoid the `position_in_file()` method by caching where the parents position and then for its children you use `range_in_parent()` plus `relative_to()` to rebase the range. >>> parent: Locatable = ... # doctest: +SKIP >>> children: Iterable[Locatable] = ... # doctest: +SKIP >>> # This will expensive >>> parent_pos = parent.position_in_file() # doctest: +SKIP >>> for child in children: # doctest: +SKIP ... child_range = child.range_in_parent() ... # Avoid a position_in_file() for each child ... child_range_in_file = child_range.relative_to(parent_pos) ... ... # Use the child_range_in_file for something :param new_base: The position that should have been the origin rather than (0, 0). :returns: The range offset relative to the base position. )START_POSITIONr*r,rr-)rrs rrRange.relative_tosB* ~ %K NN & &x 0 LL $ $X .  rcUR[:XaU$URnU(a URnOURUR- nUn[ [[ UU55$)aReduces the range to a "size" The returned range will always have its start position to (0, 0) and its end position shifted accordingly if it was not already based at (0, 0). The original range is not mutated and, if it is already at (0, 0), the method will just return it as-is. )r,rJrAr>r2r*r )rrAnew_end_cursor_positiondeltas ras_size Range.as_sizesg >>^ +K__ &*&>&> #,,t/I/IIE&+ #  '   rbasesizecURnURnUR5nURnU(aX6- nURnOURUR - nXG- nU"U[ UU55$)aCompute a range from a position and the size of another range This provides you with a range starting at the base position that has the same effective span as the size parameter. :param base: The desired starting position :param size: A range, which will be used as a size (that is, it will be reduced to a size via the `as_size()` method) for the resulting range :returns: A range at the provided base position that has the size of the provided range. rrrOrAr>r2r )rFrQrRrr size_rebasedlinesrNs rfrom_position_and_sizeRange.from_position_and_sizes** ..||~ ''   "M*>>O 44|7Y7YYE  $O     rsizescURnURnUHUnUR5nURnU(aX7- nURnM8URUR - nXH- nMW U"U[ UU55$)aCompute a range from a position and the size of number of ranges :param base: The desired starting position :param sizes: All the ranges that combined makes up the size of the desired position. Note that order can affect the end result. Particularly the end character offset gets reset every time a size spans a line. :returns: A range at the provided base position that has the size of the provided range. rT) rFrQrYrrrRrUrVrNs rfrom_position_and_sizesRange.from_position_and_sizess** ..D<<>L ++E& "."B"B$88<;];]](     rrN)rr*)r r!r"r#r$r r&r'r%r/r2r5r8r;r>rA classmethodrGrrOrWrr[r(rrrr*r*Qsl   ,S,,.s..*3***3**(((,S,,ACAA  X &  $ H  8 4 ( ' f  > 8 HWUTL$rar)xrs r.Locatable.position_in_parent..7s q}rc3@# UHoR5v M g7fra)rR).0rhs r /Locatable.position_in_parent..:s .~!VVXX~s) rd TypeError itertools takewhile iter_partsr*r[rJr-)rparentrelevant_partsspans` rposition_in_parentLocatable.position_in_parent-sd$$ >XY Y",,-DfFWFWFYZ,,  .~ . ||rcjUR5n[RUUR55$)zThe range of this token/element inside its parent This is operation is generally linear to the number of "parts" (elements/tokens) inside the parent. )rvr*rWrR)rposs rrange_in_parentLocatable.range_in_parent>s1 %%'++  IIK  rcUR5nURnUb!UR5nURU5nU$)aDThe start position of this token/element in this file This is an *expensive* operation and in many cases have to traverse the entire file structure to answer the query. Consider whether you can maintain the parent's position and then use `position_in_parent()` combined with `child_position.relative_to(parent_position)` )rvrdposition_in_filer)rpositionrsparent_positions rr}Locatable.position_in_fileJsF**,$$  $557O++Ors 44:w*.g& @d@&?@9 9 A9 x @d@&?@I I AI X!Q1a.1a.~?~?8"8"r