o -"j @sdZddlZddlmZmZddlmZdZdeded ed ed ZGd d d Z e d Z de ee e dfde e e e ffddZee e e eefe eeefe 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)AnyUnion) ParseErrorz(0|-?[1-9]\d*)z^(z|(z?(:z?)?)))$c@seZdZdZdeedefddfddZede de fdd Z defd d Z defd d Z defddZdedeeeeffddZdede fddZdefddZdddZdS) 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). argreturnNcCst|tr ||_dSt|tr||_dSt|to tt|}|s't || drEt | d}|dkr;|dnd}t|||_dStdd| 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|] }|r t|ndqSN)int).0gr\/home/develop/edictos_py/central_edictos/env/lib/python3.10/site-packages/pypdf/pagerange.py Msz&PageRange.__init__..) isinstanceslice_slicerto_slicestrrematch PAGE_RANGE_RErgroupr )selfrmstartstoprrr__init__$s    "zPageRange.__init__inputcCs(t|ttfpt|tottt|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. )rrrrboolrrr)r#rrrvalidOs zPageRange.validcCs|jS)z/Return the slice equivalent of this page range.)rrrrrr_szPageRange.to_slicecCsf|j}|jdur!|jdur|j|jdkrt|jS|j|jf}n|j|j|jf}ddd|DS)zA string like "1:2:3".Nr:css$|] }|dur dnt|VqdS)N)r)r irrr ns"z$PageRange.__str__..)rstepr r!rjoin)rsindicesrrr__str__cs  zPageRange.__str__cCsdtt|dS)z#A string like "PageRange('1:2:3')".z PageRange())reprrr&rrr__repr__pszPageRange.__repr__ncCs |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(). )rr.)rr3rrrr.ts zPageRange.indicesothercCst|tsdS|j|jkS)NF)rrr)rr4rrr__eq__s  zPageRange.__eq__cCs t|j|jj|jj|jjffSr )hash __class__rr r!r+r&rrr__hash__s zPageRange.__hash__cCst|tstdt||jjdus|jjdurtd|jj|jjf}|jj|jjf}|d|dkr;||}}|d|dkrGtdtt |dt |d|dS)NzCan't add PageRange and zCan't add PageRange with striderrzCan't add PageRanges with gap) rr TypeErrortyperr+ ValueErrorr r!rmax)rr4abrrr__add__s   zPageRange.__add__)r4rrr)__name__ __module__ __qualname____doc__rrrr" staticmethodrr$r%rr/r2r tupler.objectr5r8r?rrrrrs+ rr'argsrcCsg}d}d}g|dD]7}t|r+|std|dusJ||t|fd}q |r6|s6||tft|tr?J||}d}q |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)rr%r;appendPAGE_RANGE_ALLr)rGpairs pdf_filenamedid_page_rangerrrrparse_filename_page_rangess$  rM)rCrtypingrrerrorsr_INT_RErrrIlistrrErMr PageRangeSpecrrrrs   ,'