Skip to main content

Fraction display and form fields for Django

Project description


.. image::

.. image::

Fraction display and form fields for Django


The full documentation is at


Install django-fractions::

pip install django-fractions

Add ``djfractions`` to ``settings.INSTALLED_APPS``

Then use it in a project::

import djfractions

In templates::

{% load fractions %}
{% display_fraction 1.25 %}

In Forms::

from djfractions.forms import DecimalFractionField
from django import forms

class MyForm(forms.Form):
a_fraction = DecimalFractionField()


* Template tag for displaying float and Decimal values as fractions including mixed numbers
* DecimalFractionField form field which handles input such as "1/4", "1 1/2", "1 and 1/2", and converts to a
decimal.Decimal instance


* Read The Docs documentation
* Add unicode_fraction template tag to display the unicode fraction entity if available
* forms.FloatDecimalField to return a float rather than Decimal
* forms.SplitFractionWidget for having separate numerator and denominator form fields
* forms.SplitMixedFractionWidget for handling mixed number fractions with separate fields
* models.DecimalBackedFractionField() to store a Decimal value but return/accept it as a fraction
* models.FloatBackedFractionField() to store a Decimal value but return/accept it as a fraction
* Tags and filters to convert to Decimal and/or float

Cookiecutter Tools Used in Making This Package

* cookiecutter
* cookiecutter-djangopackage


0.2.1 (2015-08-06)

* Fixed typo in usage docs

0.2.0 (2015-08-06)

* display_fraction template tag output is templated so that its formatting can be changed by users
* Added new display_improper_fraction template tag to simplify the common case of wanting to only use
improper fractions with no whole numbers
* Added unicode_entity to template context for display_fraction and display_improper_fraction so that
the html entity for common fractions may be used rather than <sup> and <sub> tags
* Refactored lots of code out into smaller, reusable functions
* Added a bunch of test cases

0.1.0 (2015-08-01)

* First release on PyPI.

Project details

Download files

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

Files for django-fractions, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size django_fractions-0.2.1-py2.py3-none-any.whl (10.3 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size django-fractions-0.2.1.tar.gz (10.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page