django-fractions

Fraction display and form fields for Django

Documentation

The full documentation is at https://django-fractions.readthedocs.org.

Quickstart

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()

Features

• 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

TODO

• 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

Cookiecutter Tools Used in Making This Package

• cookiecutter
• cookiecutter-djangopackage