Injector pluginsΒΆ

Fanstatic allows you to write your own injector plugins. Injector plugins take care of injecting the needed resources into the HTML of the response.

The default injector plugin is the “TopBottomInjector”, which injects resources into the top (the head section) and bottom (before the closing body tag) of the page.

To write your own injector plugin, you need to do the following:

from fanstatic.injector import InjectorPlugin

class MyInjector(InjectorPlugin):

    name = 'mine'

    def __init__(self, options):
        """Optionally, you can control the configuration of the injector
        plugin here. The options are taken from the local_conf of the paste
        deploy configuration. Don't forget to super()."""

    def __call__(self, html, needed, request=None, response=None):
        """Render the needed resources into the html.
           The request and response arguments are
           webob Request and Response objects that may be relevant for how
           you want to inject the resources.

           You may want to group the resources in the needed resources.
           For every group call self.make_inclusion(), which will return an
           Inclusion object. Calling render() on an Inclusion object,
           will return an html snippet, which you can then include in the
           html.
        """
        needed_html = self.make_inclusion(needed).render()
        return html.replace('<head>', '<head>%s' % needed_html, 1)

After writing the plugin code, register the plugin through the “fanstatic.injectors” entry point.

An example of an injector plugin with configuration taken from paste deploy can be found in the sylva.fanstatic package.