Ticket #17662: django_percentage.diff

django/contrib/humanize/templatetags/humanize.py

@@ -222 +222 @@
             return ungettext(
                 u'an hour from now', u'%(count)s hours from now', count
             ) % {'count': count}
+            
+@register.filter
+def percentage(value, precision=2):
+    """
+    Returns Percentage representation of number types.
+    Takes an optional integer argument for decimal point accuracy.
+    Upon failure returns value.
+    """
+    try:
+        precision = int(precision)
+        value = float(value)
+    except (TypeError, ValueError):
+        return value
+    places = ':.{precision}%'.format(precision=precision)
+    perc_holder =  '{' + places + '}'
+    return perc_holder.format(value)

django/contrib/humanize/tests.py

@@ -109 +109 @@
                        someday_result, u"I'm not a date value", None)
         self.humanize_tester(test_list, result_list, 'naturalday')
 
+    def test_percentage(self):
+        from fractions import Fraction
+        from decimal import Decimal
+        fl_value = 1.5
+        int_value = 1
+        int_fraction = Fraction(1)/2
+        int_decimal = Decimal(1) / Decimal(2)
+        notnumber = u"I'm not a number"
+
+        test_list = (fl_value, int_value, int_fraction, int_decimal, notnumber, None)
+        result_list = (u'150.00%', u'100.00%', u'50.00%',u'50.00%',
+                        notnumber, None)
+        self.humanize_tester(test_list, result_list, 'percentage')
+        result_list = (u'150.000%', u'100.000%', u'50.000%',u'50.000%',
+                        notnumber, None)
+        self.humanize_tester(test_list, result_list, 'percentage:3')
+        result_list = (fl_value, int_value, int_fraction,int_decimal,
+                        notnumber, None)
+        self.humanize_tester(test_list, result_list, "percentage:'a'")
+
     def test_naturalday_tz(self):
         from django.contrib.humanize.templatetags.humanize import naturalday
 
@@ -200 +220 @@
         finally:
             humanize.datetime = orig_humanize_datetime
             timesince.datetime = orig_timesince_datetime
+
+

docs/ref/contrib/humanize.txt

@@ -137 +137 @@
 * ``3`` becomes ``3rd``.
 
 You can pass in either an integer or a string representation of an integer.
+
+.. templatefilter:: percentage
+
+percentage
+----------
+    
+Converts a number to a percentage.
+Takes an optional integer argument for decimal point accuracy.
+
+Examples:
+
+* ``1.5`` becomes ``150.00%``.
+* ``Fraction(1)/2`` becomes ``50.00%``.
+* ``Decimal(1) / Decimal(2)`` becomes ``50.00%``.
+* ``not a number`` returns ``not a number``.
+
+You can pass in either an integer or a string representation of a number.
+**Argument:** Decimal precision can be set utilizing the precision optional argument.
+Any number type can be passed, but the function will convert to an integer,
+following Python's conversion rules.
+
+For example::
+
+    {{ value|percentage:3}}
+    
+* ``1.5`` becomes ``150.000%``.
+
+
+Default precision is set to 2.
+ No newline at end of file