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

Uploaded Source

File details

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

File metadata

  • Download URL: pypiuma-1.1.5.tar.gz
  • Upload date:
  • Size: 5.8 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.5.tar.gz
Algorithm Hash digest
SHA256 fbc078a690cfced6e4f52e78d2af02c770acdde29843e2eb256959632ab6e90a
MD5 0a4d50a829cd8721062db66407fc0593
BLAKE2b-256 662a2250d32b5b152b3c40133be47c8af68c1b1dacc9ca49960c952820447bf7

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