1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
"""General utilities.
This package includes multiple modules that implement utility functions
and classes that are useful to both apps and the Falcon framework
itself.
All utilities in the `structures`, `misc`, and `time` modules are
imported directly into the front-door `falcon` module for convenience::
import falcon
now = falcon.http_now()
Conversely, the `uri` module must be imported explicitly::
from falcon import uri
some_uri = '...'
decoded_uri = uri.decode(some_uri)
"""
from http import cookies as http_cookies
import sys
from types import ModuleType
# Hoist misc. utils
from falcon.constants import PYTHON_VERSION
from falcon.util.deprecation import AttributeRemovedError
from falcon.util.deprecation import deprecated
from falcon.util.deprecation import deprecated_args
from falcon.util.deprecation import DeprecatedWarning
from falcon.util.mediatypes import parse_header
from falcon.util.misc import code_to_http_status
from falcon.util.misc import dt_to_http
from falcon.util.misc import get_argnames
from falcon.util.misc import get_bound_method
from falcon.util.misc import http_date_to_dt
from falcon.util.misc import http_now
from falcon.util.misc import http_status_to_code
from falcon.util.misc import is_python_func
from falcon.util.misc import secure_filename
from falcon.util.misc import to_query_str
from falcon.util.structures import CaseInsensitiveDict
from falcon.util.structures import Context
from falcon.util.structures import ETag
from falcon.util.sync import async_to_sync
from falcon.util.sync import create_task
from falcon.util.sync import get_running_loop
from falcon.util.sync import runs_sync
from falcon.util.sync import sync_to_async
from falcon.util.sync import wrap_sync_to_async
from falcon.util.sync import wrap_sync_to_async_unsafe
from falcon.util.time import TimezoneGMT
# NOTE(kgriffs): Backport support for the new 'SameSite' attribute
# for Python versions prior to 3.8. We do it this way because
# SimpleCookie does not give us a simple way to specify our own
# subclass of Morsel.
_reserved_cookie_attrs = http_cookies.Morsel._reserved # type: ignore
if 'samesite' not in _reserved_cookie_attrs: # pragma: no cover
_reserved_cookie_attrs['samesite'] = 'SameSite'
# NOTE(m-mueller): Same for the 'partitioned' attribute that will
# probably be added in Python 3.13 or 3.14.
if 'partitioned' not in _reserved_cookie_attrs: # pragma: no cover
_reserved_cookie_attrs['partitioned'] = 'Partitioned'
IS_64_BITS = sys.maxsize > 2**32
from falcon.util.reader import BufferedReader as _PyBufferedReader # NOQA
try:
from falcon.cyutil.reader import BufferedReader as _CyBufferedReader
except ImportError:
_CyBufferedReader = None
# NOTE(vytas): Cythonized BufferedReader makes heavy use of Py_ssize_t which
# would overflow on 32-bit systems with form parts larger than 2 GiB.
BufferedReader = (
(_CyBufferedReader or _PyBufferedReader) if IS_64_BITS else _PyBufferedReader
)
|
