PageRenderTime 60ms CodeModel.GetById 17ms RepoModel.GetById 0ms app.codeStats 1ms

/apidocs/pyechonest.song-pysrc.html

http://echo-nest-remix.googlecode.com/
HTML | 490 lines | 459 code | 10 blank | 21 comment | 0 complexity | 70944f72821e65e1e1ff44d1ce7a09fa MD5 | raw file
Possible License(s): BSD-3-Clause
  1. <?xml version="1.0" encoding="ascii"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  3. "DTD/xhtml1-transitional.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  5. <head>
  6. <title>pyechonest.song</title>
  7. <link rel="stylesheet" href="epydoc.css" type="text/css" />
  8. <script type="text/javascript" src="epydoc.js"></script>
  9. </head>
  10. <body bgcolor="white" text="black" link="blue" vlink="#204080"
  11. alink="#204080">
  12. <!-- ==================== NAVIGATION BAR ==================== -->
  13. <table class="navbar" border="0" width="100%" cellpadding="0"
  14. bgcolor="#a0c0ff" cellspacing="0">
  15. <tr valign="middle">
  16. <!-- Tree link -->
  17. <th>&nbsp;&nbsp;&nbsp;<a
  18. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  19. <!-- Index link -->
  20. <th>&nbsp;&nbsp;&nbsp;<a
  21. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  22. <!-- Help link -->
  23. <th>&nbsp;&nbsp;&nbsp;<a
  24. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  25. <!-- Project homepage -->
  26. <th class="navbar" align="right" width="100%">
  27. <table border="0" cellpadding="0" cellspacing="0">
  28. <tr><th class="navbar" align="center"
  29. ><a class="navbar" target="_top" href="http://code.google.com/p/echo-nest-remix/">Project Homepage</a></th>
  30. </tr></table></th>
  31. </tr>
  32. </table>
  33. <table width="100%" cellpadding="0" cellspacing="0">
  34. <tr valign="top">
  35. <td width="100%">
  36. <span class="breadcrumbs">
  37. <a href="pyechonest-module.html">Package&nbsp;pyechonest</a> ::
  38. Module&nbsp;song
  39. </span>
  40. </td>
  41. <td>
  42. <table cellpadding="0" cellspacing="0">
  43. <!-- hide/show private -->
  44. <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
  45. onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
  46. <tr><td align="right"><span class="options"
  47. >[<a href="frames.html" target="_top">frames</a
  48. >]&nbsp;|&nbsp;<a href="pyechonest.song-pysrc.html"
  49. target="_top">no&nbsp;frames</a>]</span></td></tr>
  50. </table>
  51. </td>
  52. </tr>
  53. </table>
  54. <h1 class="epydoc">Source Code for <a href="pyechonest.song-module.html">Module pyechonest.song</a></h1>
  55. <pre class="py-src">
  56. <a name="L1"></a><tt class="py-lineno"> 1</tt> <tt class="py-line"><tt class="py-comment">#!/usr/bin/env python</tt> </tt>
  57. <a name="L2"></a><tt class="py-lineno"> 2</tt> <tt class="py-line"><tt class="py-comment"># encoding: utf-8</tt> </tt>
  58. <a name="L3"></a><tt class="py-lineno"> 3</tt> <tt class="py-line"> </tt>
  59. <a name="L4"></a><tt class="py-lineno"> 4</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
  60. <a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-docstring">Copyright (c) 2010 The Echo Nest. All rights reserved.</tt> </tt>
  61. <a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-docstring">Created by Tyler Williams on 2010-04-25.</tt> </tt>
  62. <a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  63. <a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">The Song module loosely covers http://developer.echonest.com/docs/v4/song.html</tt> </tt>
  64. <a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">Refer to the official api documentation if you are unsure about something.</tt> </tt>
  65. <a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
  66. <a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"> </tt>
  67. <a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt id="link-0" class="py-name" targets="Module pyechonest.util=pyechonest.util-module.html"><a title="pyechonest.util" class="py-name" href="#" onclick="return doclink('link-0', 'util', 'link-0');">util</a></tt> </tt>
  68. <a name="L13"></a><tt class="py-lineno"> 13</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-1" class="py-name" targets="Module pyechonest.proxies=pyechonest.proxies-module.html"><a title="pyechonest.proxies" class="py-name" href="#" onclick="return doclink('link-1', 'proxies', 'link-1');">proxies</a></tt> <tt class="py-keyword">import</tt> <tt id="link-2" class="py-name" targets="Class pyechonest.proxies.SongProxy=pyechonest.proxies.SongProxy-class.html"><a title="pyechonest.proxies.SongProxy" class="py-name" href="#" onclick="return doclink('link-2', 'SongProxy', 'link-2');">SongProxy</a></tt> </tt>
  69. <a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-3" class="py-name" targets="Module pyechonest.results=pyechonest.results-module.html"><a title="pyechonest.results" class="py-name" href="#" onclick="return doclink('link-3', 'results', 'link-3');">results</a></tt> <tt class="py-keyword">import</tt> <tt id="link-4" class="py-name" targets="Class pyechonest.results.Result=pyechonest.results.Result-class.html"><a title="pyechonest.results.Result" class="py-name" href="#" onclick="return doclink('link-4', 'Result', 'link-4');">Result</a></tt> </tt>
  70. <a name="L15"></a><tt class="py-lineno"> 15</tt> <tt class="py-line"> </tt>
  71. <a name="L16"></a><tt class="py-lineno"> 16</tt> <tt class="py-line"><tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
  72. <a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"> <tt class="py-keyword">import</tt> <tt class="py-name">json</tt> </tt>
  73. <a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"><tt class="py-keyword">except</tt> <tt class="py-name">ImportError</tt><tt class="py-op">:</tt> </tt>
  74. <a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"> <tt class="py-keyword">import</tt> <tt class="py-name">simplejson</tt> <tt class="py-keyword">as</tt> <tt class="py-name">json</tt> </tt>
  75. <a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"> </tt>
  76. <a name="Song"></a><div id="Song-def"><a name="L21"></a><tt class="py-lineno"> 21</tt> <a class="py-toggle" href="#" id="Song-toggle" onclick="return toggle('Song');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html">Song</a><tt class="py-op">(</tt><tt class="py-base-class">SongProxy</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  77. </div><div id="Song-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="Song-expanded"><a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
  78. <a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"><tt class="py-docstring"> A Song object</tt> </tt>
  79. <a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  80. <a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"><tt class="py-docstring"> Create a song object like so:</tt> </tt>
  81. <a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"><tt class="py-docstring"> s = song.Song('SOXZYYG127F3E1B7A2')</tt> </tt>
  82. <a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  83. <a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"><tt class="py-docstring"> Attributes: (**attributes** are guaranteed to exist as soon as an artist object exists)</tt> </tt>
  84. <a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-docstring"> **id**: Echo Nest Song ID</tt> </tt>
  85. <a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"><tt class="py-docstring"> **title**: Song Title</tt> </tt>
  86. <a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"><tt class="py-docstring"> **artist_name**: Artist Name</tt> </tt>
  87. <a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"><tt class="py-docstring"> **artist_id**: Artist ID</tt> </tt>
  88. <a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"><tt class="py-docstring"> audio_summary: An Audio Summary Result object</tt> </tt>
  89. <a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"><tt class="py-docstring"> song_hotttnesss: A float representing a song's hotttnesss</tt> </tt>
  90. <a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"><tt class="py-docstring"> artist_hotttnesss: A float representing a song's parent artist's hotttnesss</tt> </tt>
  91. <a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"><tt class="py-docstring"> artist_familiarity: A float representing a song's parent artist's familiarity</tt> </tt>
  92. <a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"><tt class="py-docstring"> artist_location: A string specifying a song's parent artist's location</tt> </tt>
  93. <a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"><tt class="py-docstring"> tracks: A list of track result objects</tt> </tt>
  94. <a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  95. <a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
  96. <a name="Song.__init__"></a><div id="Song.__init__-def"><a name="L41"></a><tt class="py-lineno"> 41</tt> <a class="py-toggle" href="#" id="Song.__init__-toggle" onclick="return toggle('Song.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">id</tt><tt class="py-op">,</tt> <tt class="py-param">buckets</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-param">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  97. </div><div id="Song.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.__init__-expanded"><a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"> <tt class="py-name">buckets</tt> <tt class="py-op">=</tt> <tt class="py-name">buckets</tt> <tt class="py-keyword">or</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
  98. <a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-5" class="py-name" targets="Class pyechonest.song.Song=pyechonest.song.Song-class.html"><a title="pyechonest.song.Song" class="py-name" href="#" onclick="return doclink('link-5', 'Song', 'link-5');">Song</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-6" class="py-name" targets="Method echonest.action.Blend.__init__()=echonest.action.Blend-class.html#__init__,Method echonest.action.Crossfade.__init__()=echonest.action.Crossfade-class.html#__init__,Method echonest.action.Edit.__init__()=echonest.action.Edit-class.html#__init__,Method echonest.action.Jump.__init__()=echonest.action.Jump-class.html#__init__,Method echonest.action.Playback.__init__()=echonest.action.Playback-class.html#__init__,Method echonest.audio.AmplitudeFactor.__init__()=echonest.audio.AmplitudeFactor-class.html#__init__,Method echonest.audio.AudioAnalysis.__init__()=echonest.audio.AudioAnalysis-class.html#__init__,Method echonest.audio.AudioData.__init__()=echonest.audio.AudioData-class.html#__init__,Method echonest.audio.AudioData32.__init__()=echonest.audio.AudioData32-class.html#__init__,Method echonest.audio.AudioQuantum.__init__()=echonest.audio.AudioQuantum-class.html#__init__,Method echonest.audio.AudioQuantumList.__init__()=echonest.audio.AudioQuantumList-class.html#__init__,Method echonest.audio.AudioSegment.__init__()=echonest.audio.AudioSegment-class.html#__init__,Method echonest.audio.FileTypeError.__init__()=echonest.audio.FileTypeError-class.html#__init__,Method echonest.audio.LevelDB.__init__()=echonest.audio.LevelDB-class.html#__init__,Method echonest.audio.LocalAnalysis.__init__()=echonest.audio.LocalAnalysis-class.html#__init__,Method echonest.audio.LocalAudioFile.__init__()=echonest.audio.LocalAudioFile-class.html#__init__,Method echonest.audio.ModifiedRenderable.__init__()=echonest.audio.ModifiedRenderable-class.html#__init__,Method echonest.audio.Simultaneous.__init__()=echonest.audio.Simultaneous-class.html#__init__,Method echonest.audio.TimeTruncateFactor.__init__()=echonest.audio.TimeTruncateFactor-class.html#__init__,Method echonest.audio.TimeTruncateLength.__init__()=echonest.audio.TimeTruncateLength-class.html#__init__,Method echonest.modify.Modify.__init__()=echonest.modify.Modify-class.html#__init__,Method echonest.support.midi.EventDispatcher.EventDispatcher.__init__()=echonest.support.midi.EventDispatcher.EventDispatcher-class.html#__init__,Method echonest.support.midi.MidiFileParser.MidiFileParser.__init__()=echonest.support.midi.MidiFileParser.MidiFileParser-class.html#__init__,Method echonest.support.midi.MidiInFile.MidiInFile.__init__()=echonest.support.midi.MidiInFile.MidiInFile-class.html#__init__,Method echonest.support.midi.MidiInStream.MidiInStream.__init__()=echonest.support.midi.MidiInStream.MidiInStream-class.html#__init__,Method echonest.support.midi.MidiOutFile.MidiOutFile.__init__()=echonest.support.midi.MidiOutFile.MidiOutFile-class.html#__init__,Method echonest.support.midi.MidiOutStream.MidiOutStream.__init__()=echonest.support.midi.MidiOutStream.MidiOutStream-class.html#__init__,Method echonest.support.midi.RawInstreamFile.RawInstreamFile.__init__()=echonest.support.midi.RawInstreamFile.RawInstreamFile-class.html#__init__,Method echonest.support.midi.RawOutstreamFile.RawOutstreamFile.__init__()=echonest.support.midi.RawOutstreamFile.RawOutstreamFile-class.html#__init__,Method echonest.video.ImageSequence.__init__()=echonest.video.ImageSequence-class.html#__init__,Method echonest.video.SynchronizedAV.__init__()=echonest.video.SynchronizedAV-class.html#__init__,Method echonest.video.VideoSettings.__init__()=echonest.video.VideoSettings-class.html#__init__,Method pyechonest.artist.Artist.__init__()=pyechonest.artist.Artist-class.html#__init__,Method pyechonest.playlist.Playlist.__init__()=pyechonest.playlist.Playlist-class.html#__init__,Method pyechonest.proxies.ArtistProxy.__init__()=pyechonest.proxies.ArtistProxy-class.html#__init__,Method pyechonest.proxies.GenericProxy.__init__()=pyechonest.proxies.GenericProxy-class.html#__init__,Method pyechonest.proxies.PlaylistProxy.__init__()=pyechonest.proxies.PlaylistProxy-class.html#__init__,Method pyechonest.proxies.SongProxy.__init__()=pyechonest.proxies.SongProxy-class.html#__init__,Method pyechonest.proxies.TrackProxy.__init__()=pyechonest.proxies.TrackProxy-class.html#__init__,Method pyechonest.results.Result.__init__()=pyechonest.results.Result-class.html#__init__,Method pyechonest.song.Song.__init__()=pyechonest.song.Song-class.html#__init__,Method pyechonest.util.EchoNestAPIError.__init__()=pyechonest.util.EchoNestAPIError-class.html#__init__,Method pyechonest.util.attrdict.__init__()=pyechonest.util.attrdict-class.html#__init__"><a title="echonest.action.Blend.__init__
  99. echonest.action.Crossfade.__init__
  100. echonest.action.Edit.__init__
  101. echonest.action.Jump.__init__
  102. echonest.action.Playback.__init__
  103. echonest.audio.AmplitudeFactor.__init__
  104. echonest.audio.AudioAnalysis.__init__
  105. echonest.audio.AudioData.__init__
  106. echonest.audio.AudioData32.__init__
  107. echonest.audio.AudioQuantum.__init__
  108. echonest.audio.AudioQuantumList.__init__
  109. echonest.audio.AudioSegment.__init__
  110. echonest.audio.FileTypeError.__init__
  111. echonest.audio.LevelDB.__init__
  112. echonest.audio.LocalAnalysis.__init__
  113. echonest.audio.LocalAudioFile.__init__
  114. echonest.audio.ModifiedRenderable.__init__
  115. echonest.audio.Simultaneous.__init__
  116. echonest.audio.TimeTruncateFactor.__init__
  117. echonest.audio.TimeTruncateLength.__init__
  118. echonest.modify.Modify.__init__
  119. echonest.support.midi.EventDispatcher.EventDispatcher.__init__
  120. echonest.support.midi.MidiFileParser.MidiFileParser.__init__
  121. echonest.support.midi.MidiInFile.MidiInFile.__init__
  122. echonest.support.midi.MidiInStream.MidiInStream.__init__
  123. echonest.support.midi.MidiOutFile.MidiOutFile.__init__
  124. echonest.support.midi.MidiOutStream.MidiOutStream.__init__
  125. echonest.support.midi.RawInstreamFile.RawInstreamFile.__init__
  126. echonest.support.midi.RawOutstreamFile.RawOutstreamFile.__init__
  127. echonest.video.ImageSequence.__init__
  128. echonest.video.SynchronizedAV.__init__
  129. echonest.video.VideoSettings.__init__
  130. pyechonest.artist.Artist.__init__
  131. pyechonest.playlist.Playlist.__init__
  132. pyechonest.proxies.ArtistProxy.__init__
  133. pyechonest.proxies.GenericProxy.__init__
  134. pyechonest.proxies.PlaylistProxy.__init__
  135. pyechonest.proxies.SongProxy.__init__
  136. pyechonest.proxies.TrackProxy.__init__
  137. pyechonest.results.Result.__init__
  138. pyechonest.song.Song.__init__
  139. pyechonest.util.EchoNestAPIError.__init__
  140. pyechonest.util.attrdict.__init__" class="py-name" href="#" onclick="return doclink('link-6', '__init__', 'link-6');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">id</tt><tt class="py-op">,</tt> <tt class="py-name">buckets</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-name">kwargs</tt><tt class="py-op">)</tt> </tt>
  141. </div><a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"> </tt>
  142. <a name="Song.__repr__"></a><div id="Song.__repr__-def"><a name="L45"></a><tt class="py-lineno"> 45</tt> <a class="py-toggle" href="#" id="Song.__repr__-toggle" onclick="return toggle('Song.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  143. </div><div id="Song.__repr__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.__repr__-expanded"><a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"&lt;%s - %s&gt;"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">type</tt><tt class="py-op">.</tt><tt id="link-7" class="py-name" targets="Method echonest.audio.AudioData.encode()=echonest.audio.AudioData-class.html#encode,Method echonest.audio.AudioData32.encode()=echonest.audio.AudioData32-class.html#encode,Method echonest.audio.AudioRenderable.encode()=echonest.audio.AudioRenderable-class.html#encode"><a title="echonest.audio.AudioData.encode
  144. echonest.audio.AudioData32.encode
  145. echonest.audio.AudioRenderable.encode" class="py-name" href="#" onclick="return doclink('link-7', 'encode', 'link-7');">encode</a></tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">title</tt><tt class="py-op">.</tt><tt id="link-8" class="py-name"><a title="echonest.audio.AudioData.encode
  146. echonest.audio.AudioData32.encode
  147. echonest.audio.AudioRenderable.encode" class="py-name" href="#" onclick="return doclink('link-8', 'encode', 'link-7');">encode</a></tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
  148. </div><a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"> </tt>
  149. <a name="Song.__str__"></a><div id="Song.__str__-def"><a name="L48"></a><tt class="py-lineno"> 48</tt> <a class="py-toggle" href="#" id="Song.__str__-toggle" onclick="return toggle('Song.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  150. </div><div id="Song.__str__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.__str__-expanded"><a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">title</tt><tt class="py-op">.</tt><tt id="link-9" class="py-name"><a title="echonest.audio.AudioData.encode
  151. echonest.audio.AudioData32.encode
  152. echonest.audio.AudioRenderable.encode" class="py-name" href="#" onclick="return doclink('link-9', 'encode', 'link-7');">encode</a></tt><tt class="py-op">(</tt><tt class="py-string">'utf-8'</tt><tt class="py-op">)</tt> </tt>
  153. </div><a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"> </tt>
  154. <a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"> </tt>
  155. <a name="Song.get_audio_summary"></a><div id="Song.get_audio_summary-def"><a name="L52"></a><tt class="py-lineno"> 52</tt> <a class="py-toggle" href="#" id="Song.get_audio_summary-toggle" onclick="return toggle('Song.get_audio_summary');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#get_audio_summary">get_audio_summary</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  156. </div><div id="Song.get_audio_summary-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.get_audio_summary-expanded"><a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"> <tt class="py-docstring">"""Get an audio summary of a song containing mode, tempo, key, duration, time signature, loudness, and analysis_url.</tt> </tt>
  157. <a name="L54"></a><tt class="py-lineno"> 54</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  158. <a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"><tt class="py-docstring"> Args:</tt> </tt>
  159. <a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"><tt class="py-docstring"> cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</tt> </tt>
  160. <a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  161. <a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line"><tt class="py-docstring"> Returns:</tt> </tt>
  162. <a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"><tt class="py-docstring"> A dictionary containing mode, tempo, key, duration, time signature, loudness, and analysis_url keys.</tt> </tt>
  163. <a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
  164. <a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-name">cache</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'audio_summary'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  165. <a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"> <tt class="py-name">response</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-10" class="py-name" targets="Method pyechonest.proxies.ArtistProxy.get_attribute()=pyechonest.proxies.ArtistProxy-class.html#get_attribute,Method pyechonest.proxies.GenericProxy.get_attribute()=pyechonest.proxies.GenericProxy-class.html#get_attribute,Method pyechonest.proxies.PlaylistProxy.get_attribute()=pyechonest.proxies.PlaylistProxy-class.html#get_attribute,Method pyechonest.proxies.SongProxy.get_attribute()=pyechonest.proxies.SongProxy-class.html#get_attribute"><a title="pyechonest.proxies.ArtistProxy.get_attribute
  166. pyechonest.proxies.GenericProxy.get_attribute
  167. pyechonest.proxies.PlaylistProxy.get_attribute
  168. pyechonest.proxies.SongProxy.get_attribute" class="py-name" href="#" onclick="return doclink('link-10', 'get_attribute', 'link-10');">get_attribute</a></tt><tt class="py-op">(</tt><tt class="py-string">'profile'</tt><tt class="py-op">,</tt> <tt class="py-name">bucket</tt><tt class="py-op">=</tt><tt class="py-string">'audio_summary'</tt><tt class="py-op">)</tt> </tt>
  169. <a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'audio_summary'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">response</tt><tt class="py-op">[</tt><tt class="py-string">'songs'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'audio_summary'</tt><tt class="py-op">]</tt> </tt>
  170. <a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-11" class="py-name"><a title="pyechonest.results.Result" class="py-name" href="#" onclick="return doclink('link-11', 'Result', 'link-4');">Result</a></tt><tt class="py-op">(</tt><tt class="py-string">'audio_summary'</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'audio_summary'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
  171. </div><a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"> </tt>
  172. <a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"> <tt id="link-12" class="py-name" targets="Variable pyechonest.song.Song.audio_summary=pyechonest.song.Song-class.html#audio_summary"><a title="pyechonest.song.Song.audio_summary" class="py-name" href="#" onclick="return doclink('link-12', 'audio_summary', 'link-12');">audio_summary</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-13" class="py-name" targets="Method pyechonest.song.Song.get_audio_summary()=pyechonest.song.Song-class.html#get_audio_summary"><a title="pyechonest.song.Song.get_audio_summary" class="py-name" href="#" onclick="return doclink('link-13', 'get_audio_summary', 'link-13');">get_audio_summary</a></tt><tt class="py-op">)</tt> </tt>
  173. <a name="L67"></a><tt class="py-lineno"> 67</tt> <tt class="py-line"> </tt>
  174. <a name="Song.get_song_hotttnesss"></a><div id="Song.get_song_hotttnesss-def"><a name="L68"></a><tt class="py-lineno"> 68</tt> <a class="py-toggle" href="#" id="Song.get_song_hotttnesss-toggle" onclick="return toggle('Song.get_song_hotttnesss');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#get_song_hotttnesss">get_song_hotttnesss</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  175. </div><div id="Song.get_song_hotttnesss-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.get_song_hotttnesss-expanded"><a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"> <tt class="py-docstring">"""Get our numerical description of how hottt a song currently is</tt> </tt>
  176. <a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  177. <a name="L71"></a><tt class="py-lineno"> 71</tt> <tt class="py-line"><tt class="py-docstring"> Args:</tt> </tt>
  178. <a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"><tt class="py-docstring"> cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</tt> </tt>
  179. <a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  180. <a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"><tt class="py-docstring"> Returns:</tt> </tt>
  181. <a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"><tt class="py-docstring"> A float representing hotttnesss.</tt> </tt>
  182. <a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
  183. <a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-name">cache</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'song_hotttnesss'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  184. <a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"> <tt class="py-name">response</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-14" class="py-name"><a title="pyechonest.proxies.ArtistProxy.get_attribute
  185. pyechonest.proxies.GenericProxy.get_attribute
  186. pyechonest.proxies.PlaylistProxy.get_attribute
  187. pyechonest.proxies.SongProxy.get_attribute" class="py-name" href="#" onclick="return doclink('link-14', 'get_attribute', 'link-10');">get_attribute</a></tt><tt class="py-op">(</tt><tt class="py-string">'profile'</tt><tt class="py-op">,</tt> <tt class="py-name">bucket</tt><tt class="py-op">=</tt><tt class="py-string">'song_hotttnesss'</tt><tt class="py-op">)</tt> </tt>
  188. <a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'song_hotttnesss'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">response</tt><tt class="py-op">[</tt><tt class="py-string">'songs'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'song_hotttnesss'</tt><tt class="py-op">]</tt> </tt>
  189. <a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'song_hotttnesss'</tt><tt class="py-op">]</tt> </tt>
  190. </div><a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"> </tt>
  191. <a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"> <tt id="link-15" class="py-name" targets="Variable pyechonest.song.Song.song_hotttnesss=pyechonest.song.Song-class.html#song_hotttnesss"><a title="pyechonest.song.Song.song_hotttnesss" class="py-name" href="#" onclick="return doclink('link-15', 'song_hotttnesss', 'link-15');">song_hotttnesss</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-16" class="py-name" targets="Method pyechonest.song.Song.get_song_hotttnesss()=pyechonest.song.Song-class.html#get_song_hotttnesss"><a title="pyechonest.song.Song.get_song_hotttnesss" class="py-name" href="#" onclick="return doclink('link-16', 'get_song_hotttnesss', 'link-16');">get_song_hotttnesss</a></tt><tt class="py-op">)</tt> </tt>
  192. <a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"> </tt>
  193. <a name="Song.get_artist_hotttnesss"></a><div id="Song.get_artist_hotttnesss-def"><a name="L84"></a><tt class="py-lineno"> 84</tt> <a class="py-toggle" href="#" id="Song.get_artist_hotttnesss-toggle" onclick="return toggle('Song.get_artist_hotttnesss');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#get_artist_hotttnesss">get_artist_hotttnesss</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  194. </div><div id="Song.get_artist_hotttnesss-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.get_artist_hotttnesss-expanded"><a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"> <tt class="py-docstring">"""Get our numerical description of how hottt a song's artist currently is</tt> </tt>
  195. <a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  196. <a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"><tt class="py-docstring"> Args:</tt> </tt>
  197. <a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"><tt class="py-docstring"> cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</tt> </tt>
  198. <a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  199. <a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"><tt class="py-docstring"> Returns:</tt> </tt>
  200. <a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"><tt class="py-docstring"> A float representing hotttnesss.</tt> </tt>
  201. <a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
  202. <a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-name">cache</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'artist_hotttnesss'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  203. <a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"> <tt class="py-name">response</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-17" class="py-name"><a title="pyechonest.proxies.ArtistProxy.get_attribute
  204. pyechonest.proxies.GenericProxy.get_attribute
  205. pyechonest.proxies.PlaylistProxy.get_attribute
  206. pyechonest.proxies.SongProxy.get_attribute" class="py-name" href="#" onclick="return doclink('link-17', 'get_attribute', 'link-10');">get_attribute</a></tt><tt class="py-op">(</tt><tt class="py-string">'profile'</tt><tt class="py-op">,</tt> <tt class="py-name">bucket</tt><tt class="py-op">=</tt><tt class="py-string">'artist_hotttnesss'</tt><tt class="py-op">)</tt> </tt>
  207. <a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'artist_hotttnesss'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">response</tt><tt class="py-op">[</tt><tt class="py-string">'songs'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'artist_hotttnesss'</tt><tt class="py-op">]</tt> </tt>
  208. <a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'artist_hotttnesss'</tt><tt class="py-op">]</tt> </tt>
  209. </div><a name="L97"></a><tt class="py-lineno"> 97</tt> <tt class="py-line"> </tt>
  210. <a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"> <tt id="link-18" class="py-name" targets="Variable pyechonest.song.Song.artist_hotttnesss=pyechonest.song.Song-class.html#artist_hotttnesss"><a title="pyechonest.song.Song.artist_hotttnesss" class="py-name" href="#" onclick="return doclink('link-18', 'artist_hotttnesss', 'link-18');">artist_hotttnesss</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-19" class="py-name" targets="Method pyechonest.song.Song.get_artist_hotttnesss()=pyechonest.song.Song-class.html#get_artist_hotttnesss"><a title="pyechonest.song.Song.get_artist_hotttnesss" class="py-name" href="#" onclick="return doclink('link-19', 'get_artist_hotttnesss', 'link-19');">get_artist_hotttnesss</a></tt><tt class="py-op">)</tt> </tt>
  211. <a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"> </tt>
  212. <a name="Song.get_artist_familiarity"></a><div id="Song.get_artist_familiarity-def"><a name="L100"></a><tt class="py-lineno">100</tt> <a class="py-toggle" href="#" id="Song.get_artist_familiarity-toggle" onclick="return toggle('Song.get_artist_familiarity');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#get_artist_familiarity">get_artist_familiarity</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  213. </div><div id="Song.get_artist_familiarity-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.get_artist_familiarity-expanded"><a name="L101"></a><tt class="py-lineno">101</tt> <tt class="py-line"> <tt class="py-docstring">"""Get our numerical estimation of how familiar a song's artist currently is to the world</tt> </tt>
  214. <a name="L102"></a><tt class="py-lineno">102</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  215. <a name="L103"></a><tt class="py-lineno">103</tt> <tt class="py-line"><tt class="py-docstring"> Args:</tt> </tt>
  216. <a name="L104"></a><tt class="py-lineno">104</tt> <tt class="py-line"><tt class="py-docstring"> cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</tt> </tt>
  217. <a name="L105"></a><tt class="py-lineno">105</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  218. <a name="L106"></a><tt class="py-lineno">106</tt> <tt class="py-line"><tt class="py-docstring"> Returns:</tt> </tt>
  219. <a name="L107"></a><tt class="py-lineno">107</tt> <tt class="py-line"><tt class="py-docstring"> A float representing familiarity.</tt> </tt>
  220. <a name="L108"></a><tt class="py-lineno">108</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
  221. <a name="L109"></a><tt class="py-lineno">109</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-name">cache</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'artist_familiarity'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  222. <a name="L110"></a><tt class="py-lineno">110</tt> <tt class="py-line"> <tt class="py-name">response</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-20" class="py-name"><a title="pyechonest.proxies.ArtistProxy.get_attribute
  223. pyechonest.proxies.GenericProxy.get_attribute
  224. pyechonest.proxies.PlaylistProxy.get_attribute
  225. pyechonest.proxies.SongProxy.get_attribute" class="py-name" href="#" onclick="return doclink('link-20', 'get_attribute', 'link-10');">get_attribute</a></tt><tt class="py-op">(</tt><tt class="py-string">'profile'</tt><tt class="py-op">,</tt> <tt class="py-name">bucket</tt><tt class="py-op">=</tt><tt class="py-string">'artist_familiarity'</tt><tt class="py-op">)</tt> </tt>
  226. <a name="L111"></a><tt class="py-lineno">111</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'artist_familiarity'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">response</tt><tt class="py-op">[</tt><tt class="py-string">'songs'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'artist_familiarity'</tt><tt class="py-op">]</tt> </tt>
  227. <a name="L112"></a><tt class="py-lineno">112</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'artist_familiarity'</tt><tt class="py-op">]</tt> </tt>
  228. </div><a name="L113"></a><tt class="py-lineno">113</tt> <tt class="py-line"> </tt>
  229. <a name="L114"></a><tt class="py-lineno">114</tt> <tt class="py-line"> <tt id="link-21" class="py-name" targets="Variable pyechonest.song.Song.artist_familiarity=pyechonest.song.Song-class.html#artist_familiarity"><a title="pyechonest.song.Song.artist_familiarity" class="py-name" href="#" onclick="return doclink('link-21', 'artist_familiarity', 'link-21');">artist_familiarity</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-22" class="py-name" targets="Method pyechonest.song.Song.get_artist_familiarity()=pyechonest.song.Song-class.html#get_artist_familiarity"><a title="pyechonest.song.Song.get_artist_familiarity" class="py-name" href="#" onclick="return doclink('link-22', 'get_artist_familiarity', 'link-22');">get_artist_familiarity</a></tt><tt class="py-op">)</tt> </tt>
  230. <a name="L115"></a><tt class="py-lineno">115</tt> <tt class="py-line"> </tt>
  231. <a name="Song.get_artist_location"></a><div id="Song.get_artist_location-def"><a name="L116"></a><tt class="py-lineno">116</tt> <a class="py-toggle" href="#" id="Song.get_artist_location-toggle" onclick="return toggle('Song.get_artist_location');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#get_artist_location">get_artist_location</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  232. </div><div id="Song.get_artist_location-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.get_artist_location-expanded"><a name="L117"></a><tt class="py-lineno">117</tt> <tt class="py-line"> <tt class="py-docstring">"""Get the location of a song's artist.</tt> </tt>
  233. <a name="L118"></a><tt class="py-lineno">118</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  234. <a name="L119"></a><tt class="py-lineno">119</tt> <tt class="py-line"><tt class="py-docstring"> Args:</tt> </tt>
  235. <a name="L120"></a><tt class="py-lineno">120</tt> <tt class="py-line"><tt class="py-docstring"> cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</tt> </tt>
  236. <a name="L121"></a><tt class="py-lineno">121</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  237. <a name="L122"></a><tt class="py-lineno">122</tt> <tt class="py-line"><tt class="py-docstring"> Returns:</tt> </tt>
  238. <a name="L123"></a><tt class="py-lineno">123</tt> <tt class="py-line"><tt class="py-docstring"> An artist location object.</tt> </tt>
  239. <a name="L124"></a><tt class="py-lineno">124</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
  240. <a name="L125"></a><tt class="py-lineno">125</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-name">cache</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'artist_location'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  241. <a name="L126"></a><tt class="py-lineno">126</tt> <tt class="py-line"> <tt class="py-name">response</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-23" class="py-name"><a title="pyechonest.proxies.ArtistProxy.get_attribute
  242. pyechonest.proxies.GenericProxy.get_attribute
  243. pyechonest.proxies.PlaylistProxy.get_attribute
  244. pyechonest.proxies.SongProxy.get_attribute" class="py-name" href="#" onclick="return doclink('link-23', 'get_attribute', 'link-10');">get_attribute</a></tt><tt class="py-op">(</tt><tt class="py-string">'profile'</tt><tt class="py-op">,</tt> <tt class="py-name">bucket</tt><tt class="py-op">=</tt><tt class="py-string">'artist_location'</tt><tt class="py-op">)</tt> </tt>
  245. <a name="L127"></a><tt class="py-lineno">127</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'artist_location'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">response</tt><tt class="py-op">[</tt><tt class="py-string">'songs'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'artist_location'</tt><tt class="py-op">]</tt> </tt>
  246. <a name="L128"></a><tt class="py-lineno">128</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-24" class="py-name"><a title="pyechonest.results.Result" class="py-name" href="#" onclick="return doclink('link-24', 'Result', 'link-4');">Result</a></tt><tt class="py-op">(</tt><tt class="py-string">'artist_location'</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'artist_location'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
  247. </div><a name="L129"></a><tt class="py-lineno">129</tt> <tt class="py-line"> </tt>
  248. <a name="L130"></a><tt class="py-lineno">130</tt> <tt class="py-line"> <tt id="link-25" class="py-name" targets="Variable pyechonest.song.Song.artist_location=pyechonest.song.Song-class.html#artist_location"><a title="pyechonest.song.Song.artist_location" class="py-name" href="#" onclick="return doclink('link-25', 'artist_location', 'link-25');">artist_location</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-26" class="py-name" targets="Method pyechonest.song.Song.get_artist_location()=pyechonest.song.Song-class.html#get_artist_location"><a title="pyechonest.song.Song.get_artist_location" class="py-name" href="#" onclick="return doclink('link-26', 'get_artist_location', 'link-26');">get_artist_location</a></tt><tt class="py-op">)</tt> </tt>
  249. <a name="L131"></a><tt class="py-lineno">131</tt> <tt class="py-line"> </tt>
  250. <a name="Song.get_tracks"></a><div id="Song.get_tracks-def"><a name="L132"></a><tt class="py-lineno">132</tt> <a class="py-toggle" href="#" id="Song.get_tracks-toggle" onclick="return toggle('Song.get_tracks');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song.Song-class.html#get_tracks">get_tracks</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">catalog</tt><tt class="py-op">,</tt> <tt class="py-param">limit</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> <tt class="py-param">cache</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  251. </div><div id="Song.get_tracks-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="Song.get_tracks-expanded"><a name="L133"></a><tt class="py-lineno">133</tt> <tt class="py-line"> <tt class="py-docstring">"""Get the tracks for a song given a catalog.</tt> </tt>
  252. <a name="L134"></a><tt class="py-lineno">134</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  253. <a name="L135"></a><tt class="py-lineno">135</tt> <tt class="py-line"><tt class="py-docstring"> Args:</tt> </tt>
  254. <a name="L136"></a><tt class="py-lineno">136</tt> <tt class="py-line"><tt class="py-docstring"> catalog: a string representing the catalog whose track you want to retrieve.</tt> </tt>
  255. <a name="L137"></a><tt class="py-lineno">137</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
  256. <a name="L138"></a><tt class="py-lineno">138</tt> <tt class="py-line"><tt class="py-docstring"> Returns:</tt> </tt>
  257. <a name="L139"></a><tt class="py-lineno">139</tt> <tt class="py-line"><tt class="py-docstring"> A list of Track dicts.</tt> </tt>
  258. <a name="L140"></a><tt class="py-lineno">140</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
  259. <a name="L141"></a><tt class="py-lineno">141</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-name">cache</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'tracks'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">catalog</tt> <tt class="py-keyword">in</tt> <tt class="py-op">[</tt><tt class="py-name">td</tt><tt class="py-op">[</tt><tt class="py-string">'catalog'</tt><tt class="py-op">]</tt> <tt class="py-keyword">for</tt> <tt class="py-name">td</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'tracks'</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  260. <a name="L142"></a><tt class="py-lineno">142</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
  261. <a name="L143"></a><tt class="py-lineno">143</tt> <tt class="py-line"> <tt class="py-string">'bucket'</tt><tt class="py-op">:</tt><tt class="py-op">[</tt><tt class="py-string">'tracks'</tt><tt class="py-op">,</tt> <tt class="py-string">'id:%s'</tt> <tt class="py-op">%</tt> <tt class="py-name">catalog</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt>
  262. <a name="L144"></a><tt class="py-lineno">144</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt>
  263. <a name="L145"></a><tt class="py-lineno">145</tt> <tt class="py-line"> </tt>
  264. <a name="L146"></a><tt class="py-lineno">146</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">limit</tt><tt class="py-op">:</tt> </tt>
  265. <a name="L147"></a><tt class="py-lineno">147</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'limit'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'true'</tt> </tt>
  266. <a name="L148"></a><tt class="py-lineno">148</tt> <tt class="py-line"> </tt>
  267. <a name="L149"></a><tt class="py-lineno">149</tt> <tt class="py-line"> <tt class="py-name">response</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-27" class="py-name"><a title="pyechonest.proxies.ArtistProxy.get_attribute
  268. pyechonest.proxies.GenericProxy.get_attribute
  269. pyechonest.proxies.PlaylistProxy.get_attribute
  270. pyechonest.proxies.SongProxy.get_attribute" class="py-name" href="#" onclick="return doclink('link-27', 'get_attribute', 'link-10');">get_attribute</a></tt><tt class="py-op">(</tt><tt class="py-string">'profile'</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-name">kwargs</tt><tt class="py-op">)</tt> </tt>
  271. <a name="L150"></a><tt class="py-lineno">150</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-string">'tracks'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">:</tt> </tt>
  272. <a name="L151"></a><tt class="py-lineno">151</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'tracks'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
  273. <a name="L152"></a><tt class="py-lineno">152</tt> <tt class="py-line"> <tt class="py-comment"># don't blow away the cache for other catalogs</tt> </tt>
  274. <a name="L153"></a><tt class="py-lineno">153</tt> <tt class="py-line"> <tt class="py-name">potential_tracks</tt> <tt class="py-op">=</tt> <tt class="py-name">response</tt><tt class="py-op">[</tt><tt class="py-string">'songs'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt id="link-28" class="py-name" targets="Method echonest.action.Edit.get()=echonest.action.Edit-class.html#get"><a title="echonest.action.Edit.get" class="py-name" href="#" onclick="return doclink('link-28', 'get', 'link-28');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'tracks'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
  275. <a name="L154"></a><tt class="py-lineno">154</tt> <tt class="py-line"> <tt class="py-name">existing_track_ids</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">tr</tt><tt class="py-op">[</tt><tt class="py-string">'foreign_id'</tt><tt class="py-op">]</tt> <tt class="py-keyword">for</tt> <tt class="py-name">tr</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'tracks'</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
  276. <a name="L155"></a><tt class="py-lineno">155</tt> <tt class="py-line"> <tt class="py-name">new_tds</tt> <tt class="py-op">=</tt> <tt class="py-name">filter</tt><tt class="py-op">(</tt><tt class="py-keyword">lambda</tt> <tt class="py-name">tr</tt><tt class="py-op">:</tt> <tt class="py-name">tr</tt><tt class="py-op">[</tt><tt class="py-string">'foreign_id'</tt><tt class="py-op">]</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">existing_track_ids</tt><tt class="py-op">,</tt> <tt class="py-name">potential_tracks</tt><tt class="py-op">)</tt> </tt>
  277. <a name="L156"></a><tt class="py-lineno">156</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'tracks'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-name">new_tds</tt><tt class="py-op">)</tt> </tt>
  278. <a name="L157"></a><tt class="py-lineno">157</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">filter</tt><tt class="py-op">(</tt><tt class="py-keyword">lambda</tt> <tt class="py-name">tr</tt><tt class="py-op">:</tt> <tt class="py-name">tr</tt><tt class="py-op">[</tt><tt class="py-string">'catalog'</tt><tt class="py-op">]</tt><tt class="py-op">==</tt><tt class="py-name">catalog</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">cache</tt><tt class="py-op">[</tt><tt class="py-string">'tracks'</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
  279. </div></div><a name="L158"></a><tt class="py-lineno">158</tt> <tt class="py-line"> </tt>
  280. <a name="identify"></a><div id="identify-def"><a name="L159"></a><tt class="py-lineno">159</tt> <a class="py-toggle" href="#" id="identify-toggle" onclick="return toggle('identify');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song-module.html#identify">identify</a><tt class="py-op">(</tt><tt class="py-param">filename</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">query_obj</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">code</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">artist</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">title</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">release</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">duration</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">genre</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">buckets</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">alt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">codegen_start</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-param">codegen_duration</tt><tt class="py-op">=</tt><tt class="py-number">30</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  281. </div><div id="identify-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="identify-expanded"><a name="L160"></a><tt class="py-lineno">160</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
  282. <a name="L161"></a><tt class="py-lineno">161</tt> <tt class="py-line"> <tt class="py-name">post</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
  283. <a name="L162"></a><tt class="py-lineno">162</tt> <tt class="py-line"> <tt class="py-name">has_data</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
  284. <a name="L163"></a><tt class="py-lineno">163</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">filename</tt><tt class="py-op">:</tt> </tt>
  285. <a name="L164"></a><tt class="py-lineno">164</tt> <tt class="py-line"> <tt class="py-name">query_obj</tt> <tt class="py-op">=</tt> <tt id="link-29" class="py-name"><a title="pyechonest.util" class="py-name" href="#" onclick="return doclink('link-29', 'util', 'link-0');">util</a></tt><tt class="py-op">.</tt><tt id="link-30" class="py-name" targets="Function pyechonest.util.codegen()=pyechonest.util-module.html#codegen"><a title="pyechonest.util.codegen" class="py-name" href="#" onclick="return doclink('link-30', 'codegen', 'link-30');">codegen</a></tt><tt class="py-op">(</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt id="link-31" class="py-name" targets="Variable echonest.audio.AudioQuantumList.start=echonest.audio.AudioQuantumList-class.html#start"><a title="echonest.audio.AudioQuantumList.start" class="py-name" href="#" onclick="return doclink('link-31', 'start', 'link-31');">start</a></tt><tt class="py-op">=</tt><tt class="py-name">codegen_start</tt><tt class="py-op">,</tt> <tt id="link-32" class="py-name" targets="Variable echonest.audio.AudioData.duration=echonest.audio.AudioData-class.html#duration,Variable echonest.audio.AudioQuantumList.duration=echonest.audio.AudioQuantumList-class.html#duration,Variable echonest.audio.LocalAudioFile.duration=echonest.audio.LocalAudioFile-class.html#duration,Variable echonest.audio.ModifiedRenderable.duration=echonest.audio.ModifiedRenderable-class.html#duration,Variable echonest.audio.Simultaneous.duration=echonest.audio.Simultaneous-class.html#duration,Method echonest.audio.TimeTruncateFactor.duration()=echonest.audio.TimeTruncateFactor-class.html#duration,Method echonest.audio.TimeTruncateLength.duration()=echonest.audio.TimeTruncateLength-class.html#duration,Function echonest.sorting.duration()=echonest.sorting-module.html#duration,Method echonest.video.ImageSequence.duration()=echonest.video.ImageSequence-class.html#duration"><a title="echonest.audio.AudioData.duration
  286. echonest.audio.AudioQuantumList.duration
  287. echonest.audio.LocalAudioFile.duration
  288. echonest.audio.ModifiedRenderable.duration
  289. echonest.audio.Simultaneous.duration
  290. echonest.audio.TimeTruncateFactor.duration
  291. echonest.audio.TimeTruncateLength.duration
  292. echonest.sorting.duration
  293. echonest.video.ImageSequence.duration" class="py-name" href="#" onclick="return doclink('link-32', 'duration', 'link-32');">duration</a></tt><tt class="py-op">=</tt><tt class="py-name">codegen_duration</tt><tt class="py-op">)</tt> </tt>
  294. <a name="L165"></a><tt class="py-lineno">165</tt> <tt class="py-line"> </tt>
  295. <a name="L166"></a><tt class="py-lineno">166</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">query_obj</tt><tt class="py-op">,</tt> <tt class="py-name">list</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  296. <a name="L167"></a><tt class="py-lineno">167</tt> <tt class="py-line"> <tt class="py-name">query_obj</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">query_obj</tt><tt class="py-op">]</tt> </tt>
  297. <a name="L168"></a><tt class="py-lineno">168</tt> <tt class="py-line"> </tt>
  298. <a name="L169"></a><tt class="py-lineno">169</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">code</tt><tt class="py-op">:</tt> </tt>
  299. <a name="L170"></a><tt class="py-lineno">170</tt> <tt class="py-line"> <tt class="py-name">has_data</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
  300. <a name="L171"></a><tt class="py-lineno">171</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'code'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">code</tt> </tt>
  301. <a name="L172"></a><tt class="py-lineno">172</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">title</tt><tt class="py-op">:</tt> </tt>
  302. <a name="L173"></a><tt class="py-lineno">173</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'title'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">title</tt> </tt>
  303. <a name="L174"></a><tt class="py-lineno">174</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">release</tt><tt class="py-op">:</tt> </tt>
  304. <a name="L175"></a><tt class="py-lineno">175</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'release'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">release</tt> </tt>
  305. <a name="L176"></a><tt class="py-lineno">176</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-33" class="py-name"><a title="echonest.audio.AudioData.duration
  306. echonest.audio.AudioQuantumList.duration
  307. echonest.audio.LocalAudioFile.duration
  308. echonest.audio.ModifiedRenderable.duration
  309. echonest.audio.Simultaneous.duration
  310. echonest.audio.TimeTruncateFactor.duration
  311. echonest.audio.TimeTruncateLength.duration
  312. echonest.sorting.duration
  313. echonest.video.ImageSequence.duration" class="py-name" href="#" onclick="return doclink('link-33', 'duration', 'link-32');">duration</a></tt><tt class="py-op">:</tt> </tt>
  314. <a name="L177"></a><tt class="py-lineno">177</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'duration'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-34" class="py-name"><a title="echonest.audio.AudioData.duration
  315. echonest.audio.AudioQuantumList.duration
  316. echonest.audio.LocalAudioFile.duration
  317. echonest.audio.ModifiedRenderable.duration
  318. echonest.audio.Simultaneous.duration
  319. echonest.audio.TimeTruncateFactor.duration
  320. echonest.audio.TimeTruncateLength.duration
  321. echonest.sorting.duration
  322. echonest.video.ImageSequence.duration" class="py-name" href="#" onclick="return doclink('link-34', 'duration', 'link-32');">duration</a></tt> </tt>
  323. <a name="L178"></a><tt class="py-lineno">178</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">genre</tt><tt class="py-op">:</tt> </tt>
  324. <a name="L179"></a><tt class="py-lineno">179</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'genre'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">genre</tt> </tt>
  325. <a name="L180"></a><tt class="py-lineno">180</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">buckets</tt><tt class="py-op">:</tt> </tt>
  326. <a name="L181"></a><tt class="py-lineno">181</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'bucket'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">buckets</tt> </tt>
  327. <a name="L182"></a><tt class="py-lineno">182</tt> <tt class="py-line"> </tt>
  328. <a name="L183"></a><tt class="py-lineno">183</tt> <tt class="py-line"> <tt class="py-comment"># TODO -- this is a temp debug param should be taken out for release</tt> </tt>
  329. <a name="L184"></a><tt class="py-lineno">184</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">alt</tt><tt class="py-op">:</tt> </tt>
  330. <a name="L185"></a><tt class="py-lineno">185</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">query_obj</tt><tt class="py-op">:</tt> </tt>
  331. <a name="L186"></a><tt class="py-lineno">186</tt> <tt class="py-line"> <tt class="py-name">query_obj</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'alt'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
  332. <a name="L187"></a><tt class="py-lineno">187</tt> <tt class="py-line"> </tt>
  333. <a name="L188"></a><tt class="py-lineno">188</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">query_obj</tt> <tt class="py-keyword">and</tt> <tt class="py-name">any</tt><tt class="py-op">(</tt><tt class="py-name">query_obj</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  334. <a name="L189"></a><tt class="py-lineno">189</tt> <tt class="py-line"> <tt class="py-name">has_data</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
  335. <a name="L190"></a><tt class="py-lineno">190</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'query'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">json</tt><tt class="py-op">.</tt><tt class="py-name">dumps</tt><tt class="py-op">(</tt><tt class="py-name">query_obj</tt><tt class="py-op">)</tt> </tt>
  336. <a name="L191"></a><tt class="py-lineno">191</tt> <tt class="py-line"> <tt class="py-name">post</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
  337. <a name="L192"></a><tt class="py-lineno">192</tt> <tt class="py-line"> </tt>
  338. <a name="L193"></a><tt class="py-lineno">193</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">has_data</tt><tt class="py-op">:</tt> </tt>
  339. <a name="L194"></a><tt class="py-lineno">194</tt> <tt class="py-line"> <tt class="py-name">result</tt> <tt class="py-op">=</tt> <tt id="link-35" class="py-name"><a title="pyechonest.util" class="py-name" href="#" onclick="return doclink('link-35', 'util', 'link-0');">util</a></tt><tt class="py-op">.</tt><tt id="link-36" class="py-name" targets="Function pyechonest.util.callm()=pyechonest.util-module.html#callm"><a title="pyechonest.util.callm" class="py-name" href="#" onclick="return doclink('link-36', 'callm', 'link-36');">callm</a></tt><tt class="py-op">(</tt><tt class="py-string">"%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-string">'song'</tt><tt class="py-op">,</tt> <tt class="py-string">'identify'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">kwargs</tt><tt class="py-op">,</tt> <tt class="py-name">POST</tt><tt class="py-op">=</tt><tt class="py-name">post</tt><tt class="py-op">)</tt> </tt>
  340. <a name="L195"></a><tt class="py-lineno">195</tt> <tt class="py-line"> <tt class="py-keyword">print</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">result</tt><tt class="py-op">)</tt> </tt>
  341. <a name="L196"></a><tt class="py-lineno">196</tt> <tt class="py-line"> <tt class="py-name">fix</tt> <tt class="py-op">=</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">x</tt> <tt class="py-op">:</tt> <tt class="py-name">dict</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">v</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">,</tt><tt class="py-name">v</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">x</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
  342. <a name="L197"></a><tt class="py-lineno">197</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt id="link-37" class="py-name"><a title="pyechonest.song.Song" class="py-name" href="#" onclick="return doclink('link-37', 'Song', 'link-5');">Song</a></tt><tt class="py-op">(</tt><tt class="py-op">**</tt><tt class="py-name">fix</tt><tt class="py-op">(</tt><tt class="py-name">s_dict</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">s_dict</tt> <tt class="py-keyword">in</tt> <tt class="py-name">result</tt><tt class="py-op">[</tt><tt class="py-string">'response'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt id="link-38" class="py-name"><a title="echonest.action.Edit.get" class="py-name" href="#" onclick="return doclink('link-38', 'get', 'link-28');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'songs'</tt><tt class="py-op">,</tt><tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt>
  343. <a name="L198"></a><tt class="py-lineno">198</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
  344. <a name="L199"></a><tt class="py-lineno">199</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt>
  345. </div><a name="L200"></a><tt class="py-lineno">200</tt> <tt class="py-line"> </tt>
  346. <a name="L201"></a><tt class="py-lineno">201</tt> <tt class="py-line"> </tt>
  347. <a name="L202"></a><tt class="py-lineno">202</tt> <tt class="py-line"> </tt>
  348. <a name="search"></a><div id="search-def"><a name="L203"></a><tt class="py-lineno">203</tt> <a class="py-toggle" href="#" id="search-toggle" onclick="return toggle('search');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song-module.html#search">search</a><tt class="py-op">(</tt><tt class="py-param">title</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">artist</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">artist_id</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">combined</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">description</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">results</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">max_tempo</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> \ </tt>
  349. <a name="L204"></a><tt class="py-lineno">204</tt> <tt class="py-line"> <tt class="py-param">min_tempo</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">max_duration</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">min_duration</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">max_loudness</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">min_loudness</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> \ </tt>
  350. <a name="L205"></a><tt class="py-lineno">205</tt> <tt class="py-line"> <tt class="py-param">artist_max_familiarity</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">artist_min_familiarity</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">artist_max_hotttnesss</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> \ </tt>
  351. <a name="L206"></a><tt class="py-lineno">206</tt> <tt class="py-line"> <tt class="py-param">artist_min_hotttnesss</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">song_max_hotttnesss</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">song_min_hotttnesss</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">mode</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> \ </tt>
  352. <a name="L207"></a><tt class="py-lineno">207</tt> <tt class="py-line"> <tt class="py-param">key</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">max_latitude</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">min_latitude</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">max_longitude</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">min_longitude</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> \ </tt>
  353. <a name="L208"></a><tt class="py-lineno">208</tt> <tt class="py-line"> <tt class="py-param">sort</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">buckets</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">limit</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  354. </div><div id="search-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="search-expanded"><a name="L209"></a><tt class="py-lineno">209</tt> <tt class="py-line"> <tt class="py-docstring">"""search for songs"""</tt> </tt>
  355. <a name="L210"></a><tt class="py-lineno">210</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
  356. <a name="L211"></a><tt class="py-lineno">211</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">title</tt><tt class="py-op">:</tt> </tt>
  357. <a name="L212"></a><tt class="py-lineno">212</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'title'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">title</tt> </tt>
  358. <a name="L213"></a><tt class="py-lineno">213</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-39" class="py-name" targets="Module pyechonest.artist=pyechonest.artist-module.html"><a title="pyechonest.artist" class="py-name" href="#" onclick="return doclink('link-39', 'artist', 'link-39');">artist</a></tt><tt class="py-op">:</tt> </tt>
  359. <a name="L214"></a><tt class="py-lineno">214</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'artist'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-40" class="py-name"><a title="pyechonest.artist" class="py-name" href="#" onclick="return doclink('link-40', 'artist', 'link-39');">artist</a></tt> </tt>
  360. <a name="L215"></a><tt class="py-lineno">215</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">artist_id</tt><tt class="py-op">:</tt> </tt>
  361. <a name="L216"></a><tt class="py-lineno">216</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'artist_id'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">artist_id</tt> </tt>
  362. <a name="L217"></a><tt class="py-lineno">217</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">combined</tt><tt class="py-op">:</tt> </tt>
  363. <a name="L218"></a><tt class="py-lineno">218</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'combined'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">combined</tt> </tt>
  364. <a name="L219"></a><tt class="py-lineno">219</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">description</tt><tt class="py-op">:</tt> </tt>
  365. <a name="L220"></a><tt class="py-lineno">220</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'description'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">description</tt> </tt>
  366. <a name="L221"></a><tt class="py-lineno">221</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-41" class="py-name"><a title="pyechonest.results" class="py-name" href="#" onclick="return doclink('link-41', 'results', 'link-3');">results</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  367. <a name="L222"></a><tt class="py-lineno">222</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'results'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-42" class="py-name"><a title="pyechonest.results" class="py-name" href="#" onclick="return doclink('link-42', 'results', 'link-3');">results</a></tt> </tt>
  368. <a name="L223"></a><tt class="py-lineno">223</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">max_tempo</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  369. <a name="L224"></a><tt class="py-lineno">224</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'max_tempo'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">max_tempo</tt> </tt>
  370. <a name="L225"></a><tt class="py-lineno">225</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">min_tempo</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  371. <a name="L226"></a><tt class="py-lineno">226</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'min_tempo'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">min_tempo</tt> </tt>
  372. <a name="L227"></a><tt class="py-lineno">227</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">max_duration</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  373. <a name="L228"></a><tt class="py-lineno">228</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'max_duration'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">max_duration</tt> </tt>
  374. <a name="L229"></a><tt class="py-lineno">229</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">min_duration</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  375. <a name="L230"></a><tt class="py-lineno">230</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'min_duration'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">min_duration</tt> </tt>
  376. <a name="L231"></a><tt class="py-lineno">231</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">max_loudness</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  377. <a name="L232"></a><tt class="py-lineno">232</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'max_loudness'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">max_loudness</tt> </tt>
  378. <a name="L233"></a><tt class="py-lineno">233</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">min_loudness</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  379. <a name="L234"></a><tt class="py-lineno">234</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'min_loudness'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">min_loudness</tt> </tt>
  380. <a name="L235"></a><tt class="py-lineno">235</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">artist_max_familiarity</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  381. <a name="L236"></a><tt class="py-lineno">236</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'artist_max_familiarity'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">artist_max_familiarity</tt> </tt>
  382. <a name="L237"></a><tt class="py-lineno">237</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">artist_min_familiarity</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  383. <a name="L238"></a><tt class="py-lineno">238</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'artist_min_familiarity'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">artist_min_familiarity</tt> </tt>
  384. <a name="L239"></a><tt class="py-lineno">239</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">artist_max_hotttnesss</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  385. <a name="L240"></a><tt class="py-lineno">240</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'artist_max_hotttnesss'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">artist_max_hotttnesss</tt> </tt>
  386. <a name="L241"></a><tt class="py-lineno">241</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">artist_min_hotttnesss</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  387. <a name="L242"></a><tt class="py-lineno">242</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'artist_min_hotttnesss'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">artist_min_hotttnesss</tt> </tt>
  388. <a name="L243"></a><tt class="py-lineno">243</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">song_max_hotttnesss</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  389. <a name="L244"></a><tt class="py-lineno">244</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'song_max_hotttnesss'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">song_max_hotttnesss</tt> </tt>
  390. <a name="L245"></a><tt class="py-lineno">245</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">song_min_hotttnesss</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  391. <a name="L246"></a><tt class="py-lineno">246</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'song_min_hotttnesss'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">song_min_hotttnesss</tt> </tt>
  392. <a name="L247"></a><tt class="py-lineno">247</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">mode</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  393. <a name="L248"></a><tt class="py-lineno">248</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'mode'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">mode</tt> </tt>
  394. <a name="L249"></a><tt class="py-lineno">249</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  395. <a name="L250"></a><tt class="py-lineno">250</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'key'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">key</tt> </tt>
  396. <a name="L251"></a><tt class="py-lineno">251</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">max_latitude</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  397. <a name="L252"></a><tt class="py-lineno">252</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'max_latitude'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">max_latitude</tt> </tt>
  398. <a name="L253"></a><tt class="py-lineno">253</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">min_latitude</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  399. <a name="L254"></a><tt class="py-lineno">254</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'min_latitude'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">min_latitude</tt> </tt>
  400. <a name="L255"></a><tt class="py-lineno">255</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">max_longitude</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  401. <a name="L256"></a><tt class="py-lineno">256</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'max_longitude'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">max_longitude</tt> </tt>
  402. <a name="L257"></a><tt class="py-lineno">257</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">min_longitude</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
  403. <a name="L258"></a><tt class="py-lineno">258</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'min_longitude'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">min_longitude</tt> </tt>
  404. <a name="L259"></a><tt class="py-lineno">259</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">sort</tt><tt class="py-op">:</tt> </tt>
  405. <a name="L260"></a><tt class="py-lineno">260</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'sort'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">sort</tt> </tt>
  406. <a name="L261"></a><tt class="py-lineno">261</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">buckets</tt><tt class="py-op">:</tt> </tt>
  407. <a name="L262"></a><tt class="py-lineno">262</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'bucket'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">buckets</tt> </tt>
  408. <a name="L263"></a><tt class="py-lineno">263</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">limit</tt><tt class="py-op">:</tt> </tt>
  409. <a name="L264"></a><tt class="py-lineno">264</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'limit'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'true'</tt> </tt>
  410. <a name="L265"></a><tt class="py-lineno">265</tt> <tt class="py-line"> </tt>
  411. <a name="L266"></a><tt class="py-lineno">266</tt> <tt class="py-line"> <tt class="py-name">result</tt> <tt class="py-op">=</tt> <tt id="link-43" class="py-name"><a title="pyechonest.util" class="py-name" href="#" onclick="return doclink('link-43', 'util', 'link-0');">util</a></tt><tt class="py-op">.</tt><tt id="link-44" class="py-name"><a title="pyechonest.util.callm" class="py-name" href="#" onclick="return doclink('link-44', 'callm', 'link-36');">callm</a></tt><tt class="py-op">(</tt><tt class="py-string">"%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-string">'song'</tt><tt class="py-op">,</tt> <tt class="py-string">'search'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">kwargs</tt><tt class="py-op">)</tt> </tt>
  412. <a name="L267"></a><tt class="py-lineno">267</tt> <tt class="py-line"> <tt class="py-comment"># we need this to fix up all the dict keys to be strings, not unicode objects</tt> </tt>
  413. <a name="L268"></a><tt class="py-lineno">268</tt> <tt class="py-line"> <tt class="py-name">fix</tt> <tt class="py-op">=</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">x</tt> <tt class="py-op">:</tt> <tt class="py-name">dict</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">v</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">,</tt><tt class="py-name">v</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">x</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
  414. <a name="L269"></a><tt class="py-lineno">269</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt id="link-45" class="py-name"><a title="pyechonest.song.Song" class="py-name" href="#" onclick="return doclink('link-45', 'Song', 'link-5');">Song</a></tt><tt class="py-op">(</tt><tt class="py-op">**</tt><tt class="py-name">fix</tt><tt class="py-op">(</tt><tt class="py-name">s_dict</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">s_dict</tt> <tt class="py-keyword">in</tt> <tt class="py-name">result</tt><tt class="py-op">[</tt><tt class="py-string">'response'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'songs'</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
  415. </div><a name="L270"></a><tt class="py-lineno">270</tt> <tt class="py-line"> </tt>
  416. <a name="profile"></a><div id="profile-def"><a name="L271"></a><tt class="py-lineno">271</tt> <a class="py-toggle" href="#" id="profile-toggle" onclick="return toggle('profile');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="pyechonest.song-module.html#profile">profile</a><tt class="py-op">(</tt><tt class="py-param">ids</tt><tt class="py-op">,</tt> <tt class="py-param">buckets</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">limit</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  417. </div><div id="profile-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="profile-expanded"><a name="L272"></a><tt class="py-lineno">272</tt> <tt class="py-line"> <tt class="py-docstring">"""get the profiles for multiple songs at once"""</tt> </tt>
  418. <a name="L273"></a><tt class="py-lineno">273</tt> <tt class="py-line"> <tt class="py-name">buckets</tt> <tt class="py-op">=</tt> <tt class="py-name">buckets</tt> <tt class="py-keyword">or</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
  419. <a name="L274"></a><tt class="py-lineno">274</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">ids</tt><tt class="py-op">,</tt> <tt class="py-name">list</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  420. <a name="L275"></a><tt class="py-lineno">275</tt> <tt class="py-line"> <tt class="py-name">ids</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">ids</tt><tt class="py-op">]</tt> </tt>
  421. <a name="L276"></a><tt class="py-lineno">276</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
  422. <a name="L277"></a><tt class="py-lineno">277</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'id'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">ids</tt> </tt>
  423. <a name="L278"></a><tt class="py-lineno">278</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">buckets</tt><tt class="py-op">:</tt> </tt>
  424. <a name="L279"></a><tt class="py-lineno">279</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'bucket'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">buckets</tt> </tt>
  425. <a name="L280"></a><tt class="py-lineno">280</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">limit</tt><tt class="py-op">:</tt> </tt>
  426. <a name="L281"></a><tt class="py-lineno">281</tt> <tt class="py-line"> <tt class="py-name">kwargs</tt><tt class="py-op">[</tt><tt class="py-string">'limit'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'true'</tt> </tt>
  427. <a name="L282"></a><tt class="py-lineno">282</tt> <tt class="py-line"> </tt>
  428. <a name="L283"></a><tt class="py-lineno">283</tt> <tt class="py-line"> <tt class="py-name">result</tt> <tt class="py-op">=</tt> <tt id="link-46" class="py-name"><a title="pyechonest.util" class="py-name" href="#" onclick="return doclink('link-46', 'util', 'link-0');">util</a></tt><tt class="py-op">.</tt><tt id="link-47" class="py-name"><a title="pyechonest.util.callm" class="py-name" href="#" onclick="return doclink('link-47', 'callm', 'link-36');">callm</a></tt><tt class="py-op">(</tt><tt class="py-string">"%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-string">'song'</tt><tt class="py-op">,</tt> <tt class="py-string">'profile'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">kwargs</tt><tt class="py-op">)</tt> </tt>
  429. <a name="L284"></a><tt class="py-lineno">284</tt> <tt class="py-line"> <tt class="py-name">fix</tt> <tt class="py-op">=</tt> <tt class="py-keyword">lambda</tt> <tt class="py-name">x</tt> <tt class="py-op">:</tt> <tt class="py-name">dict</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">v</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">,</tt><tt class="py-name">v</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">x</tt><tt class="py-op">.</tt><tt class="py-name">iteritems</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
  430. <a name="L285"></a><tt class="py-lineno">285</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt id="link-48" class="py-name"><a title="pyechonest.song.Song" class="py-name" href="#" onclick="return doclink('link-48', 'Song', 'link-5');">Song</a></tt><tt class="py-op">(</tt><tt class="py-op">**</tt><tt class="py-name">fix</tt><tt class="py-op">(</tt><tt class="py-name">s_dict</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">s_dict</tt> <tt class="py-keyword">in</tt> <tt class="py-name">result</tt><tt class="py-op">[</tt><tt class="py-string">'response'</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'songs'</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
  431. </div><a name="L286"></a><tt class="py-lineno">286</tt> <tt class="py-line"> </tt><script type="text/javascript">
  432. <!--
  433. expandto(location.href);
  434. // -->
  435. </script>
  436. </pre>
  437. <br />
  438. <!-- ==================== NAVIGATION BAR ==================== -->
  439. <table class="navbar" border="0" width="100%" cellpadding="0"
  440. bgcolor="#a0c0ff" cellspacing="0">
  441. <tr valign="middle">
  442. <!-- Tree link -->
  443. <th>&nbsp;&nbsp;&nbsp;<a
  444. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  445. <!-- Index link -->
  446. <th>&nbsp;&nbsp;&nbsp;<a
  447. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  448. <!-- Help link -->
  449. <th>&nbsp;&nbsp;&nbsp;<a
  450. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  451. <!-- Project homepage -->
  452. <th class="navbar" align="right" width="100%">
  453. <table border="0" cellpadding="0" cellspacing="0">
  454. <tr><th class="navbar" align="center"
  455. ><a class="navbar" target="_top" href="http://code.google.com/p/echo-nest-remix/">Project Homepage</a></th>
  456. </tr></table></th>
  457. </tr>
  458. </table>
  459. <table border="0" cellpadding="0" cellspacing="0" width="100%%">
  460. <tr>
  461. <td align="left" class="footer">
  462. Generated by Epydoc 3.0.1 on Wed Sep 1 16:09:00 2010
  463. </td>
  464. <td align="right" class="footer">
  465. <a target="mainFrame" href="http://epydoc.sourceforge.net"
  466. >http://epydoc.sourceforge.net</a>
  467. </td>
  468. </tr>
  469. </table>
  470. <script type="text/javascript">
  471. <!--
  472. // Private objects are initially displayed (because if
  473. // javascript is turned off then we want them to be
  474. // visible); but by default, we want to hide them. So hide
  475. // them unless we have a cookie that says to show them.
  476. checkCookie();
  477. // -->
  478. </script>
  479. </body>
  480. </html>