Fraction display and form fields for Django
Project description
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
FractionField form field which takes string fractions from a form such as “1/4” and “1 1/2” and returns a fractions.Fraction
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
Tags and filters to convert to Decimal and/or float
History
0.3.1 (2015-08-12)
HISTORY.rst typo fixes
pypi release version fix
0.3.0 (2015-08-12)
Added forms.FractionField which returns fractions.Fraction instances
Refactoring of common code with new forms.FractionField
Smarter checking for numeric types throughout the code
forms.DecimalFractionField.to_python() handles fractions.Fraction values now
Fixed bug handling negative numbers in quantity_to_decimal()
Added min_value and max_value to forms.DecimalFractionField
Made coerce_thirds, limit_denominator, and use_mixed_numbers params to DecimalFractionField proper named parameters and not just kwargs.
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_fractions-0.3.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 882ceb6ca5829f6907a76d9834e8762840c0bf09043851287782f6b10510ed41 |
|
MD5 | efaa6ef38b9d84e74db02a2652ba7891 |
|
BLAKE2b-256 | 05f6432670c71cea6553302d350875b488a24a59d369255754ccd86c4312c8fe |