Use the pydoc utility for help on usage or see tests/ for examples.
Install via pip:
pip install pylast
Install latest development version:
pip install -U git+https://github.com/pylast/pylast.git
Or from requirements.txt:
- pylast >= 3.0.0 will likely only support Python 3.4+ (#265)
- pyLast >= 2.2.0 supports Python 2.7.10+, 3.4, 3.5, 3.6, 3.7.
- pyLast >= 2.0.0 < 2.2.0 supports Python 2.7.10+, 3.4, 3.5, 3.6.
- pyLast >= 1.7.0 < 2.0.0 supports Python 2.7, 3.3, 3.4, 3.5, 3.6.
- pyLast >= 1.0.0 < 1.7.0 supports Python 2.7, 3.3, 3.4.
- pyLast >= 0.5 < 1.0.0 supports Python 2, 3.
- pyLast < 0.5 supports Python 2.
- Simple public interface.
- Access to all the data exposed by the Last.fm web services.
- Scrobbling support.
- Full object-oriented design.
- Proxy support.
- Internal caching support for some web services calls (disabled by default).
- Support for other API-compatible networks like Libre.fm.
- Python 3-friendly (Starting from 0.5).
Here's some simple code example to get you started. In order to create any object from pyLast, you need a
Network object which represents a social music network that is Last.fm or any other API-compatible one. You can obtain a pre-configured one for Last.fm and use it as follows:
import pylast # You have to have your own unique two values for API_KEY and API_SECRET # Obtain yours from https://www.last.fm/api/account/create for Last.fm API_KEY = "b25b959554ed76058ac220b7b2e0a026" # this is a sample key API_SECRET = "425b55975eed76058ac220b7b4e8a054" # In order to perform a write operation you need to authenticate yourself username = "your_user_name" password_hash = pylast.md5("your_password") network = pylast.LastFMNetwork(api_key=API_KEY, api_secret=API_SECRET, username=username, password_hash=password_hash) # Now you can use that object everywhere artist = network.get_artist("System of a Down") artist.shout("<3") track = network.get_track("Iron Maiden", "The Nomad") track.love() track.add_tags(("awesome", "favorite")) # Type help(pylast.LastFMNetwork) or help(pylast) in a Python interpreter # to get more help about anything and see examples of how it works
The tests/ directory contains integration and unit tests with Last.fm, and plenty of code examples.
For integration tests you need a test account at Last.fm that will become cluttered with test data, and an API key and secret. Either copy example_test_pylast.yaml to test_pylast.yaml and fill out the credentials, or set them as environment variables like:
export PYLAST_USERNAME=TODO_ENTER_YOURS_HERE export PYLAST_PASSWORD_HASH=TODO_ENTER_YOURS_HERE export PYLAST_API_KEY=TODO_ENTER_YOURS_HERE export PYLAST_API_SECRET=TODO_ENTER_YOURS_HERE
To run all unit and integration tests:
pip install pytest flaky mock pytest
Or run just one test case:
pytest -k test_scrobble
To run with coverage:
pytest -v --cov pylast --cov-report term-missing coverage report # for command-line report coverage html # for HTML report open htmlcov/index.html
To enable from your own code:
import logging import pylast logging.basicConfig(level=logging.DEBUG) network = pylast.LastFMNetwork(...)
To enable from pytest:
pytest --log-cli-level debug -k test_album_search_images