From 762079cd25921596b9e1227e6c3bad6d465c430f Mon Sep 17 00:00:00 2001
From: Armin Ronacher <armin.ronacher@active-4.com>
Date: Thu, 8 May 2008 23:57:56 +0200
Subject: [PATCH] more updates on the extension API

--HG--
branch : trunk
---
 docs/_static/metal.png  | Bin 0 -> 21543 bytes
 docs/_static/style.css  |   5 +-
 docs/api.rst            |   2 +-
 docs/cache_extension.py |  39 +++++++--------
 docs/extensions.rst     | 104 ++++++++++++++++++++--------------------
 jinja2/environment.py   |   9 ++++
 jinja2/ext.py           |  74 ++++++++++++++--------------
 jinja2/nodes.py         |   3 +-
 jinja2/parser.py        |  11 ++++-
 9 files changed, 132 insertions(+), 115 deletions(-)
 create mode 100644 docs/_static/metal.png

diff --git a/docs/_static/metal.png b/docs/_static/metal.png
new file mode 100644
index 0000000000000000000000000000000000000000..97166f131933d6808f8098ba09075c4f973dbe6c
GIT binary patch
literal 21543
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
NPFq9&ezh7R;y>T5HH!cM

literal 0
HcmV?d00001

diff --git a/docs/_static/style.css b/docs/_static/style.css
index 46748d0..097b229 100644
--- a/docs/_static/style.css
+++ b/docs/_static/style.css
@@ -179,7 +179,7 @@ a:hover {
 }
 
 pre {
-    background-color: #f9f9f9;
+    background: #ededed url(metal.png);
     border-top: 1px solid #ccc;
     border-bottom: 1px solid #ccc;
     padding: 5px;
@@ -296,7 +296,8 @@ table.indextable dl dd a {
 
 dl.function dt,
 dl.class dt,
-dl.exception dt {
+dl.exception dt,
+dl.method dt {
     font-weight: normal;
 }
 
diff --git a/docs/api.rst b/docs/api.rst
index 82bb531..4ce79ff 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -48,7 +48,7 @@ High Level API
 --------------
 
 .. autoclass:: jinja2.environment.Environment([options])
-    :members: from_string, get_template, join_path, parse, lex
+    :members: from_string, get_template, join_path, parse, lex, extend
 
     .. attribute:: shared
 
diff --git a/docs/cache_extension.py b/docs/cache_extension.py
index 19839fe..c9ed92c 100644
--- a/docs/cache_extension.py
+++ b/docs/cache_extension.py
@@ -2,19 +2,18 @@ from jinja2 import nodes
 from jinja2.ext import Extension
 
 
-class CacheExtension(Extension):
-    """Adds support for fragment caching to Jinja2."""
+class FragmentCacheExtension(Extension):
+    # a set of names that trigger the extension.
     tags = set(['cache'])
 
     def __init__(self, environment):
-        Extension.__init__(self, environment)
+        super(FragmentCacheExtension, self).__init__(environment)
 
-        # default dummy implementations.  If the class does not implement
-        # those methods we add some noop defaults.
-        if not hasattr(environment, 'add_fragment_to_cache'):
-            environment.add_fragment_to_cache = lambda n, v, t: None
-        if not hasattr(environment, 'load_fragment_from_cache'):
-            environment.load_fragment_from_cache = lambda n: None
+        # add the defaults to the environment
+        environment.extend(
+            fragment_cache_prefix='',
+            fragment_cache=None
+        )
 
     def parse(self, parser):
         # the first token is the token that started the tag.  In our case
@@ -26,13 +25,10 @@ class CacheExtension(Extension):
         # now we parse a single expression that is used as cache key.
         args = [parser.parse_expression()]
 
-        # if there is a comma, someone provided the timeout.  parse the
-        # timeout then
-        if parser.stream.current.type is 'comma':
-            parser.stream.next()
+        # if there is a comma, the user provided a timeout.  If not use
+        # None as second parameter.
+        if parser.skip_comma():
             args.append(parser.parse_expression())
-
-        # otherwise set the timeout to `None`
         else:
             args.append(nodes.Const(None))
 
@@ -49,13 +45,14 @@ class CacheExtension(Extension):
 
     def _cache_support(self, name, timeout, caller):
         """Helper callback."""
-        # try to load the block from the cache
-        rv = self.environment.load_fragment_from_cache(name)
-        if rv is not None:
-            return rv
+        key = self.environment.fragment_cache_prefix + name
 
+        # try to load the block from the cache
         # if there is no fragment in the cache, render it and store
         # it in the cache.
-        rv = caller()
-        self.environment.add_fragment_to_cache(name, rv, timeout)
+        rv = self.environment.fragment_cache.get(key)
+        if rv is None:
+            return rv
+            rv = caller()
+            self.environment.fragment_cache.add(key, rv, timeout)
         return rv
diff --git a/docs/extensions.rst b/docs/extensions.rst
index 094afa9..7be9f12 100644
--- a/docs/extensions.rst
+++ b/docs/extensions.rst
@@ -3,8 +3,6 @@
 Extensions
 ==========
 
-.. module:: jinja2.ext
-
 Jinja2 supports extensions that can add extra filters, tests, globals or even
 extend the parser.  The main motivation of extensions is it to move often used
 code into a reusable class like adding support for internationalization.
@@ -32,9 +30,46 @@ used in combination with `gettext`_ or `babel`_.  If the i18n extension is
 enabled Jinja2 provides a `trans` statement that marks the wrapped string as
 translatable and calls `gettext`.
 
-After enabling dummy `_`, `gettext` and `ngettext` functions are added to
-the template globals.  A internationalized application has to override those
-methods with more useful versions.
+After enabling dummy `_` function that forwards calls to `gettext` is added
+to the environment globals.  An internationalized application then has to
+provide at least an `gettext` and optoinally a `ngettext` function into the
+namespace.  Either globally or for each rendering.
+
+After enabling of the extension the environment provides the following
+additional methods:
+
+.. method:: jinja2.Environment.install_gettext_translations(translations)
+
+    Installs a translation globally for that environment.  The tranlations
+    object provided must implement at least `ugettext` and `ungettext`.
+    The `gettext.NullTranslations` and `gettext.GNUTranslations` classes
+    as well as `Babel`_\s `Translations` class are supported.
+
+.. method:: jinja2.Environment.install_null_translations()
+
+    Install dummy gettext functions.  This is useful if you want to prepare
+    the application for internationalization but don't want to implement the
+    full internationalization system yet.
+
+.. method:: jinja2.Environment.uninstall_gettext_translations()
+
+    Uninstall the translations again.
+
+.. method:: jinja2.Environment.extract_translations(source)
+
+    Extract localizable strings from the given template node or source.
+
+    For every string found this function yields a ``(lineno, function,
+    message)`` tuple, where:
+
+    * `lineno` is the number of the line on which the string was found,
+    * `function` is the name of the `gettext` function used (if the
+      string was extracted from embedded Python code), and
+    *  `message` is the string itself (a `unicode` object, or a tuple
+       of `unicode` objects for functions with multiple string arguments).
+
+    If `Babel`_ is installed :ref:`the babel integration <babel-integration>`
+    can be used to extract strings for babel.
 
 For a web application that is available in multiple languages but gives all
 the users the same language (for example a multilingual forum software
@@ -43,40 +78,16 @@ translation methods to the environment at environment generation time::
 
     translations = get_gettext_translations()
     env = Environment(extensions=['jinja.ext.i18n'])
-    env.globals.update(
-        gettext=translations.ugettext,
-        ngettext=translations.ungettext
-    )
+    env.install_gettext_translations(translations)
 
 The `get_gettext_translations` function would return the translator for the
-current configuration.  Keep in mind that Jinja2 uses unicode internally so
-you must pass the `ugettext` and `ungettext` functions to the template.
-
-The default `_` function injected by the extension calls `gettext`
-automatically.
-
-If you want to pass the gettext function into the context at render time
-because you don't know the language/translations earlier and the optimizer
-is enabled (which it is per default), you have to unregister the `gettext`
-and `ugettext` functions first::
-
-    del env.globals['gettext'], env.globals['ugettext']
-
-Jinja2 also provides a way to extract recognized strings.  For one the
-`jinja.ext` module provides a function that can return all the occurences
-of gettext calls in a node (as returned by :meth:`Environment.parse`):
-
-.. autofunction:: extract_from_ast
-
-If `babel`_ is installed :ref:`the babel integration <babel-integration>`
-can be used to.
+current configuration.  (For example by using `gettext.find`)
 
 The usage of the `i18n` extension for template designers is covered as part
 :ref:`of the template documentation <i18n-in-templates>`.
 
-
 .. _gettext: http://docs.python.org/dev/library/gettext
-.. _babel: http://babel.edgewall.org/
+.. _Babel: http://babel.edgewall.org/
 
 
 .. _writing-extensions:
@@ -84,6 +95,8 @@ The usage of the `i18n` extension for template designers is covered as part
 Writing Extensions
 ------------------
 
+.. module:: jinja2.ext
+
 By writing extensions you can add custom tags to Jinja2.  This is a non trival
 task and usually not needed as the default tags and expressions cover all
 common use cases.  The i18n extension is a good example of why extensions are
@@ -92,32 +105,19 @@ useful, another one would be fragment caching.
 Example Extension
 ~~~~~~~~~~~~~~~~~
 
-The following example implements a `cache` tag for Jinja2:
+The following example implements a `cache` tag for Jinja2 by using the
+`Werkzeug`_ caching contrib module:
 
 .. literalinclude:: cache_extension.py
     :language: python
 
-In order to use the cache extension it makes sense to subclass the environment
-to implement the `add_fragment_to_cache` and `load_fragment_from_cache`
-methods.  The following example shows how to use the `Werkzeug`_ caching
-with the extension from above::
+And here is how you use it in an environment::
 
     from jinja2 import Environment
     from werkzeug.contrib.cache import SimpleCache
 
-    cache = SimpleCache()
-    cache_prefix = 'tempalte_fragment/'
-
-    class MyEnvironment(Environment):
-
-        def __init__(self):
-            Environment.__init__(self, extensions=[CacheExtension])
-
-        def add_fragment_to_cache(self, key, value, timeout):
-            cache.add(cache_prefix + key, value, timeout)
-
-        def load_fragment_from_cache(self, key):
-            return cache.get(cache_prefix + key)
+    env = Environment(extensions=[FragmentCacheExtension])
+    env.fragment_cache = SimpleCache()
 
 .. _Werkzeug: http://werkzeug.pocoo.org/
 
@@ -147,8 +147,8 @@ expressions of different types.  The following methods may be used by
 extensions:
 
 .. autoclass:: jinja2.parser.Parser
-    :members: parse_expression, parse_tuple, parse_statements, ignore_colon,
-              free_identifier
+    :members: parse_expression, parse_tuple, parse_statements, skip_colon,
+              skip_comma, free_identifier
 
     .. attribute:: filename
 
diff --git a/jinja2/environment.py b/jinja2/environment.py
index e771dd6..2fbe217 100644
--- a/jinja2/environment.py
+++ b/jinja2/environment.py
@@ -222,6 +222,15 @@ class Environment(object):
 
         _environment_sanity_check(self)
 
+    def extend(self, **attributes):
+        """Add the items to the instance of the environment if they do not exist
+        yet.  This is used by :ref:`extensions <writing-extensions>` to register
+        callbacks and configuration values without breaking inheritance.
+        """
+        for key, value in attributes.iteritems():
+            if not hasattr(self, key):
+                setattr(self, key, value)
+
     def overlay(self, block_start_string=missing, block_end_string=missing,
                 variable_start_string=missing, variable_end_string=missing,
                 comment_start_string=missing, comment_end_string=missing,
diff --git a/jinja2/ext.py b/jinja2/ext.py
index 22adf82..f60b85a 100644
--- a/jinja2/ext.py
+++ b/jinja2/ext.py
@@ -40,6 +40,17 @@ class Extension(object):
     may not store environment specific data on `self`.  The reason for this is
     that an extension can be bound to another environment (for overlays) by
     creating a copy and reassigning the `environment` attribute.
+
+    As extensions are created by the environment they cannot accept any
+    arguments for configuration.  One may want to work around that by using
+    a factory function, but that is not possible as extensions are identified
+    by their import name.  The correct way to configure the extension is
+    storing the configuration values on the environment.  Because this way the
+    environment ends up acting as central configuration storage the
+    attributes may clash which is why extensions have to ensure that the names
+    they choose for configuration are not too generic.  ``prefix`` for example
+    is a terrible name, ``fragment_cache_prefix`` on the other hand is a good
+    name as includes the name of the extension (fragment cache).
     """
     __metaclass__ = ExtensionRegistry
 
@@ -74,49 +85,40 @@ class Extension(object):
         return nodes.ExtensionAttribute(self.identifier, name, lineno=lineno)
 
 
-class CacheExtension(Extension):
-    """An example extension that adds cacheable blocks."""
-    tags = set(['cache'])
+class InternationalizationExtension(Extension):
+    """This extension adds gettext support to Jinja2."""
+    tags = set(['trans'])
 
     def __init__(self, environment):
         Extension.__init__(self, environment)
-        environment.globals['__cache_ext_support'] = self.cache_support
-
-    def cache_support(self, name, timeout, caller):
-        """Helper for the cache_fragment function."""
-        if not hasattr(environment, 'cache_support'):
-            return caller()
-        args = [name]
-        if timeout is not None:
-            args.append(timeout)
-        return self.environment.cache_support(generate=caller, *args)
+        environment.globals['_'] = contextfunction(lambda c, x: c['gettext'](x))
+        environment.extend(
+            install_gettext_translations=self._install,
+            install_null_translations=self._install_null,
+            uninstall_gettext_translations=self._uninstall,
+            extract_translations=self._extract
+        )
 
-    def parse(self, parser):
-        lineno = parser.stream.next().lineno
-        args = [parser.parse_expression()]
-        if parser.stream.current.type is 'comma':
-            parser.stream.next()
-            args.append(parser.parse_expression())
-        else:
-            args.append(nodes.Const(None, lineno=lineno))
-        body = parser.parse_statements(('name:endcache',), drop_needle=True)
-        return nodes.CallBlock(
-            nodes.Call(nodes.Name('__cache_ext_support', 'load', lineno=lineno),
-            args, [], None, None), [], [], body, lineno=lineno
+    def _install(self, translations):
+        self.environment.globals.update(
+            gettext=translations.ugettext,
+            ngettext=translations.ungettext
         )
 
+    def _install_null(self):
+        self.environment.globals.update(
+            gettext=lambda x: x,
+            ngettext=lambda s, p, n: (n != 1 and (p,) or (s,))[0]
+        )
 
-class InternationalizationExtension(Extension):
-    """This extension adds gettext support to Jinja."""
-    tags = set(['trans'])
+    def _uninstall(self, translations):
+        for key in 'gettext', 'ngettext':
+            self.environment.globals.pop(key, None)
 
-    def __init__(self, environment):
-        Extension.__init__(self, environment)
-        environment.globals.update({
-            '_':        contextfunction(lambda c, x: c['gettext'](x)),
-            'gettext':  lambda x: x,
-            'ngettext': lambda s, p, n: (s, p)[n != 1]
-        })
+    def _extract(self, source, gettext_functions=GETTEXT_FUNCTIONS):
+        if isinstance(source, basestring):
+            source = self.environment.parse(source)
+        return extract_from_ast(source, gettext_functions)
 
     def parse(self, parser):
         """Parse a translatable tag."""
@@ -132,7 +134,7 @@ class InternationalizationExtension(Extension):
                 parser.stream.expect('comma')
 
             # skip colon for python compatibility
-            if parser.ignore_colon():
+            if parser.skip_colon():
                 break
 
             name = parser.stream.expect('name')
diff --git a/jinja2/nodes.py b/jinja2/nodes.py
index 0d921a7..2519682 100644
--- a/jinja2/nodes.py
+++ b/jinja2/nodes.py
@@ -742,7 +742,8 @@ class ImportedName(Expr):
 
 class InternalName(Expr):
     """An internal name in the compiler.  You cannot create these nodes
-    yourself but the parser provides a `free_identifier` method that creates
+    yourself but the parser provides a
+    :meth:`~jinja2.parser.Parser.free_identifier` method that creates
     a new identifier for you.  This identifier is not available from the
     template and is not threated specially by the compiler.
     """
diff --git a/jinja2/parser.py b/jinja2/parser.py
index 91a848b..427cb05 100644
--- a/jinja2/parser.py
+++ b/jinja2/parser.py
@@ -42,13 +42,20 @@ class Parser(object):
                                             'rparen') or \
                self.stream.current.test('name:in')
 
-    def ignore_colon(self):
+    def skip_colon(self):
         """If there is a colon, skip it and return `True`, else `False`."""
         if self.stream.current.type is 'colon':
             self.stream.next()
             return True
         return False
 
+    def skip_comma(self):
+        """If there is a comma, skip it and return `True`, else `False`."""
+        if self.stream.current.type is 'comma':
+            self.stream.next()
+            return True
+        return False
+
     def free_identifier(self, lineno=None):
         """Return a new free identifier as :class:`~jinja2.nodes.InternalName`."""
         self._last_identifier += 1
@@ -100,7 +107,7 @@ class Parser(object):
         can be set to `True` and the end token is removed.
         """
         # the first token may be a colon for python compatibility
-        self.ignore_colon()
+        self.skip_colon()
 
         # in the future it would be possible to add whole code sections
         # by adding some sort of end of statement token and parsing those here.
-- 
2.26.2