A Python interface to Last.fm and Libre.fm
A Python interface to Last.fm and other API-compatible websites such as Libre.fm.
Use the pydoc utility for help on usage or see tests/ for examples.
Install via pip:
python3 -m pip install pylastInstall latest development version:
python3 -m pip install -U git+https://github.com/pylast/pylastOr from requirements.txt:
-e https://github.com/pylast/pylast.git#egg=pylastHere'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,
)Alternatively, instead of creating network with a username and password, you can
authenticate with a session key:
…And away we go:
# Now you can use that object everywhere
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 worksMore examples in hugovk/lastfm-tools and tests/.
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_HERETo run all unit and integration tests:
python3 -m pip install -e ".[tests]"
pytestOr run just one test case:
pytest -k test_scrobbleTo 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.htmlTo enable from your own code:
import logging
import pylast
logging.basicConfig(level=logging.INFO)
network = pylast.LastFMNetwork(...)To enable from pytest:
pytest --log-cli-level info -k test_album_search_imagesTo also see data returned from the API, use level=logging.DEBUG or
--log-cli-level debug instead.
No open issues yet, or sync has not completed.