// vim: et:ts=4:sw=4:sts=4:ft=javascript '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 + Ox.UI.SCROLLBAR_SIZE, removeOnClose: true, title: Ox._('API Documentation'), width: 672 + 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 getIndex() { var $index = Ox.Element() .html(Ox._( '

API Documentation

\n' + '

{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 does not' + ' start with "X" (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" + " {key: 'title', operator: '!=', value: 'x*'}\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) { if (id && actions[id]) { $text.html('

' + id + '


'); var code = actions[id].code[1], f = actions[id].code[0], line = Math.round(Ox.last(f.split(':')) || 0), doc = actions[id].doc.replace('/\n/
\n/g'), $code, $doc; $doc = Ox.SyntaxHighlighter({ source: doc, }) .appendTo($text); Ox.Button({ title: Ox._('Source ({0})', [f]), }).bindEvent({ click: function() { $code.toggle(); } }) .css({ margin: '4px' }) .appendTo($text); $code = Ox.SyntaxHighlighter({ showLineNumbers: true, source: code, offset: line }) .css({ borderWidth: '1px', }).appendTo($text); } else { $text.empty().append(getIndex()); } $text.scrollTop(0); return that; } return that; };