new: added udiff to get unified diffs of strings.

README.rst

@@ -33,6 +33,7 @@ using ``kids.txt``:
 - You'll have a ``indent`` / ``dedent`` / ``shorten`` command also in python 2.
 - You'll be able to ``wrap`` text keeping the paragraph separated.
 - minor helper like ``ucfirst`` function.
+- produce unified diffs between 2 strings easily with ``udiff``.
 
 
 Installation
@@ -134,6 +135,22 @@ replace the last 2 characters by a '..' to indicate truncation::
     'sup..'
 
 
+udiff
+-----
+
+Shows the unified diff between to text::
+
+    >>> print(txt.udiff('a\n\nc', 'b\n\nc'))
+    --- None
+    +++ None
+    @@ -1,3 +1,3 @@
+    -a
+    +b
+    <BLANKLINE>
+     c
+    <BLANKLINE>
+
+
 Contributing
 ============
 

src/kids/txt/__init__.py

@@ -1,3 +1,4 @@
 # Package placeholder
 
 from .txt import indent, dedent, paragraph_wrap, ucfirst, shorten
+from .diff import udiff

src/kids/txt/diff.py

@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+
+import difflib
+
+
+def udiff(a, b, fa=None, fb=None):
+    r"""Returns a classical unified diff between two given strings.
+
+    Straightforward to use::
+
+        >>> print(udiff('a\n\nc', 'b\n\nc'))
+        --- None
+        +++ None
+        @@ -1,3 +1,3 @@
+        -a
+        +b
+        <BLANKLINE>
+         c
+        <BLANKLINE>
+
+    Note that if the input texts do not ends with a new line, it'll be
+    added automatically, so::
+
+        >>> udiff('a', 'b') == udiff('a\n', 'b') == udiff('a', 'b\n')
+        True
+
+
+    """
+    if not a.endswith("\n"):
+        a += "\n"
+    if not b.endswith("\n"):
+        b += "\n"
+    return "".join(
+        difflib.unified_diff(
+            a.splitlines(1), b.splitlines(1),
+            fa, fb))