| 1 | <!DOCTYPE html> <html> <head> <title>discogs.coffee</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <link rel="stylesheet" media="all" href="docco.css" /> </head> <body> <div id="container"> <div id="background"></div> <table cellpadding="0" cellspacing="0"> <thead> <tr> <th class="docs"> <h1> discogs.coffee </h1> </th> <th class="code"> </th> </tr> </thead> <tbody> <tr id="section-1"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-1">¶</a> </div> </td> <td class="code"> <div class="highlight"><pre><span class="nv">querystring = </span><span class="nx">require</span> <span class="s1">'querystring'</span>
|
| 2 | <span class="nv">request = </span><span class="nx">require</span> <span class="s1">'request'</span>
|
| 3 | <span class="nv">compress = </span><span class="nx">require</span> <span class="s1">'compress'</span></pre></div> </td> </tr> <tr id="section-2"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-2">¶</a> </div> <p>This is the entry point.</p>
|
| 4 |
|
| 5 | <p>Takes an optional format parameter, defaulting to 'json'. If 'xml' consumer is expected to take care of parsing</p>
|
| 6 |
|
| 7 | <pre><code>client = discogs("xml")
|
| 8 | </code></pre> </td> <td class="code"> <div class="highlight"><pre><span class="nv">exports = module.exports = </span><span class="nf">(format) -></span>
|
| 9 | <span class="nv">gunzip = </span><span class="k">new</span> <span class="nx">compress</span><span class="p">.</span><span class="nx">Gunzip</span><span class="p">()</span>
|
| 10 | <span class="nx">gunzip</span><span class="p">.</span><span class="nx">init</span><span class="p">()</span></pre></div> </td> </tr> <tr id="section-3"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-3">¶</a> </div> <p>Return a proper url with optional format</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">getUrl = </span><span class="nf">(url) -></span>
|
| 11 | <span class="nv">sep = </span><span class="k">if</span> <span class="s2">"?"</span> <span class="k">in</span> <span class="nx">url</span> <span class="k">then</span> <span class="s2">"&"</span> <span class="k">else</span> <span class="s2">"?"</span>
|
| 12 | <span class="nv">url = </span><span class="s2">"http://api.discogs.com/#{url}"</span> <span class="k">if</span> <span class="nx">url</span><span class="p">.</span><span class="nx">substr</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">7</span><span class="p">)</span> <span class="o">isnt</span> <span class="s1">'http://'</span>
|
| 13 |
|
| 14 | <span class="nx">url</span> <span class="o">+=</span> <span class="s2">"#{sep}f=#{format}"</span> <span class="k">if</span> <span class="nx">format</span>
|
| 15 | <span class="nx">url</span></pre></div> </td> </tr> <tr id="section-4"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-4">¶</a> </div> <p>Make a request</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">discogsRequest = </span><span class="nf">(url, next) -></span>
|
| 16 | <span class="nx">request</span>
|
| 17 | <span class="nv">uri: </span><span class="nx">getUrl</span> <span class="nx">url</span>
|
| 18 | <span class="nv">headers: </span><span class="p">{</span><span class="s1">'accept-encoding'</span><span class="o">:</span> <span class="s1">'gzip'</span><span class="p">}</span>
|
| 19 | <span class="nv">encoding: </span><span class="s1">'binary'</span>
|
| 20 | <span class="p">(</span><span class="nx">error</span><span class="p">,</span> <span class="nx">res</span><span class="p">,</span> <span class="nx">body</span><span class="p">)</span> <span class="o">=></span>
|
| 21 | <span class="k">if</span> <span class="o">not</span> <span class="nx">error</span> <span class="o">and</span> <span class="mi">200</span> <span class="o"><=</span> <span class="nx">res</span><span class="p">.</span><span class="nx">statusCode</span> <span class="o"><</span> <span class="mi">400</span>
|
| 22 | <span class="k">if</span> <span class="nx">body</span>
|
| 23 | <span class="nv">body = </span><span class="nx">gunzip</span><span class="p">.</span><span class="nx">inflate</span><span class="p">(</span><span class="nx">body</span><span class="p">)</span> <span class="k">if</span> <span class="s1">'gzip'</span> <span class="k">in</span> <span class="nx">res</span><span class="p">.</span><span class="nx">headers</span><span class="p">[</span><span class="s1">'content-type'</span><span class="p">]</span>
|
| 24 | <span class="nv">body = </span><span class="nx">JSON</span><span class="p">.</span><span class="nx">parse</span><span class="p">(</span><span class="nx">body</span><span class="p">)</span> <span class="k">if</span> <span class="s1">'json'</span> <span class="k">in</span> <span class="nx">res</span><span class="p">.</span><span class="nx">headers</span><span class="p">[</span><span class="s1">'content-type'</span><span class="p">]</span> <span class="o">or</span> <span class="o">not</span> <span class="nx">format</span>
|
| 25 |
|
| 26 | <span class="nx">next</span> <span class="kc">null</span><span class="p">,</span> <span class="nx">body</span>
|
| 27 | <span class="k">else</span>
|
| 28 | <span class="nx">next</span> <span class="nx">error</span>
|
| 29 |
|
| 30 | <span class="nv">responseHandler = </span><span class="nf">(type, next) -></span>
|
| 31 | <span class="nf">(err, res) -></span>
|
| 32 | <span class="k">return</span> <span class="nx">next</span><span class="p">(</span><span class="nx">err</span><span class="p">,</span> <span class="nx">res</span><span class="p">)</span> <span class="k">if</span> <span class="nx">err</span> <span class="o">or</span> <span class="nx">res</span> <span class="o">not</span> <span class="k">instanceof</span> <span class="nb">Object</span> <span class="o">or</span> <span class="nx">type</span> <span class="o">not</span> <span class="k">of</span> <span class="nx">res</span><span class="o">?</span><span class="p">.</span><span class="nx">resp</span>
|
| 33 | <span class="nx">next</span><span class="p">(</span><span class="kc">null</span><span class="p">,</span> <span class="nx">res</span><span class="p">.</span><span class="nx">resp</span><span class="p">[</span><span class="nx">type</span><span class="p">])</span></pre></div> </td> </tr> <tr id="section-5"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-5">¶</a> </div> <p>API</p> </td> <td class="code"> <div class="highlight"><pre></pre></div> </td> </tr> <tr id="section-6"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-6">¶</a> </div> <p>Use this if you have a discogs url</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">get: </span><span class="nf">(url, next) -></span>
|
| 34 | <span class="nx">discogsRequest</span> <span class="nx">url</span><span class="p">,</span> <span class="nx">next</span></pre></div> </td> </tr> <tr id="section-7"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-7">¶</a> </div> <p>Get a release</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">master: </span><span class="nf">(id, next) -></span>
|
| 35 | <span class="nx">discogsRequest</span> <span class="s1">'master/'</span> <span class="o">+</span> <span class="nx">id</span><span class="p">,</span>
|
| 36 | <span class="nx">responseHandler</span><span class="p">(</span><span class="s1">'master'</span><span class="p">,</span> <span class="nx">next</span><span class="p">)</span></pre></div> </td> </tr> <tr id="section-8"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-8">¶</a> </div> <p>Get a release</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">release: </span><span class="nf">(id, next) -></span>
|
| 37 | <span class="nx">discogsRequest</span> <span class="s1">'release/'</span> <span class="o">+</span> <span class="nx">id</span><span class="p">,</span>
|
| 38 | <span class="nx">responseHandler</span><span class="p">(</span><span class="s1">'release'</span><span class="p">,</span> <span class="nx">next</span><span class="p">)</span></pre></div> </td> </tr> <tr id="section-9"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-9">¶</a> </div> <p>Get an artist</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">artist: </span><span class="nf">(name, next) -></span>
|
| 39 | <span class="nx">discogsRequest</span> <span class="s1">'artist/'</span> <span class="o">+</span> <span class="nx">name</span><span class="p">,</span>
|
| 40 | <span class="nx">responseHandler</span><span class="p">(</span><span class="s1">'artist'</span><span class="p">,</span> <span class="nx">next</span><span class="p">)</span></pre></div> </td> </tr> <tr id="section-10"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-10">¶</a> </div> <p>Get a label</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">label: </span><span class="nf">(name, next) -></span>
|
| 41 | <span class="nx">discogsRequest</span> <span class="s1">'label/'</span> <span class="o">+</span> <span class="nx">name</span><span class="p">,</span>
|
| 42 | <span class="nx">responseHandler</span><span class="p">(</span><span class="s1">'label'</span><span class="p">,</span> <span class="nx">next</span><span class="p">)</span></pre></div> </td> </tr> <tr id="section-11"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-11">¶</a> </div> <p>Search for something
|
| 43 | Valid types:
|
| 44 | <code>all</code>, <code>artists</code>, <code>labels</code>, <code>releases</code>, <code>needsvote</code>, <code>catno</code>, <code>forsale</code></p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">search: </span><span class="nf">(query, type, next) -></span>
|
| 45 | <span class="k">if</span> <span class="nx">type</span> <span class="k">instanceof</span> <span class="nb">Function</span>
|
| 46 | <span class="nv">next = </span><span class="nx">type</span>
|
| 47 | <span class="nv">type = </span><span class="s1">'all'</span>
|
| 48 | <span class="nx">discogsRequest</span> <span class="s1">'search?'</span> <span class="o">+</span> <span class="nx">querystring</span><span class="p">.</span><span class="nx">stringify</span><span class="p">(</span><span class="nv">type: </span><span class="nx">type</span><span class="p">,</span> <span class="nv">q: </span><span class="nx">query</span><span class="p">),</span>
|
| 49 | <span class="nx">responseHandler</span><span class="p">(</span><span class="s1">'search'</span><span class="p">,</span> <span class="nx">next</span><span class="p">)</span></pre></div> </td> </tr> <tr id="section-12"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-12">¶</a> </div> <p>Do a search and try to find the master or main release in all results.
|
| 50 | Uses 2 or 3 requests per lookup, to find the best result.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">lookup: </span><span class="nf">(query, next) -></span>
|
| 51 | <span class="nx">@search</span> <span class="nx">query</span><span class="p">,</span> <span class="s2">"releases"</span><span class="p">,</span> <span class="p">(</span><span class="nx">err</span><span class="p">,</span> <span class="nx">res</span><span class="p">)</span> <span class="o">=></span>
|
| 52 | <span class="k">return</span> <span class="nx">next</span> <span class="nx">err</span> <span class="k">if</span> <span class="nx">err</span>
|
| 53 |
|
| 54 | <span class="nv">results = </span><span class="nx">res</span><span class="o">?</span><span class="p">.</span><span class="nx">searchresults</span><span class="o">?</span><span class="p">.</span><span class="nx">results</span>
|
| 55 | <span class="k">return</span> <span class="nx">next</span><span class="p">()</span> <span class="nx">unless</span> <span class="nx">results</span>
|
| 56 |
|
| 57 | <span class="nv">masters = </span><span class="p">(</span><span class="nx">result</span> <span class="k">for</span> <span class="nx">result</span> <span class="k">in</span> <span class="nx">results</span> <span class="k">when</span> <span class="nx">result</span><span class="p">.</span><span class="nx">type</span> <span class="o">is</span> <span class="s2">"master"</span><span class="p">)</span></pre></div> </td> </tr> <tr id="section-13"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-13">¶</a> </div> <p>Did we find masters already?</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">results = </span><span class="nx">masters</span> <span class="k">if</span> <span class="nx">masters</span><span class="p">.</span><span class="nx">length</span>
|
| 58 |
|
| 59 | <span class="nv">matches = </span><span class="p">(</span><span class="nx">result</span> <span class="k">for</span> <span class="nx">result</span> <span class="k">in</span> <span class="nx">results</span> <span class="k">when</span> <span class="nx">result</span><span class="p">.</span><span class="nx">title</span><span class="p">.</span><span class="nx">toLowerCase</span><span class="p">()</span> <span class="o">is</span> <span class="nx">query</span><span class="p">.</span><span class="nx">toLowerCase</span><span class="p">())</span></pre></div> </td> </tr> <tr id="section-14"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-14">¶</a> </div> <p>Take only the best results</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nv">results = </span><span class="nx">matches</span> <span class="k">if</span> <span class="nx">matches</span><span class="p">.</span><span class="nx">length</span>
|
| 60 |
|
| 61 | <span class="nv">release = </span><span class="nx">results</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
|
| 62 | <span class="nv">id = </span><span class="nx">release</span><span class="p">.</span><span class="nx">uri</span><span class="p">.</span><span class="nx">split</span><span class="p">(</span><span class="s2">"/"</span><span class="p">).</span><span class="nx">pop</span><span class="p">()</span>
|
| 63 |
|
| 64 | <span class="err">@</span><span class="p">[</span><span class="nx">release</span><span class="p">.</span><span class="nx">type</span><span class="p">]</span> <span class="nx">id</span><span class="p">,</span> <span class="p">(</span><span class="nx">err</span><span class="p">,</span> <span class="nx">res</span><span class="p">)</span> <span class="o">=></span>
|
| 65 | <span class="k">if</span> <span class="s2">"master_id"</span> <span class="k">of</span> <span class="nx">res</span></pre></div> </td> </tr> <tr id="section-15"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-15">¶</a> </div> <p>Did we find a master now?</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@master</span> <span class="nx">res</span><span class="p">.</span><span class="nx">master_id</span><span class="p">,</span> <span class="p">(</span><span class="nx">err</span><span class="p">,</span> <span class="nx">master</span><span class="p">)</span> <span class="o">=></span>
|
| 66 | <span class="k">if</span> <span class="s2">"main_release"</span> <span class="k">of</span> <span class="nx">master</span>
|
| 67 | <span class="nx">@release</span> <span class="nx">master</span><span class="p">.</span><span class="nx">main_release</span><span class="p">,</span> <span class="nx">next</span>
|
| 68 | <span class="k">else</span>
|
| 69 | <span class="nx">next</span> <span class="kc">null</span><span class="p">,</span> <span class="nx">master</span>
|
| 70 | <span class="k">else</span> <span class="k">if</span> <span class="s2">"main_release"</span> <span class="k">of</span> <span class="nx">res</span></pre></div> </td> </tr> <tr id="section-16"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-16">¶</a> </div> <p>Or maybe a main release?</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">@release</span> <span class="nx">res</span><span class="p">.</span><span class="nx">main_release</span><span class="p">,</span> <span class="nx">next</span>
|
| 71 | <span class="k">else</span></pre></div> </td> </tr> <tr id="section-17"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-17">¶</a> </div> <p>This is the best we can do</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">next</span> <span class="kc">null</span><span class="p">,</span> <span class="nx">res</span>
|
| 72 |
|
| 73 | </pre></div> </td> </tr> </tbody> </table> </div> </body> </html> |
| \ | No newline at end of file |