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

Install

pip install pypiuma

Usage

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' %}

Settings

PIUMA_DISABLED

Disable Piuma core, useful in development.

Default: False

PIUMA_HOST

The host of your Piuma instance.

Default: /piuma/

PIUMA_MEDIA_RULES

Media rules for picture tags.

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

PIUMA_SIZES

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: {}

Example:

{
  "*": {
    "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