3 (hd@s,ddlmZddlZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZdd lmZdd lmZdd lmZdd lmZmZdd lmZmZGdddeZGdddeZGdddeZ GdddeZ!GdddeZ"Gdddee"eZ#Gddde#Z$Gdddee$Z%Gdddee#Z&Gd d!d!ee&Z'Gd"d#d#eee#Z(Gd$d%d%ee(Z)Gd&d'd'ee!e#Z*Gd(d)d)ee*Z+Gd*d+d+eee e#Z,Gd,d-d-ee,Z-Gd.d/d/e,Z.Gd0d1d1ee.Z/Gd2d3d3eee e"eZ0Gd4d5d5ee0Z1d>d8d9Z2d:d;Z3d/tmp/pip-install-q3hcpn_q/Django/django/views/generic/dates.pyget_year_formatszYearMixin.get_year_formatcCsh|j}|dkrdy|jd}WnFtk rby|jjd}Wn tk r\ttdYnXYnX|S)zJ Return the year for which this view should display data. NyearzNo year specified)rkwargsKeyErrorrequestGETr_)rrrrrget_year$szYearMixin.get_yearcCst||dddS)z* Get the next valid year. Fr) is_previousperiod)_get_next_prev)rdaterrr get_next_year3szYearMixin.get_next_yearcCst||dddS)z. Get the previous valid year. Tr)rr)r )rr!rrrget_previous_year9szYearMixin.get_previous_yearcCs|j|jddddS)z Return the start date of the next interval. The interval is defined by start date <= item date < next start date. )rmonthday)replacer)rr!rrr_get_next_year?szYearMixin._get_next_yearcCs|jdddS)z@ Return the start date of the current interval. r$)r%r&)r')rr!rrr_get_current_yearGszYearMixin._get_current_year) __name__ __module__ __qualname____doc__rrrrr"r#r(r)rrrrrsrc@sHeZdZdZdZdZddZddZdd Zd d Z d d Z ddZ dS) MonthMixinz8 Mixin for views manipulating month-based data. z%bNcCs|jS)zx Get a month format string in strptime syntax to be used to parse the month from url variables. ) month_format)rrrrget_month_formatUszMonthMixin.get_month_formatcCsh|j}|dkrdy|jd}WnFtk rby|jjd}Wn tk r\ttdYnXYnX|S)zK Return the month for which this view should display data. Nr%zNo month specified)r%rrrrrr)rr%rrr get_month\szMonthMixin.get_monthcCst||dddS)z+ Get the next valid month. Fr%)rr)r )rr!rrrget_next_monthkszMonthMixin.get_next_monthcCst||dddS)z/ Get the previous valid month. Tr%)rr)r )rr!rrrget_previous_monthqszMonthMixin.get_previous_monthcCs8|jdkr |j|jddddS|j|jdddSdS)z Return the start date of the next interval. The interval is defined by start date <= item date < next start date. r$)rr%r&)r%r&N)r%r'r)rr!rrr_get_next_monthws zMonthMixin._get_next_monthcCs |jddS)zA Return the start date of the previous interval. r$)r&)r')rr!rrr_get_current_monthszMonthMixin._get_current_month) r*r+r,r-r/r%r0r1r2r3r5r6rrrrr.Ns r.c@sHeZdZdZdZdZddZddZdd Zd d Z d d Z ddZ dS)DayMixinz6 Mixin for views manipulating day-based data. z%dNcCs|jS)zt Get a day format string in strptime syntax to be used to parse the day from url variables. ) day_format)rrrrget_day_formatszDayMixin.get_day_formatcCsh|j}|dkrdy|jd}WnFtk rby|jjd}Wn tk r\ttdYnXYnX|S)zI Return the day for which this view should display data. Nr&zNo day specified)r&rrrrrr)rr&rrrget_dayszDayMixin.get_daycCst||dddS)z) Get the next valid day. Fr&)rr)r )rr!rrr get_next_dayszDayMixin.get_next_daycCst||dddS)z- Get the previous valid day. Tr&)rr)r )rr!rrrget_previous_dayszDayMixin.get_previous_daycCs|tjddS)z Return the start date of the next interval. The interval is defined by start date <= item date < next start date. r$)days)datetime timedelta)rr!rrr _get_next_dayszDayMixin._get_next_daycCs|S)z@ Return the start date of the current interval. r)rr!rrr_get_current_dayszDayMixin._get_current_day) r*r+r,r-r8r&r9r:r;r<r@rArrrrr7sr7c@sPeZdZdZdZdZddZddZdd Zd d Z d d Z ddZ ddZ dS) WeekMixinz7 Mixin for views manipulating week-based data. z%UNcCs|jS)zv Get a week format string in strptime syntax to be used to parse the week from url variables. ) week_format)rrrrget_week_formatszWeekMixin.get_week_formatcCsh|j}|dkrdy|jd}WnFtk rby|jjd}Wn tk r\ttdYnXYnX|S)zI Return the week for which this view should display data NweekzNo week specified)rErrrrrr)rrErrrget_weekszWeekMixin.get_weekcCst||dddS)z* Get the next valid week. FrE)rr)r )rr!rrr get_next_weekszWeekMixin.get_next_weekcCst||dddS)z. Get the previous valid week. TrE)rr)r )rr!rrrget_previous_weekszWeekMixin.get_previous_weekcCs|tjd|j|dS)z Return the start date of the next interval. The interval is defined by start date <= item date < next start date. )r=)r>r? _get_weekday)rr!rrr_get_next_weekszWeekMixin._get_next_weekcCs|tj|j|S)z@ Return the start date of the current interval. )r>r?rJ)rr!rrr_get_current_weekszWeekMixin._get_current_weekcCs@|j}|dkr|jS|dkr0|jddStd|dS)z Return the weekday for a given date. The first day according to the week format is 0 and the last day is 6. z%Wz%Ur$rIzunknown week format: %sN)rDweekday ValueError)rr!rCrrrrJs zWeekMixin._get_weekday) r*r+r,r-rCrErDrFrGrHrKrLrJrrrrrBsrBc@sDeZdZdZdZdZddZddZedd Z d d Z d d Z dS) DateMixinz= Mixin class for views manipulating date-based data. NFcCs |jdkrtd|jj|jS)zI Get the name of the date field to be used to filter by. Nz%s.date_field is required.) date_fieldr __class__r*)rrrrget_date_fields zDateMixin.get_date_fieldcCs|jS)zj Returns `True` if the view should be allowed to display objects from the future. ) allow_future)rrrrget_allow_futureszDateMixin.get_allow_futurecCs6|jdkr|jjn|j}|jj|j}t|tjS)zq Return `True` if the date field is a `DateTimeField` and `False` if it's a `DateField`. N)model get_queryset_meta get_fieldrR isinstancerZ DateTimeField)rrUfieldrrruses_datetime_field szDateMixin.uses_datetime_fieldcCs2|jr.tjj|tjj}tjr.tj|tj }|S)z Convert a date into a datetime when the date field is a DateTimeField. When time zone support is enabled, `date` is assumed to be in the current time zone, so that displayed items are consistent with the URL. ) r[r>combinetimeminrUSE_TZrZ make_awareZget_current_timezone)rvaluerrr_make_date_lookup_arg*s zDateMixin._make_date_lookup_argcCsN|j}|jrB|j|}|j|tjdd}d||d||iS||iSdS)z Get the lookup kwargs for filtering on a single date. If the date field is a DateTimeField, we can't just filter on date_field=date because that doesn't take the time into account. r$)r=z%s__gtez%s__ltN)rRr[rar>r?)rr!rPsinceuntilrrr_make_single_date_lookup7s  z"DateMixin._make_single_date_lookup) r*r+r,r-rPrSrRrTr r[rardrrrrrOs  rOc@sJeZdZdZdZdZddZddZdd Zd d Z d d Z dddZ dS)BaseDateListViewzP Abstract base class for date-based views displaying a list of objects. FrcOs8|j\|_|_}|j|j|jd}|j||j|S)N) object_list date_list)get_dated_itemsrgrfZget_context_dataupdateZrender_to_response)rrargsrZ extra_contextcontextrrrgetRs   zBaseDateListView.getcCs tddS)z5 Obtain the list of dates and items. z>A DateView must provide an implementation of get_dated_items()N)NotImplementedError)rrrrrhYsz BaseDateListView.get_dated_itemscCs|jdkrd|jS|jS)zw Returns the field or fields to use for ordering the queryset; uses the date field by default. Nz-%s)orderingrR)rrrr get_ordering_szBaseDateListView.get_orderingc Ks|jjf|}|j}|j}|j}|j|}|s^|jrDtjnt }|jfd||i}|s|dkrvt |dkn|j }|rt t ddt|jjji|S)zs Get a queryset properly filtered according to `allow_future` and any extra lookup kwargs. z%s__lteNrz$No %(verbose_name_plural)s availableverbose_name_plural)rVfilterrRrTget_allow_emptyZget_paginate_byr[rnowtimezone_todaylenexistsrrr rUrWrp) rlookupqsrPrS allow_emptyZ paginate_byrsZis_emptyrrrget_dated_querysetfs z#BaseDateListView.get_dated_querysetcCs|jS)z^ Get the aggregation period for the list of dates: 'year', 'month', or 'day'. )date_list_period)rrrrget_date_list_periodsz%BaseDateListView.get_date_list_periodNASCcCs~|j}|j}|dkr |j}|jr6|j|||}n|j|||}|dk rz| rz| rzt|jjj }t t dd|i|S)z Get a date list by calling `queryset.dates/datetimes()`, checking along the way for empty lists that aren't allowed. Nz$No %(verbose_name_plural)s availablerp) rRrrr|r[Z datetimesdatesr rUrWrprr)rquerysetZ date_typernrPryrgnamerrr get_date_lists zBaseDateListView.get_date_list)Nr}) r*r+r,r-ryr{rlrhrorzr|rrrrrreKsrec@seZdZdZdZddZdS)BaseArchiveIndexViewzV Base class for archives of date-based items. Requires a response mixin. latestcCs,|j}|j|dd}|s"|j}||ifS)zL Return (date_list, items, extra_context) for this request. ZDESC)rn)rzrnone)rrxrgrrrrhs z$BaseArchiveIndexView.get_dated_itemsN)r*r+r,r-Zcontext_object_namerhrrrrrsrc@seZdZdZdZdS)ArchiveIndexViewz0 Top-level archive of date-based items. Z_archiveN)r*r+r,r-template_name_suffixrrrrrsrc@s(eZdZdZdZdZddZddZdS) BaseYearArchiveViewz4 List of objects published in a given year. r%Fc Cs|j}|j}t||j}|j|}|j|j|}d||d||i}|jf|}|j|}|jsr|j }||||j ||j |dfS)zL Return (date_list, items, extra_context) for this request. z%s__gtez%s__lt)rZ next_yearZ previous_year) rrR_date_from_stringrrar(rzrget_make_object_listrr"r#) rrrPr!rbrc lookup_kwargsrxrgrrrrhs    z#BaseYearArchiveView.get_dated_itemscCs|jS)zo Return `True` if this view should contain the full list of objects in the given year. )make_object_list)rrrrrsz(BaseYearArchiveView.get_make_object_listN)r*r+r,r-r{rrhrrrrrrs rc@seZdZdZdZdS)YearArchiveViewz4 List of objects published in a given year. Z _archive_yearN)r*r+r,r-rrrrrrsrc@seZdZdZdZddZdS)BaseMonthArchiveViewz5 List of objects published in a given month. r&c Cs|j}|j}|j}t||j||j}|j|}|j|j|}d||d||i}|jf|}|j |} | |||j ||j |dfS)zL Return (date_list, items, extra_context) for this request. z%s__gtez%s__lt)r% next_monthprevious_month) rr1rRrrr0rar5rzrr2r3) rrr%rPr!rbrcrrxrgrrrrhs      z$BaseMonthArchiveView.get_dated_itemsN)r*r+r,r-r{rhrrrrrsrc@seZdZdZdZdS)MonthArchiveViewz5 List of objects published in a given month. Z_archive_monthN)r*r+r,r-rrrrrrsrc@seZdZdZddZdS)BaseWeekArchiveViewz4 List of objects published in a given week. c Cs|j}|j}|j}|j}ddd|}t||j|d||}|j|}|j|j|}d||d||i} |jf| } d| ||j ||j |dfS) zL Return (date_list, items, extra_context) for this request. 10)z%Wz%Uz%wz%s__gtez%s__ltN)rEZ next_weekZ previous_week) rrFrRrDrrrarKrzrGrH) rrrErPrCZ week_startr!rbrcrrxrrrrhs&    z#BaseWeekArchiveView.get_dated_itemsN)r*r+r,r-rhrrrrrsrc@seZdZdZdZdS)WeekArchiveViewz4 List of objects published in a given week. Z _archive_weekN)r*r+r,r-rrrrrr;src@s eZdZdZddZddZdS)BaseDayArchiveViewz3 List of objects published on a given day. cCs@|j}|j}|j}t||j||j||j}|j|S)zL Return (date_list, items, extra_context) for this request. )rr1r:rrr0r9_get_dated_items)rrr%r&r!rrrrhFs  z"BaseDayArchiveView.get_dated_itemscCsD|j|}|jf|}d|||j||j||j||j|dfS)z Do the actual heavy lifting of getting the dated items; this accepts a date object so that TodayArchiveView can be trivial. N)r&Z previous_dayZnext_dayrr)rdrzr<r;r3r2)rr!rrxrrrrTs  z#BaseDayArchiveView._get_dated_itemsN)r*r+r,r-rhrrrrrrBsrc@seZdZdZdZdS)DayArchiveViewz3 List of objects published on a given day. _archive_dayN)r*r+r,r-rrrrrresrc@seZdZdZddZdS)BaseTodayArchiveViewz* List of objects published today. cCs|jtjjS)zL Return (date_list, items, extra_context) for this request. )rr>r!today)rrrrrhqsz$BaseTodayArchiveView.get_dated_itemsN)r*r+r,r-rhrrrrrlsrc@seZdZdZdZdS)TodayArchiveViewz* List of objects published today. rN)r*r+r,r-rrrrrrxsrcs"eZdZdZdfdd ZZS)BaseDateDetailViewz Detail view of a single object on a single date; this differs from the standard DetailView by accepting a year/month/day in the URL. Ncs|j}|j}|j}t||j||j||j}|dkrF|jn|}|j r|t j j krt t d|jjj|jjd|j|}|jf|}tt|j|dS)z7 Get the object this request displays. NzZFuture %(verbose_name_plural)s not available because %(class_name)s.allow_future is False.)rp class_name)r)rr1r:rrr0r9rVrTr>r!rrrrUrWrprQr*rdrqsuperr get_object)rrrr%r&r!rxr)rQrrrs    zBaseDateDetailView.get_object)N)r*r+r,r-r __classcell__rr)rQrrsrc@seZdZdZdZdS)DateDetailViewz Detail view of a single object on a single date; this differs from the standard DetailView by accepting a year/month/day in the URL. Z_detailN)r*r+r,r-rrrrrrsr__c Csf|j|||f}|j|||f}ytjjt||jStk r`ttd||dYnXdS)z Helper: get a datetime.date object given a format string and a year, month, and day (only year is mandatory). Raise a 404 for an invalid date. z;Invalid date string '%(datestr)s' given format '%(format)s')datestrformatN)joinr>strptimerr!rNrr) rrr%r/r&r8delimrrrrrrsrc CsJ|j}|j}|j}t|d|}t|d|}||||} } |r|rd|| tjdd} n| } |sv| tkrz| SdSn|rd||j| i} d|} nd||j| i} |} |s|jrt j }nt}|| d |<|j j f| j | }yt|d |} Wntk rdSX|jr>tjr6t j| } | j} || SdS) a^ Helper: Get the next or the previous valid date. The idea is to allow links on month/day views to never be 404s by never providing a date that'll be invalid for the given view. This is a bit complicated since it handles different intervals of time, hence the coupling to generic_view. However in essence the logic comes down to: * If allow_empty and allow_future are both true, this is easy: just return the naive result (just the next/previous day/week/month, regardless of object existence.) * If allow_empty is true, allow_future is false, and the naive result isn't in the future, then return it; otherwise return None. * If allow_empty is false and allow_future is true, return the next date *that contains a valid object*, even if it's in the future. If there are no next objects, return None. * If allow_empty is false and allow_future is false, return the next date that contains a valid object. If that date is in the future, or if there are no next objects, return None. z_get_current_%sz _get_next_%sr$)r=Nz%s__ltz-%sz%s__gtez%s__lter)rRrrrTgetattrr>r?rtrar[rrsrVrqZorder_by IndexErrorrr_ localtimer!)Z generic_viewr!rrrPryrSZ get_currentZget_nextstartendresultrwrnrsrxrrrr sB    r cCs&tjrtjtjjStjjSdS)z; Return the current date in the current time zone. N)rr_rrrsr!r>rrrrrrtsrt)rrrrr)5 __future__rr>Z django.confrZdjango.core.exceptionsrZ django.dbrZ django.httprZ django.utilsrZdjango.utils.encodingrr Zdjango.utils.functionalr Zdjango.utils.translationr rZdjango.views.generic.baser Zdjango.views.generic.detailr rZdjango.views.generic.listrrobjectrr.r7rBrOrerrrrrrrrrrrrrrrr rtrrrrsF         8;8FDQ-"&# % Z