Handle encoding misfortunes in logging (#1248)

The beets loggers now, as proposed in #1044, do their utmost to avoid crashing
when logged values are not valid Unicode or Unicode-convertible. This came up
urgently when a `CalledProcessError` could not be logged with `'u{}'.format()`
(!!!) so we needed to some manner of conversion, but it should be possible to
log paths without `displayable_path`. In fact, it may be time to retire
`displayable_path` for the most part.

beets/logging.py

@@ -31,6 +31,34 @@
 PY26 = sys.version_info[:2] == (2, 6)
 
 
+def as_unicode(val):
+    """Coerce a value to Unicode for displaying in a log message.
+
+    This works around a number of pitfalls when logging objects in
+    Python 2:
+    - Logging path names, which must be byte strings, requires
+      conversion for output.
+    - Some objects, including some exceptions, will crash when you call
+      `unicode(v)` while `str(v)` works fine. CalledProcessError is an
+      example.
+    """
+    if isinstance(val, unicode):
+        return val
+    elif isinstance(val, bytes):
+        # Blindly convert with UTF-8. Eventually, it would be nice to
+        # (a) only do this for paths, if they can be given a distinct
+        # type, and (b) warn the developer if they do this for other
+        # bytestrings.
+        return val.decode('utf8', 'replace')
+    else:
+        try:
+            return unicode(val)
+        except UnicodeDecodeError:
+            # An object with a broken __unicode__ formatter. Use __str__
+            # instead.
+            return str(val).decode('utf8', 'replace')
+
+
 class StrFormatLogger(Logger):
     """A version of `Logger` that uses `str.format`-style formatting
     instead of %-style formatting.
@@ -43,7 +71,9 @@ def __init__(self, msg, args, kwargs):
             self.kwargs = kwargs
 
         def __str__(self):
-            return self.msg.format(*self.args, **self.kwargs)
+            args = [as_unicode(a) for a in self.args]
+            kwargs = dict((k, as_unicode(v)) for (k, v) in self.kwargs.items())
+            return self.msg.format(*args, **kwargs)
 
     def _log(self, level, msg, args, exc_info=None, extra=None, **kwargs):
         """Log msg.format(*args, **kwargs)"""