import json
+from django.template.loader import render_to_string
+
+from manifoldapi.metadata import MetaData
+
from unfold.prelude import Prelude
-from manifold.manifoldapi import ManifoldAPI
-from myslice.config import Config
+
+from myslice.configengine import ConfigEngine
# decorator to deflect calls on this Page to its prelude
def to_prelude (method):
return prelude_method(self.prelude,*args, **kwds)
return actual
+debug=False
+debug=True
+
class Page:
def __init__ (self, request):
self.request=request
# all plugins mentioned in this page
self._plugins = {}
- # queue of queries
+ # the set of all queries
+ self._queries=set()
+ # queue of queries with maybe a domid, see enqueue_query
self._queue=[]
# global prelude object
- self.prelude=Prelude(css_files='css/plugin.css')
- # load metadata
- self._metadata={}
- # do not call this uncondionnally as we might not even have logged in
- # self.expose_js_metadata()
+ # global requirements should go in base.html
+ self.prelude=Prelude()
# record known plugins hashed on their domid
def record_plugin (self, plugin):
def get_plugin (self, domid):
return self._plugins.get(domid,None)
+
+ # not sure this is useful at all
+# def reset_queue (self):
+# self._queries = set()
+# self._queue = []
+
+ # this method adds a query to the page
+ # the query will be exposed to js when calling __expose_queries, which is done by prelude_env()
+ # additionally if run_it is set to True, this query will be asynchroneously triggered on page load
+ # in this case (exec=True) the js async callback (see manifold.asynchroneous_success)
+ # offers the option to deliver the result to a specific DOM elt (in this case, set domid)
+ # otherwise (i.e. if domid not provided), it goes through the pubsub system (so all plugins can receive it)
+ #
+ # NOTE:
+ # analyzed_query is required because it contains query_uuid that the
+ # plugins initialized in the python part will listen to. When a result is
+ # received in javascript, subresults should be publish to the appropriate
+ # query_uuid.
+ #
+ def enqueue_query (self, query, run_it=True, domid=None, analyzed_query=None):
+ # _queries is the set of all known queries
+ # XXX complex XXX self._queries = self._queries.union(set( [ query, ] ))
+ self._queries.add((query, analyzed_query))
+ # _queue is the list of queries that need to be triggered, with an optional domid
+ # we only do this if run_it is set
+ if run_it: self._queue.append ( (query.query_uuid,domid) )
+
+ def generate_records(self, query, generators, number=10):
+ self.add_js_files('js/record_generator.js');
+ js_chunk = '$(document).ready(function() { new RecordGenerator(%s,%s,%s).run(); });'%(query.to_json(),json.dumps(generators),number);
+ self.add_js_chunks(js_chunk)
- def reset_queue (self):
- self._queue = []
-
- # the js async methods (see manifold_async_success)
- # offer the option to deliver the result to a specific DOM elt
- # otherwise (i.e. if domid not provided)
- # it goes through the pubsub using query's uuid
- def enqueue_query (self, query, domid=None):
- self._queue.append ( (query,domid,) )
-
- # return the javascript that triggers all the queries
- def exec_queue_asynchroneously (self):
- js = ""
- js += "var async_queries = new Array();\n"
- for (query,domid) in self._queue:
- qjson=query.to_json()
- id="'%s'"%domid if domid else 'undefined'
- js += "async_queries.push({'query':%(qjson)s, 'id':%(id)s});\n"%locals()
- js += "onFunctionAvailable('manifold_async_exec', function() {manifold_async_exec(async_queries);}, this, true);"
- self.reset_queue()
- # run only once the document is ready
- js = "$(document).ready(function(){%(js)s})"%locals()
- self.add_js_chunks (js)
-
-
- def expose_js_metadata(self):
- request=self.request
- # xxx this code should probably not be called unconditionnally at page creation time
- # because we're not sure a user is logged in so we might have no session...
- if 'manifold' not in request.session:
- print "Page.expose_js_metadata: no 'manifold' in session... - skipping"
- return
- # use cached version if present
- if 'metadata' in request.session.keys():
- self._metadata = request.session['metadata']
- else:
- manifold_api_session_auth = request.session['manifold']['auth']
- manifold_api = ManifoldAPI(auth=manifold_api_session_auth)
-
- fields = ['table', 'column.column',
- 'column.description','column.header', 'column.title',
- 'column.unit', 'column.info_type',
- 'column.resource_type', 'column.value_type',
- 'column.allowed_values', 'column.platforms.platform',
- 'column.platforms.platform_url']
-
- results = manifold_api.Get('metadata:table', [], [], fields)
-
- for res in results:
- method = res['table']
- self._metadata[method] = res
-
- request.session['metadata'] = self._metadata
-
- javascript = "all_headers=" + json.dumps(self._metadata) + ";"
- self.add_js_chunks(javascript)
-
- def metadata_get_fields(self, method):
- return self._metadata[method]['column'].sort()
-
+ # return the javascript code for exposing queries
+ # all queries are inserted in the global manifold object
+ # in addition, the ones enqueued with 'run_it=True' are triggered
+ def __expose_queries (self):
+ # compute variables to expose to the template
+ env = {}
+ # expose the json definition of all queries
+ env['queries_json'] = [ query.to_json(analyzed_query=aq) for (query, aq) in self._queries ]
+ def query_publish_dom_tuple (a,b):
+ result={'query_uuid':a}
+ if b: result['domid']=b
+ return result
+ env['query_exec_tuples'] = [ query_publish_dom_tuple (a,b) for (a,b) in self._queue ]
+ javascript = render_to_string ("page-queries.js",env)
+ self.add_js_chunks (javascript)
+# self.reset_queue()
+ # unconditionnally expose MANIFOLD_URL, this is small and manifold.js uses that for various messages
+ self.expose_js_manifold_config()
+
+
+ # needs to be called explicitly and only when metadata is actually required
+ # in particular user needs to be logged
+ def get_metadata (self):
+ # look in session's cache - we don't want to retrieve this for every request
+ session=self.request.session
+
+ if 'manifold' not in session:
+ session['manifold'] = {}
+ manifold = session['manifold']
+
+ # if cached, use it
+ if 'metadata' in manifold and isinstance(manifold['metadata'],MetaData):
+ if debug: print "Page.get_metadata: return cached value"
+ return manifold['metadata']
+
+ metadata_auth = {'AuthMethod':'anonymous'}
+
+ metadata=MetaData (metadata_auth)
+ metadata.fetch(self.request)
+ # store it for next time
+ manifold['metadata']=metadata
+ if debug: print "Page.get_metadata: return new value"
+ return metadata
+
+ def expose_js_metadata (self):
+ # expose global MANIFOLD_METADATA as a js variable
+ # xxx this is fetched synchroneously..
+ self.add_js_init_chunks("var MANIFOLD_METADATA =" + self.get_metadata().to_json() + ";\n")
+
def expose_js_manifold_config (self):
- self.add_js_chunks(Config.manifold_js_export())
+ self.add_js_init_chunks(ConfigEngine().manifold_js_export())
#################### requirements/prelude management
# just forward to self.prelude - see decorator above
@to_prelude
def add_css_files (self):pass
@to_prelude
+ def add_js_init_chunks (self):pass
+ @to_prelude
def add_js_chunks (self):pass
@to_prelude
def add_css_chunks (self):pass
- @to_prelude
- def template_env (self):pass
+
+ # prelude_env also does expose_queries
+ def prelude_env (self):
+ self.__expose_queries()
+ from_prelude=self.prelude.prelude_env()
+ return from_prelude