# -*- coding: utf-8 -*-
|
|
"""
|
requests._internal_utils
|
~~~~~~~~~~~~~~
|
|
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
|
else:
|
if is_py2:
|
out = string.encode(encoding)
|
else:
|
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)
|
try:
|
u_string.encode('ascii')
|
return True
|
except UnicodeEncodeError:
|
return False
|
