[PATCH 2 of 5] templatefilter: use decorator to mark a function as template filter
FUJIWARA Katsunori
foozy at lares.dti.ne.jp
Wed Dec 23 10:46:38 CST 2015
# HG changeset patch
# User FUJIWARA Katsunori <foozy at lares.dti.ne.jp>
# Date 1450888882 -32400
# Thu Dec 24 01:41:22 2015 +0900
# Node ID 1f82fc126080883bc931a26648e53298cbdbf047
# Parent e49528b9e652dc0e5d2543ea34de3068f78ae9ed
templatefilter: use decorator to mark a function as template filter
Using decorator can localize changes for adding (or removing) a
template filter function in source code.
It is also useful to pick filters up for specific purpose. For
example, I'm planning to make "hg help templates" show the list of
keywords referring each element (or information of it) of a list in
"expr % '{template}'" form (e.g. '{line}' for 'splitlines'
filterring).
To avoid (1) redundancy between "filter name" string and (the
beginning of) help document, and (2) accidental typo of help document,
this patch also makes decorator put filter name into the beginning of
help.
This uses not 'filter' but 'templatefilter', because the former name
hides Python built-in one, even though the latter is a little
redundant in 'templatefilters.py'.
diff --git a/hgext/keyword.py b/hgext/keyword.py
--- a/hgext/keyword.py
+++ b/hgext/keyword.py
@@ -118,27 +118,26 @@ colortable = {
}
# date like in cvs' $Date
+ at templatefilters.templatefilter('utcdate')
def utcdate(text):
- ''':utcdate: Date. Returns a UTC-date in this format: "2009/08/18 11:00:13".
+ '''Date. Returns a UTC-date in this format: "2009/08/18 11:00:13".
'''
return util.datestr((util.parsedate(text)[0], 0), '%Y/%m/%d %H:%M:%S')
# date like in svn's $Date
+ at templatefilters.templatefilter('svnisodate')
def svnisodate(text):
- ''':svnisodate: Date. Returns a date in this format: "2009-08-18 13:00:13
+ '''Date. Returns a date in this format: "2009-08-18 13:00:13
+0200 (Tue, 18 Aug 2009)".
'''
return util.datestr(text, '%Y-%m-%d %H:%M:%S %1%2 (%a, %d %b %Y)')
# date like in svn's $Id
+ at templatefilters.templatefilter('svnutcdate')
def svnutcdate(text):
- ''':svnutcdate: Date. Returns a UTC-date in this format: "2009-08-18
+ '''Date. Returns a UTC-date in this format: "2009-08-18
11:00:13Z".
'''
return util.datestr((util.parsedate(text)[0], 0), '%Y-%m-%d %H:%M:%SZ')
-templatefilters.filters.update({'utcdate': utcdate,
- 'svnisodate': svnisodate,
- 'svnutcdate': svnutcdate})
-
# make keyword tools accessible
kwtools = {'templater': None, 'hgcmd': ''}
diff --git a/mercurial/templatefilters.py b/mercurial/templatefilters.py
--- a/mercurial/templatefilters.py
+++ b/mercurial/templatefilters.py
@@ -21,8 +21,27 @@ from . import (
util,
)
+# filters are callables like:
+# fn(obj)
+# with:
+# obj - object to be filtered (text, date, list and so on)
+filters = {}
+
+def templatefilter(name):
+ """Return a decorator for template filter function
+
+ 'name' argument is the filter name.
+ """
+ def decorator(func):
+ filters[name] = func
+ if func.__doc__:
+ func.__doc__ = ":%s: %s" % (name, func.__doc__.strip())
+ return func
+ return decorator
+
+ at templatefilter('addbreaks')
def addbreaks(text):
- """:addbreaks: Any text. Add an XHTML "<br />" tag before the end of
+ """Any text. Add an XHTML "<br />" tag before the end of
every line except the last.
"""
return text.replace('\n', '<br/>\n')
@@ -35,8 +54,9 @@ agescales = [("year", 3600 * 24 * 365, '
("minute", 60, 'm'),
("second", 1, 's')]
+ at templatefilter('age')
def age(date, abbrev=False):
- """:age: Date. Returns a human-readable date/time difference between the
+ """Date. Returns a human-readable date/time difference between the
given date/time and the current date/time.
"""
@@ -69,20 +89,23 @@ def age(date, abbrev=False):
return '%s from now' % fmt(t, n, a)
return '%s ago' % fmt(t, n, a)
+ at templatefilter('basename')
def basename(path):
- """:basename: Any text. Treats the text as a path, and returns the last
+ """Any text. Treats the text as a path, and returns the last
component of the path after splitting by the path separator
(ignoring trailing separators). For example, "foo/bar/baz" becomes
"baz" and "foo/bar//" becomes "bar".
"""
return os.path.basename(path)
+ at templatefilter('count')
def count(i):
- """:count: List or text. Returns the length as an integer."""
+ """List or text. Returns the length as an integer."""
return len(i)
+ at templatefilter('domain')
def domain(author):
- """:domain: Any text. Finds the first string that looks like an email
+ """Any text. Finds the first string that looks like an email
address, and extracts just the domain component. Example: ``User
<user at example.com>`` becomes ``example.com``.
"""
@@ -95,15 +118,17 @@ def domain(author):
author = author[:f]
return author
+ at templatefilter('email')
def email(text):
- """:email: Any text. Extracts the first string that looks like an email
+ """Any text. Extracts the first string that looks like an email
address. Example: ``User <user at example.com>`` becomes
``user at example.com``.
"""
return util.email(text)
+ at templatefilter('escape')
def escape(text):
- """:escape: Any text. Replaces the special XML/XHTML characters "&", "<"
+ """Any text. Replaces the special XML/XHTML characters "&", "<"
and ">" with XML entities, and filters out NUL characters.
"""
return cgi.escape(text.replace('\0', ''), True)
@@ -137,41 +162,48 @@ def fill(text, width, initindent='', han
width, initindent, hangindent) + rest
for para, rest in findparas()])
+ at templatefilter('fill68')
def fill68(text):
- """:fill68: Any text. Wraps the text to fit in 68 columns."""
+ """Any text. Wraps the text to fit in 68 columns."""
return fill(text, 68)
+ at templatefilter('fill76')
def fill76(text):
- """:fill76: Any text. Wraps the text to fit in 76 columns."""
+ """Any text. Wraps the text to fit in 76 columns."""
return fill(text, 76)
+ at templatefilter('firstline')
def firstline(text):
- """:firstline: Any text. Returns the first line of text."""
+ """Any text. Returns the first line of text."""
try:
return text.splitlines(True)[0].rstrip('\r\n')
except IndexError:
return ''
+ at templatefilter('hex')
def hexfilter(text):
- """:hex: Any text. Convert a binary Mercurial node identifier into
+ """Any text. Convert a binary Mercurial node identifier into
its long hexadecimal representation.
"""
return node.hex(text)
+ at templatefilter('hgdate')
def hgdate(text):
- """:hgdate: Date. Returns the date as a pair of numbers: "1157407993
+ """Date. Returns the date as a pair of numbers: "1157407993
25200" (Unix timestamp, timezone offset).
"""
return "%d %d" % text
+ at templatefilter('isodate')
def isodate(text):
- """:isodate: Date. Returns the date in ISO 8601 format: "2009-08-18 13:00
+ """Date. Returns the date in ISO 8601 format: "2009-08-18 13:00
+0200".
"""
return util.datestr(text, '%Y-%m-%d %H:%M %1%2')
+ at templatefilter('isodatesec')
def isodatesec(text):
- """:isodatesec: Date. Returns the date in ISO 8601 format, including
+ """Date. Returns the date in ISO 8601 format, including
seconds: "2009-08-18 13:00:13 +0200". See also the rfc3339date
filter.
"""
@@ -192,6 +224,7 @@ def indent(text, prefix):
yield '\n'
return "".join(indenter())
+ at templatefilter('json')
def json(obj):
if obj is None or obj is False or obj is True:
return {None: 'null', False: 'false', True: 'true'}[obj]
@@ -234,26 +267,31 @@ def _uescape(c):
('<', '\\u003c'), ('>', '\\u003e'), ('\0', '\\u0000')
]
+ at templatefilter('jsonescape')
def jsonescape(s):
for k, v in _escapes:
s = s.replace(k, v)
return ''.join(_uescape(c) for c in s)
+ at templatefilter('lower')
def lower(text):
- """:lower: Any text. Converts the text to lowercase."""
+ """Any text. Converts the text to lowercase."""
return encoding.lower(text)
+ at templatefilter('nonempty')
def nonempty(str):
- """:nonempty: Any text. Returns '(none)' if the string is empty."""
+ """Any text. Returns '(none)' if the string is empty."""
return str or "(none)"
+ at templatefilter('obfuscate')
def obfuscate(text):
- """:obfuscate: Any text. Returns the input text rendered as a sequence of
+ """Any text. Returns the input text rendered as a sequence of
XML entities.
"""
text = unicode(text, encoding.encoding, 'replace')
return ''.join(['&#%d;' % ord(c) for c in text])
+ at templatefilter('permissions')
def permissions(flags):
if "l" in flags:
return "lrwxrwxrwx"
@@ -261,8 +299,9 @@ def permissions(flags):
return "-rwxr-xr-x"
return "-rw-r--r--"
+ at templatefilter('person')
def person(author):
- """:person: Any text. Returns the name before an email address,
+ """Any text. Returns the name before an email address,
interpreting it as per RFC 5322.
>>> person('foo at bar')
@@ -288,52 +327,61 @@ def person(author):
f = author.find('@')
return author[:f].replace('.', ' ')
+ at templatefilter('revescape')
def revescape(text):
- """:revescape: Any text. Escapes all "special" characters, except @.
+ """Any text. Escapes all "special" characters, except @.
Forward slashes are escaped twice to prevent web servers from prematurely
unescaping them. For example, "@foo bar/baz" becomes "@foo%20bar%252Fbaz".
"""
return urllib.quote(text, safe='/@').replace('/', '%252F')
+ at templatefilter('rfc3339date')
def rfc3339date(text):
- """:rfc3339date: Date. Returns a date using the Internet date format
+ """Date. Returns a date using the Internet date format
specified in RFC 3339: "2009-08-18T13:00:13+02:00".
"""
return util.datestr(text, "%Y-%m-%dT%H:%M:%S%1:%2")
+ at templatefilter('rfc822date')
def rfc822date(text):
- """:rfc822date: Date. Returns a date using the same format used in email
+ """Date. Returns a date using the same format used in email
headers: "Tue, 18 Aug 2009 13:00:13 +0200".
"""
return util.datestr(text, "%a, %d %b %Y %H:%M:%S %1%2")
+ at templatefilter('short')
def short(text):
- """:short: Changeset hash. Returns the short form of a changeset hash,
+ """Changeset hash. Returns the short form of a changeset hash,
i.e. a 12 hexadecimal digit string.
"""
return text[:12]
+ at templatefilter('shortbisect')
def shortbisect(text):
- """:shortbisect: Any text. Treats `text` as a bisection status, and
+ """Any text. Treats `text` as a bisection status, and
returns a single-character representing the status (G: good, B: bad,
S: skipped, U: untested, I: ignored). Returns single space if `text`
is not a valid bisection status.
"""
return hbisect.shortlabel(text) or ' '
+ at templatefilter('shortdate')
def shortdate(text):
- """:shortdate: Date. Returns a date like "2006-09-18"."""
+ """Date. Returns a date like "2006-09-18"."""
return util.shortdate(text)
+ at templatefilter('splitlines')
def splitlines(text):
- """:splitlines: Any text. Split text into a list of lines."""
+ """Any text. Split text into a list of lines."""
return templatekw.showlist('line', text.splitlines(), 'lines')
+ at templatefilter('stringescape')
def stringescape(text):
return text.encode('string_escape')
+ at templatefilter('stringify')
def stringify(thing):
- """:stringify: Any type. Turns the value into text by converting values into
+ """Any type. Turns the value into text by converting values into
text and concatenating them.
"""
if util.safehasattr(thing, '__iter__') and not isinstance(thing, str):
@@ -342,8 +390,9 @@ def stringify(thing):
return ""
return str(thing)
+ at templatefilter('stripdir')
def stripdir(text):
- """:stripdir: Treat the text as path and strip a directory level, if
+ """Treat the text as path and strip a directory level, if
possible. For example, "foo" and "foo/bar" becomes "foo".
"""
dir = os.path.dirname(text)
@@ -352,31 +401,37 @@ def stripdir(text):
else:
return dir
+ at templatefilter('tabindent')
def tabindent(text):
- """:tabindent: Any text. Returns the text, with every non-empty line
+ """Any text. Returns the text, with every non-empty line
except the first starting with a tab character.
"""
return indent(text, '\t')
+ at templatefilter('upper')
def upper(text):
- """:upper: Any text. Converts the text to uppercase."""
+ """Any text. Converts the text to uppercase."""
return encoding.upper(text)
+ at templatefilter('urlescape')
def urlescape(text):
- """:urlescape: Any text. Escapes all "special" characters. For example,
+ """Any text. Escapes all "special" characters. For example,
"foo bar" becomes "foo%20bar".
"""
return urllib.quote(text)
+ at templatefilter('user')
def userfilter(text):
- """:user: Any text. Returns a short representation of a user name or email
+ """Any text. Returns a short representation of a user name or email
address."""
return util.shortuser(text)
+ at templatefilter('emailuser')
def emailuser(text):
- """:emailuser: Any text. Returns the user portion of an email address."""
+ """Any text. Returns the user portion of an email address."""
return util.emailuser(text)
+ at templatefilter('xmlescape')
def xmlescape(text):
text = (text
.replace('&', '&')
@@ -386,46 +441,6 @@ def xmlescape(text):
.replace("'", ''')) # ' invalid in HTML
return re.sub('[\x00-\x08\x0B\x0C\x0E-\x1F]', ' ', text)
-filters = {
- "addbreaks": addbreaks,
- "age": age,
- "basename": basename,
- "count": count,
- "domain": domain,
- "email": email,
- "escape": escape,
- "fill68": fill68,
- "fill76": fill76,
- "firstline": firstline,
- "hex": hexfilter,
- "hgdate": hgdate,
- "isodate": isodate,
- "isodatesec": isodatesec,
- "json": json,
- "jsonescape": jsonescape,
- "lower": lower,
- "nonempty": nonempty,
- "obfuscate": obfuscate,
- "permissions": permissions,
- "person": person,
- "revescape": revescape,
- "rfc3339date": rfc3339date,
- "rfc822date": rfc822date,
- "short": short,
- "shortbisect": shortbisect,
- "shortdate": shortdate,
- "splitlines": splitlines,
- "stringescape": stringescape,
- "stringify": stringify,
- "stripdir": stripdir,
- "tabindent": tabindent,
- "upper": upper,
- "urlescape": urlescape,
- "user": userfilter,
- "emailuser": emailuser,
- "xmlescape": xmlescape,
-}
-
def websub(text, websubtable):
""":websub: Any text. Only applies to hgweb. Applies the regular
expression replacements defined in the websub section.
diff --git a/tests/test-keyword.t b/tests/test-keyword.t
--- a/tests/test-keyword.t
+++ b/tests/test-keyword.t
@@ -51,6 +51,31 @@ as it would succeed without uisetup othe
Branch = {branches}
$Branch: demobranch $
+(test template filter svnisodate and svnutcdate)
+
+ $ hg --quiet kwdemo --config keywordset.svn=True
+ [extensions]
+ keyword =
+ [keyword]
+ demo.txt =
+ [keywordset]
+ svn = True
+ [keywordmaps]
+ Author = {author|user}
+ Date = {date|svnisodate}
+ Id = {file|basename},v {node|short} {date|svnutcdate} {author|user}
+ LastChangedBy = {author|user}
+ LastChangedDate = {date|svnisodate}
+ LastChangedRevision = {node|short}
+ Revision = {node|short}
+ $Author: test $
+ $Date: ????-??-?? ??:??:?? ????? (???, ?? ??? ????) $ (glob)
+ $Id: demo.txt,v ???????????? ????-??-?? ??:??:??Z test $ (glob)
+ $LastChangedBy: test $
+ $LastChangedDate: ????-??-?? ??:??:?? ????? (???, ?? ??? ????) $ (glob)
+ $LastChangedRevision: ???????????? $ (glob)
+ $Revision: ???????????? $ (glob)
+
$ cat <<EOF >> $HGRCPATH
> [keyword]
> ** =
More information about the Mercurial-devel
mailing list