(j dZddlZddlmZmZmZddlmZdZdeded ed ed Z Gd d Z e d Z de ee e dfde ee e ffdZee e eeefeeeefe efZdS)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 fdZdefdZddZdS) 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). argreturnNcpt|tr ||_dSt|tr||_dSt|t ot jt|}|st|| drFt| d}|dkr|dznd}t|||_dSd| dddD}|d}|d krt|t||_dS) 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. Nrc4g|]}|rt|ndSN)int).0gs 6/tmp/pip-target-1l1kndlc/lib/python/pypdf/pagerange.py z&PageRange.__init__..Ms'FFF+c!ffftFFFr) isinstanceslice_slicer to_slicestrrematch PAGE_RANGE_RErgroupr)selfr mstartstopboundssteps r__init__zPageRange.__init__$s0 c5 ! ! DK F c9 % % ,,..DK F sC ARXmS%A%A "S// ! 771:: ) OOE % 5199Dt,,DKKKFFQWWQ15E5EFFFF!9Dqyy!oo%.DKKKrinputct|ttfrdSt|tsdS t|n#t$rYdSwxYwdS)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. TF)rrr rr)r*s rvalidzPageRange.validUst eeY/ 0 0 4%%% 5  e       55 tsA AAc|jS)z/Return the slice equivalent of this page range.)rr#s rrzPageRange.to_sliceks {rc|j}|j=|j'|j|jdzkrt |jS|j|jf}n|j|j|jf}dd|DS)zA string like "1:2:3".Nr:c3<K|]}|dnt|VdS)N)r)ris r z$PageRange.__str__..zs0EEaiSVVEEEEEEr)rr(r%r&rjoin)r#sindicess r__str__zPageRange.__str__osz K 6>w"qv1'<'<17||#gqvoGGgqvqv-GxxEEWEEEEEErcFdtt|zdzS)z#A string like "PageRange('1:2:3')".z PageRange())reprrr.s r__repr__zPageRange.__repr__|sd3t99oo-33rnc6|j|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(). )rr7)r#r=s rr7zPageRange.indicess{""1%%%rothercPt|tsdS|j|jkS)NF)rr r)r#r?s r__eq__zPageRange.__eq__s(%++ 5{el**rcpt|j|jj|jj|jjffSr)hash __class__rr%r&r(r.s r__hash__zPageRange.__hash__s-T^dk&79I4;K[%\]^^^rct|tstdt||jj |jjt d|jj|jjf}|jj|jjf}dttdtfd}dttdtfd}||d||dkr||}}||d||dkrt d ||d||dkr|dn|d}tt|d|S) NzCan't add PageRange and zCan't add PageRange with stridevr c(|tdn|S)Nz-inffloatrGs r _start_keyz%PageRange.__add__.._start_keys$%I5===1 4rc(|tdn|S)NinfrIrKs r _stop_keyz$PageRange.__add__.._stop_keys#$95<<?? ? K t{/ / L  1 1 5(3- 5E 5 5 5 5 4# 45 4 4 4 4 :ad  jj1.. . .aqA :ad  ii!oo - -<== = y11Q488qttadqtT**+++r)r?r r r )__name__ __module__ __qualname____doc__rrrr) staticmethodrboolr,rr8r<rtupler7objectrArErUrrr r sT /)E%c"9:/)t/)/)/)/)bST\*% F F F F F4#4444&&sC}!5&&&& +F+t++++ _#____,,,,,,rr r0argsr cVg}d}d}g|dD]}t|r<|std|J||t|fd}X|r|s||tft |tr J||}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,rRappendPAGE_RANGE_ALLr)r_pairs pdf_filenamedid_page_ranger s rparse_filename_page_rangesrfs*,E%)LN}t}## ??3   #  N??? LL, #7 8 8 8!NN =N = lN;<<<!#y11 6 63 6 6 6L"NN Lr)rYrtypingrrrerrorsr_INT_REr!r rblistrr\rfr PageRangeSpecr^rrrls. '''''''''' HWHHHHGHHHHH \,\,\,\,\,\,\,\,~3$ uS)T)* +$ %Y  $$$$Nc9eCHouS#s]7KTRUYVW r