Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A Python RFC2397 ("data url") implementation

branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.rst

py-rfc2397

Author: Jacob Oscarson
Contact email: jacob@plexical.com

Quick implementation of RFC2397 in Python, MIT Licenced. RFC2397 is also known as the 'data url' format used to embed image data directly into CSS stylesheets among other things.

The rationale behind this package is described in this blogpost.

Requirements

Python 2.6 and 2.7, not tested on Python 3+ (yet).

Installation

The latest version can be found on PyPI. The recommended way to install is via pip:

$ pip install rfc2397

An executable named rfc2397 is then placed in the python environment that pip installs to.

As an alternate method, it's also possible to copy the rfc2397.py file to any location and run the script stand-alone.

Usage

Just give rfc2397 a path to an image file. rfc2397 uses Python's mimetypes module to determine what MIME-type a file has (N.B: the program won't stop you from encoding something too large/an unsupported mime-type).

$ rfc2397 dot.png # <- your image path data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVQImWP4o8oAAANCASIYayeeAAAAAElFTkSuQmCC

Changes

1.0b2 (2012-01-03)

  • Uses mimetypes module instead of primitive ad-hoc file name extension guessing.
  • rfc2397 is now a single-file module, simplifies package and makes it possible to just copy the rfc2397.py file to an arbitrary location as an alternate installation method.
  • Better QA by using tox.

1.0b1 (2011-06-16)

Concept and initial coding.

Something went wrong with that request. Please try again.