qapu-cli 0.77.0__tar.gz → 0.78.0__tar.gz

{qapu_cli-0.77.0 → qapu_cli-0.78.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qapu-cli
-Version: 0.77.0
+Version: 0.78.0
 Summary: CLI client for the Qapu API - built for the Hermes agent, but usable by anyone talking to api.ovoo.com.tr from outside the Swarm.
 Author: OVOO Technology
 Classifier: Programming Language :: Python :: 3

{qapu_cli-0.77.0 → qapu_cli-0.78.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qapu-cli"
-version = "0.77.0"
+version = "0.78.0"
 description = "CLI client for the Qapu API - built for the Hermes agent, but usable by anyone talking to api.ovoo.com.tr from outside the Swarm."
 readme = "README.md"
 requires-python = ">=3.10"

{qapu_cli-0.77.0 → qapu_cli-0.78.0}/qapu_cli/command_packages.py

@@ -200,8 +200,11 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"score_watch": frozenset({"scores:read", "telemetry:read"}),
 	"setting_get": frozenset({"settings:read"}),
 	"setting_update": frozenset({"settings:write"}),
+	"sim_add": frozenset({"hardware-catalog:write"}),
+	"sim_delete": frozenset({"hardware-catalog:write"}),
 	"sim_get": frozenset({"hardware-catalog:read"}),
 	"sim_list": frozenset({"hardware-catalog:read"}),
+	"sim_update": frozenset({"hardware-catalog:write"}),
 	"site_add": frozenset({"infrastructure:write"}),
 	"site_context": frozenset({"infrastructure:read"}),
 	"site_delete": frozenset({"infrastructure:write"}),

{qapu_cli-0.77.0 → qapu_cli-0.78.0}/qapu_cli/main.py

@@ -4277,7 +4277,6 @@ def sim_list(
 	as_json: bool = typer.Option(False, "--json"),
 	operator_id: Optional[int] = typer.Option(None, "--operator-id"),
 	active: Optional[bool] = typer.Option(None, "--active/--inactive"),
-	online: Optional[bool] = typer.Option(None, "--online/--offline"),
 	limit: Optional[int] = typer.Option(None, "--limit"),
 ):
 	"""List the SIM inventory (GET /hermes/sims)."""
@@ -4286,15 +4285,13 @@ def sim_list(
 		params["operator_id"] = operator_id
 	if active is not None:
 		params["active"] = active
-	if online is not None:
-		params["online"] = online
 	items: list[dict[str, Any]] = client.get("/hermes/sims", params=params)
 	if limit is not None:
 		items = items[:limit]
 	if as_json:
 		typer.echo(json.dumps(items, indent=2))
 		return
-	_print_paginated(items, _simple_table_builder([("ICCID", "ICCID"), ("NUMBER", "Number"), ("OPERATOR", "Operator.MNC_Operator"), ("STATIC_IP", "Static_IP"), ("STATUS", "Status")]), limit=limit, noun="SIM")
+	_print_paginated(items, _simple_table_builder([("ICCID", "ICCID"), ("NUMBER", "Number"), ("OPERATOR", "Operator.MNC_Brand"), ("APN", "APN"), ("INSTITUTIONAL", "Institutional"), ("STATIC_IP", "Static_IP"), ("STATUS", "Status")]), limit=limit, noun="SIM")
 
 
 # Get One SIM's Detail
@@ -4308,6 +4305,63 @@ def sim_get(iccid: str = typer.Argument(...), as_json: bool = typer.Option(False
 	_print_detail(result)
 
 
+# SIM Body From CLI Options - Only What was Given
+def _sim_body(operator_id: Optional[int], number: Optional[str], static_ip: Optional[str], apn: Optional[str], institutional: Optional[bool], active: Optional[bool]) -> dict[str, Any]:
+	body: dict[str, Any] = {}
+	if operator_id is not None:
+		body["Operator"] = {"ID": operator_id}
+	for key, value in (("Number", number), ("Static_IP", static_ip), ("APN", apn), ("Institutional", institutional), ("Status", active)):
+		if value is not None:
+			body[key] = value
+	return body
+
+
+# Add a SIM
+@sim_app.command("add")
+def sim_add(
+	iccid: str = typer.Argument(..., help="ICCID (18-22 digits)."),
+	operator_id: Optional[int] = typer.Option(None, "--operator-id", help="GSM operator ID (e.g. 28601 Turkcell); defaults to Unknown until the device reports it."),
+	number: Optional[str] = typer.Option(None, "--number"),
+	static_ip: Optional[str] = typer.Option(None, "--static-ip"),
+	apn: Optional[str] = typer.Option(None, "--apn"),
+	institutional: Optional[bool] = typer.Option(None, "--institutional/--not-institutional", help="SIM supplied by a customer institution."),
+	active: Optional[bool] = typer.Option(None, "--active/--inactive"),
+):
+	"""Add a SIM (POST /hermes/sims)."""
+	result = client.post("/hermes/sims", json_body={"ICCID": iccid, **_sim_body(operator_id, number, static_ip, apn, institutional, active)})
+	typer.echo(result.get("Message", result))
+
+
+# Update a SIM
+@sim_app.command("update")
+def sim_update(
+	iccid: str = typer.Argument(...),
+	operator_id: Optional[int] = typer.Option(None, "--operator-id"),
+	number: Optional[str] = typer.Option(None, "--number"),
+	static_ip: Optional[str] = typer.Option(None, "--static-ip"),
+	apn: Optional[str] = typer.Option(None, "--apn"),
+	institutional: Optional[bool] = typer.Option(None, "--institutional/--not-institutional"),
+	active: Optional[bool] = typer.Option(None, "--active/--inactive"),
+):
+	"""Update a SIM - only the options given change (PUT /hermes/sims/{iccid}). APN/operator are also refreshed from the device's own reports."""
+	body = _sim_body(operator_id, number, static_ip, apn, institutional, active)
+	if not body:
+		typer.echo("Nothing to update - give at least one option.")
+		raise typer.Exit(1)
+	result = client.put(f"/hermes/sims/{iccid}", json_body=body)
+	typer.echo(result.get("Message", result))
+
+
+# Delete a SIM - Refused by the API if a Device or any Stored Packet Uses it
+@sim_app.command("delete")
+def sim_delete(iccid: str = typer.Argument(...), yes: bool = typer.Option(False, "--yes", "-y", help="Skip the confirmation prompt.")):
+	"""Delete an unused SIM (DELETE /hermes/sims/{iccid}). A SIM used by a device or any stored packet can't be deleted - deactivate it with `qapu sim update ICCID --inactive`."""
+	if not yes and not typer.confirm(f"Delete SIM {iccid}?"):
+		raise typer.Exit(0)
+	result = client.delete(f"/hermes/sims/{iccid}")
+	typer.echo(result.get("Message", result))
+
+
 # List Firmware Versions
 @firmware_app.command("list")
 def firmware_list(

{qapu_cli-0.77.0 → qapu_cli-0.78.0}/qapu_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qapu-cli
-Version: 0.77.0
+Version: 0.78.0
 Summary: CLI client for the Qapu API - built for the Hermes agent, but usable by anyone talking to api.ovoo.com.tr from outside the Swarm.
 Author: OVOO Technology
 Classifier: Programming Language :: Python :: 3