v^@sddlZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m ZGdddeZGd d d eZGd d d eZGd ddeZGdddZGdddeZGdddejjZdS)N)ceil)RemovedInDjango31Warning)cached_property)method_has_no_args) gettext_lazyc@seZdZdS)UnorderedObjectListWarningN)__name__ __module__ __qualname__r r 7/tmp/pip-build-8lau8j11/django/django/core/paginator.pyr s rc@seZdZdS) InvalidPageN)rr r r r r r r s r c@seZdZdS)PageNotAnIntegerN)rr r r r r r rs rc@seZdZdS) EmptyPageN)rr r r r r r rs rc@seZdZddddZddZddZd d Zd d Zed dZ eddZ e ddZ ddZ dS) PaginatorrTcCs>||_|jt||_t||_||_dS)N) object_list_check_object_list_is_orderedintper_pageorphansallow_empty_first_page)selfrrrrr r r __init__s   zPaginator.__init__c Csy2t|tr%|j r%tt|}Wn*ttfk r^ttdYnX|dkr}ttd||j kr|dkr|j rnttd|S)z'Validate the given 1-based page number.z"That page number is not an integerzThat page number is less than 1zThat page contains no results) isinstancefloat is_integer ValueErrorr TypeErrorr_r num_pagesr)rnumberr r r validate_number&s zPaginator.validate_numberc CsUy|j|}Wn2tk r-d}Yntk rG|j}YnX|j|S)zj Return a valid page, even if the page argument isn't a number or isn't in range. r)r"rrr page)rr!r r r get_page7s   zPaginator.get_pagecCsl|j|}|d|j}||j}||j|jkrL|j}|j|j||||S)z7Return a Page object for the given 1-based page number.r)r"rrcount _get_pager)rr!Zbottomtopr r r r#Ds   zPaginator.pagecOs t||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)rargskwargsr r r r&MszPaginator._get_pagecCsQt|jdd}t|rDtj| rDt|rD|St|jS)z5Return the total number of objects, across all pages.r%N)getattrrcallableinspectZ isbuiltinrlen)rcr r r r%Vs(zPaginator.countcCsG|jdkr|j rdStd|j|j}t||jS)z!Return the total number of pages.rr)r%rmaxrrr)rhitsr r r r ^szPaginator.num_pagescCstd|jdS)zk Return a 1-based range of pages for iterating through within a template for loop. r)ranger )rr r r page_rangefszPaginator.page_rangecCst|jdd}|dk r| rt|jdr[dj|jj|jjjndj|j}tjdj|t dddS) zO Warn if self.object_list is unordered (typically a QuerySet). orderedNmodelz{} {}z{!r}zLPagination may yield inconsistent results with an unordered object_list: {}. stacklevel) r+rhasattrformatr5 __class__rwarningswarnr)rr4Z obj_list_reprr r r rns3z'Paginator._check_object_list_is_orderedN)rr r rr"r$r#r&rr%r propertyr3rr r r r rs   rcs"eZdZfddZS)QuerySetPaginatorcs-tjdtddtj||dS)Nz7The QuerySetPaginator alias of Paginator is deprecated.r6)r;r<rsuperr)rr)r*)r:r r rs zQuerySetPaginator.__init__)rr r rr r )r:r r>s r>c@seZdZddZddZddZddZd d Zd d Zd dZ ddZ ddZ ddZ ddZ dS)r(cCs||_||_||_dS)N)rr! paginator)rrr!rAr r r rs  z Page.__init__cCsd|j|jjfS)Nz)r!rAr )rr r r __repr__sz Page.__repr__cCs t|jS)N)r.r)rr r r __len__sz Page.__len__cCs]t|ttfs.tdt|jt|jtsRt|j|_|j|S)Nz0Page indices must be integers or slices, not %s.)rrslicertyperrlist)rindexr r r __getitem__szPage.__getitem__cCs|j|jjkS)N)r!rAr )rr r r has_nextsz Page.has_nextcCs |jdkS)Nr)r!)rr r r has_previousszPage.has_previouscCs|jp|jS)N)rJrI)rr r r has_other_pagesszPage.has_other_pagescCs|jj|jdS)Nr)rAr"r!)rr r r next_page_numberszPage.next_page_numbercCs|jj|jdS)Nr)rAr"r!)rr r r previous_page_numberszPage.previous_page_numbercCs/|jjdkrdS|jj|jddS)z Return the 1-based index of the first object on this page, relative to total objects in the paginator. rr)rAr%rr!)rr r r start_indexszPage.start_indexcCs0|j|jjkr|jjS|j|jjS)z{ Return the 1-based index of the last object on this page, relative to total objects found (hits). )r!rAr r%r)rr r r end_indexs zPage.end_indexN)rr r rrBrCrHrIrJrKrLrMrNrOr r r r r(s          r()collections.abc collectionsr-r;mathrZdjango.utils.deprecationrZdjango.utils.functionalrZdjango.utils.inspectrZdjango.utils.translationrrRuntimeWarningr Exceptionr rrrr>abcSequencer(r r r r s   e