Skip to main content

Lazy Last.FM API bindings

Project description

[![Build Status](https://travis-ci.org/thesquelched/pylastfm.svg?branch=master)](https://travis-ci.org/thesquelched/pylastfm)

pylastfm
========

Lazy LastFM API bindings in python. Currently supports the following LastFM API methods:

- `track.*`
- `user.*`


Pagination
==========

Paginated API methods (i.e. methods that accept `page` and `limit` parameters) automatically query all results, returning a `PaginatedIterator`. This works like a standard iterator, except that it provides the `pages` attribute, which is the same as the total number of API requests it will take to exhaus all results. It also provides the `map` method, which works the same as the `map` function, except that it produces another `PaginatedIterator`.


Examples
========

```python
>>> from pylastfm import LastFM

>>> # Current, only password authentication is supported
>>> client = LastFM('api_key', 'api_secret', username='username', password='password')

>>> tracks = client.user.get_loved_tracks('some_user')
>>> tracks
<PaginatedIterator(5 pages)>

>>> track = next(tracks)
>>> track
<pylastfm.response.common.Track at 0x102458a50>

>>> '{0} - {1}'.format(track.artist_name, track.name)
'Low - On My Own'

>>> track.to_dict()
{'artist_mbid': u'0c39e6da-14c7-4d7e-954f-a3fbd6ab7225',
'artist_name': u'Low',
'artist_url': u'0c39e6da-14c7-4d7e-954f-a3fbd6ab7225',
'date': datetime.datetime(2015, 4, 17, 18, 54),
'images': {u'extralarge': u'http://userserve-ak.last.fm/serve/300x300/97233023.png',
u'large': u'http://userserve-ak.last.fm/serve/126/97233023.png',
u'medium': u'http://userserve-ak.last.fm/serve/64s/97233023.png',
u'small': u'http://userserve-ak.last.fm/serve/34s/97233023.png'},
'mbid': u'9afc711b-42cd-4ddc-9a29-f9a39cf47891',
'name': u'On My Own',
'streamable': None,
'url': u'http://www.last.fm/music/Low/_/On+My+Own'}

>>> other_tracks = list(tracks)
>>> len(other_tracks)
1000

>>> client.track.unlove(track.artist_name, track.name)
```

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pylastfm, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size pylastfm-0.1.0.tar.gz (16.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page