29
from ivle.config import Config
30
28
from ivle.webapp.base.views import BaseView
31
29
from ivle.webapp.base.plugins import PublicViewPlugin, ViewPlugin, MediaPlugin
32
30
from ivle.webapp.errors import NotFound, Forbidden
31
from ivle.webapp.publisher import INF
32
from ivle.webapp import ApplicationRoot
34
# This maps a media namespace to an external dependency directory (in this
35
# case specified by the configuration option media/externals/jquery) and a
36
# list of permitted subpaths.
37
EXTERNAL_MEDIA_MAP = {'jquery': ('jquery', ['jquery.js'])}
34
39
def media_url(req, plugin, path):
35
40
'''Generates a URL to a media file.
43
48
if not isinstance(plugin, basestring):
44
49
plugin = req.config.reverse_plugins[plugin]
48
media_path = os.path.join('+media', '+' + config['media']['version']) if \
49
config['media']['version'] else '+media'
51
return os.path.join(ivle.conf.root_dir, media_path, plugin, path)
53
class BaseMediaFileView(BaseView):
54
'''A view for media files.
56
This serves static files from directories registered by plugins.
58
Plugins wishing to export media should declare a 'media' attribute,
59
pointing to the directory to serve (relative to the module's directory).
60
The contents of that directory will then be available under
61
/+media/python.path.to.module.
63
def __init__(self, req, ns, path):
51
media_path = os.path.join('+media', '+' + req.config['media']['version']) \
52
if req.config['media']['version'] else '+media'
54
return req.make_path(os.path.join(media_path, plugin, path))
56
class MediaFile(object):
57
def __init__(self, root, external, version, ns, path):
59
self.external = external
60
self.version = version
67
def _make_filename(self, req):
68
raise NotImplementedError()
68
extern = EXTERNAL_MEDIA_MAP[self.ns]
72
# Unless it's a whitelisted path, we don't want to hear about it.
73
# If the whitelist is None (not []), we allow all.
74
if extern[1] is not None and self.path not in extern[1]:
77
# Grab the admin-configured path for this particular external dep.
78
externdir = self.root.config['media']['externals'][extern[0]]
80
assert isinstance(externdir, basestring)
82
return os.path.join(externdir, self.path)
85
plugin = self.root.config.plugins[self.ns]
89
if not issubclass(plugin, MediaPlugin):
92
mediadir = plugin.media
93
plugindir = os.path.dirname(inspect.getmodule(plugin).__file__)
95
return os.path.join(plugindir, mediadir, self.path)
97
class MediaFileView(BaseView):
98
def authorize(self, req):
70
101
def render(self, req):
71
102
# If it begins with ".." or separator, it's illegal. Die.
72
if self.path.startswith("..") or self.path.startswith('/'):
103
if self.context.path.startswith("..") or \
104
self.context.path.startswith('/'):
75
filename = self._make_filename(req)
107
filename = self.get_filename(req)
77
111
# Find an appropriate MIME type.
78
112
(type, _) = mimetypes.guess_type(filename)
85
119
if not os.access(filename, os.R_OK) or os.path.isdir(filename):
122
if self.context.version is not None:
123
req.headers_out['Expires'] = email.utils.formatdate(
124
timeval=time.time() + (60*60*24*365),
88
129
req.content_type = type
89
130
req.sendfile(filename)
92
class MediaFileView(BaseMediaFileView):
93
'''A view for media files.
95
This serves static files from directories registered by plugins.
97
Plugins wishing to export media should declare a 'media' attribute,
98
pointing to the directory to serve (relative to the module's directory).
99
The contents of that directory will then be available under
100
/+media/python.path.to.module.
104
def _make_filename(self, req):
106
plugin = req.config.plugins[self.ns]
110
if not issubclass(plugin, MediaPlugin):
113
mediadir = plugin.media
114
plugindir = os.path.dirname(inspect.getmodule(plugin).__file__)
116
return os.path.join(plugindir, mediadir, self.path)
118
def get_permissions(self, user):
121
class VersionedMediaFileView(MediaFileView):
122
'''A view for versioned media files, with aggressive caching.
124
This serves static media files with a version string, and requests that
125
browsers cache them for a long time.
128
def __init__(self, req, ns, path, version):
129
super(VersionedMediaFileView, self).__init__(req, ns, path)
130
self.version = version
132
def _make_filename(self, req):
133
if self.version != Config()['media']['version']:
136
# Don't expire for a year.
137
req.headers_out['Expires'] = email.utils.formatdate(
138
timeval=time.time() + (60*60*24*365),
141
return super(VersionedMediaFileView, self)._make_filename(req)
132
def get_filename(self, req):
133
return self.context.filename
135
def root_to_media(root, *segments):
136
if segments[0].startswith('+'):
137
if segments[0] == '+external':
142
version = segments[0][1:]
143
if segments[1] == '+external':
154
if version is not None and version != root.config['media']['version']:
158
path = os.path.normpath(os.path.join(*path[1:]))
160
return MediaFile(root, external, version, ns, path)
143
162
class Plugin(ViewPlugin, PublicViewPlugin):
145
('+media/+:version/:ns/*path', VersionedMediaFileView),
146
('+media/:ns/*path', MediaFileView),
163
forward_routes = [(ApplicationRoot, '+media', root_to_media, INF)]
164
views = [(MediaFile, '+index', MediaFileView)]
165
public_forward_routes = forward_routes