HAi SrSSKrSSKJrJrJrJr SSKJr Sr S\ S\ S \ S \ S 3 r "S S 5r \ "S 5r S\\\ \ S4S\\\ \ 44Sjr\\ \ \\\4\\\\4\\4rg)z Representation and utils for ranges of PDF file pages. Copyright (c) 2014, Steve Witham . All rights reserved. This software is available under a BSD license; see https://github.com/py-pdf/pypdf/blob/main/LICENSE N)AnyListTupleUnion) ParseErrorz(0|-?[1-9]\d*)z^(z|(z?(:z?)?)))$c\rSrSrSrS\\S\4SS4Sjr\ S\ S\ 4Sj5r S\4S jr S\4S jrS\4S jrS \S\\\\44S jrS\S\ 4SjrS\4SjrSSjrSrg) PageRangea A slice-like representation of a range of page indices. For example, page numbers, only starting at zero. The syntax is like what you would put between brackets [ ]. The slice is one of the few Python types that can't be subclassed, but this class converts to and from slices, and allows similar use. - PageRange(str) parses a string representing a page range. - PageRange(slice) directly "imports" a slice. - to_slice() gives the equivalent slice. - str() and repr() allow printing. - indices(n) is like slice.indices(n). argreturnNc@[U[5(aXlg[U[5(aUR 5Ulg[U[ 5=(a [ R"[U5nU(d [U5eURS5(a8[URS55nUS:waUS-OSn[X45Ulg[URSSS5Vs/sHoU(a [U5OSPM sn6Ulgs snf)a+ Initialize with either a slice -- giving the equivalent page range, or a PageRange object -- making a copy, or a string like "int", "[int]:[int]" or "[int]:[int]:[int]", where the brackets indicate optional ints. Remember, page indices start with zero. Page range expression examples: : all pages. -1 last page. 22 just the 23rd page. :-1 all but the last page. 0:3 the first three pages. -2 second-to-last page. :3 the first three pages. -2: last two pages. 5: from the sixth page onward. -3:-1 third & second to last. The third, "stride" or "step" number is also recognized. ::2 0 2 4 ... to the end. 3:0:-1 3 2 1 but not 0. 1:10:2 1 3 5 7 9 2::-1 2 1 0. ::-1 all pages in reverse order. Note the difference between this notation and arguments to slice(): slice(3) means the first three pages; PageRange("3") means the range of only the fourth page. However PageRange(slice(3)) means the first three pages. Nr) isinstanceslice_slicer to_slicestrrematch PAGE_RANGE_RErgroupint)selfr mstartstopgs K/var/www/html/land-ocr/venv/lib/python3.13/site-packages/pypdf/pagerange.py__init__PageRange.__init__$s0 c5 ! !K  c9 % %,,.DK  sC ARXXmS%AS/ ! 771:: OE % 519D,DKAqAQ!RAQAA#a&4"7AQ!RSDK!Rs4Dinputc[U[[45=(d; [U[5=(a$ [ [ R "[U55$)z True if input is a valid initializer for a PageRange. Args: input: A possible PageRange string or a PageRange object. Returns: True, if the ``input`` is a valid PageRange. )rrr rboolrrr)r&s r#validPageRange.validOs<%%!34 uc " KtBHH]E,J'K cUR$)z/Return the slice equivalent of this page range.rrs r#rPageRange.to_slice_s {{r+cZURnURcXURb2URURS-:Xa[ UR5$URUR4nO#URURUR4nSR SU55$)zA string like "1:2:3".r:c3@# UHocSO [U5v M g7f)N)r).0is r# $PageRange.__str__..nsEWiSV3Ws)rstepr r!rjoin)rsindicess r#__str__PageRange.__str__cs} KK 66>ww"qvv1'<177|#ggqvvoGggqvvqvv-GxxEWEEEr+c6S[[U55-S-$)z#A string like "PageRange('1:2:3')".z PageRange())reprrr.s r#__repr__PageRange.__repr__psd3t9o-33r+nc8URRU5$)z Assuming a sequence of length n, calculate the start and stop indices, and the stride length of the PageRange. See help(slice.indices). Args: n: the length of the list of pages to choose from. Returns: Arguments for range(). )rr;)rrCs r#r;PageRange.indicests{{""1%%r+otherc`[U[5(dgURUR:H$)NF)rr r)rrFs r#__eq__PageRange.__eq__s%%++{{ell**r+c[URURRURRURR 445$)N)hash __class__rr r!r8r.s r#__hash__PageRange.__hash__s;T^^dkk&7&79I9I4;;K[K[%\]^^r+c [U[5(d[S[U535eURR cURR b [ S5eURRURR4nURRURR4nUSUS:aX2p2USUS:a [ S5e[[US[USUS555$)NzCan't add PageRange and zCan't add PageRange with striderrzCan't add PageRanges with gap) rr TypeErrortyperr8 ValueErrorr r!rmax)rrFabs r#__add__PageRange.__add__s%++6tE{mDE E ;;   '5<<+<+<+H>? ? KK  t{{// / LL   1 1 1 Q4!A$;q Q4!A$;<= =qtS1qt_566r+r-)rFr r r )__name__ __module__ __qualname____firstlineno____doc__rrrr$ staticmethodrr(r)rr<rArrr;objectrHrMrV__static_attributes__r+r#r r s )TE%c"9:)Tt)TV  S  T    % F F4#4&&sC}!5& +F+t+ _#_7r+r r1argsr cX/nSnSn/UQSPHn[RU5(a7U(d [S5eUceURU[U545 SnMTU(aU(dURU[45 [ U[5(aU5eUnSnM U$)a Given a list of filenames and page ranges, return a list of (filename, page_range) pairs. Args: args: A list where the first element is a filename. The other elements are filenames, page-range expressions, slice objects, or PageRange objects. A filename not followed by a page range indicates all pages of the file. Returns: A list of (filename, page_range) pairs. NFz8The first argument must be a filename, not a page range.T)r r)rRappendPAGE_RANGE_ALLr)rapairs pdf_filenamedid_page_ranger s r#parse_filename_page_rangesrhs*,E%)LN}t} ??3   N? "? LL, #7 8!NN lN;<!#y11 63 61L"N#$ Lr+)r\rtypingrrrrerrorsr_INT_RErr rdrrhr PageRangeSpecr`r+r#rms ** WIRyG9CyH H7H7V3$ uS)T)* +$ %Y  $Nc9eCHouS#s]7KTRUYVW r+