3 gtd@sddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZmZdd lmZmZGd d d ZGdddZGdddZGdddZGdddZGdddeeeZGdddeZGdddeeZGdddeeZ Gdddee Z!Gd d!d!eeeZ"Gd"d#d#ee"Z#Gd$d%d%eeeZ$Gd&d'd'ee$Z%Gd(d)d)eeeeZ&Gd*d+d+ee&Z'Gd,d-d-e&Z(Gd.d/d/ee(Z)Gd0d1d1eeeeeZ*Gd2d3d3ee*Z+dr?rrrrr5xs r5c@sPeZdZdZdZdZddZddZdd Zd d Z d d Z ddZ ddZ dS) WeekMixinz-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)z8Return the week for which this view should display data.NweekzNo week specified)rCrrrrrr)rrCrrrget_weekszWeekMixin.get_weekcCst||dddS)zGet the next valid week.FrC)rr)r)rrrrr get_next_weekszWeekMixin.get_next_weekcCst||dddS)zGet the previous valid week.TrC)rr)r)rrrrrget_previous_weekszWeekMixin.get_previous_weekc Cs@y|tjd|j|dStk r:ttdYnXdS)z Return the start date of the next interval. The interval is defined by start date <= item date < next start date. )r;zDate out of rangeN)r<r= _get_weekday OverflowErrorrr)rrrrr_get_next_weekszWeekMixin._get_next_weekcCs|tj|j|S)z.Return the start date of the current interval.)r<r=rH)rrrrr_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. %W%Vz%Ur!rGzunknown week format: %sN>rLrM)rBweekdayr%)rrrArrrrHs zWeekMixin._get_weekday) r(r)r*r+rArCrBrDrErFrJrKrHrrrrr@s  r@c@sDeZdZdZdZdZddZddZedd Z d d Z d d Z dS) DateMixinz3Mixin class for views manipulating date-based data.NFcCs |jdkrtd|jj|jS)z7Get 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)zi Return `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_fieldszDateMixin.uses_datetime_fieldcCs,|jr(tjj|tjj}tjr(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_aware)rvaluerrr_make_date_lookup_args  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=)rrrPsinceuntilrrr_make_single_date_lookups  z"DateMixin._make_single_date_lookup) r(r)r*r+rPrSrRrTrr[rardrrrrrOs  rOc@sJeZdZdZdZdZddZddZdd Zd d Z d d Z dddZ dS)BaseDateListViewzFAbstract base class for date-based views displaying a list of objects.FrcOs6|j\|_|_}|jf|j|jd|}|j|S)N) object_list date_list)get_dated_itemsrgrfZget_context_dataZrender_to_response)rrargsrZ extra_contextcontextrrrget*s zBaseDateListView.getcCs tddS)z#Obtain the list of dates and items.z>A DateView must provide an implementation of get_dated_items()N)NotImplementedError)rrrrrh3sz BaseDateListView.get_dated_itemscCs|jdkrd|jS|jS)zu Return the field or fields to use for ordering the queryset; use the date field by default. Nz-%s)orderingrR)rrrr get_ordering7szBaseDateListView.get_orderingc Ks|jjf|}|j}|j}|j}|j|}|s^|jrDtjnt }|jfd||i}|s|dkrp| n|j }|rt t dd|j jji|S)zs Get a queryset properly filtered according to `allow_future` and any extra lookup kwargs. z%s__lteNz$No %(verbose_name_plural)s availableverbose_name_plural)rVfilterrRrTget_allow_emptyZget_paginate_byr[rnowtimezone_todayexistsrrrUrWro) rlookupqsrPrS allow_emptyZ paginate_byrrZis_emptyrrrget_dated_queryset>s z#BaseDateListView.get_dated_querysetcCs|jS)zf Get the aggregation period for the list of dates: 'year', 'month', or 'day'. )date_list_period)rrrrget_date_list_periodXsz%BaseDateListView.get_date_list_periodNASCcCsv|j}|j}|dkr |j}|jr6|j|||}n|j|||}|dk rr| rr| rrttdd|jj j 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 availablero) rRrqrzr[Z datetimesdatesrrrUrWro)rquerysetZ date_typermrPrwrgrrr get_date_list_szBaseDateListView.get_date_list)Nr{) r(r)r*r+rwryrkrhrnrxrzr~rrrrre%s rec@seZdZdZdZddZdS)BaseArchiveIndexViewzQ Base class for archives of date-based items. Requires a response mixin. ZlatestcCs,|j}|j|dd}|s"|j}||ifS)z:Return (date_list, items, extra_context) for this request.ZDESC)rm)rxr~none)rrvrgrrrrh}s z$BaseArchiveIndexView.get_dated_itemsN)r(r)r*r+Zcontext_object_namerhrrrrrwsrc@seZdZdZdZdS)ArchiveIndexViewz&Top-level archive of date-based items.Z_archiveN)r(r)r*r+template_name_suffixrrrrrsrc@s(eZdZdZdZdZddZddZdS) BaseYearArchiveViewz*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)z:Return (date_list, items, extra_context) for this request.z%s__gtez%s__lt)rZ next_yearZ previous_year) rrR_date_from_stringrrar&rxr~get_make_object_listrrr ) rrrPrrbrc lookup_kwargsrvrgrrrrhs    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+ryrrhrrrrrrs rc@seZdZdZdZdS)YearArchiveViewz*List of objects published in a given year.Z _archive_yearN)r(r)r*r+rrrrrrsrc@seZdZdZdZddZdS)BaseMonthArchiveViewz+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)z:Return (date_list, items, extra_context) for this request.z%s__gtez%s__lt)r" next_monthprevious_month) rr/rRrrr.rar3rxr~r0r1) rrr"rPrrbrcrrvrgrrrrhs      z$BaseMonthArchiveView.get_dated_itemsN)r(r)r*r+ryrhrrrrrsrc@seZdZdZdZdS)MonthArchiveViewz+List of objects published in a given month.Z_archive_monthN)r(r)r*r+rrrrrrsrc@seZdZdZddZdS)BaseWeekArchiveViewz*List of objects published in a given week.c Cs|j}|j}|j}|j}dddd}y ||}Wn.tk rftd|djt|fYnX|j}|dkr|dkrtd||ft |||d ||}|j |} |j |j |} d || d || i} |j f| } d | ||j ||j|d fS)z:Return (date_list, items, extra_context) for this request.10)z%Wz%Uz%Vz'Unknown week format %r. Choices are: %sz, z%Vz%GzeISO week directive '%s' is incompatible with the year directive '%s'. Use the ISO year '%%G' instead.z%wz%s__gtez%s__ltN)rCZ next_weekZ previous_week)rrDrRrBrr%joinsortedrrrarJrxrErF) rrrCrPrAZ week_choicesZ week_startrrrbrcrrvrrrrhs4      z#BaseWeekArchiveView.get_dated_itemsN)r(r)r*r+rhrrrrrsrc@seZdZdZdZdS)WeekArchiveViewz*List of objects published in a given week.Z _archive_weekN)r(r)r*r+rrrrrr src@s eZdZdZddZddZdS)BaseDayArchiveViewz)List of objects published on a given day.cCs@|j}|j}|j}t||j||j||j}|j|S)z:Return (date_list, items, extra_context) for this request.)rr/r8rrr.r7_get_dated_items)rrr"r#rrrrrhs  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)rdrxr:r9r1r0)rrrrvrrrrs  z#BaseDayArchiveView._get_dated_itemsN)r(r)r*r+rhrrrrrrs rc@seZdZdZdZdS)DayArchiveViewz)List of objects published on a given day. _archive_dayN)r(r)r*r+rrrrrr-src@seZdZdZddZdS)BaseTodayArchiveViewz List of objects published today.cCs|jtjjS)z:Return (date_list, items, extra_context) for this request.)rr<rtoday)rrrrrh5sz$BaseTodayArchiveView.get_dated_itemsN)r(r)r*r+rhrrrrr2src@seZdZdZdZdS)TodayArchiveViewz List of objects published today.rN)r(r)r*r+rrrrrr:srcs"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|}tj|dS)z%Get the object this request displays.NzZFuture %(verbose_name_plural)s not available because %(class_name)s.allow_future is False.)ro class_name)r})rr/r8rrr.r7rVrTr<rrrrrUrWrorQr(rdrpsuper get_object)rr}rr"r#rrvr)rQrrrDs    zBaseDateDetailView.get_object)N)r(r)r*r+r __classcell__rr)rQrr?src@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+rrrrrrbsr__c Csv|||||}t||t||t|}ytjj||jStk rpttd||dYnXdS)z 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. uCInvalid date string “%(datestr)s” given format “%(format)s”)datestrformatN)strr<strptimerr%rr) rrr"r-r#r6delimrrrrrrjs rc 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) aV 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)rRrqrTgetattrr<r=rsrar[rrrrVrpZorder_by IndexErrorrr_ localtimer)Z generic_viewrrrrPrwrSZ get_currentZget_nextstartendresultrurmrrrvrrrrzsB    rcCstjrtjStjjSdS)z1Return the current date in the current time zone.N)rr_rZ localdater<rrrrrrrssrs)rrrrr)/r<Z django.confrZdjango.core.exceptionsrZ django.dbrZ django.httprZ django.utilsrZdjango.utils.functionalrZdjango.utils.translationrrZdjango.views.generic.baser Zdjango.views.generic.detailr r Zdjango.views.generic.listr r rr,r5r@rOrerrrrrrrrrrrrrrrrrsrrrrsB        14.?@R)+# Z