1# sql/expression.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"""Defines the public namespace for SQL expression constructs."""
9
10
11from __future__ import annotations
12
13from ._dml_constructors import delete as delete
14from ._dml_constructors import insert as insert
15from ._dml_constructors import update as update
16from ._elements_constructors import all_ as all_
17from ._elements_constructors import and_ as and_
18from ._elements_constructors import any_ as any_
19from ._elements_constructors import asc as asc
20from ._elements_constructors import between as between
21from ._elements_constructors import bindparam as bindparam
22from ._elements_constructors import bitwise_not as bitwise_not
23from ._elements_constructors import case as case
24from ._elements_constructors import cast as cast
25from ._elements_constructors import collate as collate
26from ._elements_constructors import column as column
27from ._elements_constructors import desc as desc
28from ._elements_constructors import distinct as distinct
29from ._elements_constructors import extract as extract
30from ._elements_constructors import false as false
31from ._elements_constructors import funcfilter as funcfilter
32from ._elements_constructors import label as label
33from ._elements_constructors import not_ as not_
34from ._elements_constructors import null as null
35from ._elements_constructors import nulls_first as nulls_first
36from ._elements_constructors import nulls_last as nulls_last
37from ._elements_constructors import or_ as or_
38from ._elements_constructors import outparam as outparam
39from ._elements_constructors import over as over
40from ._elements_constructors import text as text
41from ._elements_constructors import true as true
42from ._elements_constructors import try_cast as try_cast
43from ._elements_constructors import tuple_ as tuple_
44from ._elements_constructors import type_coerce as type_coerce
45from ._elements_constructors import within_group as within_group
46from ._selectable_constructors import alias as alias
47from ._selectable_constructors import cte as cte
48from ._selectable_constructors import except_ as except_
49from ._selectable_constructors import except_all as except_all
50from ._selectable_constructors import exists as exists
51from ._selectable_constructors import intersect as intersect
52from ._selectable_constructors import intersect_all as intersect_all
53from ._selectable_constructors import join as join
54from ._selectable_constructors import lateral as lateral
55from ._selectable_constructors import outerjoin as outerjoin
56from ._selectable_constructors import select as select
57from ._selectable_constructors import table as table
58from ._selectable_constructors import tablesample as tablesample
59from ._selectable_constructors import union as union
60from ._selectable_constructors import union_all as union_all
61from ._selectable_constructors import values as values
62from ._typing import ColumnExpressionArgument as ColumnExpressionArgument
63from .base import _from_objects as _from_objects
64from .base import _select_iterables as _select_iterables
65from .base import ColumnCollection as ColumnCollection
66from .base import Executable as Executable
67from .cache_key import CacheKey as CacheKey
68from .dml import Delete as Delete
69from .dml import Insert as Insert
70from .dml import Update as Update
71from .dml import UpdateBase as UpdateBase
72from .dml import ValuesBase as ValuesBase
73from .elements import _truncated_label as _truncated_label
74from .elements import BinaryExpression as BinaryExpression
75from .elements import BindParameter as BindParameter
76from .elements import BooleanClauseList as BooleanClauseList
77from .elements import Case as Case
78from .elements import Cast as Cast
79from .elements import ClauseElement as ClauseElement
80from .elements import ClauseList as ClauseList
81from .elements import CollectionAggregate as CollectionAggregate
82from .elements import ColumnClause as ColumnClause
83from .elements import ColumnElement as ColumnElement
84from .elements import ExpressionClauseList as ExpressionClauseList
85from .elements import Extract as Extract
86from .elements import False_ as False_
87from .elements import FunctionFilter as FunctionFilter
88from .elements import Grouping as Grouping
89from .elements import Label as Label
90from .elements import literal as literal
91from .elements import literal_column as literal_column
92from .elements import Null as Null
93from .elements import Over as Over
94from .elements import quoted_name as quoted_name
95from .elements import ReleaseSavepointClause as ReleaseSavepointClause
96from .elements import RollbackToSavepointClause as RollbackToSavepointClause
97from .elements import SavepointClause as SavepointClause
98from .elements import SQLColumnExpression as SQLColumnExpression
99from .elements import TextClause as TextClause
100from .elements import True_ as True_
101from .elements import TryCast as TryCast
102from .elements import Tuple as Tuple
103from .elements import TypeClause as TypeClause
104from .elements import TypeCoerce as TypeCoerce
105from .elements import UnaryExpression as UnaryExpression
106from .elements import WithinGroup as WithinGroup
107from .functions import func as func
108from .functions import Function as Function
109from .functions import FunctionElement as FunctionElement
110from .functions import modifier as modifier
111from .lambdas import lambda_stmt as lambda_stmt
112from .lambdas import LambdaElement as LambdaElement
113from .lambdas import StatementLambdaElement as StatementLambdaElement
114from .operators import ColumnOperators as ColumnOperators
115from .operators import custom_op as custom_op
116from .operators import Operators as Operators
117from .selectable import Alias as Alias
118from .selectable import AliasedReturnsRows as AliasedReturnsRows
119from .selectable import CompoundSelect as CompoundSelect
120from .selectable import CTE as CTE
121from .selectable import Exists as Exists
122from .selectable import FromClause as FromClause
123from .selectable import FromGrouping as FromGrouping
124from .selectable import GenerativeSelect as GenerativeSelect
125from .selectable import HasCTE as HasCTE
126from .selectable import HasPrefixes as HasPrefixes
127from .selectable import HasSuffixes as HasSuffixes
128from .selectable import Join as Join
129from .selectable import LABEL_STYLE_DEFAULT as LABEL_STYLE_DEFAULT
130from .selectable import (
131 LABEL_STYLE_DISAMBIGUATE_ONLY as LABEL_STYLE_DISAMBIGUATE_ONLY,
132)
133from .selectable import LABEL_STYLE_NONE as LABEL_STYLE_NONE
134from .selectable import (
135 LABEL_STYLE_TABLENAME_PLUS_COL as LABEL_STYLE_TABLENAME_PLUS_COL,
136)
137from .selectable import Lateral as Lateral
138from .selectable import ReturnsRows as ReturnsRows
139from .selectable import ScalarSelect as ScalarSelect
140from .selectable import ScalarValues as ScalarValues
141from .selectable import Select as Select
142from .selectable import Selectable as Selectable
143from .selectable import SelectBase as SelectBase
144from .selectable import SelectLabelStyle as SelectLabelStyle
145from .selectable import Subquery as Subquery
146from .selectable import TableClause as TableClause
147from .selectable import TableSample as TableSample
148from .selectable import TableValuedAlias as TableValuedAlias
149from .selectable import TextAsFrom as TextAsFrom
150from .selectable import TextualSelect as TextualSelect
151from .selectable import Values as Values
152from .visitors import Visitable as Visitable
153
154nullsfirst = nulls_first
155"""Synonym for the :func:`.nulls_first` function."""
156
157
158nullslast = nulls_last
159"""Synonym for the :func:`.nulls_last` function."""