a
    Lcòf  ã                   @   s®   d dl Zd dlZd dlZd dlmZ d dlmZ d dlm	Z	 d dl
mZ G dd„ deƒZG dd	„ d	eƒZG d
d„ deƒZG dd„ deƒZG dd„ dƒZG dd„ dejjƒZdS )é    N)Úceil)Úcached_property)Úmethod_has_no_args)Úgettext_lazyc                   @   s   e Zd ZdS )ÚUnorderedObjectListWarningN©Ú__name__Ú
__module__Ú__qualname__© r   r   úR/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/django/core/paginator.pyr      s   r   c                   @   s   e Zd ZdS )ÚInvalidPageNr   r   r   r   r   r      s   r   c                   @   s   e Zd ZdS )ÚPageNotAnIntegerNr   r   r   r   r   r      s   r   c                   @   s   e Zd ZdS )Ú	EmptyPageNr   r   r   r   r   r      s   r   c                   @   s„   e Zd ZedƒZddd„Zdd„ Zdd	„ Zd
d„ Zdd„ Z	dd„ Z
edd„ ƒZedd„ ƒZedd„ ƒZdd„ Zd dddœdd„ZdS )!Ú	Paginatoru   â€¦r   Tc                 C   s,   || _ |  ¡  t|ƒ| _t|ƒ| _|| _d S ©N)Úobject_listÚ_check_object_list_is_orderedÚintÚper_pageÚorphansÚallow_empty_first_page)Úselfr   r   r   r   r   r   r   Ú__init__    s
    

zPaginator.__init__c                 c   s   | j D ]}|  |¡V  qd S r   )Ú
page_rangeÚpage)r   Zpage_numberr   r   r   Ú__iter__'   s    
zPaginator.__iter__c              	   C   st   z"t |tƒr| ¡ st‚t|ƒ}W n" ttfyD   ttdƒƒ‚Y n0 |dk rZttdƒƒ‚|| j	krpttdƒƒ‚|S )z'Validate the given 1-based page number.z"That page number is not an integeré   zThat page number is less than 1zThat page contains no results)
Ú
isinstanceÚfloatÚ
is_integerÚ
ValueErrorr   Ú	TypeErrorr   Ú_r   Ú	num_pages©r   Únumberr   r   r   Úvalidate_number+   s    
zPaginator.validate_numberc                 C   sF   z|   |¡}W n, ty$   d}Y n ty:   | j}Y n0 |  |¡S )zj
        Return a valid page, even if the page argument isn't a number or isn't
        in range.
        r   )r'   r   r   r$   r   r%   r   r   r   Úget_page9   s    zPaginator.get_pagec                 C   sP   |   |¡}|d | j }|| j }|| j | jkr8| j}|  | j||… || ¡S )z7Return a Page object for the given 1-based page number.r   )r'   r   r   ÚcountÚ	_get_pager   )r   r&   ÚbottomÚtopr   r   r   r   F   s    

zPaginator.pagec                 O   s   t |i |¤ŽS )z¥
        Return an instance of a single page.

        This hook can be used by subclasses to use an alternative to the
        standard :cls:`Page` object.
        )ÚPage)r   ÚargsÚkwargsr   r   r   r*   O   s    zPaginator._get_pagec                 C   s8   t | jddƒ}t|ƒr.t |¡s.t|ƒr.|ƒ S t| jƒS )z5Return the total number of objects, across all pages.r)   N)Úgetattrr   ÚcallableÚinspectÚ	isbuiltinr   Úlen)r   Úcr   r   r   r)   X   s    zPaginator.countc                 C   s4   | j dkr| jsdS td| j | j ƒ}t|| j ƒS )z!Return the total number of pages.r   r   )r)   r   Úmaxr   r   r   )r   Úhitsr   r   r   r$   `   s    zPaginator.num_pagesc                 C   s   t d| jd ƒS )zk
        Return a 1-based range of pages for iterating through within
        a template for loop.
        r   )Úranger$   ©r   r   r   r   r   h   s    zPaginator.page_rangec                 C   sb   t | jddƒ}|dur^|s^t| jdƒr<d | jj| jjj¡n
d | j¡}tjd |¡t	dd� dS )	zO
        Warn if self.object_list is unordered (typically a QuerySet).
        ÚorderedNÚmodelz{} {}z{!r}zLPagination may yield inconsistent results with an unordered object_list: {}.é   )Ú
stacklevel)
r0   r   ÚhasattrÚformatr;   Ú	__class__r   ÚwarningsÚwarnr   )r   r:   Zobj_list_reprr   r   r   r   p   s    
ýÿ
ûÿüz'Paginator._check_object_list_is_orderedr   r<   é   )Úon_each_sideÚon_endsc                c   s  |   |¡}| j|| d kr,| jE dH  dS |d| | d krvtd|d ƒE dH  | jV  t|| |d ƒE dH  ntd|d ƒE dH  || j| | d k ræt|d || d ƒE dH  | jV  t| j| d | jd ƒE dH  nt|d | jd ƒE dH  dS )u›  
        Return a 1-based range of pages with some values elided.

        If the page range is larger than a given size, the whole range is not
        provided and a compact form is returned instead, e.g. for a paginator
        with 50 pages, if page 43 were the current page, the output, with the
        default arguments, would be:

            1, 2, â€¦, 40, 41, 42, 43, 44, 45, 46, â€¦, 49, 50.
        rC   Nr   )r'   r$   r   r8   ÚELLIPSIS)r   r&   rD   rE   r   r   r   Úget_elided_page_range„   s    
"zPaginator.get_elided_page_rangeN)r   T)r   )r   r	   r
   r#   rF   r   r   r'   r(   r   r*   r   r)   r$   Úpropertyr   r   rG   r   r   r   r   r      s   
		


r   c                   @   sd   e Zd Zdd„ Zdd„ Zdd„ Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ Zdd„ ZdS )r-   c                 C   s   || _ || _|| _d S r   )r   r&   Ú	paginator)r   r   r&   rI   r   r   r   r   ¥   s    zPage.__init__c                 C   s   d| j | jjf S )Nz<Page %s of %s>©r&   rI   r$   r9   r   r   r   Ú__repr__ª   s    zPage.__repr__c                 C   s
   t | jƒS r   )r4   r   r9   r   r   r   Ú__len__­   s    zPage.__len__c                 C   sB   t |ttfƒs tdt|ƒj ƒ‚t | jtƒs8t| jƒ| _| j| S )Nz0Page indices must be integers or slices, not %s.)r   r   Úslicer"   Útyper   r   Úlist)r   Úindexr   r   r   Ú__getitem__°   s    ÿÿzPage.__getitem__c                 C   s   | j | jjk S r   rJ   r9   r   r   r   Úhas_next¼   s    zPage.has_nextc                 C   s
   | j dkS ©Nr   )r&   r9   r   r   r   Úhas_previous¿   s    zPage.has_previousc                 C   s   |   ¡ p|  ¡ S r   )rT   rR   r9   r   r   r   Úhas_other_pagesÂ   s    zPage.has_other_pagesc                 C   s   | j  | jd ¡S rS   ©rI   r'   r&   r9   r   r   r   Únext_page_numberÅ   s    zPage.next_page_numberc                 C   s   | j  | jd ¡S rS   rV   r9   r   r   r   Úprevious_page_numberÈ   s    zPage.previous_page_numberc                 C   s&   | j jdkrdS | j j| jd  d S )z€
        Return the 1-based index of the first object on this page,
        relative to total objects in the paginator.
        r   r   )rI   r)   r   r&   r9   r   r   r   Ústart_indexË   s    zPage.start_indexc                 C   s$   | j | jjkr| jjS | j | jj S )z{
        Return the 1-based index of the last object on this page,
        relative to total objects found (hits).
        )r&   rI   r$   r)   r   r9   r   r   r   Ú	end_indexÕ   s    zPage.end_indexN)r   r	   r
   r   rK   rL   rQ   rR   rT   rU   rW   rX   rY   rZ   r   r   r   r   r-   ¤   s   
r-   )Úcollections.abcÚcollectionsr2   rA   Úmathr   Zdjango.utils.functionalr   Zdjango.utils.inspectr   Zdjango.utils.translationr   r#   ÚRuntimeWarningr   Ú	Exceptionr   r   r   r   ÚabcÚSequencer-   r   r   r   r   Ú<module>   s    
