a Kcf@sDddlmZddlmZmZeZGdddZGdddZdS))settings) constantsutilsc@sJeZdZdZdddZddZddZd 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. NcCst||_||_||_dSN)intlevelmessage extra_tagsselfrr r r a/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/django/contrib/messages/storage/base.py__init__s zMessage.__init__cCs*t|j|_|jdur t|jnd|_dS)z Prepare the message for serialization by forcing the ``message`` and ``extra_tags`` to str in case they are lazy translations. N)strr r r r r r_prepares zMessage._preparecCs&t|tstS|j|jko$|j|jkSr) isinstancerNotImplementedrr )r otherr r r__eq__s zMessage.__eq__cCs t|jSr)rr rr r r__str__ szMessage.__str__cCsddd|j|jfDS)N css|]}|r|VqdSrr ).0tagr r r %zMessage.tags..)joinr level_tagrr r rtags#sz Message.tagscCst|jdS)N) LEVEL_TAGSgetrrr r rr'szMessage.level_tag)N) __name__ __module__ __qualname____doc__rrrrpropertyrrr r r rrs  rcseZdZdZfddZddZddZdd Zd d Ze d d Z ddZ ddZ ddZ ddZdddZddZdddZe eeeZZS) 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|i|dS)NF)request_queued_messagesused added_newsuperr)r r)argskwargs __class__r rr4s zBaseStorage.__init__cCst|jt|jSr)len_loaded_messagesr*rr r r__len__;szBaseStorage.__len__cCs*d|_|jr |j|jg|_t|jS)NT)r+r*r3extenditerrr r r__iter__>s zBaseStorage.__iter__cCs||jvp||jvSr)r3r*)r itemr r r __contains__EszBaseStorage.__contains__cCsd|jjd|jdS)N)r1r%r)rr r r__repr__HszBaseStorage.__repr__cCs&t|ds |\}}|pg|_|jS)zs Return a list of loaded messages, retrieving them first if they have not been loaded yet. _loaded_data)hasattr_getr=)r messagesZ all_retrievedr r rr3Ks   zBaseStorage._loaded_messagescOs tddS)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() methodNNotImplementedError)r r.r/r r rr?Vs zBaseStorage._getcOs tddS)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() methodNrA)r r@responser.r/r r r_storegs zBaseStorage._storecCs|D] }|qdS)z9 Prepare a list of messages for storage. N)r)r r@r r r r_prepare_messagestszBaseStorage._prepare_messagescCsB||j|jr ||j|S|jr>|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)rEr*r+rDr,r3)r rCr@r r rupdate{s   zBaseStorage.updater cCsB|sdSt|}||jkrdSd|_t|||d}|j|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``). NT)r )rrr,rr*appendr r r radds zBaseStorage.addcCs t|dsttdtj|_|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)r>getattrrrINFOrIrr r r _get_levels zBaseStorage._get_levelNcCs&|durt|dr|`n t||_dS)z Set a custom minimum recorded level. If set to ``None``, the default level will be used (see the ``_get_level`` method). NrI)r>rIr)r valuer r r _set_levelszBaseStorage._set_level)r )N)r#r$r%r&rr4r7r9r<r'r3r?rDrErFrHrLrNr __classcell__r r r0rr(,s      r(N) Z django.confrZdjango.contrib.messagesrrZget_level_tagsr!rr(r r r rs %