pyitunes

A simple python wrapper for accessing the iTunes Store API iTunes Store API

Installation

To install with pip, just run this in your terminal:

$ pip install pyitunes

Or clone the code from Github and:

$ python setup.py install

Caching

This module caches responses from the iTunes API to speed up repeated queries against the same resources. Note, however, that there’s no persistent caching that happens between Python processes. Ie, once a python process exits, the cache is cleared.

Examples

Search

from __future__ import print_function
import itunes

# Search band U2
artist = itunes.search_artist('u2')[0]
for album in artist.get_albums():
    for track in album.get_tracks():
        print(album.name, album.url, track.name, track.duration, track.preview_url)

# Search U2 videos
videos = itunes.search(query='u2', media='musicVideo')
for video in videos:
    print(video.name, video.preview_url, video.artwork)

# Search Volta album by Björk
album = itunes.search_album('Volta Björk')[0]

# Global Search 'Beatles'
items = itunes.search(query='beatles')
for item in items:
    print('[' + item.type + ']', item.artist, item.name, item.url, item.release_date)

# Search 'Angry Birds' game
item = itunes.search(query='angry birds', media='software')[0]
vars(item)

# Search 'Family Guy Season 1'
item = itunes.search_season('Family Guy Season 1')[0]
vars(item)

# Search 'Episode 5 of Family Guy Season 1'
items = itunes.search_episode('Family Guy Season 1')
for ep in items:
    if ep.episode_number == 5:
        vars(ep)

Lookup

import itunes

# Lookup Achtung Baby album by U2
U2_ACHTUNGBABY_ID = 475390461
album = itunes.lookup(U2_ACHTUNGBABY_ID)

print(album.url)
print(album.artwork)

artist = album.artist
tracks = album.get_tracks()

# Lookup song One from Achtung Baby album by U2
U2_ONE_ID = 475391315
track = itunes.lookup(U2_ONE_ID)

artist = track.artist
album = track.get_album()

Tests

$ py.test tests

Metadata

Release files for pyitunes 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyitunes 1.0.1
File	Size	Uploaded	Provenance	Actions
pyitunes-1.0.1.tar.gz	6.4 kB	Jul 2, 2016	Without provenance	Details for pyitunes-1.0.1.tar.gz

Release files / pyitunes-1.0.1.tar.gz

Download URL	pyitunes-1.0.1.tar.gz
Size	6.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`7110700203b09443c3714d97535e527ba6c2900c25acf2a50ac5069234166b07`
BLAKE2b-256 checksum How to use checksums	`45f3f21592c0aee05d8a662d8b8ba12bf3e716dcf8f673254b9b827e91d1c2d1`
Upload date	Jul 2, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No

Security for pyitunes 1.0.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

Jul 2, 2016 1 release file No provenance

1.0.0

Jun 26, 2016 1 release file No provenance

pyitunes 1.0.1