From 9a5d2dfa9fda0e25fd2b7fb159ef8648867725de Mon Sep 17 00:00:00 2001
From: Wirawan Purwanto <wirawan0@gmail.com>
Date: Thu, 17 Oct 2013 13:48:07 -0400
Subject: [PATCH] * text_tools: Added str_fmt_heading() function for formatting
 table heading   a la printf.

---
 text_tools.py | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/text_tools.py b/text_tools.py
index b92a37f..becdb9d 100644
--- a/text_tools.py
+++ b/text_tools.py
@@ -89,6 +89,24 @@ def str_snippet(S):
   file segments."""
   return str_unindent(S).rstrip()
 
+def str_trunc_begin(S, L):
+  """Returns a possibly truncated S (ellipsis added at the string's
+  beginning) if the length of S is greater than L.
+  L should be equal to or greater than 3 to be making sense."""
+  if len(S) > L:
+    return "..." + S[min(-L+3,0):]
+  else:
+    return S
+
+def str_trunc_end(S, L):
+  """Returns a possibly truncated S (ellipsis added at the string's
+  ending) if the length of S is greater than L.
+  L should be equal to or greater than 3 to be making sense."""
+  if len(S) > L:
+    return S[:max(L-3,0)] + "..."
+  else:
+    return S
+
 
 def str_save_to_file(filename, s1, *more_str, **opts):
   """Save one or more string (or iterables) to a file with a given file.
@@ -133,6 +151,32 @@ def str_expand(template, params, maxiter=100):
   return str1
 
 
+# Internal variable: don't mess!
+_str_fmt_heading_rx = None
+def str_fmt_heading(fmt):
+  """Replaces a printf-style formatting with one suitable for table heading:
+  all non-string conversions are replaced with string conversions,
+  preserving the minimum widths."""
+  # Originally from: $PWQMC77/scripts/cost.py and later Cr2_analysis_cbs.py .
+  #
+  #_str_fmt_heading_rx = None # only for development purposes
+  import re
+  if _str_fmt_heading_rx == None:
+    # Because of complicated regex, I verbosely write it out here:
+    _str_fmt_heading_rx = re.compile(r"""
+      (
+        %                 # % sign
+        (?:\([^)]+\))?    # optional '(keyname)' mapping key
+        [-+#0 hlL]*       # optional conversion flag
+        [0-9*]*           # optional minimum field width
+      )
+      ((?:\.[0-9]*)?)     # optional precision
+      [^-+#*0 hlL0-9.%s]  # not conv flag, dimensions, nor literal '%',
+                          # nor 's' conversion specifiers
+    """, re.VERBOSE)
+  return _str_fmt_heading_rx.sub(r'\1s', fmt)
+
+
 def str_grep(S, strs):
   """Returns a list of strings wherein the substring S is found."""
   return [s for s in strs if s.find(S) >= 0]
@@ -144,6 +188,7 @@ def str_igrep(S, strs):
   #return [i for (s,i) in zip(strs,xrange(len(strs))) if s.find(S) >= 0]
 
 
+
 def slice_str(s):
   return "%s:%s:%s" % (
     ifelse(s.start == None, "", str(s.start)),