Skip to main content

Piuma Python library with Django support

Project description

Latest Version CI codecov License: MIT

A library to use Piuma with Python and Django


pip install pypiuma


from pypiuma import piuma_url

piuma_url("http://mypiumahost", "http://myimagehost/static/img/a.png", 200, 200, 80)

Usage with Django

{% load pypiuma_tags %}

<img src="{% piuma 'http://myimagehost/static/img/a.png' width=200 convert_to="auto" %}">
<img src="{% piuma_static 'img/mylogo.png' width=200 %}">

Picture tags

{% load pypiuma_tags %}

{% piuma_picture 'http://myimagehost/static/img/a.png'%}
{% piuma_picture_static 'img/a.png' %}



Disable Piuma core, useful in development.

Default: False


The host of your Piuma instance.

Default: /piuma/


Media rules for picture tags.

Default: (max-width: 576px),(max-width: 768px),(max-width: 992px),(max-width: 1366px)


Fast configurations for your images. These can be handy if you want to define different sizes like small, medium, full to serve the best optimized version of the image for your needs. The * size, if defined, is applied to all images imported with a tag that do not specify a size.

Default: {}


  "*": {
    "convert_to": "auto",
    "quality": 80
  "small": {
    "width": 300,
    "convert_to": "auto",
    "quality": 80
  "medium": {
    "width": 500,
    "convert_to": "auto",
    "quality": 80
  "large": {
    "width": 1000,
    "convert_to": "auto",
    "quality": 80

Run tests

pip install -r requirements-dev.txt
make test

Project details

Download files

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

Source Distribution

pypiuma-1.1.6.tar.gz (5.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page