pietunes 0.0.5

A library to aid in automating iTunes via ScriptingBridge.

PieTunes is a Python library that creates an abstraction of Apple’s Scripting Bridge API for iTunes. This makes it much easier to write Python scripts (or full python applications) that interact with iTunes and the iTunes Store.

There are some caveats:

• The only external dependency right now is PyObjC

• Due to this dependency, this pietunes Python library is only available for MacOS [1]

• This is a modern Python library that requires Python>=3.6

Objectives

1. Create a modern, stable Python library with a clearly-defined API

2. Provide as close to 100% Test Coverage as possible [2]

3. Provide clear documentation with full coverage of the API and example code.

Installing

Install and update using pip:

pip install -U pietunes

A Simple Example

from pietunes import App

app = App()

movie_playlist = app.get_playlist("Movies")

movies = list(app.get_tracks(movie_playlist))

for movie in movies:
   print(movie.name())

Links

• Website: https://pypi.org/project/pietunes/

• Documentation: https://brianfarrell.gitlab.io/pietunes/

• License: https://www.gnu.org/licenses/agpl.html

• Releases: https://pypi.org/project/pietunes/

• Code: https://gitlab.com/brianfarrell/pietunes/

• Issue tracker:

• Test status:

• Test coverage:

Footnotes

[1]

Once this is working correctly on MacOS, I will look into how I might possibly get it working for iTunes on Windows.

[2]

This project started-out as a Proof of Concept (POC).

At that point, no automated testing was involved.

Going forward, all new development and bug fixes will be test-driven.