Metadata-Version: 1.1
Name: django-fractions
Version: 2.0.0
Summary: Fraction display and form fields for Django
Home-page: https://github.com/jmichalicek/django-fractions
Author: Justin Michalicek
Author-email: jmichalicek@gmail.com
License: BSD
Description: =============================
        django-fractions
        =============================
        
        .. image:: https://badge.fury.io/py/django-fractions.png
            :target: https://badge.fury.io/py/django-fractions
        
        .. image:: https://github.com/jmichalicek/django-fractions/workflows/Python%20package/badge.svg
            :target: https://github.com/jmichalicek/django-fractions/actions?query=workflow%3A%22Python+package%22
        
        
        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
        
Keywords: django-fractions
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
