unic.py

Go to the documentation of this file.

#  Copyright 2008-2015 Nokia Networks
#  Copyright 2016-     Robot Framework Foundation
#
#  Licensed under the Apache License, Version 2.0 (the "License");
#  you may not use this file except in compliance with the License.
#  You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
#  Unless required by applicable law or agreed to in writing, software
#  distributed under the License is distributed on an "AS IS" BASIS,
#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#  See the License for the specific language governing permissions and
#  limitations under the License.
 
import sys
from pprint import PrettyPrinter
from unicodedata import normalize
 
 
def safe_str(item):
    return normalize('NFC', _safe_str(item))
 
 
def _safe_str(item):
    if isinstance(item, str):
        return item
    if isinstance(item, (bytes, bytearray)):
        try:
            return item.decode('ASCII')
        except UnicodeError:
            return ''.join(chr(b) if b < 128 else '\\x%x' % b for b in item)
    try:
        return str(item)
    except:
        return _unrepresentable_object(item)
 
 
def prepr(item, width=80):
    return safe_str(PrettyRepr(width=width).pformat(item))
 
 
class PrettyRepr(PrettyPrinter):
 
    def format(self, object, context, maxlevels, level):
        try:
            return PrettyPrinter.format(self, object, context, maxlevels, level)
        except:
            return _unrepresentable_object(object), True, False
 
    # Don't split strings: https://stackoverflow.com/questions/31485402
    def _format(self, object, *args, **kwargs):
        if isinstance(object, (str, bytes, bytearray)):
            width = self._width_width
            self._width_width = sys.maxsize
            try:
                super()._format(object, *args, **kwargs)
            finally:
                self._width_width = width
        else:
            super()._format(object, *args, **kwargs)
 
 
def _unrepresentable_object(item):
    from .error import get_error_message
    return "<Unrepresentable object %s. Error: %s>" \
           % (item.__class__.__name__, get_error_message())