Metadata-Version: 1.1
Name: pyechonest
Version: 4.2.10
Summary: Python interface to The Echo Nest APIs.
Home-page: http://code.google.com/p/pyechonest/
Author: Tyler Williams
Author-email: tyler@echonest.com
License: UNKNOWN
Download-URL: http://code.google.com/p/pyechonest/
Description: Welcome to pyechonest, a python wrapper around the Echo Nest API (v4).
        
        This client library should allow you to get started using the Echo Nest API quickly and easily. The only requirement is a developer API key, which you can get for free from http://developer.echonest.com/account/register/.
        
        For documentation questions, please refer to the official api docs, which are available at http://developer.echonest.com/.
        
        IMPORTANT: You must let pyechonest know about your API key before you use it. There are two ways to let pyechonest know about your API key:
        
        1. Set the variable ECHO_NEST_API_KEY in your environment to your key.
        (bourne-like shells) 	$ export ECHO_NEST_API_KEY=YOUR_API_KEY
        (c-like shells)		$ setenv ECHO_NEST_API_KEY YOUR_API_KEY
        
        2. In Python, do this:
        >>> from pyechonest import config
        >>> config.ECHO_NEST_API_KEY = YOUR_API_KEY
        
        
        Examples:
        Search for artist:
        >>> from pyechonest import artist
        >>> weezer_results = artist.search(name='weezer')
        >>> weezer = weezer_results[0]
        >>> weezer_blogs = weezer.blogs
        >>> print 'Blogs about weezer:', [blog.get('url') for blog in weezer_blogs]
        
        Get an artist by name:
        >>> from pyechonest import artist
        >>> a = artist.Artist('lady gaga')
        >>> print a.id
        
        Get an artist from their Musicbrainz ID:
        >>> from pyechonest import artist
        >>> a = artist.Artist('musicbrainz:artist:a74b1b7f-71a5-4011-9441-d0b5e4122711')
        >>> print a.name
        
        Get the top hottt artists:
        >>> from pyechonest import artist
        >>> for hottt_artist in artist.top_hottt():
        >>>     print hottt_artist.name, hottt_artist.hotttnesss
        
        Search for songs:
        >>> from pyechonest import song
        >>> rkp_results = song.search(artist='radiohead', title='karma police')
        >>> karma_police = rkp_results[0]
        >>> print karma_police.artist_location
        >>> print 'tempo:',karma_police.audio_summary['tempo'],'duration:',karma_police.audio_summary['duration']
        
        Get a song's audio_url and analysis_url:
        >>> from pyechonest import song
        >>> wn_results = song.search(combined='the national - wasp nest', buckets=['id:7digital'], limit=True)
        >>> wasp_nest = wn_results[0]
        >>> wn_tracks = wasp_nest.get_tracks('7digital')
        >>> print wn_tracks[0].get('preview_url')
        
        
        
Platform: UNKNOWN
Requires: urllib
Requires: urllib2
Requires: json
