unfold/page.py

   1 # the supervisor for Plugins
   2 # keeps a handle on all present plugins for managing their queries in a consistent way
   3 # it is expected to exist one such object for a given page
   4
   5 import json
   6
   7 from django.template.loader import render_to_string
   8
   9 from manifold.metadata import MetaData
  10
  11 from unfold.prelude import Prelude
  12
  13 from myslice.config import Config
  14
  15 # decorator to deflect calls on this Page to its prelude
  16 def to_prelude (method):
  17     def actual (self, *args, **kwds):
  18         prelude_method=Prelude.__dict__[method.__name__]
  19         return prelude_method(self.prelude,*args, **kwds)
  20     return actual
  21
  22 debug=False
  23 debug=True
  24
  25 class Page:
  26
  27     def __init__ (self, request):
  28         self.request=request
  29         # all plugins mentioned in this page
  30         self._plugins = {}
  31         # the set of all queries
  32         self._queries=set()
  33         # queue of queries with maybe a domid, see enqueue_query
  34         self._queue=[]
  35         # global prelude object
  36         self.prelude=Prelude(css_files='css/plugin.css')
  37         self.prelude=Prelude(css_files='css/onelab_marko.css')
  38
  39     # record known plugins hashed on their domid
  40     def record_plugin (self, plugin):
  41         self._plugins[plugin.domid]=plugin
  42
  43     def get_plugin (self, domid):
  44         return self._plugins.get(domid,None)
  45
  46     # not sure this is useful at all
  47 #    def reset_queue (self):
  48 #        self._queries = set()
  49 #        self._queue = []
  50
  51     # this method adds a query to the page
  52     # the query will be exposed to js when calling expose_queries
  53     # additionally if run_it is set to True, this query will be asynchroneously triggered on page load
  54     # in this case (exec=True) the js async callback (see manifold.asynchroneous_success)
  55     # offers the option to deliver the result to a specific DOM elt (in this case, set domid)
  56     # otherwise (i.e. if domid not provided), it goes through the pubsub system (so all plugins can receive it)
  57     #
  58     # NOTE:
  59     # analyzed_query is required because it contains query_uuid that the
  60     # plugins initialized in the python part will listen to. When a result is
  61     # received in javascript, subresults should be publish to the appropriate
  62     # query_uuid.
  63     #
  64     def enqueue_query (self, query, run_it=True, domid=None, analyzed_query=None):
  65         # _queries is the set of all known queries
  66         # XXX complex XXX self._queries = self._queries.union(set( [ query, ] ))
  67         self._queries.add((query, analyzed_query))
  68         # _queue is the list of queries that need to be triggered, with an optional domid
  69         # we only do this if run_it is set
  70         if run_it: self._queue.append ( (query.query_uuid,domid) )
  71
  72     # return the javascript code for exposing queries
  73     # all queries are inserted in the global manifold object
  74     # in addition, the ones enqueued with 'run_it=True' are triggered
  75     def expose_queries (self):
  76         # compute variables to expose to the template
  77         env = {}
  78         # expose the json definition of all queries
  79         env['queries_json'] = [ query.to_json(analyzed_query=aq) for (query, aq) in self._queries ]
  80         def query_publish_dom_tuple (a,b):
  81             result={'query_uuid':a}
  82             if b: result['domid']=b
  83             return result
  84         env['query_publish_dom_tuples'] = [ query_publish_dom_tuple (a,b) for (a,b) in self._queue ]
  85         javascript = render_to_string ("page-queries.js",env)
  86         self.add_js_chunks (javascript)
  87 #        self.reset_queue()
  88         # unconditionnally expose MANIFOLD_URL, this is small and manifold.js uses that for various messages
  89         self.expose_js_manifold_config()
  90
  91
  92 # DEPRECATED #    # needs to be called explicitly and only when metadata is actually required
  93 # DEPRECATED #    # in particular user needs to be logged
  94 # DEPRECATED #    def get_metadata (self):
  95 # DEPRECATED #        # look in session's cache - we don't want to retrieve this for every request
  96 # DEPRECATED #        session=self.request.session
  97 # DEPRECATED #        if 'manifold' not in session:
  98 # DEPRECATED #            print "Page.expose_js_metadata: no 'manifold' in session... - cannot retrieve metadata - skipping"
  99 # DEPRECATED #            return
 100 # DEPRECATED #        manifold=session['manifold']
 101 # DEPRECATED #        # if cached, use it
 102 # DEPRECATED #        if 'metadata' in manifold and isinstance(manifold['metadata'],MetaData):
 103 # DEPRECATED #            if debug: print "Page.get_metadata: return cached value"
 104 # DEPRECATED #            return manifold['metadata']
 105 # DEPRECATED #        # otherwise retrieve it
 106 # DEPRECATED #        manifold_api_session_auth = session['manifold']['auth']
 107 # DEPRECATED #        print "get_metadata(), manifold_api_session_auth =", session['manifold']['auth']
 108 # DEPRECATED #        metadata=MetaData (manifold_api_session_auth)
 109 # DEPRECATED #        metadata.fetch()
 110 # DEPRECATED #        # store it for next time
 111 # DEPRECATED #        manifold['metadata']=metadata
 112 # DEPRECATED #        if debug: print "Page.get_metadata: return new value"
 113 # DEPRECATED #        return metadata
 114
 115     # needs to be called explicitly and only when metadata is actually required
 116     # in particular user needs to be logged
 117     def get_metadata (self):
 118         # look in session's cache - we don't want to retrieve this for every request
 119         session=self.request.session
 120
 121         if 'manifold' not in session:
 122             session['manifold'] = {}
 123         manifold = session['manifold']
 124
 125         # if cached, use it
 126         if 'metadata' in manifold and isinstance(manifold['metadata'],MetaData):
 127             if debug: print "Page.get_metadata: return cached value"
 128             return manifold['metadata']
 129
 130         metadata_auth = {'AuthMethod':'anonymous'}
 131
 132         metadata=MetaData (metadata_auth)
 133         metadata.fetch()
 134         # store it for next time
 135         manifold['metadata']=metadata
 136         if debug: print "Page.get_metadata: return new value"
 137         return metadata
 138
 139     def expose_js_metadata (self):
 140         # export in this js global...
 141         self.add_js_chunks("var MANIFOLD_METADATA =" + self.get_metadata().to_json() + ";")
 142
 143     def expose_js_manifold_config (self):
 144         config=Config()
 145         self.add_js_chunks(config.manifold_js_export())
 146
 147     #################### requirements/prelude management
 148     # just forward to self.prelude - see decorator above
 149     @to_prelude
 150     def add_js_files (self):pass
 151     @to_prelude
 152     def add_css_files (self):pass
 153     @to_prelude
 154     def add_js_chunks (self):pass
 155     @to_prelude
 156     def add_css_chunks (self):pass
 157     @to_prelude
 158     def prelude_env (self):pass