Labs/Ubiquity/Ubiquity 0.1.3 Architecture: Difference between revisions

[[Image:Ubiquity_0.1.3_Architecture.png]]

* '''Mixed Code Source Collection''' and '''Code Source''' classes are defined in [http://hg.toolness.com/ubiquity-firefox/file/9a629fab9402/ubiquity/modules/codesource.js ubiquity/modules/codesource.js].  A better name for <tt>MixedCodeSourceCollection</tt> would probably be <tt>DecoratedCodeSourceCollection</tt>, since the general idea is to take a single piece of code&mdash;what's commonly referred to as a "command feed" in Ubiquity&mdash;and add a header or preamble that contains common utilities, such as the <tt>Utils</tt> and <tt>CmdUtils</tt> namespaces, and a footer that contains finalization and post-processing logic.  The headers, footers, and built-in (non-unsubscribable) command feeds are contained in [http://hg.toolness.com/ubiquity-firefox/file/9a629fab9402/ubiquity/feed-parts/ ubiquity/feed-parts/], while most the standard (and unsubscribable) feeds are in [http://hg.toolness.com/ubiquity-firefox/file/9a629fab9402/ubiquity/standard-feeds/ ubiquity/standard-feeds/].  Iterating over a <tt>MixedCodeSourceCollection</tt> yields Code Sources that are full representations of all code that ultimately gets executed in a command feed's sandbox.

* '''LINK REL Code Service''' is defined in [http://hg.toolness.com/ubiquity-firefox/file/9a629fab9402/ubiquity/modules/linkrel_codesvc.js ubiquity/modules/linkrel_codesvc.js] and is responsible for detecting <tt><nowiki><LINK REL="commands"></nowiki></tt> tags on web pages, displaying notification box messages to the user, and managing command feed subscriptions.  When iterated over, it yields a Code Source object for each subscribed-to command feed, each of which are subsequently decorated by <tt>MixedCodeSourceCollection</tt>.