Ticket #2606: 2606.diff

django/template/defaulttags.py

@@ -297 +297 @@
     def render(self, context):
         return self.mapping.get(self.tagtype, '')
 
+class URLNode(Node):
+    def __init__(self, view_name, args):
+        self.view_name = view_name
+        self.args = args
+      
+    def render(self, context):
+        from django.core.urlresolvers import reverse, NoReverseMatch
+        args = [arg.resolve(context) for arg in self.args]
+        project_name = settings.SETTINGS_MODULE.split('.')[0]
+        try:
+            return reverse(project_name + '.' + self.view_name, args=args)
+        except NoReverseMatch:
+            return ''
+
 class WidthRatioNode(Node):
     def __init__(self, val_expr, max_expr, max_width):
         self.val_expr = val_expr
@@ -837 +851 @@
     return TemplateTagNode(tag)
 templatetag = register.tag(templatetag)
 
+def url(parser, token):
+    """
+    Returns an absolute URL matching given view with its parameters. This is a mean to
+    define links that aren't tied to a particular url configuration.
+    
+    The first argument is a path to a view in the form ``app_name.view_name`` (without
+    the project name). Other arguments are values that will be filled in place of arguments
+    in the URL and thus should be all present. Currently only positional arguments are 
+    supported.
+    
+    For example if you have a view ``app_name.client`` taking client's id and the 
+    corresponding line in the urlconf looks like this:
+    
+        ('^client/(\d+)/$', 'app_name.client')
+    
+    ... and this app's urlconf is included into the project's urlconf under some path:
+    
+        ('^clients/', include('project_name.app_name.urls'))
+    
+    ... then in a template you can create a link for a certain client like this:
+    
+        {% url app_name.client client.id %}
+    
+    The URL will look like ``/clients/client/123/``.
+    """
+    bits = token.contents.split()
+    if len(bits) < 2:
+        raise TemplateSyntaxError, "'url' takes at least one argument (path to a view)"
+    if len(bits) > 2:
+        args = [parser.compile_filter(arg) for arg in bits[2].split(',')]
+    else:
+        args = []
+    return URLNode(bits[1], args)
+url = register.tag(url)
+
 #@register.tag
 def widthratio(parser, token):
     """