pam-python 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

pam/__init__.py

@@ -1,3 +1,3 @@
 """PAM Data Plugin framework."""
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"

pam/cli.py

@@ -8,6 +8,7 @@ import shutil
 import subprocess
 import sys
 import tempfile
+import tomllib
 
 
 PROJECT_MARKER = ".pam-project"
@@ -159,6 +160,67 @@ def _assert_new_project(directory: Path):
         )
 
 
+def _requirement_name(requirement: str) -> str:
+    return re.split(r"[<>=!~;\s\[]", requirement, maxsplit=1)[0].lower()
+
+
+def _assert_fresh_uv_project(directory: Path):
+    pyproject_path = directory / "pyproject.toml"
+    try:
+        project = tomllib.loads(pyproject_path.read_text(encoding="utf-8"))["project"]
+    except (OSError, tomllib.TOMLDecodeError, KeyError, TypeError) as exc:
+        raise FileExistsError(f"Invalid fresh uv project: {exc}") from exc
+
+    dependencies = project.get("dependencies", [])
+    if not isinstance(dependencies, list) or not any(
+        isinstance(item, str) and _requirement_name(item) == "pam-python"
+        for item in dependencies
+    ):
+        raise FileExistsError(
+            "Run `uv add pam-python` before `uv run pam init`"
+        )
+
+    python_version = directory / ".python-version"
+    if not python_version.is_file() or not python_version.read_text().strip().startswith("3.12"):
+        raise FileExistsError(
+            "A fresh uv project must pin Python 3.12; run `uv init --python 3.12`"
+        )
+
+    allowed = {
+        ".git",
+        ".gitignore",
+        ".python-version",
+        ".venv",
+        "README.md",
+        "main.py",
+        "pyproject.toml",
+        "uv.lock",
+    }
+    unexpected = sorted(path.name for path in directory.iterdir() if path.name not in allowed)
+    if unexpected:
+        raise FileExistsError(
+            "pam init only accepts a fresh uv project; existing files: "
+            + ", ".join(unexpected)
+        )
+
+    readme = directory / "README.md"
+    if readme.is_file() and readme.read_text(encoding="utf-8").strip():
+        raise FileExistsError("pam init will not overwrite a non-empty README.md")
+
+    main_file = directory / "main.py"
+    if main_file.is_file():
+        source = main_file.read_text(encoding="utf-8")
+        uv_placeholder = re.fullmatch(
+            r'def main\(\):\n'
+            r'    print\("Hello from [a-z0-9-]+!"\)\n\n\n'
+            r'if __name__ == "__main__":\n'
+            r'    main\(\)\n?',
+            source,
+        )
+        if uv_placeholder is None:
+            raise FileExistsError("pam init will not overwrite an edited main.py")
+
+
 def _run_uv(args: list[str], cwd: Path):
     uv = shutil.which("uv")
     if uv is None:
@@ -167,12 +229,20 @@ def _run_uv(args: list[str], cwd: Path):
 
 
 def init_project(package_manager: str | None = None):
-    package_manager = package_manager or _select_package_manager()
+    destination = Path.cwd()
+    preinitialized_uv = (destination / "pyproject.toml").is_file()
+    if preinitialized_uv:
+        if package_manager not in (None, "uv"):
+            raise FileExistsError("A uv project cannot be initialized as a pip project")
+        _assert_fresh_uv_project(destination)
+        package_manager = "uv"
+    else:
+        package_manager = package_manager or _select_package_manager()
+        _assert_new_project(destination)
+
     if package_manager not in PACKAGE_MANAGER_TEMPLATES:
         raise ValueError(f"Unsupported package manager: {package_manager}")
 
-    destination = Path.cwd()
-    _assert_new_project(destination)
     if package_manager == "uv" and shutil.which("uv") is None:
         raise RuntimeError("uv is required for this project but was not found on PATH")
 
@@ -184,6 +254,11 @@ def init_project(package_manager: str | None = None):
         **COMMON_PROJECT_TEMPLATES,
         **PACKAGE_MANAGER_TEMPLATES[package_manager],
     }
+    if preinitialized_uv:
+        templates = {
+            src: dest for src, dest in templates.items()
+            if dest not in {".gitignore", ".python-version", "pyproject.toml"}
+        }
 
     with tempfile.TemporaryDirectory(prefix=".pam-init-", dir=destination) as temp_dir:
         staging = Path(temp_dir)
@@ -202,7 +277,7 @@ def init_project(package_manager: str | None = None):
             encoding="utf-8",
         )
 
-        if package_manager == "uv":
+        if package_manager == "uv" and not preinitialized_uv:
             _run_uv(["lock"], staging)
 
         for path in staging.iterdir():

{pam_python-0.2.1.dist-info → pam_python-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pam-python
-Version: 0.2.1
+Version: 0.2.2
 Summary: Pam Python Library
 Author-email: Narongrit Kanhanoi <narongrit@pams.ai>
 Project-URL: Homepage, https://github.com/heart/pam-python
@@ -58,46 +58,42 @@ This README is a practical, step-by-step guide you can follow to create and run
 
 ---
 
-**Install**
-Recommended installation:
+**Create a uv project**
+
+Install PAM inside each project instead of installing the CLI globally:
 
 ```bash
 mkdir my_data_plugin
 cd my_data_plugin
-uv tool install pam-python
+uv init --python 3.12
+uv add pam-python
+uv run pam init
 ```
 
-Pip remains supported:
+`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.
+
+Pip remains supported for new projects that do not use uv:
 
 ```bash
+mkdir my_data_plugin
+cd my_data_plugin
 python3 -m venv venv
 source venv/bin/activate
 python -m pip install pam-python
-```
-
----
-
-**Initialize a Project**
-This creates a runnable project with templates, including `AGENT.md` for runtime
-rules and `REPORTS.md` for the managed-report public API and copyable examples.
-
-```bash
 pam init
 ```
 
-`pam init` asks you to select `uv` (default) or `pip`. A uv project contains
-`pyproject.toml`, `.python-version`, and `uv.lock`; a pip project contains
-`requirements.txt`. The two templates are independent and are never mixed.
-
-Initialization only supports a new project directory and will not migrate or
-overwrite an existing project.
+When run in an empty directory, `pam init` still asks whether to create a uv or
+pip project. PAM never migrates an existing application.
 
 ---
 
 **Create a Service**
 
 ```bash
-pam new service rfm_segment
+uv run pam new service rfm_segment
 ```
 
 The generator asks you to select Polars (default) or Pandas. Polars services use

{pam_python-0.2.1.dist-info → pam_python-0.2.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-pam/__init__.py,sha256=HkDyjbFKSTG9cYUIHwpisICJbo99Cl8uvvTA7cva-wg,56
+pam/__init__.py,sha256=vwt2aChyIDuFICQ8ZWjM1dPatwHoyi1kwsjGs8LoLhE,56
 pam/api.py,sha256=4t64ey_Jc4gC3SvfI-mtedEGzkX2cPTt0cdZgP_huLk,7231
-pam/cli.py,sha256=1jzS7a4Tz9SSIDraSdIQ88AhpAKMMMvtjiRmdQT4umU,11381
+pam/cli.py,sha256=GbTyHD2Gc2WLTY54bZ9rtofjVc7bV2JjqXThR9JCQf4,14130
 pam/interface_task_manager.py,sha256=moKUjSpAeNF9C2dluDFPAdU4IyvwXckB0RK-jINTLm4,1665
 pam/logger.py,sha256=JYPfIpaQZy6QrfVKrzEMrxOgTzWIEhoegvIZgHTGWoc,3021
 pam/request_file_format.py,sha256=fSRlJagbvVGqdIEqhINSeqBNUTNQdm8GL5JfqgX9bxU,317
@@ -69,9 +69,9 @@ pam/templates/service/pandas/service_class.tmpl,sha256=LGgIYjfdsBwppOqP-FfgEsF1k
 pam/templates/service/polars/functions.tmpl,sha256=nMKFC5GqIm2Q1dSg2zDOscSwQaOpzS2jzqjQV7xhPRk,382
 pam/templates/service/polars/service.test.tmpl,sha256=58x_MJYwp7BvDtuSsETAt9Q6v5KwOI8MaEdjNciAQDk,3746
 pam/templates/service/polars/service_class.tmpl,sha256=8FDTFb6I5OHFqM0KPJtYDFAHeL3kl2WbwtbHAjwTG4Y,1830
-pam_python-0.2.1.dist-info/licenses/LICENSE.txt,sha256=yeHD2-gzrkkET2ZkMe22WyUGpDjlwTrqA4POb0FoZi4,1138
-pam_python-0.2.1.dist-info/METADATA,sha256=fPvsI78skyXPDA5yh_a2dZopS9xLmYa7TY2HftO9a4s,8730
-pam_python-0.2.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-pam_python-0.2.1.dist-info/entry_points.txt,sha256=xqYpsIqvNlO0j8elZc02bDwR-12dLK9FU2B1ACsLYxw,37
-pam_python-0.2.1.dist-info/top_level.txt,sha256=0EOjbyc3hQyzjhn6iyMgsEseqA66Xz0p27iBN7G7W1w,4
-pam_python-0.2.1.dist-info/RECORD,,
+pam_python-0.2.2.dist-info/licenses/LICENSE.txt,sha256=yeHD2-gzrkkET2ZkMe22WyUGpDjlwTrqA4POb0FoZi4,1138
+pam_python-0.2.2.dist-info/METADATA,sha256=MWstqmu0l3XRLjBamIEM0p-uSf0UBHmX1-V2kczonVM,8669
+pam_python-0.2.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+pam_python-0.2.2.dist-info/entry_points.txt,sha256=xqYpsIqvNlO0j8elZc02bDwR-12dLK9FU2B1ACsLYxw,37
+pam_python-0.2.2.dist-info/top_level.txt,sha256=0EOjbyc3hQyzjhn6iyMgsEseqA66Xz0p27iBN7G7W1w,4
+pam_python-0.2.2.dist-info/RECORD,,