v^ @s\ddlmZddlmZmZejZGdddZGdddZdS))settings) constantsutilsc@smeZdZdZdddZddZddZd d Zed d Z ed dZ dS)Messagez Represent an actual message that can be stored in any of the supported storage classes (typically session- or cookie-based) and rendered in a view or template. NcCs%t||_||_||_dS)N)intlevelmessage extra_tags)selfrrr r F/tmp/pip-build-8lau8j11/django/django/contrib/messages/storage/base.py__init__s zMessage.__init__cCs=t|j|_|jdk r0t|jnd|_dS)z Prepare the message for serialization by forcing the ``message`` and ``extra_tags`` to str in case they are lazy translations. N)strrr )r r r r _prepareszMessage._preparecCs1t|to0|j|jko0|j|jkS)N) isinstancerrr)r otherr r r __eq__s!zMessage.__eq__cCs t|jS)N)rr)r r r r __str__szMessage.__str__cCs&djdd|j|jgDS)N css|]}|r|VqdS)Nr ).0tagr r r $szMessage.tags..)joinr level_tag)r r r r tags"sz Message.tagscCstj|jdS)N) LEVEL_TAGSgetr)r r r r r&szMessage.level_tag) __name__ __module__ __qualname____doc__r rrrpropertyrrr r r r rs    rcseZdZdZfddZddZddZdd Zed d Z d d Z ddZ ddZ ddZ dddZddZdddZeeeeZS) BaseStoragez This is the base backend for temporary message storage. This is not a complete class; to be a usable storage backend, it must be subclassed and the two methods ``_get`` and ``_store`` overridden. cs;||_g|_d|_d|_tj||dS)NF)request_queued_messagesused added_newsuperr )r r$argskwargs) __class__r r r 3s     zBaseStorage.__init__cCst|jt|jS)N)len_loaded_messagesr%)r r r r __len__:szBaseStorage.__len__cCs;d|_|jr.|jj|jg|_t|jS)NT)r&r%r-extenditer)r r r r __iter__=s    zBaseStorage.__iter__cCs||jkp||jkS)N)r-r%)r itemr r r __contains__DszBaseStorage.__contains__cCs7t|ds0|j\}}|p*g|_|jS)zs Return a list of loaded messages, retrieving them first if they have not been loaded yet. _loaded_data)hasattr_getr4)r messagesZ all_retrievedr r r r-GszBaseStorage._loaded_messagescOstddS)a Retrieve a list of stored messages. Return a tuple of the messages and a flag indicating whether or not all the messages originally intended to be stored in this storage were, in fact, stored and retrieved; e.g., ``(messages, all_retrieved)``. **This method must be implemented by a subclass.** If it is possible to tell if the backend was not used (as opposed to just containing no messages) then ``None`` should be returned in place of ``messages``. z6subclasses of BaseStorage must provide a _get() methodN)NotImplementedError)r r)r*r r r r6Rs zBaseStorage._getcOstddS)z Store a list of messages and return a list of any messages which could not be stored. One type of object must be able to be stored, ``Message``. **This method must be implemented by a subclass.** z8subclasses of BaseStorage must provide a _store() methodN)r8)r r7responser)r*r r r _storeas zBaseStorage._storecCsx|D]}|jqWdS)z9 Prepare a list of messages for storage. N)r)r r7rr r r _prepare_messagesls zBaseStorage._prepare_messagescCsY|j|j|jr,|j|j|S|jrU|j|j}|j||SdS)z Store all unread messages. If the backend has yet to be iterated, store previously stored messages again. Otherwise, only store messages added after the last iteration. N)r;r%r&r:r'r-)r r9r7r r r updatess   zBaseStorage.updatercCs[|s dSt|}||jkr)dSd|_t||d|}|jj|dS)z Queue a message to be stored. The message is only queued if it contained something and its level is not less than the recording level (``self.level``). NTr )rrr'rr%append)r rrr r r r adds  zBaseStorage.addcCs.t|ds'ttdtj|_|jS)z Return the minimum recorded level. The default level is the ``MESSAGE_LEVEL`` setting. If this is not found, the ``INFO`` level is used. _levelZ MESSAGE_LEVEL)r5getattrrrINFOr?)r r r r _get_levelszBaseStorage._get_levelNcCs7|dkr$t|dr$|`nt||_dS)z Set a custom minimum recorded level. If set to ``None``, the default level will be used (see the ``_get_level`` method). Nr?)r5r?r)r valuer r r _set_levels zBaseStorage._set_level)rrr r!r r.r1r3r"r-r6r:r;r<r>rBrDrr r )r+r r#+s         r#N) Z django.confrZdjango.contrib.messagesrrZget_level_tagsrrr#r r r r s $