rename 'put' to 'set'

2 files changed, 13 insertions, 3 deletions

diff --git a/CHANGES b/CHANGES
index 388c9b7..a718726 100644
--- a/CHANGES
+++ b/CHANGES
@@ -12,6 +12,9 @@
   core plugin is the mako.cache.CacheImpl
   class.
 
+- [feature] The 'put' method on Cache is now
+  'set'.  'put' is there for backwards compatibility.
+
 - [feature] The <%def>, <%block> and <%page> tags now accept
   any argument named "cache_*", and the key
   minus the "cache_" prefix will be passed as keyword
diff --git a/mako/cache.py b/mako/cache.py
index 2985e69..fe34073 100644
--- a/mako/cache.py
+++ b/mako/cache.py
@@ -81,7 +81,7 @@ class Cache(object):
                         creation_function, 
                         **self._get_cache_kw(kw))
 
-    def put(self, key, value, **kw):
+    def set(self, key, value, **kw):
         """Place a value in the cache.
  
         :param key: the value's key.
@@ -90,7 +90,14 @@ class Cache(object):
  
         """
 
-        self.impl.put(key, value, **self._get_cache_kw(kw))
+        self.impl.set(key, value, **self._get_cache_kw(kw))
+
+    put = set
+    """A synonym for :meth:`.Cache.set`.
+    
+    This is here for backwards compatibility.
+
+    """
 
     def get(self, key, **kw):
         """Retrieve a value from the cache.
@@ -178,7 +185,7 @@ class CacheImpl(object):
         """
         raise NotImplementedError()
 
-    def put(self, key, value, **kw):
+    def set(self, key, value, **kw):
         """Place a value in the cache.
  
         :param key: the value's key.