makea-cli 0.2.18__tar.gz → 0.2.19__tar.gz

{makea_cli-0.2.18 → makea_cli-0.2.19}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.19
+
+- `admin create rule` and `admin update rule` take `--valid-until YYYY-MM-DD`:
+  the day the rule ends (a closure, a temporary arrangement). From the day
+  after, it is in no prompt and does nothing; `playbook-preview` lists it as
+  "Ended". `--valid-until none` on update removes the end date. Needs the
+  backend from 3c1dc4e4.
+
 ## 0.2.18
 
 New: see why a playbook rule did not reach Beeboo, and what a rule said

{makea_cli-0.2.18 → makea_cli-0.2.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.18
+Version: 0.2.19
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -143,7 +143,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
-| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before. | — |
+| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until). --reason required; the rule keeps what it was before. | — |
 | `makea-cli admin update shipping-order` | write（ask） | `PUT /admin/shipping_orders/{shipping_order_id}/status` | Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |

{makea_cli-0.2.18 → makea_cli-0.2.19}/README.md

@@ -131,7 +131,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
-| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before. | — |
+| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until). --reason required; the rule keeps what it was before. | — |
 | `makea-cli admin update shipping-order` | write（ask） | `PUT /admin/shipping_orders/{shipping_order_id}/status` | Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |

makea_cli-0.2.19/makea_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.19"

{makea_cli-0.2.18 → makea_cli-0.2.19}/makea_cli/commands/playbook/cmd.py

@@ -17,6 +17,7 @@ the row stays as the record, and ``update --status active`` brings it back.
 from __future__ import annotations
 
 import json
+from datetime import date
 from typing import Any
 
 import typer
@@ -107,6 +108,13 @@ def _when(raw: str) -> dict[str, Any]:
     return data
 
 
+def _date(raw: str) -> str:
+    try:
+        return date.fromisoformat(raw.strip()).isoformat()
+    except ValueError as e:
+        raise typer.BadParameter("--valid-until: expected YYYY-MM-DD") from e
+
+
 def _choice(value: str | None, allowed: tuple[str, ...], flag: str) -> str | None:
     if value is None:
         return None
@@ -290,6 +298,11 @@ def register(app: typer.Typer) -> None:
         force: bool = typer.Option(
             False, "--force", help="Add even if it repeats or disagrees with an existing rule."
         ),
+        valid_until: str | None = typer.Option(
+            None,
+            "--valid-until",
+            help="YYYY-MM-DD the rule ends on (a closure, a temporary arrangement).",
+        ),
     ) -> None:
         """Add a playbook rule for a person."""
         body: dict[str, Any] = {"text": text, "reason": _reason(reason)}
@@ -311,6 +324,8 @@ def register(app: typer.Typer) -> None:
             body["status"] = _choice(status, ("pending", "active", "muted"), "--status")
         if force:
             body["force"] = True
+        if valid_until is not None:
+            body["valid_until"] = _date(valid_until)
         print_json_or_exit(console, lambda: api_client.admin_create_user_rule(user, body))
 
     @command(
@@ -345,6 +360,11 @@ def register(app: typer.Typer) -> None:
             None, "--when", help="Which products, JSON ({} for every product)."
         ),
         mode: str | None = typer.Option(None, "--mode", help="remind or act."),
+        valid_until: str | None = typer.Option(
+            None,
+            "--valid-until",
+            help='YYYY-MM-DD the rule ends on; "none" removes the end date.',
+        ),
     ) -> None:
         """Edit a person's playbook rule."""
         body: dict[str, Any] = {}
@@ -358,9 +378,14 @@ def register(app: typer.Typer) -> None:
             body["when"] = _when(when)
         if mode is not None:
             body["mode"] = _choice(mode, _MODES, "--mode")
+        if valid_until is not None:
+            body["valid_until"] = (
+                "" if valid_until.strip().lower() == "none" else _date(valid_until)
+            )
         if not body:
             raise typer.BadParameter(
-                "nothing to change: pass --text, --status, --applies-to, --when or --mode"
+                "nothing to change: pass --text, --status, --applies-to, --when, --mode "
+                "or --valid-until"
             )
         body["reason"] = _reason(reason)
         print_json_or_exit(console, lambda: api_client.admin_update_user_rule(user, rule_id, body))

{makea_cli-0.2.18 → makea_cli-0.2.19}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makea-cli"
-version = "0.2.18"
+version = "0.2.19"
 description = "Makea admin CLI (browser login + Makea admin HTTP API)"
 readme = "README.md"
 requires-python = ">=3.10"

{makea_cli-0.2.18 → makea_cli-0.2.19}/tests/golden_manifest.json

@@ -486,6 +486,18 @@
           "multiple": false,
           "default": false,
           "help": "Add even if it repeats or disagrees with an existing rule."
+        },
+        {
+          "name": "valid_until",
+          "kind": "option",
+          "opts": [
+            "--valid-until"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "YYYY-MM-DD the rule ends on (a closure, a temporary arrangement)."
         }
       ]
     },
@@ -4560,6 +4572,18 @@
           "multiple": false,
           "default": null,
           "help": "remind or act."
+        },
+        {
+          "name": "valid_until",
+          "kind": "option",
+          "opts": [
+            "--valid-until"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "YYYY-MM-DD the rule ends on; \"none\" removes the end date."
         }
       ]
     },

{makea_cli-0.2.18 → makea_cli-0.2.19}/uv.lock

@@ -115,7 +115,7 @@ wheels = [
 
 [[package]]
 name = "makea-cli"
-version = "0.2.18"
+version = "0.2.19"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

makea_cli-0.2.18/makea_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.18"