test: add sample file to read

Author: DeflateAwning

pyproject.toml

@@ -23,7 +23,12 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [dependency-groups]
-dev = ["pyright>=1.1.406", "pytest>=8.4.2", "ruff>=0.14.1"]
+dev = [
+    "pyright>=1.1.406",
+    "pytest>=8.4.2",
+    "requests>=2.32.5",
+    "ruff>=0.14.1",
+]
 
 [tool.pyright]
 typeCheckingMode = "strict"

tests/conftest.py

@@ -0,0 +1,45 @@
+"""Fixtures (sample files) for tests."""
+
+import hashlib
+import tempfile
+from collections.abc import Iterator
+from pathlib import Path
+
+import pytest
+import requests
+
+
+def _sha256_checksum(file_path: Path) -> str:
+    """Compute the SHA-256 checksum of a file.
+
+    :param file_path: The path to the file.
+    :return: The SHA-256 checksum as a hexadecimal string.
+    """
+    sha256 = hashlib.sha256()
+    with file_path.open("rb") as f:
+        for chunk in iter(lambda: f.read(8192), b""):
+            sha256.update(chunk)
+    return sha256.hexdigest()
+
+
+@pytest.fixture
+def sample_db_1() -> Iterator[Path]:
+    """Give a sample access database file for tests.
+
+    Download the Access Example .accdb file to a temporary directory,
+    yield its path for tests, and delete it afterward.
+    """
+    url = "https://github.com/Access-projects/Access-examples/raw/refs/heads/master/Access_Example_VBA.accdb"
+    with tempfile.TemporaryDirectory() as temp_dir_str:
+        db_path = Path(temp_dir_str) / "Access_Example_VBA.accdb"
+        response = requests.get(url, stream=True, timeout=10)
+        response.raise_for_status()
+
+        db_path.write_bytes(response.content)
+        assert (
+            _sha256_checksum(db_path)
+            == "3cd1fc88d70bc93909ae6d190fa9692e709d5641b205fd2f66185c905e42cfbf"
+        ), "Downloaded file checksum does not match expected value."
+
+        yield db_path  # Provide file path to test.
+        # Tempdir automatically cleaned up on exit.

tests/test_list_table_names.py

@@ -0,0 +1,23 @@
+"""Test the `list_table_names()` function."""
+
+from pathlib import Path
+
+from polars_access_mdbtools import list_table_names
+
+
+def test_list_table_names_db_1(sample_db_1: Path) -> None:
+    table_names = list_table_names(sample_db_1)
+    assert isinstance(table_names, list)
+    assert table_names == [
+        "CMD_LINE_TB",
+        "CUM_VAL_TB",
+        "DATABASE_STRUCTURE_TB",
+        "DECUM_VAL_TB",
+        "ROULETTE_TB",
+        "TAG_GRP_TB",
+        "TAG_NME_TB",
+        "tblContacts",
+        "tblDefaults",
+        "tblFileList",
+        "USysRibbons",
+    ]

tests/test_read_table.py

@@ -1,6 +1,26 @@
 """Tests for reading tables from Access databases."""
 
+from pathlib import Path
 
-def test_placeholder() -> None:
-    """A placeholder test."""
-    assert True
+from polars_access_mdbtools import read_table
+
+
+def test_can_read_all_tables_in_sample_db_1(sample_db_1: Path) -> None:
+    """Test reading all tables in sample_db_1. Check row counts."""
+    for table_name, expected_rows in [
+        ("CMD_LINE_TB", 14),
+        ("CUM_VAL_TB", 59),
+        ("DATABASE_STRUCTURE_TB", 46),
+        ("DECUM_VAL_TB", 59),
+        ("ROULETTE_TB", 38),
+        ("TAG_GRP_TB", 19),
+        ("TAG_NME_TB", 933),
+        ("tblContacts", 0),
+        ("tblDefaults", 1),
+        ("tblFileList", 0),
+        ("USysRibbons", 2),
+    ]:
+        df = read_table(sample_db_1, table_name)
+        assert df.height == expected_rows, (
+            f"Table {table_name} should have {expected_rows} rows, but had {df.height}."
+        )