o
    `^h                     @   s   d Z ddlZddlmZmZmZmZ ddlmZ dZ	dj
e	dZG d	d
 d
ZedZdeeeedf  deeeef  fddZeeeeeef eeeef ee f ZdS )z
Representation and utils for ranges of PDF file pages.

Copyright (c) 2014, Steve Witham <switham_github@mac-guyver.com>.
All rights reserved. This software is available under a BSD license;
see https://github.com/py-pdf/PyPDF2/blob/main/LICENSE
    N)AnyListTupleUnion   )
ParseErrorz(0|-?[1-9]\d*)z%^({int}|({int}?(:{int}?(:{int}?)?)))$intc                   @   s   e Zd ZdZdeed ef ddfddZede	de
fdd	Zdefd
dZdefddZdefddZdedeeeef fddZde	de
fddZdddZdS )	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).

    argreturnNc                 C   s   t |tr
|| _dS t |tr| | _dS t |to tt|}|s't	||
drEt|
d}|dkr;|d nd}t||| _dS tdd |
ddd	D  | _dS )
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.
        N   r   c                 S   s   g | ]
}|r
t |nd qS )Nr   ).0g r   N/home/air/shanriGPT/back/venv/lib/python3.10/site-packages/PyPDF2/pagerange.py
<listcomp>M   s    z&PageRange.__init__.<locals>.<listcomp>         )
isinstanceslice_slicer
   to_slicestrrematchPAGE_RANGE_REr   groupr	   )selfr   mstartstopr   r   r   __init__%   s   



"zPageRange.__init__inputc                 C   s(   t | ttfpt | tottt| S )z5True if input is a valid initializer for a PageRange.)r   r   r
   r   boolr   r   r   )r%   r   r   r   validO   s   zPageRange.validc                 C   s   | j S )z/Return the slice equivalent of this page range.)r   r    r   r   r   r   V   s   zPageRange.to_slicec                 C   sf   | j }|jdu r!|jdur|j|jd krt|jS |j|jf}n|j|j|jf}ddd |D S )zA string like "1:2:3".Nr   :c                 s   s$    | ]}|d u r
dnt |V  qd S )N )r   )r   ir   r   r   	<genexpr>e   s   " z$PageRange.__str__.<locals>.<genexpr>)r   stepr"   r#   r   join)r    sindicesr   r   r   __str__Z   s   

zPageRange.__str__c                 C   s   dt t|  d S )z#A string like "PageRange('1:2:3')".z
PageRange())reprr   r(   r   r   r   __repr__g   s   zPageRange.__repr__nc                 C   s   | j |S )z
        n is the length of the list of pages to choose from.

        Returns arguments for range().  See help(slice.indices).
        )r   r0   )r    r5   r   r   r   r0   k   s   zPageRange.indicesotherc                 C   s   t |tsdS | j|jkS )NF)r   r
   r   )r    r6   r   r   r   __eq__s   s   
zPageRange.__eq__c                 C   s   t |tstdt| | jjd us|jjd urtd| jj| jjf}|jj|jjf}|d |d kr;||}}|d |d krGtdtt	|d t
|d |d S )NzCan't add PageRange and zCan't add PageRange with strider   r   zCan't add PageRanges with gap)r   r
   	TypeErrortyper   r-   
ValueErrorr"   r#   r   max)r    r6   abr   r   r   __add__x   s   

 zPageRange.__add__)r6   r
   r   r
   )__name__
__module____qualname____doc__r   r   r   r$   staticmethodr   r&   r'   r   r1   r4   r	   r   r0   r7   r>   r   r   r   r   r
      s    *r
   r)   argsr   c                 C   sl   g }d}d}| dg D ](}t |r$|std||t |f d}q|r/|s/||tf |}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:   appendPAGE_RANGE_ALL)rD   pairspdf_filenamedid_page_ranger   r   r   r   parse_filename_page_ranges   s    

rJ   )rB   r   typingr   r   r   r   errorsr   _INT_REformatr   r
   rF   r   rJ   r	   PageRangeSpecr   r   r   r   <module>   s    w
, 