pgdevkit 0.6.1__tar.gz → 0.6.2__tar.gz

{pgdevkit-0.6.1 → pgdevkit-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pgdevkit
-Version: 0.6.1
+Version: 0.6.2
 Summary: A helper for developing with Postgres
 Requires-Python: >=3.14
 Requires-Dist: docker>=7.1.0

{pgdevkit-0.6.1 → pgdevkit-0.6.2}/pgdevkit/testdb/constants.py

@@ -11,6 +11,13 @@ PORT = int(os.environ.get("PGDEVKIT_TESTDB_PORT", "54322"))
 USER = os.environ.get("PGDEVKIT_TESTDB_USER", "postgres")
 PASSWORD = os.environ.get("PGDEVKIT_TESTDB_PASSWORD", "testpwd")
 PG_SPEED_FLAGS = ["-c", "fsync=off", "-c", "synchronous_commit=off", "-c", "full_page_writes=off"]
+# Production connects with session timezone=UTC; the container image's own default
+# (baked into its base OS, not something pgdevkit ever set) can differ, silently
+# making any ::date cast of a timestamptz column disagree between test and prod for
+# rows near local midnight. Forcing UTC here -- both as the server's own timezone GUC
+# and as PGTZ/TZ for any client library that consults the environment instead -- keeps
+# test parity with prod instead of depending on the host/image's locale.
+PG_STARTUP_FLAGS = [*PG_SPEED_FLAGS, "-c", "timezone=UTC"]
 
 
 def conninfo(dbname: str, *, connect_timeout: int | None = None) -> str:

{pgdevkit-0.6.1 → pgdevkit-0.6.2}/pgdevkit/testdb/container.py

@@ -36,8 +36,13 @@ def _create_container(client: docker.DockerClient) -> None:
             environment={
                 "POSTGRES_USER": constants.USER,
                 "POSTGRES_PASSWORD": constants.PASSWORD,
+                # Belt-and-suspenders alongside the server's own -c timezone=UTC below:
+                # some client libraries/tools inside the container consult TZ/PGTZ
+                # directly instead of asking Postgres for its configured timezone.
+                "TZ": "UTC",
+                "PGTZ": "UTC",
             },
-            command=["postgres", *constants.PG_SPEED_FLAGS],
+            command=["postgres", *constants.PG_STARTUP_FLAGS],
         )
     except docker.errors.APIError as e:
         if getattr(e, "status_code", None) == 409 or "already in use" in str(e):

{pgdevkit-0.6.1 → pgdevkit-0.6.2}/pyproject.toml

@@ -11,7 +11,7 @@ packages = ["pgdevkit"]
 
 [project]
 name = "pgdevkit"
-version = "0.6.1"
+version = "0.6.2"
 description = "A helper for developing with Postgres"
 readme = "README.md"
 requires-python = ">=3.14"

{pgdevkit-0.6.1 → pgdevkit-0.6.2}/tests/testdb/test_container.py

@@ -49,6 +49,36 @@ def test_ensure_container_skips_everything_when_skip_env_set(monkeypatch):
     ensure_container()  # must return without checking availability or calling the Docker API
 
 
+class _FakeContainers:
+    def __init__(self):
+        self.run_kwargs: dict | None = None
+
+    def run(self, image, **kwargs):
+        self.run_kwargs = kwargs
+
+
+class _FakeClient:
+    def __init__(self):
+        self.containers = _FakeContainers()
+
+
+def test_create_container_forces_utc_timezone():
+    """Test Postgres must run with timezone=UTC regardless of the container
+    image's/host's own locale default -- production connects with session
+    timezone=UTC, so any ::date cast of a timestamptz column would otherwise
+    silently disagree between test and prod for rows near local midnight."""
+    client = _FakeClient()
+
+    _create_container(client)
+
+    assert client.containers.run_kwargs is not None
+    assert "-c" in client.containers.run_kwargs["command"]
+    timezone_flag_index = client.containers.run_kwargs["command"].index("timezone=UTC")
+    assert client.containers.run_kwargs["command"][timezone_flag_index - 1] == "-c"
+    assert client.containers.run_kwargs["environment"]["TZ"] == "UTC"
+    assert client.containers.run_kwargs["environment"]["PGTZ"] == "UTC"
+
+
 def _admin_dsn() -> str:
     return constants.conninfo("postgres", connect_timeout=5)
 
@@ -84,3 +114,13 @@ def test_create_container_falls_back_to_start_when_name_in_use():
         with con.cursor() as cur:
             cur.execute("SELECT 1")
             assert cur.fetchone() == (1,)
+
+
+@requires_podman
+def test_ensure_container_runs_with_utc_timezone():
+    ensure_container()
+
+    with psycopg.connect(_admin_dsn()) as con:
+        with con.cursor() as cur:
+            cur.execute("SHOW timezone")
+            assert cur.fetchone() == ("UTC",)

{pgdevkit-0.6.1 → pgdevkit-0.6.2}/uv.lock

@@ -313,7 +313,7 @@ wheels = [
 
 [[package]]
 name = "pgdevkit"
-version = "0.6.1"
+version = "0.6.2"
 source = { editable = "." }
 dependencies = [
     { name = "docker" },