blob: 759d9a56ba0102bb3b7b3abfcfae6731a2ecc243 [file] [log] [blame]
# -*- coding: utf-8 -*-
Provides utility functions that are consumed internally by Requests
which depend on extremely few external helpers (such as compat)
from .compat import is_py2, builtin_str, str
def to_native_string(string, encoding='ascii'):
"""Given a string object, regardless of type, returns a representation of
that string in the native string type, encoding and decoding where
necessary. This assumes ASCII unless told otherwise.
if isinstance(string, builtin_str):
out = string
if is_py2:
out = string.encode(encoding)
out = string.decode(encoding)
return out
def unicode_is_ascii(u_string):
"""Determine if unicode string only contains ASCII characters.
:param str u_string: unicode string to check. Must be unicode
and not Python 2 `str`.
:rtype: bool
assert isinstance(u_string, str)
return True
except UnicodeEncodeError:
return False