1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
# -*- coding: utf-8 -*-
"""
sphinx.web.util
~~~~~~~~~~~~~~~
Miscellaneous utilities.
:copyright: 2007-2008 by Georg Brandl.
:license: BSD.
"""
import re
from os import path
from sphinx.util import relative_uri
from sphinx._jinja import Environment, FileSystemLoader
def get_target_uri(source_filename):
"""Get the web-URI for a given reST file name (without extension)."""
if source_filename == 'index':
return ''
if source_filename.endswith('/index'):
return source_filename[:-5] # up to /
return source_filename + '/'
# ------------------------------------------------------------------------------
# Setup the templating environment
templates_path = path.join(path.dirname(__file__), '..', 'templates')
jinja_env = Environment(loader=FileSystemLoader(templates_path,
use_memcache=True),
friendly_traceback=True)
def do_datetime_format():
def wrapped(env, ctx, value):
return value.strftime('%a, %d %b %Y %H:%M')
return wrapped
jinja_env.filters['datetimeformat'] = do_datetime_format
_striptags_re = re.compile(r'(<!--.*?-->|<[^>]+>)')
def striptags(text):
return ' '.join(_striptags_re.sub('', text).split())
def render_template(req, template_name, *contexts):
context = {}
for ctx in contexts:
context.update(ctx)
tmpl = jinja_env.get_template(template_name)
path = req.path.lstrip('/')
if not path[-1:] == '/':
path += '/'
def relative_path_to(otheruri, resource=False):
if not resource:
otheruri = get_target_uri(otheruri)
return relative_uri(path, otheruri)
context['pathto'] = relative_path_to
# add it here a second time for templates that don't
# get the builder information from the environment (such as search)
context['builder'] = 'web'
context['req'] = req
return tmpl.render(context)
class lazy_property(object):
"""
Descriptor implementing a "lazy property", i.e. the function
calculating the property value is called only once.
"""
def __init__(self, func, name=None, doc=None):
self._func = func
self._name = name or func.func_name
self.__doc__ = doc or func.__doc__
def __get__(self, obj, objtype=None):
if obj is None:
return self
value = self._func(obj)
setattr(obj, self._name, value)
return value
class blackhole_dict(dict):
def __setitem__(self, key, value):
pass
|
