This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

cctagutils is a package which provides a pluggable facility for retrieving and verifying license metadata embedded and linked to content files. Metadata may be embedded directly in the file, or provided in a web page linked to the file (in this case the URL is actually embedded in the file).

cctagutils uses handlers for different file types, and ships with an ID3 handler for MP3 files and an XMP handler for many other file types. The XMP handler is used as a default fall-back for all files. Information about embedding metadata is available in the CC wiki; see Resources below.

Installation

cctagutils and its dependencies may be installed using easy_install (recommended)

$ easy_install cctagutils

or by using the standard distutils setup.py:

$ python setup.py install

If installing using setup.py, ccrdf will also need to be installed along with its dependencies. Using easy_install will automatically download and install these dependencies.

Usage

cctagutils is primarily accessed through the metadata module. For example:

>>> import cctagutils
>>> file_info = cctagutils.metadata.open('test/test.mp3')

The metadata module will use entry points to look up the best fit handler for extracting metadata from the file.

Extending cctagutils

cctagutils uses entry points for providing metadata handlers for new file types. A metadata handler should subclass cctagutils.handler.base.BaseMetadata. The package for the handler should declare that it implements the cctagutils.handler entry point.

The cctagutils package declares itself as the entry points for MP3 and PDF files using the ID3 and XMP implementations respectively.

Limitations and Known Issues

  • This is an alpha release of 0.5, and the API is still subject to change.
  • Handler lookup is currently based on file extensions, and should be improved to use something like the MIME type.

Change History

0.5 (TBD)

  • Reorganized source tree to work better with PyPI and setuptools
  • Converted to using entry points for file-type handling extensibility

Download

Release History

Release History

0.5a2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.5a1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
cctagutils-0.5a2-py2.4.egg (46.4 kB) Copy SHA256 Checksum SHA256 2.4 Egg Mar 15, 2007
cctagutils-0.5a2.tar.gz (16.2 kB) Copy SHA256 Checksum SHA256 Source Mar 15, 2007

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting