1be3f1254b
Co-authored-by: christianlouis <361235+christianlouis@users.noreply.github.com>
534 lines
19 KiB
Python
534 lines
19 KiB
Python
"""Tests for app/database.py module."""
|
|
|
|
from unittest.mock import MagicMock, patch
|
|
|
|
import pytest
|
|
|
|
from app.database import get_db, init_db
|
|
|
|
|
|
@pytest.mark.unit
|
|
class TestInitDb:
|
|
"""Tests for init_db function."""
|
|
|
|
def test_init_db_creates_tables(self):
|
|
"""Test that init_db creates tables without error."""
|
|
# In test environment, DATABASE_URL is sqlite:///:memory:
|
|
init_db()
|
|
|
|
@patch("app.database.make_url")
|
|
@patch("app.database.Base")
|
|
def test_init_db_with_sqlite_file(self, mock_base, mock_make_url, tmp_path):
|
|
"""Test init_db with a file-based SQLite database."""
|
|
db_path = str(tmp_path / "test_db" / "test.db")
|
|
mock_url = MagicMock()
|
|
mock_url.get_backend_name.return_value = "sqlite"
|
|
mock_url.database = db_path
|
|
mock_make_url.return_value = mock_url
|
|
|
|
init_db()
|
|
|
|
@patch("app.database.make_url")
|
|
@patch("app.database.Base")
|
|
def test_init_db_with_memory_db(self, mock_base, mock_make_url):
|
|
"""Test init_db with in-memory database."""
|
|
mock_url = MagicMock()
|
|
mock_url.get_backend_name.return_value = "sqlite"
|
|
mock_url.database = ":memory:"
|
|
mock_make_url.return_value = mock_url
|
|
|
|
init_db()
|
|
|
|
@patch("app.database.make_url")
|
|
@patch("app.database.Base")
|
|
def test_init_db_with_non_sqlite(self, mock_base, mock_make_url):
|
|
"""Test init_db with non-SQLite database."""
|
|
mock_url = MagicMock()
|
|
mock_url.get_backend_name.return_value = "postgresql"
|
|
mock_make_url.return_value = mock_url
|
|
|
|
init_db()
|
|
|
|
|
|
@pytest.mark.unit
|
|
class TestGetDb:
|
|
"""Tests for get_db function."""
|
|
|
|
def test_get_db_yields_session(self):
|
|
"""Test that get_db yields a session and closes it."""
|
|
gen = get_db()
|
|
session = next(gen)
|
|
assert session is not None
|
|
# Clean up
|
|
try:
|
|
next(gen)
|
|
except StopIteration:
|
|
pass
|
|
|
|
def test_get_db_closes_session_on_exit(self):
|
|
"""Test that the session is closed when exiting the generator."""
|
|
gen = get_db()
|
|
session = next(gen)
|
|
# Force the generator to close
|
|
gen.close()
|
|
|
|
|
|
@pytest.mark.unit
|
|
class TestSchemaMigrations:
|
|
"""Tests for schema migration logic."""
|
|
|
|
def test_processing_log_detail_column_exists(self, db_session):
|
|
"""Test that ProcessingLog has the detail column."""
|
|
from app.models import ProcessingLog
|
|
|
|
log = ProcessingLog(
|
|
task_id="test-task",
|
|
step_name="test_step",
|
|
status="success",
|
|
message="Short message",
|
|
detail="Verbose worker log output\nWith multiple lines",
|
|
)
|
|
db_session.add(log)
|
|
db_session.commit()
|
|
db_session.refresh(log)
|
|
|
|
assert log.detail == "Verbose worker log output\nWith multiple lines"
|
|
|
|
def test_processing_log_detail_nullable(self, db_session):
|
|
"""Test that detail column is nullable (backward compatible)."""
|
|
from app.models import ProcessingLog
|
|
|
|
log = ProcessingLog(
|
|
task_id="test-task-2",
|
|
step_name="test_step",
|
|
status="success",
|
|
message="Short message",
|
|
)
|
|
db_session.add(log)
|
|
db_session.commit()
|
|
db_session.refresh(log)
|
|
|
|
assert log.detail is None
|
|
|
|
def test_migration_adds_detail_column(self, tmp_path):
|
|
"""Test that _run_schema_migrations adds detail column to existing tables."""
|
|
from sqlalchemy import create_engine, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create a database with the old schema (no detail column)
|
|
db_path = str(tmp_path / "migration_test.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE processing_logs ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"file_id INTEGER, "
|
|
"task_id VARCHAR, "
|
|
"step_name VARCHAR, "
|
|
"status VARCHAR, "
|
|
"message VARCHAR, "
|
|
"timestamp DATETIME)"
|
|
)
|
|
)
|
|
|
|
# Run migrations
|
|
_run_schema_migrations(engine)
|
|
|
|
# Verify detail column was added
|
|
from sqlalchemy import inspect
|
|
|
|
inspector = inspect(engine)
|
|
columns = [col["name"] for col in inspector.get_columns("processing_logs")]
|
|
assert "detail" in columns
|
|
|
|
engine.dispose()
|
|
|
|
def test_migration_adds_file_path_columns(self, tmp_path):
|
|
"""Test that _run_schema_migrations adds file path columns to files table."""
|
|
from sqlalchemy import create_engine, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create a database with the old schema (no file path columns)
|
|
db_path = str(tmp_path / "migration_files_test.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE files ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"filename VARCHAR, "
|
|
"filehash VARCHAR, "
|
|
"upload_date DATETIME)"
|
|
)
|
|
)
|
|
|
|
# Run migrations
|
|
_run_schema_migrations(engine)
|
|
|
|
# Verify columns were added with correct types
|
|
from sqlalchemy import inspect
|
|
|
|
inspector = inspect(engine)
|
|
columns = {col["name"]: col for col in inspector.get_columns("files")}
|
|
|
|
assert "original_file_path" in columns
|
|
assert columns["original_file_path"]["type"].__class__.__name__ in ("VARCHAR", "String", "TEXT")
|
|
|
|
assert "processed_file_path" in columns
|
|
assert columns["processed_file_path"]["type"].__class__.__name__ in ("VARCHAR", "String", "TEXT")
|
|
|
|
assert "is_duplicate" in columns
|
|
assert columns["is_duplicate"]["type"].__class__.__name__ in ("BOOLEAN", "Integer")
|
|
|
|
assert "duplicate_of_id" in columns
|
|
assert columns["duplicate_of_id"]["type"].__class__.__name__ in ("INTEGER", "Integer")
|
|
|
|
engine.dispose()
|
|
|
|
def test_migration_drops_unique_filehash_index(self, tmp_path):
|
|
"""Test that _run_schema_migrations drops unique index on filehash."""
|
|
from sqlalchemy import create_engine, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create a database with unique index on filehash
|
|
db_path = str(tmp_path / "migration_index_test.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE files ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"filename VARCHAR, "
|
|
"filehash VARCHAR, "
|
|
"upload_date DATETIME, "
|
|
"original_file_path VARCHAR, "
|
|
"processed_file_path VARCHAR, "
|
|
"is_duplicate BOOLEAN DEFAULT FALSE NOT NULL, "
|
|
"duplicate_of_id INTEGER)"
|
|
)
|
|
)
|
|
conn.execute(text("CREATE UNIQUE INDEX idx_filehash_unique ON files (filehash)"))
|
|
|
|
# Verify unique index exists before migration
|
|
from sqlalchemy import inspect
|
|
|
|
inspector = inspect(engine)
|
|
indexes_before = inspector.get_indexes("files")
|
|
unique_indexes_before = [idx for idx in indexes_before if idx.get("unique")]
|
|
assert len(unique_indexes_before) > 0
|
|
|
|
# Run migrations
|
|
_run_schema_migrations(engine)
|
|
|
|
# Verify unique index was removed
|
|
inspector = inspect(engine)
|
|
indexes_after = inspector.get_indexes("files")
|
|
unique_filehash_indexes_after = [
|
|
idx for idx in indexes_after if idx.get("unique") and "filehash" in idx.get("column_names", [])
|
|
]
|
|
assert len(unique_filehash_indexes_after) == 0
|
|
|
|
engine.dispose()
|
|
|
|
def test_migration_handles_missing_tables_gracefully(self, tmp_path):
|
|
"""Test that migrations don't fail when tables don't exist."""
|
|
from sqlalchemy import create_engine
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create an empty database
|
|
db_path = str(tmp_path / "empty_db_test.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
|
|
# Run migrations - should not raise any errors
|
|
_run_schema_migrations(engine)
|
|
|
|
engine.dispose()
|
|
|
|
def test_migration_is_idempotent(self, tmp_path):
|
|
"""Test that running migrations multiple times is safe."""
|
|
from sqlalchemy import create_engine, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create a database with old schema
|
|
db_path = str(tmp_path / "idempotent_test.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE processing_logs ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"file_id INTEGER, "
|
|
"task_id VARCHAR, "
|
|
"step_name VARCHAR, "
|
|
"status VARCHAR, "
|
|
"message VARCHAR, "
|
|
"timestamp DATETIME)"
|
|
)
|
|
)
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE files ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"filename VARCHAR, "
|
|
"filehash VARCHAR, "
|
|
"upload_date DATETIME)"
|
|
)
|
|
)
|
|
|
|
# Run migrations multiple times
|
|
_run_schema_migrations(engine)
|
|
_run_schema_migrations(engine)
|
|
_run_schema_migrations(engine)
|
|
|
|
# Verify all columns exist and no errors occurred
|
|
from sqlalchemy import inspect
|
|
|
|
inspector = inspect(engine)
|
|
|
|
processing_log_columns = [col["name"] for col in inspector.get_columns("processing_logs")]
|
|
assert "detail" in processing_log_columns
|
|
|
|
files_columns = [col["name"] for col in inspector.get_columns("files")]
|
|
assert "original_file_path" in files_columns
|
|
assert "processed_file_path" in files_columns
|
|
assert "is_duplicate" in files_columns
|
|
assert "duplicate_of_id" in files_columns
|
|
|
|
engine.dispose()
|
|
|
|
|
|
@pytest.mark.unit
|
|
class TestInitDbErrors:
|
|
"""Tests for error handling in init_db function."""
|
|
|
|
@patch("app.database.Base")
|
|
@patch("app.database.make_url")
|
|
def test_init_db_handles_sqlalchemy_error(self, mock_make_url, mock_base):
|
|
"""Test that init_db properly handles SQLAlchemy errors."""
|
|
from sqlalchemy import exc
|
|
|
|
# Mock to raise SQLAlchemy error
|
|
mock_url = MagicMock()
|
|
mock_url.get_backend_name.return_value = "sqlite"
|
|
mock_url.database = ":memory:"
|
|
mock_make_url.return_value = mock_url
|
|
|
|
mock_base.metadata.create_all.side_effect = exc.SQLAlchemyError("Database error")
|
|
|
|
with pytest.raises(exc.SQLAlchemyError):
|
|
init_db()
|
|
|
|
|
|
@pytest.mark.unit
|
|
class TestMultiVersionMigrations:
|
|
"""Test migration scenarios from various database versions."""
|
|
|
|
def test_migration_from_v1_to_v2_processing_logs(self, tmp_path):
|
|
"""Test migration from v1 (no detail column) to v2 (with detail)."""
|
|
from sqlalchemy import create_engine, inspect, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create v1 database (without detail column)
|
|
db_path = str(tmp_path / "v1_to_v2.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE processing_logs ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"file_id INTEGER, "
|
|
"task_id VARCHAR, "
|
|
"step_name VARCHAR, "
|
|
"status VARCHAR, "
|
|
"message VARCHAR, "
|
|
"timestamp DATETIME)"
|
|
)
|
|
)
|
|
# Insert test data
|
|
conn.execute(
|
|
text(
|
|
"INSERT INTO processing_logs (task_id, step_name, status, message) "
|
|
"VALUES ('test-1', 'test_step', 'success', 'Test message')"
|
|
)
|
|
)
|
|
|
|
# Run migration to v2
|
|
_run_schema_migrations(engine)
|
|
|
|
# Verify detail column exists and old data is preserved
|
|
inspector = inspect(engine)
|
|
columns = [col["name"] for col in inspector.get_columns("processing_logs")]
|
|
assert "detail" in columns
|
|
|
|
# Verify old data still accessible
|
|
with engine.connect() as conn:
|
|
result = conn.execute(text("SELECT task_id, message, detail FROM processing_logs WHERE task_id = 'test-1'"))
|
|
row = result.fetchone()
|
|
assert row[0] == "test-1"
|
|
assert row[1] == "Test message"
|
|
assert row[2] is None # detail should be NULL for old records
|
|
|
|
engine.dispose()
|
|
|
|
def test_migration_from_v1_to_v3_files_table(self, tmp_path):
|
|
"""Test migration from v1 (basic) to v3 (with dedup columns)."""
|
|
from sqlalchemy import create_engine, inspect, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create v1 database (minimal files table)
|
|
db_path = str(tmp_path / "v1_to_v3.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE files ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"filename VARCHAR, "
|
|
"filehash VARCHAR, "
|
|
"upload_date DATETIME)"
|
|
)
|
|
)
|
|
# Insert test data
|
|
conn.execute(text("INSERT INTO files (filename, filehash) VALUES ('test.pdf', 'abc123')"))
|
|
|
|
# Run migration to v3 (adds path columns and dedup columns)
|
|
_run_schema_migrations(engine)
|
|
|
|
# Verify all new columns exist
|
|
inspector = inspect(engine)
|
|
columns = {col["name"] for col in inspector.get_columns("files")}
|
|
assert "original_file_path" in columns
|
|
assert "processed_file_path" in columns
|
|
assert "is_duplicate" in columns
|
|
assert "duplicate_of_id" in columns
|
|
|
|
# Verify old data preserved with default values
|
|
with engine.connect() as conn:
|
|
result = conn.execute(text("SELECT filename, is_duplicate FROM files WHERE filename = 'test.pdf'"))
|
|
row = result.fetchone()
|
|
assert row[0] == "test.pdf"
|
|
# is_duplicate should be False (0) by default
|
|
assert row[1] in (0, False)
|
|
|
|
engine.dispose()
|
|
|
|
def test_migration_with_unique_index_already_dropped(self, tmp_path):
|
|
"""Test that migration handles case where unique index was already dropped."""
|
|
from sqlalchemy import create_engine, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create database without unique index
|
|
db_path = str(tmp_path / "no_index.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE files ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"filename VARCHAR, "
|
|
"filehash VARCHAR, "
|
|
"original_file_path VARCHAR, "
|
|
"processed_file_path VARCHAR, "
|
|
"is_duplicate BOOLEAN DEFAULT FALSE NOT NULL, "
|
|
"duplicate_of_id INTEGER)"
|
|
)
|
|
)
|
|
|
|
# Run migration - should not error even though there's no index to drop
|
|
_run_schema_migrations(engine)
|
|
|
|
# Should complete without error
|
|
engine.dispose()
|
|
|
|
def test_migration_partial_state(self, tmp_path):
|
|
"""Test migration from partial state (some columns added, some missing)."""
|
|
from sqlalchemy import create_engine, inspect, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create database with only some of the new columns
|
|
db_path = str(tmp_path / "partial.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
# Files table with only original_file_path, missing processed_file_path and dedup columns
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE files ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"filename VARCHAR, "
|
|
"filehash VARCHAR, "
|
|
"original_file_path VARCHAR)"
|
|
)
|
|
)
|
|
# Processing logs with detail column already present
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE processing_logs ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"task_id VARCHAR, "
|
|
"step_name VARCHAR, "
|
|
"status VARCHAR, "
|
|
"message VARCHAR, "
|
|
"detail TEXT, "
|
|
"timestamp DATETIME)"
|
|
)
|
|
)
|
|
|
|
# Run migration - should add missing columns only
|
|
_run_schema_migrations(engine)
|
|
|
|
# Verify all columns exist now
|
|
inspector = inspect(engine)
|
|
files_columns = {col["name"] for col in inspector.get_columns("files")}
|
|
assert "original_file_path" in files_columns
|
|
assert "processed_file_path" in files_columns
|
|
assert "is_duplicate" in files_columns
|
|
assert "duplicate_of_id" in files_columns
|
|
|
|
logs_columns = {col["name"] for col in inspector.get_columns("processing_logs")}
|
|
assert "detail" in logs_columns
|
|
|
|
engine.dispose()
|
|
|
|
def test_migration_exception_handling(self, tmp_path):
|
|
"""Test that migration handles exceptions gracefully for index operations."""
|
|
from sqlalchemy import create_engine, text
|
|
|
|
from app.database import _run_schema_migrations
|
|
|
|
# Create database with all columns but trigger exception path
|
|
db_path = str(tmp_path / "exception_test.db")
|
|
engine = create_engine(f"sqlite:///{db_path}")
|
|
with engine.begin() as conn:
|
|
conn.execute(
|
|
text(
|
|
"CREATE TABLE files ("
|
|
"id INTEGER PRIMARY KEY, "
|
|
"filename VARCHAR, "
|
|
"filehash VARCHAR, "
|
|
"original_file_path VARCHAR, "
|
|
"processed_file_path VARCHAR, "
|
|
"is_duplicate BOOLEAN DEFAULT FALSE NOT NULL, "
|
|
"duplicate_of_id INTEGER)"
|
|
)
|
|
)
|
|
|
|
# Run migration - should handle the exception path for index operations
|
|
# (when get_indexes might have issues)
|
|
try:
|
|
_run_schema_migrations(engine)
|
|
# Should complete without raising
|
|
except Exception as e:
|
|
pytest.fail(f"Migration should handle exceptions gracefully: {e}")
|
|
|
|
engine.dispose()
|