U Bb@sdZddlZddlmZmZmZmZddlmZdZ dj e dZ Gd d d Z e d Z eeee dfeeee fd d dZeee eeefeeeeffZdS)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/PyPDF2/blob/main/LICENSE N)AnyListTupleUnion) ParseErrorz(0|-?[1-9]\d*)z%^({int}|({int}?(:{int}?(:{int}?)?)))$intc@seZdZdZeedefddddZee e dddZ ed d d Z ed d d Z ed ddZeeeeefdddZe e dddZdddddZdS) PageRangeaK 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). N)argreturncCst|tr||_dSt|tr,||_dSt|to@tt|}|sPt |nX| drt | d}|dkrx|dnd}t|||_ntdd| ddd D|_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. NrcSsg|]}|rt|ndqS)Nr).0gr4/tmp/pip-unpacked-wheel-weujb6sz/PyPDF2/pagerange.py Msz&PageRange.__init__..) isinstanceslice_slicer to_slicestrrematch PAGE_RANGE_RErgroupr )selfr mstartstoprrr__init__%s     zPageRange.__init__)inputr cCs(t|ttfp&t|to&ttt|S)z5True if input is a valid initializer for a PageRange.)rrr rboolrrr)r%rrrvalidOszPageRange.valid)r cCs|jS)z/Return the slice equivalent of this page range.)rr rrrrVszPageRange.to_slicecCsf|j}|jdkrB|jdk r4|j|jdkr4t|jS|j|jf}n|j|j|jf}ddd|DS)zA string like "1:2:3".Nr:css"|]}|dkrdnt|VqdS)N)r)rirrr esz$PageRange.__str__..)rstepr"r#rjoin)r sindicesrrr__str__Zs  zPageRange.__str__cCsdtt|dS)z#A string like "PageRange('1:2:3')".z PageRange())reprrr(rrr__repr__gszPageRange.__repr__)nr cCs |j|S)z n is the length of the list of pages to choose from. Returns arguments for range(). See help(slice.indices). )rr0)r r5rrrr0kszPageRange.indices)otherr cCst|tsdS|j|jkS)NF)rr r)r r6rrr__eq__ss zPageRange.__eq__cCst|tstdt||jjdk s4|jjdk rrrrrr s* r r))argsr cCslg}d}d}|dgD]P}t|rH|s0td||t|fd}q|r^|s^||tf|}d}q|S)a- Given a list of filenames and page ranges, return a list of (filename, page_range) pairs. First arg must be a filename; other ags are filenames, page-range expressions, slice objects, or PageRange objects. A filename not followed by a page range indicates all pages of the file. NFz8The first argument must be a filename, not a page range.T)r r'r:appendPAGE_RANGE_ALL)rDpairsZ pdf_filenameZdid_page_ranger rrrparse_filename_page_rangess  rH)rBrtypingrrrrerrorsrZ_INT_REformatrr rFrrHr Z PageRangeSpecrrrrs  w