1# util/__init__.py
2# Copyright (C) 2005-2025 the SQLAlchemy authors and contributors
3# <see AUTHORS file>
4#
5# This module is part of SQLAlchemy and is released under
6# the MIT License: https://www.opensource.org/licenses/mit-license.php
7
8
9from collections import defaultdict as defaultdict
10from functools import partial as partial
11from functools import update_wrapper as update_wrapper
12
13from . import preloaded as preloaded
14from ._collections import coerce_generator_arg as coerce_generator_arg
15from ._collections import coerce_to_immutabledict as coerce_to_immutabledict
16from ._collections import column_dict as column_dict
17from ._collections import column_set as column_set
18from ._collections import EMPTY_DICT as EMPTY_DICT
19from ._collections import EMPTY_SET as EMPTY_SET
20from ._collections import FacadeDict as FacadeDict
21from ._collections import flatten_iterator as flatten_iterator
22from ._collections import has_dupes as has_dupes
23from ._collections import has_intersection as has_intersection
24from ._collections import IdentitySet as IdentitySet
25from ._collections import immutabledict as immutabledict
26from ._collections import LRUCache as LRUCache
27from ._collections import merge_lists_w_ordering as merge_lists_w_ordering
28from ._collections import NONE_SET as NONE_SET
29from ._collections import ordered_column_set as ordered_column_set
30from ._collections import OrderedDict as OrderedDict
31from ._collections import OrderedIdentitySet as OrderedIdentitySet
32from ._collections import OrderedProperties as OrderedProperties
33from ._collections import OrderedSet as OrderedSet
34from ._collections import PopulateDict as PopulateDict
35from ._collections import Properties as Properties
36from ._collections import ReadOnlyContainer as ReadOnlyContainer
37from ._collections import ReadOnlyProperties as ReadOnlyProperties
38from ._collections import ScopedRegistry as ScopedRegistry
39from ._collections import sort_dictionary as sort_dictionary
40from ._collections import ThreadLocalRegistry as ThreadLocalRegistry
41from ._collections import to_column_set as to_column_set
42from ._collections import to_list as to_list
43from ._collections import to_set as to_set
44from ._collections import unique_list as unique_list
45from ._collections import UniqueAppender as UniqueAppender
46from ._collections import update_copy as update_copy
47from ._collections import WeakPopulateDict as WeakPopulateDict
48from ._collections import WeakSequence as WeakSequence
49from .compat import anext_ as anext_
50from .compat import arm as arm
51from .compat import b as b
52from .compat import b64decode as b64decode
53from .compat import b64encode as b64encode
54from .compat import cmp as cmp
55from .compat import cpython as cpython
56from .compat import dataclass_fields as dataclass_fields
57from .compat import decode_backslashreplace as decode_backslashreplace
58from .compat import dottedgetter as dottedgetter
59from .compat import has_refcount_gc as has_refcount_gc
60from .compat import inspect_getfullargspec as inspect_getfullargspec
61from .compat import is64bit as is64bit
62from .compat import local_dataclass_fields as local_dataclass_fields
63from .compat import osx as osx
64from .compat import py310 as py310
65from .compat import py311 as py311
66from .compat import py312 as py312
67from .compat import py313 as py313
68from .compat import py314 as py314
69from .compat import py38 as py38
70from .compat import py39 as py39
71from .compat import pypy as pypy
72from .compat import win32 as win32
73from .concurrency import await_fallback as await_fallback
74from .concurrency import await_only as await_only
75from .concurrency import greenlet_spawn as greenlet_spawn
76from .concurrency import is_exit_exception as is_exit_exception
77from .deprecations import became_legacy_20 as became_legacy_20
78from .deprecations import deprecated as deprecated
79from .deprecations import deprecated_cls as deprecated_cls
80from .deprecations import deprecated_params as deprecated_params
81from .deprecations import moved_20 as moved_20
82from .deprecations import warn_deprecated as warn_deprecated
83from .langhelpers import add_parameter_text as add_parameter_text
84from .langhelpers import as_interface as as_interface
85from .langhelpers import asbool as asbool
86from .langhelpers import asint as asint
87from .langhelpers import assert_arg_type as assert_arg_type
88from .langhelpers import attrsetter as attrsetter
89from .langhelpers import bool_or_str as bool_or_str
90from .langhelpers import chop_traceback as chop_traceback
91from .langhelpers import class_hierarchy as class_hierarchy
92from .langhelpers import classproperty as classproperty
93from .langhelpers import clsname_as_plain_name as clsname_as_plain_name
94from .langhelpers import coerce_kw_type as coerce_kw_type
95from .langhelpers import constructor_copy as constructor_copy
96from .langhelpers import constructor_key as constructor_key
97from .langhelpers import counter as counter
98from .langhelpers import create_proxy_methods as create_proxy_methods
99from .langhelpers import decode_slice as decode_slice
100from .langhelpers import decorator as decorator
101from .langhelpers import dictlike_iteritems as dictlike_iteritems
102from .langhelpers import duck_type_collection as duck_type_collection
103from .langhelpers import ellipses_string as ellipses_string
104from .langhelpers import EnsureKWArg as EnsureKWArg
105from .langhelpers import FastIntFlag as FastIntFlag
106from .langhelpers import format_argspec_init as format_argspec_init
107from .langhelpers import format_argspec_plus as format_argspec_plus
108from .langhelpers import generic_fn_descriptor as generic_fn_descriptor
109from .langhelpers import generic_repr as generic_repr
110from .langhelpers import get_annotations as get_annotations
111from .langhelpers import get_callable_argspec as get_callable_argspec
112from .langhelpers import get_cls_kwargs as get_cls_kwargs
113from .langhelpers import get_func_kwargs as get_func_kwargs
114from .langhelpers import getargspec_init as getargspec_init
115from .langhelpers import has_compiled_ext as has_compiled_ext
116from .langhelpers import HasMemoized as HasMemoized
117from .langhelpers import (
118 HasMemoized_ro_memoized_attribute as HasMemoized_ro_memoized_attribute,
119)
120from .langhelpers import hybridmethod as hybridmethod
121from .langhelpers import hybridproperty as hybridproperty
122from .langhelpers import inject_docstring_text as inject_docstring_text
123from .langhelpers import iterate_attributes as iterate_attributes
124from .langhelpers import map_bits as map_bits
125from .langhelpers import md5_hex as md5_hex
126from .langhelpers import memoized_instancemethod as memoized_instancemethod
127from .langhelpers import memoized_property as memoized_property
128from .langhelpers import MemoizedSlots as MemoizedSlots
129from .langhelpers import method_is_overridden as method_is_overridden
130from .langhelpers import methods_equivalent as methods_equivalent
131from .langhelpers import (
132 monkeypatch_proxied_specials as monkeypatch_proxied_specials,
133)
134from .langhelpers import non_memoized_property as non_memoized_property
135from .langhelpers import NoneType as NoneType
136from .langhelpers import only_once as only_once
137from .langhelpers import (
138 parse_user_argument_for_enum as parse_user_argument_for_enum,
139)
140from .langhelpers import PluginLoader as PluginLoader
141from .langhelpers import portable_instancemethod as portable_instancemethod
142from .langhelpers import quoted_token_parser as quoted_token_parser
143from .langhelpers import ro_memoized_property as ro_memoized_property
144from .langhelpers import ro_non_memoized_property as ro_non_memoized_property
145from .langhelpers import rw_hybridproperty as rw_hybridproperty
146from .langhelpers import safe_reraise as safe_reraise
147from .langhelpers import set_creation_order as set_creation_order
148from .langhelpers import string_or_unprintable as string_or_unprintable
149from .langhelpers import symbol as symbol
150from .langhelpers import TypingOnly as TypingOnly
151from .langhelpers import (
152 unbound_method_to_callable as unbound_method_to_callable,
153)
154from .langhelpers import walk_subclasses as walk_subclasses
155from .langhelpers import warn as warn
156from .langhelpers import warn_exception as warn_exception
157from .langhelpers import warn_limited as warn_limited
158from .langhelpers import wrap_callable as wrap_callable
159from .preloaded import preload_module as preload_module
160from .typing import is_non_string_iterable as is_non_string_iterable