113 lines
3.1 KiB
JavaScript
113 lines
3.1 KiB
JavaScript
"use strict";
|
|
|
|
|
|
|
|
// P A C K A G E S
|
|
|
|
const dedent = require("dedent");
|
|
const fetch = require("make-fetch-happen").defaults({ cacheManager: "./cache" });
|
|
const fs = require("graceful-fs");
|
|
const html = require("choo-async/html");
|
|
const raw = require("nanohtml/raw");
|
|
|
|
// V A R I A B L E
|
|
|
|
const apiFileLink = process.env.NODE_ENV === "development" ?
|
|
"https://rawgit.com/lbryio/lbry/master/docs/api.json" :
|
|
"https://cdn.rawgit.com/lbryio/lbry/5b3103e4/docs/api.json"
|
|
;
|
|
|
|
const apiScripts = "<script>" + fs.readFileSync("./views/partials/api-scripts.js", "utf-8") + "</script>";
|
|
|
|
|
|
|
|
// E X P O R T
|
|
|
|
module.exports = exports = () => async () => parseApiFile().then(response => html`
|
|
<div class="__slate">
|
|
<aside class="api__toc">
|
|
<div class="api__toc__search">
|
|
<input class="api__toc__search__field" id="input-search" placeholder="Search" type="search"/>
|
|
<div class="api__toc__search__clear" id="clear-search" title="Clear search query">×</div>
|
|
<ul class="api__toc__search__results"></ul>
|
|
</div>
|
|
|
|
<ul class="api__toc__items" id="toc" role="navigation">${raw(createApiSidebar(response).join(""))}</ul>
|
|
</aside>
|
|
|
|
<section class="api__content" id="toc-content">${raw(createApiContent(response).join(""))}</section>
|
|
</div>
|
|
|
|
${raw(apiScripts)}
|
|
`);
|
|
|
|
|
|
|
|
// H E L P E R S
|
|
|
|
function createApiContent(apiDetails) {
|
|
const apiContent = [];
|
|
|
|
for (const apiDetail of apiDetails) {
|
|
const apiDetailsReturns = JSON.parse(JSON.stringify(apiDetail.returns));
|
|
|
|
apiContent.push(`
|
|
<div class="api__content__body">
|
|
<h2 id="${apiDetail.name}">${apiDetail.name}</h2>
|
|
<p>${apiDetail.description}</p>
|
|
|
|
${apiDetail.arguments.length ? `<h3>Arguments</h3><ul class="api__content__body__arguments">${renderArguments(apiDetail.arguments).join("")}</ul>` : ""}
|
|
|
|
<h3>Returns</h3>
|
|
<pre><code>${dedent(apiDetailsReturns)}</code></pre>
|
|
</div>
|
|
|
|
<div class="api__content__example">
|
|
<pre><code>// example(s) for ${apiDetail.name} to come later</code></pre>
|
|
</div>
|
|
`);
|
|
}
|
|
|
|
return apiContent;
|
|
}
|
|
|
|
function createApiSidebar(apiDetails) {
|
|
const apiSidebar = [];
|
|
|
|
for (const apiDetail of apiDetails) {
|
|
apiSidebar.push(`
|
|
<li class="api__toc__item">
|
|
<a href="#${apiDetail.name}" title="Go to ${apiDetail.name} section">
|
|
${apiDetail.name}
|
|
</a>
|
|
</li>
|
|
`);
|
|
}
|
|
|
|
return apiSidebar;
|
|
}
|
|
|
|
function parseApiFile() {
|
|
return fetch(apiFileLink).then(() => fetch(apiFileLink, {
|
|
cache: "no-cache" // forces a conditional request
|
|
})).then(res => res.json().then(body => body)); // res.status 304 = cache validated
|
|
}
|
|
|
|
function renderArguments(args) {
|
|
const argumentContent = [];
|
|
|
|
for (const arg of args) {
|
|
argumentContent.push(`
|
|
<li class="api__content__body__argument">
|
|
<div class="left">
|
|
<strong>${arg.name}</strong><br/>
|
|
${arg.is_required === true ? "" : "<span>optional</span>" }<span>${arg.type}</span>
|
|
</div>
|
|
|
|
<div class="right">${arg.description.replace(/</g, "<").replace(/>/g, ">")}</div>
|
|
</li>
|
|
`);
|
|
}
|
|
|
|
return argumentContent;
|
|
}
|