Metadata-Version: 1.1
Name: django-fractions
Version: 0.2.1
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://travis-ci.org/jmichalicek/django-fractions.png?branch=master
            :target: https://travis-ci.org/jmichalicek/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
        ____
        
        * 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
        
        
        
        
        History
        -------
        
        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.
        
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 :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
