112cxyz / coverpy

A small Python library for grabbing album covers from the iTunes Search API

coverpy

Small wrapper for the iTunes API; mostly for fetching album covers. As of now, fully feature complete.

Install

This library requires Python 3.0+. It might work on 2, but proceed with caution.

pip install coverpy

For development installs:

make install

Testing

We have a Travis CI instance that unit tests automatically on commits. To run code coverage tests and unit tests, run:

make test

Usage

Usage is very simple:

# Instance CoverPy
coverpy = coverpy.CoverPy()
# Set a limit. There is a default (1), but I set it manually to showcase usage.
limit = 1

try:
	result = coverpy.get_cover("OK Computer", limit)
	# Set a size for the artwork (first parameter) and get the result url.
	print(result.name)
	print(result.artwork(100))
except coverpy.exceptions.NoResultsException:
	print("Nothing found.")
except requests.exceptions.HTTPError:
	print("Could not execute GET request")