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.4.tar.gz (5.7 kB view details)

Uploaded Source

File details

Details for the file pypiuma-1.1.4.tar.gz.

File metadata

  • Download URL: pypiuma-1.1.4.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.5

File hashes

Hashes for pypiuma-1.1.4.tar.gz
Algorithm Hash digest
SHA256 2c4832efac8326de2c448e42be91056b051bce1f2e4ac72a4480e6557878cad8
MD5 acb3ac4c9bc2c36e29c1b8f119effa38
BLAKE2b-256 15bc2ab96f4bc2fd43b70bdf9f6c276ef1f75bbbcfbe3d9b0a47c589ef8b5677

See more details on using hashes here.

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