qapu-cli 0.75.0__tar.gz → 0.76.0__tar.gz

{qapu_cli-0.75.0 → qapu_cli-0.76.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qapu-cli
-Version: 0.75.0
+Version: 0.76.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.75.0 → qapu_cli-0.76.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qapu-cli"
-version = "0.75.0"
+version = "0.76.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.75.0 → qapu_cli-0.76.0}/qapu_cli/command_packages.py

@@ -63,6 +63,17 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"calibration_get": frozenset({"calibration:read"}),
 	"calibration_list": frozenset({"calibration:read"}),
 	"calibration_update": frozenset({"calibration:write"}),
+	"calibration_assignment_add": frozenset({"calibration:write"}),
+	"calibration_assignment_delete": frozenset({"calibration:write"}),
+	"calibration_assignment_get": frozenset({"calibration:read"}),
+	"calibration_assignment_list": frozenset({"calibration:read"}),
+	"calibration_assignment_retire": frozenset({"calibration:write"}),
+	"calibration_assignment_update": frozenset({"calibration:write"}),
+	"calibration_profile_add": frozenset({"calibration:write"}),
+	"calibration_profile_delete": frozenset({"calibration:write"}),
+	"calibration_profile_get": frozenset({"calibration:read"}),
+	"calibration_profile_list": frozenset({"calibration:read"}),
+	"calibration_profile_update": frozenset({"calibration:write"}),
 	"cinga_ai_list": frozenset({"mcp:read-only"}),
 	"cinga_ai_log": frozenset({"observability:write"}),
 	"crop_type_add": frozenset({"operations-catalog:write"}),
@@ -90,6 +101,7 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"device_power": frozenset({"telemetry:read"}),
 	"device_purge_history": frozenset({"devices:destructive"}),
 	"device_reliability": frozenset({"telemetry:read"}),
+	"device_windows": frozenset({"telemetry:read"}),
 	"device_trend": frozenset({"telemetry:read"}),
 	"device_voltage": frozenset({"telemetry:read"}),
 	"equipment_add": frozenset({"infrastructure:write"}),

{qapu_cli-0.75.0 → qapu_cli-0.76.0}/qapu_cli/main.py

@@ -1165,6 +1165,91 @@ def device_reliability(
 	]))
 
 
+_WINDOWS_PERIOD_TYPE_TO_CODE = {"day": 1, "week": 7, "month": 30}
+_WINDOWS_PERIOD_CODE_TO_LABEL = {1: "Günlük", 7: "Haftalık", 30: "Aylık"}
+
+
+@device_app.command("windows")
+def device_windows(
+	device_id: str = typer.Argument(..., help="Device ID."),
+	variable_id: Optional[str] = typer.Option(None, "--variable-id", help="Restrict to one variable (e.g. VRMS_A). Omit for every in-scope variable."),
+	period: Optional[str] = typer.Option(None, "--period", help="day | week | month. Omit for all three."),
+	days: Optional[int] = typer.Option(None, "--days", help="Window size in days, by window_start, ending now. Ignored if --start/--end are given."),
+	start: Optional[str] = typer.Option(None, "--start", help="ISO date/datetime lower bound on window_start, inclusive. Takes priority over --days."),
+	end: Optional[str] = typer.Option(None, "--end", help="ISO date/datetime upper bound on window_start, exclusive. Takes priority over --days."),
+	limit: Optional[int] = typer.Option(None, "--limit", help="Cap the number of rows shown. Omit to page through everything interactively."),
+	as_json: bool = typer.Option(False, "--json", help="Print raw JSON instead of a human-readable table."),
+):
+	"""Pre-computed daily/weekly/monthly statistics for a device, voltage/current/power/energy only (GET /hermes/windows/{device_id}). Not real-time - see `qapu trend`/`qapu data` for live readings."""
+
+	# Translate --period's Friendly Name Into the Raw int the API Expects
+	period_type: Optional[int] = None
+	if period is not None:
+		period_type = _WINDOWS_PERIOD_TYPE_TO_CODE.get(period.strip().lower())
+		if period_type is None:
+			console.print(f"[red]Geçersiz --period değeri: {period!r} (day, week veya month olmalı)[/red]")
+			raise typer.Exit(code=1)
+
+	# Fetch the Rows
+	params: dict[str, Any] = {}
+	if variable_id:
+		params["variable_id"] = variable_id
+	if period_type is not None:
+		params["period_type"] = period_type
+	if start or end:
+		if start:
+			params["start"] = start
+		if end:
+			params["end"] = end
+	elif days is not None:
+		params["days"] = days
+	rows: list[dict[str, Any]] = client.get(f"/hermes/windows/{device_id}", params=params)
+
+	# JSON Output - Nothing Further to Format
+	if as_json:
+		typer.echo(json.dumps(rows, indent=2))
+		return
+
+	# No Rows - Say so Plainly
+	if not rows:
+		console.print(f"[yellow]{device_id} için kayıt bulunamadı.[/yellow]")
+		return
+
+	# Build and Print the Table, Paginated Like Every Other Long List in
+	# This CLI (device/variable/synthesis list) - a Device's own Window
+	# History Can Easily Run Into the Hundreds of Rows Once Every Variable
+	# and Period Type is Included.
+	build_table = _simple_table_builder([
+		("DÖNEM", "period_type"),
+		("DEĞİŞKEN", "variable_id"),
+		("BAŞLANGIÇ", "window_start"),
+		("ORT", "mean"),
+		("MIN", "min"),
+		("MAKS", "max"),
+		("ÖRNEK", "sample_count"),
+		("TAMLIK", "completeness_ratio"),
+	])
+
+	# Pretty-Print Each Row's period_type/window_start/completeness_ratio
+	# Before Handing off to the Generic Table Builder - Raw int Period
+	# Codes and ISO Timestamps/Ratios Read Poorly Side by Side With Every
+	# Other Column's Already-Human Values.
+	display_rows = []
+	for row in rows:
+		display_row = dict(row)
+		display_row["period_type"] = _WINDOWS_PERIOD_CODE_TO_LABEL.get(row.get("period_type"), row.get("period_type"))
+		display_row["window_start"] = _format_time(row.get("window_start"))
+		ratio = row.get("completeness_ratio")
+		display_row["completeness_ratio"] = f"%{ratio * 100:.0f}" if ratio is not None else "-"
+		for numeric_col in ("mean", "min", "max"):
+			value = row.get(numeric_col)
+			if isinstance(value, (int, float)):
+				display_row[numeric_col] = round(value, 3)
+		display_rows.append(display_row)
+
+	_print_paginated(display_rows, build_table, limit, "pencere")
+
+
 @device_app.command("purge-history")
 def device_purge_history(
 	device_id: str = typer.Argument(..., help="Device ID."),

{qapu_cli-0.75.0 → qapu_cli-0.76.0}/qapu_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qapu-cli
-Version: 0.75.0
+Version: 0.76.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