makea-cli 0.2.10__tar.gz → 0.2.11__tar.gz

{makea_cli-0.2.10 → makea_cli-0.2.11}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.2.11
+
+- Order reads for a factory (and its Beeboo):
+  - `supplier get order <rfq> [--readable]`: the sample and bulk orders on one
+    RFQ; `--readable` gives each order's state, dates, quantity and what has
+    been paid, with no ids or product payload.
+  - `supplier list milestone --production-order <id>`: the bulk order's
+    milestones, which came back and why, and the proof review's view.
+  - `supplier get payment-summary <rfq>`: whether the buyer has paid the
+    sample, deposit and balance, and the factory's own price on each PO.
+  - `supplier list purchase-order`, `supplier list order-note`.
+- `supplier list production-order` now requires `--rfq` (the backend always
+  did; without it the command failed).
+
 ## 0.2.10
 
 - PM reads for a brand (and Beeboo working for one):

{makea_cli-0.2.10 → makea_cli-0.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.10
+Version: 0.2.11
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1

makea_cli-0.2.11/makea_cli/__init__.py

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

{makea_cli-0.2.10 → makea_cli-0.2.11}/makea_cli/api_client.py

@@ -1062,6 +1062,43 @@ def supplier_list_production_orders(*, quote_request_id: str | None = None) -> A
     return get_json("/supplier/production_orders", params=params)
 
 
+def supplier_get_orders(quote_request_id: str, *, readable: bool = False) -> Any:
+    """GET /supplier/quote_requests/{id}/orders_view — the sample and bulk orders
+    on one RFQ. ``readable``: each order's state, dates and what was paid, with
+    no ids or product payload (the full view runs past 100KB)."""
+    params = {"view": "readable"} if readable else None
+    return get_json(f"/supplier/quote_requests/{quote_request_id}/orders_view", params=params)
+
+
+def supplier_list_milestones(production_order_id: str) -> Any:
+    """GET /supplier/production_orders/{id}/progress?view=readable — each step's
+    milestones, which one came back and why, and the proof review's view."""
+    return get_json(
+        f"/supplier/production_orders/{production_order_id}/progress",
+        params={"view": "readable"},
+    )
+
+
+def supplier_get_payment_summary(quote_request_id: str) -> Any:
+    """GET /supplier/quote_requests/{id}/payment_summary — whether the buyer has
+    paid each stage, and the factory's own price on its purchase orders."""
+    return get_json(f"/supplier/quote_requests/{quote_request_id}/payment_summary")
+
+
+def supplier_list_purchase_orders() -> Any:
+    """GET /supplier/purchase-orders — purchase orders raised to this factory."""
+    return get_json("/supplier/purchase-orders")
+
+
+def supplier_list_order_notes(
+    *, production_order_id: str | None = None, sampling_order_id: str | None = None
+) -> Any:
+    """GET /supplier/{production|sampling}_orders/{id}/notes — an order's notes."""
+    if production_order_id:
+        return get_json(f"/supplier/production_orders/{production_order_id}/notes")
+    return get_json(f"/supplier/sampling_orders/{sampling_order_id}/notes")
+
+
 def supplier_list_actions() -> Any:
     """GET /supplier/actions — what the platform is waiting on this factory for."""
     return get_json("/supplier/actions")

{makea_cli-0.2.10 → makea_cli-0.2.11}/makea_cli/commands/factory/cmd.py

@@ -96,11 +96,11 @@ def register(app: typer.Typer) -> None:
         "list",
         "production-order",
         api="GET /supplier/production_orders",
-        help="GET /supplier/production_orders — your production orders, optionally for one RFQ.",
+        help="GET /supplier/production_orders?quote_request_id=… — the bulk orders on one RFQ.",
     )
     def list_production_orders(
-        rfq: str | None = typer.Option(
-            None, "--rfq", help="Only orders that grew out of this quote request."
+        rfq: str = typer.Option(
+            ..., "--rfq", help="The quote request whose orders to list (required)."
         ),
     ) -> None:
         """List the factory's production orders."""
@@ -108,6 +108,107 @@ def register(app: typer.Typer) -> None:
             console, lambda: api_client.supplier_list_production_orders(quote_request_id=rfq)
         )
 
+    @command(
+        app,
+        "supplier",
+        "get",
+        "order",
+        api="GET /supplier/quote_requests/{id}/orders_view",
+        help=(
+            "GET /supplier/quote_requests/{id}/orders_view — the sample and bulk orders on one RFQ."
+        ),
+    )
+    def get_order(
+        quote_request_id: str = typer.Argument(..., help="The quote request."),
+        readable: bool = typer.Option(
+            False,
+            "--readable",
+            help=(
+                "Each order's state, dates, quantity and what has been paid, with "
+                "no ids or product payload. The full view runs past 100KB."
+            ),
+        ),
+    ) -> None:
+        """Read the orders on one RFQ."""
+        print_json_or_exit(
+            console,
+            lambda: api_client.supplier_get_orders(quote_request_id, readable=readable),
+        )
+
+    @command(
+        app,
+        "supplier",
+        "list",
+        "milestone",
+        api="GET /supplier/production_orders/{id}/progress",
+        help=(
+            "GET /supplier/production_orders/{id}/progress?view=readable — each "
+            "step's milestones, which came back and why, and the proof review."
+        ),
+    )
+    def list_milestones(
+        production_order: str = typer.Option(
+            ..., "--production-order", help="The bulk order (from `get order`)."
+        ),
+    ) -> None:
+        """List a bulk order's production milestones."""
+        print_json_or_exit(console, lambda: api_client.supplier_list_milestones(production_order))
+
+    @command(
+        app,
+        "supplier",
+        "get",
+        "payment-summary",
+        api="GET /supplier/quote_requests/{id}/payment_summary",
+        help=(
+            "GET /supplier/quote_requests/{id}/payment_summary — whether the buyer "
+            "has paid the sample, deposit and balance, and your price on each PO."
+        ),
+    )
+    def get_payment_summary(
+        quote_request_id: str = typer.Argument(..., help="The quote request."),
+    ) -> None:
+        """Where the money for one RFQ stands, from the factory's side."""
+        print_json_or_exit(
+            console, lambda: api_client.supplier_get_payment_summary(quote_request_id)
+        )
+
+    @command(
+        app,
+        "supplier",
+        "list",
+        "purchase-order",
+        api="GET /supplier/purchase-orders",
+        help="GET /supplier/purchase-orders — the purchase orders raised to you.",
+    )
+    def list_purchase_orders() -> None:
+        """List the factory's purchase orders."""
+        print_json_or_exit(console, lambda: api_client.supplier_list_purchase_orders())
+
+    @command(
+        app,
+        "supplier",
+        "list",
+        "order-note",
+        api="GET /supplier/production_orders/{id}/notes",
+        help=("GET /supplier/{production|sampling}_orders/{id}/notes — the notes on one order."),
+    )
+    def list_order_notes(
+        production_order: str | None = typer.Option(
+            None, "--production-order", help="A bulk order."
+        ),
+        sampling_order: str | None = typer.Option(None, "--sampling-order", help="A sample order."),
+    ) -> None:
+        """List the notes on one order."""
+        if bool(production_order) == bool(sampling_order):
+            raise typer.BadParameter("Give exactly one of --production-order, --sampling-order")
+        print_json_or_exit(
+            console,
+            lambda: api_client.supplier_list_order_notes(
+                production_order_id=production_order, sampling_order_id=sampling_order
+            ),
+        )
+
     @command(
         app,
         "supplier",

{makea_cli-0.2.10 → makea_cli-0.2.11}/pyproject.toml

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

{makea_cli-0.2.10 → makea_cli-0.2.11}/tests/golden_manifest.json

@@ -6991,6 +6991,49 @@
         }
       ]
     },
+    {
+      "name": "supplier get order",
+      "persona": "supplier",
+      "verb": "get",
+      "noun": "order",
+      "access": "read",
+      "api": "GET /supplier/quote_requests/{id}/orders_view",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /supplier/quote_requests/{id}/orders_view — the sample and bulk orders on one RFQ.",
+      "function": "makea_cli.commands.factory.cmd.register.<locals>.get_order",
+      "flags": [
+        {
+          "name": "quote_request_id",
+          "kind": "argument",
+          "opts": [
+            "quote_request_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "The quote request."
+        },
+        {
+          "name": "readable",
+          "kind": "option",
+          "opts": [
+            "--readable"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": false,
+          "help": "Each order's state, dates, quantity and what has been paid, with no ids or product payload. The full view runs past 100KB."
+        }
+      ]
+    },
     {
       "name": "supplier get pack",
       "persona": "supplier",
@@ -7066,6 +7109,37 @@
         }
       ]
     },
+    {
+      "name": "supplier get payment-summary",
+      "persona": "supplier",
+      "verb": "get",
+      "noun": "payment-summary",
+      "access": "read",
+      "api": "GET /supplier/quote_requests/{id}/payment_summary",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /supplier/quote_requests/{id}/payment_summary — whether the buyer has paid the sample, deposit and balance, and your price on each PO.",
+      "function": "makea_cli.commands.factory.cmd.register.<locals>.get_payment_summary",
+      "flags": [
+        {
+          "name": "quote_request_id",
+          "kind": "argument",
+          "opts": [
+            "quote_request_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "The quote request."
+        }
+      ]
+    },
     {
       "name": "supplier get profile",
       "persona": "supplier",
@@ -7165,6 +7239,37 @@
         }
       ]
     },
+    {
+      "name": "supplier list milestone",
+      "persona": "supplier",
+      "verb": "list",
+      "noun": "milestone",
+      "access": "read",
+      "api": "GET /supplier/production_orders/{id}/progress",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /supplier/production_orders/{id}/progress?view=readable — each step's milestones, which came back and why, and the proof review.",
+      "function": "makea_cli.commands.factory.cmd.register.<locals>.list_milestones",
+      "flags": [
+        {
+          "name": "production_order",
+          "kind": "option",
+          "opts": [
+            "--production-order"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "The bulk order (from `get order`)."
+        }
+      ]
+    },
     {
       "name": "supplier list note",
       "persona": "supplier",
@@ -7210,6 +7315,49 @@
         }
       ]
     },
+    {
+      "name": "supplier list order-note",
+      "persona": "supplier",
+      "verb": "list",
+      "noun": "order-note",
+      "access": "read",
+      "api": "GET /supplier/production_orders/{id}/notes",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /supplier/{production|sampling}_orders/{id}/notes — the notes on one order.",
+      "function": "makea_cli.commands.factory.cmd.register.<locals>.list_order_notes",
+      "flags": [
+        {
+          "name": "production_order",
+          "kind": "option",
+          "opts": [
+            "--production-order"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "A bulk order."
+        },
+        {
+          "name": "sampling_order",
+          "kind": "option",
+          "opts": [
+            "--sampling-order"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "A sample order."
+        }
+      ]
+    },
     {
       "name": "supplier list production-order",
       "persona": "supplier",
@@ -7224,7 +7372,7 @@
       "idempotent": null,
       "limit": "client",
       "legacy": [],
-      "help": "GET /supplier/production_orders — your production orders, optionally for one RFQ.",
+      "help": "GET /supplier/production_orders?quote_request_id=… — the bulk orders on one RFQ.",
       "function": "makea_cli.commands.factory.cmd.register.<locals>.list_production_orders",
       "flags": [
         {
@@ -7234,13 +7382,31 @@
             "--rfq"
           ],
           "type": "text",
-          "required": false,
+          "required": true,
           "multiple": false,
           "default": null,
-          "help": "Only orders that grew out of this quote request."
+          "help": "The quote request whose orders to list (required)."
         }
       ]
     },
+    {
+      "name": "supplier list purchase-order",
+      "persona": "supplier",
+      "verb": "list",
+      "noun": "purchase-order",
+      "access": "read",
+      "api": "GET /supplier/purchase-orders",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /supplier/purchase-orders — the purchase orders raised to you.",
+      "function": "makea_cli.commands.factory.cmd.register.<locals>.list_purchase_orders",
+      "flags": []
+    },
     {
       "name": "supplier list quote-edit-request",
       "persona": "supplier",

{makea_cli-0.2.10 → makea_cli-0.2.11}/uv.lock

@@ -115,9 +115,10 @@ wheels = [
 
 [[package]]
 name = "makea-cli"
-version = "0.1.4"
+version = "0.2.11"
 source = { editable = "." }
 dependencies = [
+    { name = "click" },
     { name = "httpx" },
     { name = "platformdirs" },
     { name = "rich" },
@@ -126,10 +127,11 @@ dependencies = [
 
 [package.metadata]
 requires-dist = [
+    { name = "click", specifier = ">=8.1,<9" },
     { name = "httpx", specifier = ">=0.27" },
     { name = "platformdirs", specifier = ">=4.2" },
     { name = "rich", specifier = ">=13.7" },
-    { name = "typer", specifier = ">=0.12" },
+    { name = "typer", specifier = ">=0.12,<0.25" },
 ]
 
 [[package]]

makea_cli-0.2.10/makea_cli/__init__.py

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