20
20
'''Media file support for the framework.'''
29
from ivle.config import Config
27
30
from ivle.webapp.base.views import BaseView
28
from ivle.webapp.base.plugins import ViewPlugin, MediaPlugin
31
from ivle.webapp.base.plugins import PublicViewPlugin, ViewPlugin, MediaPlugin
29
32
from ivle.webapp.errors import NotFound, Forbidden
31
34
def media_url(req, plugin, path):
32
35
'''Generates a URL to a media file.
34
37
Plugin can be a string, in which case it is put into the path literally,
35
or a plugin object, in which case its name is looked up.'''
38
or a plugin object, in which case its name is looked up.
40
If a version is specified in the IVLE configuration, a versioned URL will
36
43
if not isinstance(plugin, basestring):
37
plugin = req.reverse_plugins[plugin]
39
return os.path.join(ivle.conf.root_dir, '+media', plugin, path)
41
class MediaFileView(BaseView):
44
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):
42
54
'''A view for media files.
44
56
This serves static files from directories registered by plugins.
55
67
def _make_filename(self, req):
57
plugin = req.plugins[self.ns]
61
if not issubclass(plugin, MediaPlugin):
64
mediadir = plugin.media
65
plugindir = os.path.dirname(inspect.getmodule(plugin).__file__)
67
return os.path.join(plugindir, mediadir, self.path)
68
raise NotImplementedError()
69
70
def render(self, req):
70
71
# If it begins with ".." or separator, it's illegal. Die.
87
88
req.content_type = type
88
89
req.sendfile(filename)
90
class Plugin(ViewPlugin):
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)
143
class Plugin(ViewPlugin, PublicViewPlugin):
145
('+media/+:version/:ns/*path', VersionedMediaFileView),
92
146
('+media/:ns/*path', MediaFileView),