make-cloudflare 0.3.0__tar.gz → 0.4.0__tar.gz

{make_cloudflare-0.3.0 → make_cloudflare-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: make-cloudflare
-Version: 0.3.0
+Version: 0.4.0
 Summary: Cloudflare Pages direct upload for mkrun -- deploy a built site with no Node and no wrangler.
 Project-URL: Homepage, https://make.optersoft.com
 Author-email: "Optersoft, S.L." <david@optersoft.com>
@@ -21,7 +21,7 @@ in the pipeline.
 # Makefile.py in a consuming repo
 # /// script
 # requires-python = ">=3.11"
-# dependencies = ["mkrun>=0.4", "make-cloudflare>=0.1"]
+# dependencies = ["mkrun>=0.4.1", "make-cloudflare>=0.3"]
 # ///
 from make_cloudflare import cloudflare  # importing is what registers the group
 ```
@@ -62,6 +62,13 @@ site's own `_routes.json` wins. Everything else is still the four calls below.
 Bindings (D1, KV) and secrets are settings on the Pages project, never part of
 the upload.
 
+**Those settings are one call.** `pages.configure(project, d1={"DB": "<id>"},
+vars={...}, compatibility_date="2026-10-01")` PATCHes the project's
+`production` (or `preview`) configuration. Only what you pass is sent, and
+Cloudflare merges it in. It takes effect on the **next** deployment. Secrets
+are not set this way: a plain variable is shown in the dashboard, so a secret
+goes through `wrangler pages secret put`.
+
 ## Why this exists
 
 `wrangler pages deploy` is four HTTPS calls and a hash. Reaching them through

{make_cloudflare-0.3.0 → make_cloudflare-0.4.0}/README.md

@@ -8,7 +8,7 @@ in the pipeline.
 # Makefile.py in a consuming repo
 # /// script
 # requires-python = ">=3.11"
-# dependencies = ["mkrun>=0.4", "make-cloudflare>=0.1"]
+# dependencies = ["mkrun>=0.4.1", "make-cloudflare>=0.3"]
 # ///
 from make_cloudflare import cloudflare  # importing is what registers the group
 ```
@@ -49,6 +49,13 @@ site's own `_routes.json` wins. Everything else is still the four calls below.
 Bindings (D1, KV) and secrets are settings on the Pages project, never part of
 the upload.
 
+**Those settings are one call.** `pages.configure(project, d1={"DB": "<id>"},
+vars={...}, compatibility_date="2026-10-01")` PATCHes the project's
+`production` (or `preview`) configuration. Only what you pass is sent, and
+Cloudflare merges it in. It takes effect on the **next** deployment. Secrets
+are not set this way: a plain variable is shown in the dashboard, so a secret
+goes through `wrangler pages secret put`.
+
 ## Why this exists
 
 `wrangler pages deploy` is four HTTPS calls and a hash. Reaching them through

{make_cloudflare-0.3.0 → make_cloudflare-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "make-cloudflare"
-version = "0.3.0"
+version = "0.4.0"
 description = "Cloudflare Pages direct upload for mkrun -- deploy a built site with no Node and no wrangler."
 readme = "README.md"
 requires-python = ">=3.11"

{make_cloudflare-0.3.0 → make_cloudflare-0.4.0}/src/make_cloudflare/__init__.py

@@ -17,7 +17,7 @@ namespaces, and this package claims only the four names above.
 
 from __future__ import annotations
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 
 __all__ = ["cloudflare", "pages"]
 

{make_cloudflare-0.3.0 → make_cloudflare-0.4.0}/src/make_cloudflare/pages.py

@@ -61,6 +61,7 @@ from make.errors import ConfigError, MakeError
 __all__ = [
     "Asset",
     "build_functions",
+    "configure",
     "collect",
     "deploy",
     "deployments",
@@ -494,6 +495,53 @@ def create_project(
     return created if isinstance(created, dict) else {"name": project}
 
 
+def configure(
+    project: str,
+    *,
+    d1: Mapping[str, str] | None = None,
+    vars: Mapping[str, str] | None = None,
+    compatibility_date: str | None = None,
+    compatibility_flags: Iterable[str] | None = None,
+    environment: str = "production",
+    account: str | None = None,
+    token: str | None = None,
+) -> dict:
+    """Set what a project's Functions run with; return the project as Cloudflare now has it.
+
+    `d1` maps a binding name to a D1 database id (`{"DB": "<uuid>"}`), `vars` sets plain
+    environment variables, and the compatibility date and flags pick the runtime.
+    `environment` is `production` or `preview`. Only what is passed is sent, and
+    Cloudflare merges it into what the project already has -- nothing unnamed is removed.
+
+    ⚠ Settings take effect on the **next deployment**, never on the live one. Secrets are
+    not set here: a value sent this way is stored in plain text and shown in the dashboard,
+    so a secret goes through `wrangler pages secret put`.
+    """
+    if environment not in ("production", "preview"):
+        raise MakeError(f"no Pages environment {environment!r}", hint="production or preview")
+    settings: dict[str, Any] = {}
+    if d1:
+        settings["d1_databases"] = {name: {"id": ident} for name, ident in d1.items()}
+    if vars:
+        settings["env_vars"] = {name: {"type": "plain_text", "value": value} for name, value in vars.items()}
+    if compatibility_date:
+        settings["compatibility_date"] = compatibility_date
+    if compatibility_flags is not None:
+        settings["compatibility_flags"] = list(compatibility_flags)
+    if not settings:
+        raise MakeError(f"nothing to set on {project}", hint="pass d1=, vars= or a compatibility date")
+
+    account, token = _credentials(account, token)
+    step(f"{project} ({environment}): " + ", ".join(sorted(settings)))
+    result = _json_call(
+        "PATCH",
+        f"{API}/accounts/{account}/pages/projects/{project}",
+        auth=token,
+        payload={"deployment_configs": {environment: settings}},
+    )
+    return result if isinstance(result, dict) else {"name": project}
+
+
 def deployments(project: str, *, account: str | None = None, token: str | None = None) -> list[dict]:
     """A project's deployments, newest first -- every page of them.
 

{make_cloudflare-0.3.0 → make_cloudflare-0.4.0}/tests/test_pages.py

@@ -423,3 +423,37 @@ def test_a_missing_functions_tree_is_named(monkeypatch, tmp_path):
     site = build(tmp_path / "dist", {"index.html": "x"})
     with pytest.raises(MakeError, match="not a directory"):
         deploy(monkeypatch, site, FakeHTTP(), functions=tmp_path / "nope")
+
+
+# -- project settings --------------------------------------------------------
+
+
+def test_configure_patches_only_what_it_is_given(monkeypatch):
+    fake = FakeHTTP()
+    monkeypatch.setattr(pages.http, "request", fake)
+    pages.configure(
+        "demo",
+        d1={"DB": "uuid-1"},
+        vars={"ZONE": "example.dev"},
+        compatibility_date="2026-10-01",
+        account="acct",
+        token="tok",
+    )
+    method, url, call = fake.calls[0]
+    assert (method, url) == ("PATCH", f"{pages.API}/accounts/acct/pages/projects/demo")
+    assert json.loads(call["data"]) == {
+        "deployment_configs": {
+            "production": {
+                "d1_databases": {"DB": {"id": "uuid-1"}},
+                "env_vars": {"ZONE": {"type": "plain_text", "value": "example.dev"}},
+                "compatibility_date": "2026-10-01",
+            }
+        }
+    }
+
+
+def test_configure_refuses_an_empty_or_unknown_request():
+    with pytest.raises(MakeError, match="nothing to set"):
+        pages.configure("demo", account="acct", token="tok")
+    with pytest.raises(MakeError, match="no Pages environment"):
+        pages.configure("demo", vars={"A": "1"}, environment="staging", account="acct", token="tok")