JՁjp dZddlZddlmZmZmZddlmZdZdeded ed ed Z Gd d Z e d Z de ee e dfde ee e ffdZee e eeefeeeefe efZy)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)AnyOptionalUnion) ParseErrorz(0|-?[1-9]\d*)z^(z|(z?(:z?)?)))$ceZdZdZdeedefddfdZede de fdZ defdZ defd Z defd Zd edeeeeffd Zd ede fdZdefdZddZy) PageRangeaJ 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). argreturnNct|tr||_yt|tr|j |_yt|t xrt jt|}|s t||jdr8t|jd}|dk7r|dznd}t|||_yt|jdddDcgc]}|r t|ndc}|_ycc}w)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 6/tmp/pip-target-jj2dfcxx/lib/python/pypdf/pagerange.py__init__zPageRange.__init__$s0 c5 !DK  c9 %,,.DK  sC ARXXmS%AS/ ! 771: OE % 519Dt,DKAqAQ!RAA#a&4"7!RSDK!RsC;inputct|ttfxs5t|txr#t t j t|S)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!validzPageRange.validOs<%%!34 uc " KtBHH]E,J'K c|jS)z/Return the slice equivalent of this page range.)rrs r!rzPageRange.to_slice_s {{r'cT|j}|jV|j1|j|jdzk(rt |jS|j|jf}n#|j|j|jf}dj d|DS)zA string like "1:2:3".r:c3:K|]}|dn t|yw)N)r).0is r! z$PageRange.__str__..nsEaiSV3Es)rsteprrrjoin)rsindicess r!__str__zPageRange.__str__cs} KK 66>ww"qvv1'<177|#ggqvvoGggqvvqvv-GxxEWEEEr'c6dtt|zdzS)z#A string like "PageRange('1:2:3')".z PageRange())reprrr)s r!__repr__zPageRange.__repr__psd3t9o-33r'nc8|jj|S)a/ 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(). )rr4)rr:s r!r4zPageRange.indicests{{""1%%r'othercVt|tsy|j|jk(S)NF)rr r)rr<s r!__eq__zPageRange.__eq__s"%+{{ell**r'ct|j|jj|jj|jj ffS)N)hash __class__rrrr1r)s r!__hash__zPageRange.__hash__s;T^^dkk&7&79I9I4;;K[K[%\]^^r'ct|tstdt||jj |jj t d|jj|jjf}|jj|jjf}dttdtfd}dttdtfd}||d||dkDr||}}||d||dkDr t d ||d||dkDr|dn|d}tt|d|S) NzCan't add PageRange and zCan't add PageRange with stridevr c | tdS|S)Nz-inffloatrDs r! _start_keyz%PageRange.__add__.._start_keys$%I5= 41 4r'c | tdS|S)NinfrFrHs r! _stop_keyz$PageRange.__add__.._stop_keys#$95< 3! 3r'rrzCan't add PageRanges with gap) rr TypeErrortyperr1 ValueErrorrrrrrGr)rr<abrIrLrs r!__add__zPageRange.__add__s@%+6tE{mDE E ;;   '5<<+<+<+H>? ? KK  t{{// / LL   1 1 1 5(3- 5E 5 4# 45 4 ad j1. .aqA ad i!o -<= = 11Q48qtadqtT*++r')r<r r r )__name__ __module__ __qualname____doc__rrrr" staticmethodrr%r&rr5r9rtupler4objectr>rBrRr'r!r r s )TE%c"9:)Tt)TV  S  T    % F F4#4&&sC}!5& +F+t+ _#_,r'r r+argsr cg}d}d}g|dD]}}tj|r0|s td|J|j|t|fd}H|r|s|j|tft |trJ||}d}|S)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&rOappendPAGE_RANGE_ALLr)r[pairs pdf_filenamedid_page_ranger s r!parse_filename_page_rangesrbs*,E%)LN}t}# ??3  N? "? LL, #7 8!NN lN;<!#y1 63 61L"N##$ Lr')rVrtypingrrrerrorsr_INT_RErr r^listrrXrbr PageRangeSpecrZr'r!rhs '' WIRyG9CyH P,P,f3$ uS)T)* +$ %Y  $Nc9eCHouS#s]7KTRUYVW r'