phrydy 2.0.0

A easy wrapper for mutagen

phrydy

This package originates from the file beets/mediafile.py of the beets project.

Handles low-level interfacing for files’ tags. Wraps Mutagen to automatically detect file types and provide a unified interface for a useful subset of music files’ tags.

Installation

From Github

git clone [e-mail]:Josef-Friedrich/phrydy.git
cd phrydy
python setup.py install

From PyPI

pip install phrydy
easy_install phrydy

Usage

Basic usage:

>>> from phrydy import MediaFile
>>> f = MediaFile('Lucy.mp3')
>>> f.title
u'Lucy in the Sky with Diamonds'
>>> f.artist = 'The Beatles'
>>> f.save()

List all available fields of a media file:

from phrydy import MediaFile

media_file = MediaFile('test/files/full.mp3')

for key in MediaFile.readable_fields():
    value = getattr(media_file, key)
    if key != 'art' and value:
        print('{}: {}'.format(key, value))

A field will always return a reasonable value of the correct type, even if no tag is present. If no value is available, the value will be false (e.g., zero or the empty string).

Internally MediaFile uses MediaField descriptors to access the data from the tags. In turn MediaField uses a number of StorageStyle strategies to handle format specific logic.

Development

Test

tox

Publish a new version

git tag 1.1.1
git push --tags
python setup.py sdist upload

Package documentation

The package documentation is hosted on readthedocs.

Generate the package documentation:

python setup.py build_sphinx