async def test_session_save__does_not_commit(async_db: AsyncDatabase):
async with async_db.session() as session:
await session.save(User())
async with async_db.session() as session:
select_count = sa.select(sa.func.count(User.id))
assert await session.one(select_count) == 0
def test_async_database_session__returns_new_session_object(
async_db: AsyncDatabase):
session = async_db.session()
assert isinstance(session, AsyncSession)
assert not session.in_transaction()
other_session = async_db.session()
assert other_session is not session
def test_async_database_session__can_override_default_options(
async_db: AsyncDatabase, option, default_value, override_value):
session = async_db.session()
option_value = getattr(session.sync_session, option)
assert (
option_value == default_value
), f"Expected session.{option} to be {default_value!r}, not {option_value!r}"
session = async_db.session(**{option: override_value})
option_value = getattr(session.sync_session, option)
assert (
option_value == override_value
), f"Expected session.{option} to be {override_value!r}, not {option_value!r}"
async def test_session_save__updates_existing_in_same_session(
async_db: AsyncDatabase):
async with async_db.session() as session:
user = User(id=1)
session.add(user)
await session.commit()
user.name = "n"
await session.save(user)
await session.commit()
async with async_db.session() as session:
select_count = sa.select(sa.func.count(User.id))
assert await session.one(select_count) == 1
async def test_session_save_all__inserts_and_updates_multiple_types(
async_db: AsyncDatabase):
existing_users = [User(name="uA"), User(name="uB"), User(name="uC")]
new_users = [User(name="u1"), User(name="u2"), User(name="u3")]
existing_groups = [Group(name="gA"), Group(name="gB"), Group(name="gC")]
new_groups = [Group(name="g1"), Group(name="g2"), Group(name="g3")]
async with async_db.begin() as session:
await session.save_all(existing_users)
await session.save_all(existing_groups)
all_models = existing_users + existing_groups + new_users + new_groups # type: ignore
all_users = existing_users + new_users
all_groups = existing_groups + new_groups
async with async_db.begin() as session:
await session.save_all(all_models)
async with async_db.session() as session:
count_users = sa.select(sa.func.count(User.id))
assert await session.one(count_users) == len(all_users)
count_groups = sa.select(sa.func.count(Group.id))
assert await session.one(count_groups) == len(all_groups)
async def test_session_one_or_none__returns_one_model_or_none_or_raises(
async_db: AsyncDatabase):
users = await async_create_users(async_db)
user = users[0]
async with async_db.session() as session:
result = await session.one_or_none(
sa.select(User).where(User.id == user.id))
assert isinstance(result, User)
assert result.id == user.id
result = await session.one_or_none(sa.select(User).where(User.id == 0))
assert result is None
with pytest.raises(MultipleResultsFound):
async with async_db.session() as session:
await session.one_or_none(sa.select(User))
async def test_async_session_all__returns_all_models(async_db: AsyncDatabase):
users = await async_create_users(async_db)
async with async_db.session() as session:
results = await session.all(sa.select(User))
assert len(results) == len(users)
for model in results:
assert isinstance(model, User)
async def test_session_first__returns_first_result_or_none(
async_db: AsyncDatabase):
await async_create_users(async_db)
async with async_db.session() as session:
result = await session.first(sa.select(User))
assert isinstance(result, User)
result = await session.first(sa.select(User).where(User.id == 0))
assert result is None
async def test_session_save_all__returns_list(async_db: AsyncDatabase):
users = [User(), User(), User()]
async with async_db.begin() as session:
result = await session.save_all(users)
assert isinstance(result, list)
assert result == users
async with async_db.session() as session:
select_count = sa.select(sa.func.count(User.id))
assert await session.one(select_count) == len(users)
async def test_session_save_all__accepts_single_model_and_returns_list(
async_db: AsyncDatabase):
user = User()
async with async_db.begin() as session:
result = await session.save_all(user)
assert isinstance(result, list)
assert result == [user]
async with async_db.session() as session:
select_count = sa.select(sa.func.count(User.id))
assert await session.one(select_count) == 1
async def test_session_save__inserts_new_without_pk(async_db: AsyncDatabase):
user = User(name="n")
async with async_db.begin() as session:
await session.save(user)
assert user.id == 1
assert user.name == "n"
async with async_db.session() as session:
select_count = sa.select(sa.func.count(User.id))
assert await session.one(select_count) == 1
async def test_session_one_or_none__returns_one_row_or_none_or_raises(
async_db: AsyncDatabase):
users = await async_create_users(async_db)
user = users[0]
async with async_db.session() as session:
result = await session.one_or_none(
sa.text("SELECT * FROM users WHERE id = :id"),
params={"id": user.id})
assert not isinstance(result, User)
assert result.id == user.id
assert result.name == user.name
result = await session.one_or_none(
sa.text("SELECT * FROM users WHERE id = :id"), params={"id": 0})
assert result is None
with pytest.raises(MultipleResultsFound):
async with async_db.session() as session:
await session.one_or_none(sa.text("SELECT * FROM users"))
async def test_session_save__updates_existing(async_db: AsyncDatabase):
existing_user = (await async_create_users(async_db, count=1))[0]
assert existing_user.id == 1
assert existing_user.name is None
new_user = User(id=1, name="n")
async with async_db.begin() as session:
await session.save(existing_user)
assert new_user.id == 1
assert new_user.name == "n"
async with async_db.session() as session:
select_count = sa.select(sa.func.count(User.id))
assert await session.one(select_count) == 1
async def test_session_first__returns_first_result_or_none_from_non_orm_query(
async_db: AsyncDatabase, ):
users = await async_create_users(async_db)
first_user = users[0]
async with async_db.session() as session:
result = await session.first(
sa.text("SELECT * FROM users WHERE active = :active ORDER BY id"),
params={"active": True},
)
assert not isinstance(result, User)
assert result.id == first_user.id
assert result.name == first_user.name
result = await session.first(
sa.text("SELECT * FROM users WHERE id = :id ORDER BY id"),
params={"id": 0})
assert result is None
async def test_session_all__returns_all_rows_from_non_orm_query(
async_db: AsyncDatabase):
inactive_users_by_id = {
user.id: user
for user in (
await async_create_users(async_db, overrides={"active": False}))
}
async with async_db.session() as session:
results = await session.all(
sa.text("SELECT * FROM users WHERE active = :active"),
params={"active": False})
for user in results:
assert not isinstance(user, User)
inactive_user = inactive_users_by_id.get(user.id)
assert inactive_user
for key, value in dict(inactive_user).items():
assert user[key] == value
async def test_session_all__uniquifies_joinedload_results(
async_db: AsyncDatabase):
users = [
User(id=1, addresses=[Address(id=11),
Address(id=12),
Address(id=13)]),
User(id=2, addresses=[Address(id=21),
Address(id=22),
Address(id=23)]),
User(id=3, addresses=[Address(id=31),
Address(id=32),
Address(id=33)]),
]
async with async_db.begin() as session:
session.add_all(users)
stmt = sa.select(User).options(joinedload(User.addresses))
async with async_db.session() as session:
results = await session.all(stmt)
assert len(results) == len(users)
async def test_session_save_all__raises_on_invalid_type(
async_db: AsyncDatabase, value: t.Any, exception: t.Type[Exception]):
with pytest.raises(exception):
async with async_db.session() as session:
await session.save_all(value)
async def test_session_save__returns_model_instance(async_db: AsyncDatabase):
user = User()
async with async_db.session() as session:
result = await session.save(user)
assert result is user