padolsey / jsapi-info Goto Github PK

This one will be hard to reproduce. OpenLayers has definitions that look like this:

OpenLayers.Layer.OSM = OpenLayers.Class(OpenLayers.Layer.XYZ, {
  name: "OpenStreetMap",
  attribution: "Data CC-By-SA by <a href='http://openstreetmap.org/'>OpenStreetMap</a>",
  sphericalMercator: true,
  url: 'http://tile.openstreetmap.org/${z}/${x}/${y}.png',
  ...
}

When you view OpenLayers.Layer.OSM, you get this:

function(){ P.apply(this, arguments); };

The definition of OpenLayers.Class looks like so:

OpenLayers.Class = function() {
    var len = arguments.length;
    var P = arguments[0];
    var F = arguments[len-1];

    var C = typeof F.initialize == "function" ?
        F.initialize :
        function(){ P.prototype.initialize.apply(this, arguments); };

    if (len > 1) {
        var newArgs = [C, P].concat(
            Array.prototype.slice.call(arguments).slice(1, len-1), F);
        OpenLayers.inherit.apply(null, newArgs);
    } else {
        C.prototype = F;
    }
    return C;
};

It seems OSM is being resolved to via OpenLayers.Class and pointing to the closure they used to extend the object. Any ideas on how to un-foobar this?

From initial clone, jsapi will fail b/c app/_libs doesn't exist.

Awesome project! I love the idea of making different JS lib APIs easily explorable on a single site.

Providing good support for modular or sandboxed libraries like YUI is going to be difficult (maybe even impossible) using runtime analysis, though. For instance, right now, jsapi only lists static members of the YUI global object, but virtually all of YUI's useful core APIs exist inside an instance-specific function sandbox, so they aren't visible by default. In addition, YUI's core is actually very small; most of the library's functionality exists in modules that are loaded on demand. Getting those modules' APIs into jsapi using runtime analysis would require loading and inspecting each one.

If you're open to considering alternative discovery mechanisms in addition to runtime analysis, the YUI website exposes a JSON API that provides names, parameter lists, summaries, and source locations for all classes and class members of all official YUI modules (warning: there are tons of them!). jsapi could consume this API if you're interested.

The following API endpoint will return all the info you'd need except the source files themselves (warning: the response is over 300KB gzipped; there's a lot of info there): http://yuilibrary.com/api/v1/classes

The source files can be found on the Yahoo! CDN at http://yui.yahooapis.com/{{version}}/build/{{file}}, where {{file}} is the file path returned from the API. The Google CDN, which jsapi currently uses, will not host YUI versions after 3.3.0 (the current version is 3.4.1).