'use strict';
pandora.ui.apiDialog = function() {
var selected = pandora.user.ui.part.api,
actions,
$panel, $list, $text,
that = Ox.Dialog({
buttons: [
Ox.Button({
id: 'switch',
title: Ox._('Help...')
}).bindEvent({
click: function() {
pandora.UI.set({page: 'help'});
}
}),
{},
Ox.Button({
id: 'close',
title: Ox._('Close')
}).bindEvent({
click: function() {
that.close();
}
})
],
closeButton: true,
content: Ox.LoadingScreen().start(),
height: 384,
keys: {escape: 'close'},
maximizeButton: true,
minHeight: 256,
minWidth: 544 + 2 + Ox.UI.SCROLLBAR_SIZE,
removeOnClose: true,
title: Ox._('API Documentation'),
width: 672 + 2 + Ox.UI.SCROLLBAR_SIZE
})
.bindEvent({
close: function() {
pandora.user.ui.page == 'api' && pandora.UI.set({page: ''});
},
resize: function() {
$list.size();
},
'pandora_part.api': function(data) {
pandora.user.ui.page == 'api' && that.select(data.value);
}
});
pandora.api.api({docs: true, code: true}, function(results) {
var items = [{
id: '',
title: Ox._('API Documentation'),
sort: 'aaa' // FIXME: what's this?
}];
actions = results.data.actions;
Ox.forEach(results.data.actions, function(v, k) {
items.push({
'id': k,
'title': k,
'sort': k
});
});
$list = Ox.TableList({
_tree: true,
columns: [
{
id: 'title',
visible: true,
width: 128 - Ox.UI.SCROLLBAR_SIZE
}
],
items: items,
max: 1,
min: 1,
scrollbarVisible: true,
selected: [selected],
sort: [{key: 'sort', operator: '+'}],
unique: 'id'
})
.bindEvent({
select: function(data) {
var id = data.ids[0];
pandora.UI.set({'part.api': id});
}
});
$text = Ox.Element()
.css({
padding: '16px',
lineHeight: '16px',
overflowY: 'auto'
});
$panel = Ox.SplitPanel({
elements: [
{element: $list, size: 128},
{element: $text}
],
orientation: 'horizontal'
});
that.select(selected).options({content: $panel});
$list.gainFocus();
});
function getDoc(id) {
/*
API Documentation format:
Description
takes {
key: value, // comment
key: value, // comment
...
}
returns {
key: value, // comment
key: value, // comment
...
}
notes: Notes
see: action, action, ...
*/
var string = actions[id].doc + '\nsource: ' + actions[id].code[0],
$doc = Ox.SyntaxHighlighter({
source: '\n' + string.replace(
/\n(?=(takes \{|returns \{|notes: |see: |source: ))/g,
'\n\n'
).replace(
/(takes|returns|notes|see|source)(?=( \{|: ))/g,
'BOLD$1BOLD'
).replace(
/`/g,
'BOLD'
)
})
.css({backgroundColor: 'rgba(0, 0, 0, 0)'}),
parts, parts_,
colon = ':',
comma = ',',
linebreak = '
',
whitespace = ' ';
['Keyword', 'Method', 'Property'].forEach(function(type) {
$doc.find('.Ox' + type)
.removeClass('Ox' + type)
.addClass('OxIdentifier');
});
$doc.html(
$doc.html().replace(/BOLD(\w+)BOLD/g, '$1')
);
parts = $doc.html().split('see' + colon + whitespace);
if (parts.length == 2) {
parts_ = parts[1].split('source' + colon + whitespace);
parts_[0] = parts_[0]
.split(comma + whitespace)
.map(function(action) {
action = Ox.stripTags(action);
return '' + action + '';
})
.join(comma + whitespace);
parts[1] = parts_.join(
linebreak + linebreak + 'source' + colon + whitespace
);
$doc.html(parts.join('see' + colon + whitespace));
}
pandora.createLinks($doc);
return $doc;
}
function getIndex() {
var $index = Ox.Element()
.html(Ox._(
'
{0} uses a JSON API' + ' to communicate between the browser and the server.' + ' This API is 100% public, which means that there is' + ' virtually no limit to what you can do with the site,' + ' or build on top of it — from writing simple scripts' + ' to read or write specific information to including' + ' data from {0}' + ' (not just videos, but also metadata, annotations, lists,' + ' or a custom search interface) in your own website.
\n' + 'If you are using the API in JavaScript, you may want to' + ' take a look at ' + ' OxJS, and if you are using Python, there is' + ' ' + ' python-ox, which is used by' + ' ' + ' pandora_client to automate certain tasks.
\n' + 'To get started, just open the console and paste the' + ' following snippet. For the first ten items that are' + ' both shorter than one hour and whose title starts with' + ' either "a" or "the" (sorted by duration, then title, both' + ' in ascending order), it will return their duration,' + ' id and title properties.
', [pandora.site.site.name])) .append( Ox.SyntaxHighlighter({ source: "pandora.api.find({\n" + " keys: ['duration', 'id', 'title'],\n" + " query: {\n" + " conditions: [\n" + " {key: 'duration', operator: '<', value: '01:00:00'},\n" + " {\n" + " conditions: [\n" + " {key: 'title', operator: '=', value: 'a*'}\n" + " {key: 'title', operator: '=', value: 'the*'}\n" + " ],\n" + " operator: '|'\n" + " }\n" + " ],\n" + " operator: '&'\n" + " },\n" + " range: [0, 10],\n" + " sort: [\n" + " {key: 'duration', operator: '+'},\n" + " {key: 'title', operator: '+'}\n" + " ]\n" + "}, function(result) {\n" + " console.log(\n" + " result.status.code == 200 ? result.data : result.status\n" + " );\n" + "});" }) ); pandora.createLinks($index); return $index; } that.select = function(id) { var $code; if (id && actions[id]) { $text.empty(); $('