Skip to main content

Python library for generating IIIF Image API urls

Project description

# piffle

Python library for generating and parsing [IIIF Image API]( URLs in an object-oriented, pythonic fashion.

[![Build Status](]( [![Coverage Status](]( [![Say Thanks!](!-1EAEDB.svg)](

Piffle is tested on Python 2.7 and 3.3-3.6.

Piffle was originally developed by Emory University as a part of [Readux](>) and forked as a separate project under [emory-lits-labs](

## Installation and example use:

pip install piffle

Example use for generating an IIIF image url:

` >>> from piffle.iiif import IIIFImageClient >>> myimg = IIIFImageClient('http://image.server/path/', 'myimgid') >>> print myimg http://image.server/path/myimgid/full/full/0/default.jpg >>> print http://image.server/path/myimgid/info.json" >>> print myimg.size(width=120).format('png') http://image.server/path/myimgid/full/120,/0/default.png `

Example use for parsing an IIIF image url:

` >>> from piffle.iiif import IIIFImageClient >>> myimg = IIIFImageClient.init_from_url('') >>> print myimg >>> print >>> myimg.as_dict()['size']['full'] True >>> myimg.as_dict()['size']['exact'] False >>> myimg.as_dict()['rotation']['degrees'] 0.0 `

## Development and Testing

This project uses [git-flow]( branching conventions.

Install locally for development (the use of virtualenv is recommended):

pip install -e .

Install test dependencies:

pip install -e “.[test]”

Run unit tests: py.test or python test

## Publishing

To upload a tagged release to [PyPI]( with a [wheel]( package:

python sdist bdist_wheel upload

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
piffle-0.3.0-py2.py3-none-any.whl (9.1 kB) Copy SHA256 hash SHA256 Wheel 3.6
piffle-0.3.0.tar.gz (8.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page