from sqlalchemy import bindparam from sqlalchemy import Column from sqlalchemy import column from sqlalchemy import exc from sqlalchemy import func from sqlalchemy import Integer from sqlalchemy import MetaData from sqlalchemy import select from sqlalchemy import String from sqlalchemy import Table from sqlalchemy import table from sqlalchemy import testing from sqlalchemy import text from sqlalchemy import update from sqlalchemy import values from sqlalchemy.schema import DDL from sqlalchemy.schema import Sequence from sqlalchemy.sql import ClauseElement from sqlalchemy.sql import coercions from sqlalchemy.sql import false from sqlalchemy.sql import False_ from sqlalchemy.sql import literal from sqlalchemy.sql import roles from sqlalchemy.sql import true from sqlalchemy.sql import True_ from sqlalchemy.sql.coercions import expect from sqlalchemy.sql.elements import _truncated_label from sqlalchemy.sql.elements import Null from sqlalchemy.sql.selectable import FromGrouping from sqlalchemy.sql.selectable import ScalarSelect from sqlalchemy.sql.selectable import SelectStatementGrouping from sqlalchemy.testing import assert_raises from sqlalchemy.testing import assert_raises_message from sqlalchemy.testing import AssertsCompiledSQL from sqlalchemy.testing import fixtures from sqlalchemy.testing import is_ from sqlalchemy.testing import is_instance_of from sqlalchemy.testing import is_true m = MetaData() t = Table("t", m, Column("q", Integer)) class NotAThing1: pass not_a_thing1 = NotAThing1() class NotAThing2(ClauseElement): pass not_a_thing2 = NotAThing2() class NotAThing3: def __clause_element__(self): return not_a_thing2 not_a_thing3 = NotAThing3() class RoleTest(fixtures.TestBase): # TODO: the individual role tests here are incomplete. The functionality # of each role is covered by other tests in the sql testing suite however # ideally they'd all have direct tests here as well. def _test_role_neg_comparisons(self, role): impl = coercions._impl_lookup[role] role_name = impl.name assert_raises_message( exc.ArgumentError, r"%s expected, got .*NotAThing1" % role_name, expect, role, not_a_thing1, ) assert_raises_message( exc.ArgumentError, r"%s expected, got .*NotAThing2" % role_name, expect, role, not_a_thing2, ) assert_raises_message( exc.ArgumentError, r"%s expected, got .*NotAThing3" % role_name, expect, role, not_a_thing3, ) assert_raises_message( exc.ArgumentError, r"%s expected for argument 'foo'; got .*NotAThing3" % role_name, expect, role, not_a_thing3, argname="foo", ) def test_const_expr_role(self): t = true() is_(expect(roles.ConstExprRole, t), t) f = false() is_(expect(roles.ConstExprRole, f), f) is_instance_of(expect(roles.ConstExprRole, True), True_) is_instance_of(expect(roles.ConstExprRole, False), False_) is_instance_of(expect(roles.ConstExprRole, None), Null) def test_truncated_label_role(self): is_instance_of( expect(roles.TruncatedLabelRole, "foobar"), _truncated_label ) def test_labeled_column_expr_role(self): c = column("q") is_true(expect(roles.LabeledColumnExprRole, c).compare(c)) is_true( expect(roles.LabeledColumnExprRole, c.label("foo")).compare( c.label("foo") ) ) is_true( expect( roles.LabeledColumnExprRole, select(column("q")).scalar_subquery(), ).compare(select(column("q")).label(None)) ) is_true( expect(roles.LabeledColumnExprRole, not_a_thing1).compare( literal(not_a_thing1).label(None) ) ) def test_untyped_scalar_subquery(self): """test for :ticket:`6181`""" c = column("q") subq = select(c).scalar_subquery() assert isinstance( subq._with_binary_element_type(Integer()), ScalarSelect ) expr = column("a", Integer) == subq assert isinstance(expr.right, ScalarSelect) def test_no_clauseelement_in_bind(self): with testing.expect_raises_message( exc.ArgumentError, r"Literal Python value expected, got BindParameter", ): literal(bindparam("x")) with testing.expect_raises_message( exc.ArgumentError, r"Literal Python value expected, got .*ColumnClause", ): literal(column("q")) def test_scalar_select_no_coercion(self): with testing.expect_warnings( "implicitly coercing SELECT object to scalar subquery" ): expect( roles.LabeledColumnExprRole, select(column("q")), ) with testing.expect_warnings( "implicitly coercing SELECT object to scalar subquery" ): expect( roles.LabeledColumnExprRole, select(column("q")).alias(), ) def test_values_advice(self): value_expr = values( column("id", Integer), column("name", String), name="my_values" ).data([(1, "name1"), (2, "name2"), (3, "name3")]) assert_raises_message( exc.ArgumentError, r"SQL expression element expected, got <.*Values.*my_values>. To " r"create a " r"column expression from a VALUES clause, " r"use the .scalar_values\(\) method.", expect, roles.ExpressionElementRole, value_expr, ) def test_table_valued_advice(self): msg = ( r"SQL expression element expected, got %s. To create a " r"column expression from a FROM clause row as a whole, " r"use the .table_valued\(\) method." ) assert_raises_message( exc.ArgumentError, msg % ("Table.*",), expect, roles.ExpressionElementRole, t, ) # no table_valued() message here right now, it goes to scalar subquery with testing.expect_warnings( "implicitly coercing SELECT object to scalar subquery" ): expect(roles.ExpressionElementRole, t.select().alias()) def test_raise_on_regular_python_obj_for_expr(self): """test #6350""" def some_function(): pass class Thing: def __clause_element__(self): return some_function with testing.expect_raises_message( exc.ArgumentError, r"SQL expression element expected, got " " self.table1.c.myid), "SELECT mytable.myid FROM mytable WHERE " "mytable.myid < (SELECT mytable.myid FROM " "mytable)", ) with testing.expect_warnings( "implicitly coercing SELECT object to scalar subquery" ): s = select(self.table1.c.myid).alias() self.assert_compile( select(self.table1.c.myid).where(self.table1.c.myid == s), "SELECT mytable.myid FROM mytable WHERE " "mytable.myid = (SELECT mytable.myid FROM " "mytable)", ) with testing.expect_warnings( "implicitly coercing SELECT object to scalar subquery" ): self.assert_compile( select(self.table1.c.myid).where(s > self.table1.c.myid), "SELECT mytable.myid FROM mytable WHERE " "mytable.myid < (SELECT mytable.myid FROM " "mytable)", ) @testing.fixture() def update_from_fixture(self): metadata = MetaData() mytable = Table( "mytable", metadata, Column("myid", Integer), Column("name", String(30)), Column("description", String(50)), ) myothertable = Table( "myothertable", metadata, Column("otherid", Integer), Column("othername", String(30)), ) return mytable, myothertable def test_correlated_update_two(self, update_from_fixture): table1, t2 = update_from_fixture mt = table1.alias() with testing.expect_warnings( "implicitly coercing SELECT object to scalar subquery" ): u = update(table1).values( { table1.c.name: select(mt.c.name).where( mt.c.myid == table1.c.myid ) }, ) self.assert_compile( u, "UPDATE mytable SET name=(SELECT mytable_1.name FROM " "mytable AS mytable_1 WHERE " "mytable_1.myid = mytable.myid)", ) def test_correlated_update_three(self, update_from_fixture): table1, table2 = update_from_fixture # test against a regular constructed subquery s = select(table2).where(table2.c.otherid == table1.c.myid) with testing.expect_warnings( "implicitly coercing SELECT object to scalar subquery" ): u = ( update(table1) .where(table1.c.name == "jack") .values({table1.c.name: s}) ) self.assert_compile( u, "UPDATE mytable SET name=(SELECT myothertable.otherid, " "myothertable.othername FROM myothertable WHERE " "myothertable.otherid = mytable.myid) " "WHERE mytable.name = :name_1", )