pam-python 0.2.7__tar.gz → 0.2.9__tar.gz

{pam_python-0.2.7/pam_python.egg-info → pam_python-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pam-python
-Version: 0.2.7
+Version: 0.2.9
 Summary: Pam Python Library
 Author-email: Narongrit Kanhanoi <narongrit@pams.ai>
 Project-URL: Homepage, https://github.com/heart/pam-python
@@ -70,9 +70,9 @@ uv add pam-python
 uv run pam init
 ```
 
-`pam init` recognizes a fresh uv project, keeps its uv configuration, and adds
-the PAM scaffold. It refuses projects whose generated source files have already
-been edited.
+`pam init` recognizes a fresh uv project, keeps its uv configuration, adds the
+Flask and Gunicorn runtime dependencies, and adds the PAM scaffold. It refuses
+projects whose generated source files have already been edited.
 
 Pip remains supported for new projects that do not use uv:
 

{pam_python-0.2.7 → pam_python-0.2.9}/README.md

@@ -50,9 +50,9 @@ uv add pam-python
 uv run pam init
 ```
 
-`pam init` recognizes a fresh uv project, keeps its uv configuration, and adds
-the PAM scaffold. It refuses projects whose generated source files have already
-been edited.
+`pam init` recognizes a fresh uv project, keeps its uv configuration, adds the
+Flask and Gunicorn runtime dependencies, and adds the PAM scaffold. It refuses
+projects whose generated source files have already been edited.
 
 Pip remains supported for new projects that do not use uv:
 

{pam_python-0.2.7 → pam_python-0.2.9}/pam/__init__.py

@@ -1,3 +1,3 @@
 """PAM Data Plugin framework."""
 
-__version__ = "0.2.7"
+__version__ = "0.2.9"

{pam_python-0.2.7 → pam_python-0.2.9}/pam/cli.py

@@ -59,6 +59,8 @@ ENGINE_DEPENDENCIES = {
     "pandas": ["pandas>=2.2.3", "pyarrow>=19.0.1"],
 }
 
+UV_RUNTIME_DEPENDENCIES = ["Flask>=3.0.2", "gunicorn>=23.0.0"]
+
 
 def main(argv=None):
     args = list(sys.argv[1:] if argv is None else argv)
@@ -238,6 +240,9 @@ def init_project(package_manager: str | None = None):
     if not _prompt_overwrite_if_needed(destination, templates):
         return
 
+    if preinitialized_uv:
+        _run_uv(["add", *UV_RUNTIME_DEPENDENCIES], destination)
+
     with tempfile.TemporaryDirectory(prefix=".pam-init-", dir=destination) as temp_dir:
         staging = Path(temp_dir)
         for src, dest in templates.items():

{pam_python-0.2.7 → pam_python-0.2.9}/pam/models/data_input_v2.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import csv
 from dataclasses import dataclass
-from datetime import datetime
+from datetime import datetime, timezone
 from hashlib import sha256
 import json
 from pathlib import Path
@@ -15,6 +15,7 @@ V2_PROTOCOL_VERSION = "data-plugin-input/v2"
 V2_MANIFEST_FILE_NAME = "manifest.json"
 V2_MAX_DATASETS = 5
 V2_POPULATION_MODES = {"contacts", "event_any", "event_all"}
+PAM_TIMESTAMP_FORMAT = "%Y-%m-%d %H:%M:%S"
 
 
 @dataclass(frozen=True)
@@ -364,6 +365,11 @@ def _required_optional_string(source: dict[str, Any], key: str) -> str:
     return value
 
 
+def _parse_pam_timestamp(value: str) -> datetime:
+    """Parse PAM's suffix-free timestamp as UTC+0 without shifting it."""
+    return datetime.strptime(value, PAM_TIMESTAMP_FORMAT).replace(tzinfo=timezone.utc)
+
+
 def _parse_time_window(raw_time_window: Any) -> DataInputV2TimeWindow | None:
     if raw_time_window is None:
         return None
@@ -374,11 +380,11 @@ def _parse_time_window(raw_time_window: Any) -> DataInputV2TimeWindow | None:
     start_inclusive = _required_bool(raw_time_window, "start_inclusive")
     end_inclusive = _required_bool(raw_time_window, "end_inclusive")
     try:
-        start_time = datetime.fromisoformat(start.replace("Z", "+00:00"))
-        end_time = datetime.fromisoformat(end.replace("Z", "+00:00"))
+        start_time = _parse_pam_timestamp(start)
+        end_time = _parse_pam_timestamp(end)
     except ValueError as error:
         raise ValueError("V2 manifest time_window timestamps are invalid") from error
-    if start_time.tzinfo is None or end_time.tzinfo is None or start_time >= end_time:
+    if start_time >= end_time:
         raise ValueError("V2 manifest time_window order is invalid")
     if not start_inclusive or end_inclusive:
         raise ValueError("V2 manifest time_window must be half-open")

{pam_python-0.2.7 → pam_python-0.2.9}/pam/templates/init/AGENT.md

@@ -1,5 +1,13 @@
 # AGENT
 
+## PAM date and time contract
+
+PAM timestamps are UTC+0 strings in the exact format `%Y-%m-%d %H:%M:%S`, for
+example `2026-03-31 02:37:44`. The timezone suffix is intentionally omitted.
+Interpret these values as UTC without shifting the clock value. Do not emit or
+expect RFC3339, ISO-8601, `T`, `Z`, or explicit timezone suffixes in internal PAM
+contracts.
+
 This document defines the **data plugin runtime specification** and execution contract so developers and agents can create services and understand runtime behavior inside the CDP environment.
 
 This is not a tutorial.

{pam_python-0.2.7 → pam_python-0.2.9}/pam/templates/project/uv/Dockerfile

@@ -17,4 +17,4 @@ RUN mkdir -p "$DATA_FOLDER"
 EXPOSE 8000
 
 # Keep one worker: service lifecycle state is local to the process.
-CMD ["gunicorn", "-w", "1", "-b", "0.0.0.0:8000", "main:app"]
+CMD ["uv", "run", "--no-sync", "gunicorn", "-w", "1", "-b", "0.0.0.0:8000", "main:app"]

{pam_python-0.2.7 → pam_python-0.2.9/pam_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pam-python
-Version: 0.2.7
+Version: 0.2.9
 Summary: Pam Python Library
 Author-email: Narongrit Kanhanoi <narongrit@pams.ai>
 Project-URL: Homepage, https://github.com/heart/pam-python
@@ -70,9 +70,9 @@ uv add pam-python
 uv run pam init
 ```
 
-`pam init` recognizes a fresh uv project, keeps its uv configuration, and adds
-the PAM scaffold. It refuses projects whose generated source files have already
-been edited.
+`pam init` recognizes a fresh uv project, keeps its uv configuration, adds the
+Flask and Gunicorn runtime dependencies, and adds the PAM scaffold. It refuses
+projects whose generated source files have already been edited.
 
 Pip remains supported for new projects that do not use uv:
 

{pam_python-0.2.7 → pam_python-0.2.9}/tests/test_cli_templates.py

@@ -151,15 +151,23 @@ class CLITemplateTest(unittest.TestCase):
 
             root = Path(temp_dir)
             self.assertTrue((root / "pyproject.toml").is_file())
+            self.assertIn(
+                '"gunicorn>=23.0.0"',
+                (root / "pyproject.toml").read_text(),
+            )
             self.assertTrue((root / "uv.lock").is_file())
             self.assertFalse((root / "requirements.txt").exists())
             self.assertFalse((root / "run_unit_test.sh").exists())
+            self.assertIn(
+                'CMD ["uv", "run", "--no-sync", "gunicorn"',
+                (root / "Dockerfile").read_text(),
+            )
             self.assertEqual(
                 [["lock"], ["add", "polars>=1.43.0"]],
                 calls,
             )
 
-    def test_init_adopts_a_fresh_uv_project_without_rewriting_uv_files(self):
+    def test_init_adopts_a_fresh_uv_project_and_adds_runtime_dependencies(self):
         calls = []
         original_pyproject = """[project]
 name = "customer-plugin"
@@ -196,8 +204,15 @@ if __name__ == "__main__":
             self.assertEqual("version = 1\n", (root / "uv.lock").read_text())
             self.assertEqual(".venv\n", (root / ".gitignore").read_text())
             self.assertIn("plugin_server = Server", (root / "main.py").read_text())
+            self.assertIn(
+                'CMD ["uv", "run", "--no-sync", "gunicorn"',
+                (root / "Dockerfile").read_text(),
+            )
             self.assertEqual("uv", json.loads((root / ".pam-project").read_text())["package_manager"])
-            self.assertEqual([], calls)
+            self.assertEqual(
+                [["add", "Flask>=3.0.2", "gunicorn>=23.0.0"]],
+                calls,
+            )
 
     def test_init_adds_gitignore_when_fresh_uv_project_does_not_have_one(self):
         uv_main = '''def main():
@@ -220,6 +235,8 @@ if __name__ == "__main__":
             (root / "main.py").write_text(uv_main)
 
             with mock.patch.object(cli.shutil, "which", return_value="/usr/bin/uv"), mock.patch.object(
+                cli, "_run_uv"
+            ), mock.patch.object(
                 cli.sys.stdin, "isatty", return_value=True
             ), mock.patch("builtins.input", return_value="y"):
                 cli.init_project()

{pam_python-0.2.7 → pam_python-0.2.9}/tests/test_data_input_v2.py

@@ -23,7 +23,7 @@ class DataInputV2Test(unittest.TestCase):
         TempfileUtils.temp_datasource_path = str(self.temp_dir / "data_sources")
         self.population_path = self._write_file(
             "population.csv",
-            b"id,contact_created_at\ncontact-1,2025-01-01T00:00:00Z\n",
+            b"id,contact_created_at\ncontact-1,2025-01-01 00:00:00\n",
         )
         self.dataset_path = self._write_file(
             "dataset_001_demographic_part_0001.csv",
@@ -255,8 +255,8 @@ class DataInputV2Test(unittest.TestCase):
         manifest["datasets"][0]["type"] = "event"
         manifest["datasets"][0]["event_names"] = ["purchase"]
         manifest["time_window"] = {
-            "start": "2025-08-14T07:00:00Z",
-            "end": "2026-08-14T07:00:00Z",
+            "start": "2025-08-14 07:00:00",
+            "end": "2026-08-14 07:00:00",
             "start_inclusive": True,
             "end_inclusive": False,
         }
@@ -268,8 +268,8 @@ class DataInputV2Test(unittest.TestCase):
 
         self.assertEqual("event_all", data_input.population_mode)
         self.assertIsNotNone(data_input.time_window)
-        self.assertEqual("2025-08-14T07:00:00Z", data_input.time_window.start)
-        self.assertEqual("2026-08-14T07:00:00Z", data_input.time_window.end)
+        self.assertEqual("2025-08-14 07:00:00", data_input.time_window.start)
+        self.assertEqual("2026-08-14 07:00:00", data_input.time_window.end)
         self.assertTrue(data_input.time_window.start_inclusive)
         self.assertFalse(data_input.time_window.end_inclusive)
 
@@ -299,8 +299,8 @@ class DataInputV2Test(unittest.TestCase):
         manifest["datasets"][0]["type"] = "event"
         manifest["datasets"][0]["event_names"] = ["purchase"]
         manifest["time_window"] = {
-            "start": "2025-08-14T07:00:00Z",
-            "end": "2026-08-14T07:00:00Z",
+            "start": "2025-08-14 07:00:00",
+            "end": "2026-08-14 07:00:00",
             "start_inclusive": True,
             "end_inclusive": True,
         }
@@ -311,6 +311,23 @@ class DataInputV2Test(unittest.TestCase):
                 [str(manifest_path), str(self.population_path), str(self.dataset_path)]
             )
 
+    def test_parse_rejects_rfc3339_event_time_window(self):
+        manifest = self._valid_manifest()
+        manifest["datasets"][0]["type"] = "event"
+        manifest["datasets"][0]["event_names"] = ["purchase"]
+        manifest["time_window"] = {
+            "start": "2025-08-14T07:00:00Z",
+            "end": "2026-08-14T07:00:00Z",
+            "start_inclusive": True,
+            "end_inclusive": False,
+        }
+        manifest_path = self._write_manifest(manifest)
+
+        with self.assertRaisesRegex(ValueError, "timestamps are invalid"):
+            parse_data_input_v2(
+                [str(manifest_path), str(self.population_path), str(self.dataset_path)]
+            )
+
     def test_parse_rejects_event_population_without_event_dataset(self):
         manifest = self._valid_manifest()
         manifest["population"]["mode"] = "event_any"