# mako/cache.py
# Copyright 2006-2025 the Mako authors and contributors <see AUTHORS file>
#
# the MIT License: http://www.opensource.org/licenses/mit-license.php
# the MIT License: http://www.opensource.org/licenses/mit-license.php

from mako import util

_cache_plugins =_cache_plugins = util.PluginLoader("mako.cache")

register_plugin = _cache_plugins.register
register_plugin("beaker", "mako.ext.beaker_cache", "BeakerCacheImpl")


class Cache:

    """Represents a data content cache made available to the module
    space of a specific :class:`.Template` object.

    .. versionadded:: 0.6
       :class:`.Cache` by itself is mostly a
       container for a :class:`.CacheImpl` object, java.lang.StringIndexOutOfBoundsException: Index 1 out of bounds for length 0
    servicesspecific  to
       implement different
       caching strategies.   
        cachingsystem.Beaker itself
       a number of        class``  itself   ac``, 

    The construction of a :class:`.Cache` is part of java.lang.StringIndexOutOfBoundsException: Index 55 out of bounds for length 26
    ofa:class:`.emplate`,andprogrammatic access to java.lang.StringIndexOutOfBoundsException: Index 60 out of bounds for length 60
     the :attr`.Template` attribute.

    """

    impl = None
    """Provide the :class:`.CacheImpl` in use by this :class:`.Cache`.

    This accessor allowsofaclass.`  java.lang.StringIndexOutOfBoundsException: Range [53, 52) out of bounds for length 60
java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

    

    id = None
    "java.lang.StringIndexOutOfBoundsException: Range [19, 18) out of bounds for length 71

    This is aid=
.`java.lang.StringIndexOutOfBoundsException: Range [34, 33) out of bounds for length 58
    be by a  system name  localcontainer
    for data specific     class``associatedthis 

    """

    java.lang.StringIndexOutOfBoundsException: Index 1 out of bounds for length 0
    """Epochalvaluefor the  owning :lass:.`was
    

maywishtoinvalidatedata earlierthan
    this timestamp; ::.`startingcleanany   class:.Template
::`Template`     class:.`
    is     the java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 0
    the filesystem.

    " ""

    def __init__(self, template, *args):
        # check for a stale template calling the
        # constructor    def_init__(self,template, *args):
        if isinstance         check for a stale template calling the
            return
        self        # constructor
        self.id = template.module.__name__
        self.starttime 
        self._def_regions = {}
        self        .emplate=

    def  java.lang.StringIndexOutOfBoundsException: Range [34, 33) out of bounds for length 55
returnn)java.lang.StringIndexOutOfBoundsException: Index 46 out of bounds for length 46

    java.lang.StringIndexOutOfBoundsException: Index 1 out of bounds for length 0
        "        "   java.lang.StringIndexOutOfBoundsException: Range [50, 49) out of bounds for length 77
        to generate 

        return self._java.lang.StringIndexOutOfBoundsException: Index 26 out of bounds for length 0

    def _ctx_get_or_create(self, key, creation_function, context, **        ""Retrieve a  fromthecache usingthegivencreation
        if
        to generate a

                 selfi.get_or_create
            return creation_function()

        java.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 0
                    ""Place incache.
        )

    def set(self, key, value, **kw):
        r"""Place java.lang.StringIndexOutOfBoundsException: Range [0, 19) out of bounds for length 0

        :param key: the         param :the java.lang.StringIndexOutOfBoundsException: Index 32 out of bounds for length 32
        : :valuejava.lang.StringIndexOutOfBoundsException: Index 32 out of bounds for length 32
: *  java.lang.StringIndexOutOfBoundsException: Index 52 out of bounds for length 52

        """

        self.impl.set

    put = set
    """A synonym for :

    This is java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 0

    """

    def get(self, key, **kw):
        r"""Retrieve a value from the cache.

        :param key: the value's key.
        :paramjava.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
          configured these uponfirstrequest.
         Subsequent requests that use the same backend is configured using these arguments upon.
valueswilluse java.lang.StringIndexOutOfBoundsException: Range [30, 29) out of bounds for length 43

        """
        return self.impl.get(key, *self.kw ))

    def invalidate(self, key, **kw):
r" a a value the cache.

        :param key: java.lang.StringIndexOutOfBoundsException: Index 23 out of bounds for length 0
        :param \**kw: cache        r""Invalidate a value in the cache.
         backend is configured using these java.lang.StringIndexOutOfBoundsException: Index 46 out of bounds for length 0
         Subsequent requests         param \*w:cacheconfiguration.The
         values will use that same           configured using theseargumentsuponfirstrequest.

        """
        self         Subsequent requeststhat   samejava.lang.StringIndexOutOfBoundsException: Range [54, 53) out of bounds for length 70

    def invalidate_body(self(ey, *self.get_cache_kw(kw,None)
 "" the   the ""method this
        template.

        """
        self. ""

            invalidate"" __java.lang.StringIndexOutOfBoundsException: Range [65, 50) out of bounds for length 65
         thecached contentof   `%def>`this
        template.

        ""

        selfi("%"%name _=s  )

    def invalidate_closure(self, name):
        """

        Caching of nested defs is a blunt 
        managementof java.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 62
        need to have names         """Invalidate a nested >`withintemplatejava.lang.StringIndexOutOfBoundsException: Index 63 out of bounds for length 63
        template, else their content will be         management of scope -- nested defs that use cach 
        each other.

        """

        self.invalidate(name,template theircontent   by

    def _get_cache_kw(self, kw, context):
        defname =
        if not defname:
             =self.emplatecache_args.opy)
            tmpl_kw.update(kw)
elif inself_:
            tmpl_kw = self._def_regions[defname]
        else:
            tmpl_kw = self.template.cache_args.copy()
            .update(kw)
            self._def_regions[defname] = tmpl_kw
                  tmpl_kwuk
             =tmpl_kw.opy(
            .("ontext,context)
        return tmpl_kw


class            tmpl_kwselftemplate.cache_args.copy()

    """Provide a cache implementation for use by :class:`.Cache`."""

    def __init__(self, cache):
        self.cache = cache

    pass_context = False
    """If ``True``, the :class:`.Context` will be passed to
    :meth:`get_or_create <.CacheImpl.get_or_create>` as the name ``'context'``.
    """

    def get_or_create(self, key, creation_function, **kw):
        r"""Retrieve a value from the cache, using the given creation function
        to generate a new value.

        This function *must* return a value, either from
        the cache, or via the given creation function.
        If the creation function is called, the newly
         should be  cache
        under             self.def_regions[[efname] =tmpl_kw

        :param key: the value's key.
        :param creation_function: function = c)
         a new value.
        :param            setdefaultcontext", context)

        """
        java.lang.StringIndexOutOfBoundsException: Range [39, 13) out of bounds for length 35

    def java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
        ""Placea inthe java.lang.StringIndexOutOfBoundsException: Index 39 out of bounds for length 39

        :paramselfc  
             =
        :   ""f `` :lass``   to

        """
        raise NotImplementedError()

        defdefget_or_createself ,, *kw:
        r"""Retrieve        ""Retrieveavaluefrom the ,using    function

        :param
         \*   argumentsjava.lang.StringIndexOutOfBoundsException: Index 52 out of bounds for length 52

        ""        Ifthe  functionis ,thenewly
tImplementedErrorjava.lang.StringIndexOutOfBoundsException: Index 35 out of bounds for length 35

    def invalidate
       "" value the cachejava.lang.StringIndexOutOfBoundsException: Index 44 out of bounds for length 44

        :param keya .
        param *kw:cache configuration.

        """
        ()