Ticket #5426: uncapfirst-with-tests.diff

django/template/defaultfilters.py

@@ -172 +172 @@
     return truncate_html_words(value, length)
 truncatewords_html = stringfilter(truncatewords_html)
 
+def uncapfirst(value):
+    "Uncapitalizes the first character of the value"
+    if len(value) > 1:
+        if value[1].islower():
+            return value[0].lower() + value[1:]
+        else:
+            return value
+    else:
+        return value.lower()
+uncapfirst = stringfilter(uncapfirst)
+
 def upper(value):
     "Converts a string into all uppercase"
     return value.upper()
@@ -656 +667 @@
 register.filter(title)
 register.filter(truncatewords)
 register.filter(truncatewords_html)
+register.filter(uncapfirst)
 register.filter(unordered_list)
 register.filter(upper)
 register.filter(urlencode)

django/utils/text.py

@@ -8 +8 @@
 capfirst = lambda x: x and force_unicode(x)[0].upper() + force_unicode(x)[1:]
 capfirst = allow_lazy(capfirst, unicode)
 
+# Uncapitalizes the first letter of a string.
+def uncapfirst(x):
+    x = force_unicode(x)
+    if len(x) > 1:
+        if x[1].islower():
+            return x[0].lower() + x[1:]
+        else:
+            return x
+    else:
+        return x.lower()
+uncapfirst = allow_lazy(uncapfirst, unicode)
+
 def wrap(text, width):
     """
     A word-wrap function that preserves existing line breaks and most spaces in

tests/regressiontests/defaultfilters/tests.py

@@ -490 +490 @@
 u'123'
 >>> striptags(123)
 u'123'
-
+>>> uncapfirst('Contact')
+u'contact'
+>>> uncapfirst('Some field with many words')
+u'some field with many words'
+>>> uncapfirst('ORM framework')
+u'ORM framework'
 """
 
 from django.template.defaultfilters import *

tests/regressiontests/text/tests.py

@@ -35 +35 @@
 iri_to_uri() is idempotent:
 >>> iri_to_uri(iri_to_uri(u'red%09ros\xe9#red'))
 'red%09ros%C3%A9#red'
+
+### uncapfirst ###########################################################
+>>> uncapfirst('Contact')
+u'contact'
+>>> uncapfirst('Some field with many words')
+u'some field with many words'
+>>> uncapfirst('ORM framework')
+u'ORM framework'
 """