ventilatepro-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{ventilatepro_cli-0.1.0 → ventilatepro_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ventilatepro-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: VentilatePro CLI
 Project-URL: Homepage, https://ventilatepro.com/exam/cli/
 Project-URL: Documentation, https://ventilatepro.com/exam/cli/
@@ -42,8 +42,27 @@ pip install -e .
 ```bash
 ventilatepro auth login --url http://localhost:8000
 ventilatepro projects list
+ventilatepro projects show 1
+ventilatepro rooms list --project 1
+ventilatepro ahus list --project 1
+ventilatepro systems hierarchy --project 1
+ventilatepro calc status --project 1
+ventilatepro calc ahu-properties --ahu 1
+ventilatepro design-day context --project 1
 ventilatepro notes create --project 1 --body "Captured from terminal"
 ventilatepro notes sync
 ```
 
+If the hidden token prompt is awkward in your terminal, use either:
+
+```bash
+ventilatepro auth login --url https://ventilatepro.com --token-prompt-visible
+```
+
+or pipe the token through stdin:
+
+```bash
+printf '%s' "$VPCLI_TOKEN" | ventilatepro auth login --url https://ventilatepro.com --token-stdin
+```
+
 See the hosted install guide at `https://ventilatepro.com/exam/cli/`, plus [docs/commands.md](./docs/commands.md), [docs/auth.md](./docs/auth.md), [docs/api.md](./docs/api.md), and [docs/releasing.md](./docs/releasing.md) in this repo.

{ventilatepro_cli-0.1.0 → ventilatepro_cli-0.2.0}/README.md

@@ -28,8 +28,27 @@ pip install -e .
 ```bash
 ventilatepro auth login --url http://localhost:8000
 ventilatepro projects list
+ventilatepro projects show 1
+ventilatepro rooms list --project 1
+ventilatepro ahus list --project 1
+ventilatepro systems hierarchy --project 1
+ventilatepro calc status --project 1
+ventilatepro calc ahu-properties --ahu 1
+ventilatepro design-day context --project 1
 ventilatepro notes create --project 1 --body "Captured from terminal"
 ventilatepro notes sync
 ```
 
+If the hidden token prompt is awkward in your terminal, use either:
+
+```bash
+ventilatepro auth login --url https://ventilatepro.com --token-prompt-visible
+```
+
+or pipe the token through stdin:
+
+```bash
+printf '%s' "$VPCLI_TOKEN" | ventilatepro auth login --url https://ventilatepro.com --token-stdin
+```
+
 See the hosted install guide at `https://ventilatepro.com/exam/cli/`, plus [docs/commands.md](./docs/commands.md), [docs/auth.md](./docs/auth.md), [docs/api.md](./docs/api.md), and [docs/releasing.md](./docs/releasing.md) in this repo.

ventilatepro_cli-0.2.0/tests/test_cli.py

@@ -0,0 +1,404 @@
+import json
+import os
+import tempfile
+import unittest
+from unittest import mock
+
+from typer.testing import CliRunner
+
+from ventilatepro import auth, config
+from ventilatepro.api_client import ApiError, NetworkError
+from ventilatepro.cli import app
+from ventilatepro.queue import QueueStore
+
+
+class CliTests(unittest.TestCase):
+    def setUp(self):
+        self.runner = CliRunner()
+
+    def test_auth_login_reads_token_from_stdin(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            os.environ[config.CONFIG_ENV_VAR] = tmpdir
+            os.environ[config.DATA_ENV_VAR] = tmpdir
+            try:
+                fake_client = mock.Mock()
+                fake_client.auth_me.return_value = {
+                    "username": "demo-user",
+                    "email": "demo@example.com",
+                }
+
+                with mock.patch.object(auth, "ApiClient", return_value=fake_client):
+                    with mock.patch.object(config, "_try_get_keyring", return_value=None):
+                        result = self.runner.invoke(
+                            app,
+                            ["auth", "login", "--url", "http://localhost:8000", "--token-stdin", "--json"],
+                            input="vpcli_demo_secret\n",
+                        )
+
+                self.assertEqual(result.exit_code, 0)
+                payload = json.loads(result.stdout)
+                self.assertEqual(payload["status"], "authenticated")
+                self.assertEqual(config.get_token(), "vpcli_demo_secret")
+                self.assertEqual(config.get_base_url(), "http://localhost:8000")
+            finally:
+                os.environ.pop(config.CONFIG_ENV_VAR, None)
+                os.environ.pop(config.DATA_ENV_VAR, None)
+
+    def test_auth_login_accepts_visible_prompt_input(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            os.environ[config.CONFIG_ENV_VAR] = tmpdir
+            os.environ[config.DATA_ENV_VAR] = tmpdir
+            try:
+                fake_client = mock.Mock()
+                fake_client.auth_me.return_value = {
+                    "username": "demo-user",
+                    "email": "demo@example.com",
+                }
+
+                with mock.patch.object(auth, "ApiClient", return_value=fake_client):
+                    with mock.patch.object(config, "_try_get_keyring", return_value=None):
+                        result = self.runner.invoke(
+                            app,
+                            ["auth", "login", "--url", "http://localhost:8000", "--token-prompt-visible", "--json"],
+                            input="vpcli_demo_secret\n",
+                        )
+
+                self.assertEqual(result.exit_code, 0)
+                self.assertIn("Personal access token (visible):", result.stdout)
+                self.assertEqual(config.get_token(), "vpcli_demo_secret")
+                self.assertEqual(config.get_base_url(), "http://localhost:8000")
+            finally:
+                os.environ.pop(config.CONFIG_ENV_VAR, None)
+                os.environ.pop(config.DATA_ENV_VAR, None)
+
+    def test_auth_login_rejects_conflicting_token_inputs(self):
+        result = self.runner.invoke(
+            app,
+            [
+                "auth",
+                "login",
+                "--url",
+                "http://localhost:8000",
+                "--token",
+                "vpcli_demo_secret",
+                "--token-stdin",
+            ],
+        )
+
+        self.assertNotEqual(result.exit_code, 0)
+        self.assertIn("either --token or --token-stdin", result.output)
+
+    def test_status_json_reports_not_authenticated(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            os.environ[config.CONFIG_ENV_VAR] = tmpdir
+            os.environ[config.DATA_ENV_VAR] = tmpdir
+            try:
+                result = self.runner.invoke(app, ["auth", "status", "--json"])
+                self.assertEqual(result.exit_code, 0)
+                payload = json.loads(result.stdout)
+                self.assertFalse(payload["authenticated"])
+            finally:
+                os.environ.pop(config.CONFIG_ENV_VAR, None)
+                os.environ.pop(config.DATA_ENV_VAR, None)
+
+    def test_notes_create_queues_on_network_error(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            os.environ[config.CONFIG_ENV_VAR] = tmpdir
+            os.environ[config.DATA_ENV_VAR] = tmpdir
+            try:
+                config.set_base_url("http://localhost:8000")
+                with mock.patch.object(config, "_try_get_keyring", return_value=None):
+                    config.save_token("vpcli_demo_secret")
+
+                fake_client = mock.Mock()
+                fake_client.create_note.side_effect = NetworkError("connection dropped")
+
+                with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+                    result = self.runner.invoke(
+                        app,
+                        ["notes", "create", "--project", "1", "--body", "Captured from CLI"],
+                    )
+
+                self.assertEqual(result.exit_code, 0)
+                queue_store = QueueStore()
+                queued = queue_store.list_unsynced()
+                self.assertEqual(len(queued), 1)
+                self.assertEqual(queued[0].sync_state, "pending")
+            finally:
+                os.environ.pop(config.CONFIG_ENV_VAR, None)
+                os.environ.pop(config.DATA_ENV_VAR, None)
+
+    def test_notes_create_does_not_queue_validation_errors(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            os.environ[config.CONFIG_ENV_VAR] = tmpdir
+            os.environ[config.DATA_ENV_VAR] = tmpdir
+            try:
+                config.set_base_url("http://localhost:8000")
+                with mock.patch.object(config, "_try_get_keyring", return_value=None):
+                    config.save_token("vpcli_demo_secret")
+
+                fake_client = mock.Mock()
+                fake_client.create_note.side_effect = ApiError(400, "Validation failed")
+
+                with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+                    result = self.runner.invoke(
+                        app,
+                        ["notes", "create", "--project", "1", "--body", "Captured from CLI"],
+                    )
+
+                self.assertNotEqual(result.exit_code, 0)
+                queue_store = QueueStore()
+                self.assertEqual(queue_store.count(), 0)
+            finally:
+                os.environ.pop(config.CONFIG_ENV_VAR, None)
+                os.environ.pop(config.DATA_ENV_VAR, None)
+
+    def test_notes_create_derives_title_from_first_non_empty_body_line(self):
+        fake_client = mock.Mock()
+        fake_client.create_note.return_value = {
+            "note": {"note_ref": "general-info:1"},
+            "audit_entry_id": 12,
+        }
+
+        with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+            result = self.runner.invoke(
+                app,
+                ["notes", "create", "--project", "1", "--body", "\n\n  First captured line  \nSecond line"],
+            )
+
+        self.assertEqual(result.exit_code, 0)
+        payload = fake_client.create_note.call_args.args[0]
+        self.assertEqual(payload["title"], "First captured line")
+        self.assertEqual(payload["body"], "\n\n  First captured line  \nSecond line")
+
+    def test_notes_sync_retries_queued_notes_and_marks_them_synced(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            os.environ[config.CONFIG_ENV_VAR] = tmpdir
+            os.environ[config.DATA_ENV_VAR] = tmpdir
+            try:
+                queue_store = QueueStore()
+                queued = queue_store.enqueue(
+                    project_id=1,
+                    title="Queued note",
+                    body="Queued body",
+                    tags=["cli"],
+                    captured_at="2026-03-10T10:00:00-07:00",
+                    idempotency_key="queued-note-1",
+                )
+
+                fake_client = mock.Mock()
+                fake_client.create_note.return_value = {
+                    "note": {"note_ref": "general-info:99"},
+                    "audit_entry_id": 25,
+                }
+
+                with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+                    result = self.runner.invoke(app, ["notes", "sync", "--project", "1", "--json"])
+
+                self.assertEqual(result.exit_code, 0)
+                payload = json.loads(result.stdout)
+                self.assertEqual(payload["total"], 1)
+                self.assertEqual(payload["synced"], 1)
+                self.assertEqual(payload["failed"], 0)
+                self.assertEqual(payload["results"][0]["note_ref"], "general-info:99")
+
+                synced = queue_store.get(queued.local_id)
+                self.assertEqual(synced.sync_state, "synced")
+                self.assertEqual(synced.server_note_ref, "general-info:99")
+                fake_client.create_note.assert_called_once_with(
+                    {
+                        "project": 1,
+                        "title": "Queued note",
+                        "body": "Queued body",
+                        "tags": ["cli"],
+                        "captured_at": "2026-03-10T10:00:00-07:00",
+                    },
+                    idempotency_key="queued-note-1",
+                )
+            finally:
+                os.environ.pop(config.CONFIG_ENV_VAR, None)
+                os.environ.pop(config.DATA_ENV_VAR, None)
+
+    def test_notes_list_json_outputs_server_payload(self):
+        fake_client = mock.Mock()
+        fake_client.list_notes.return_value = {
+            "project_id": 1,
+            "count": 1,
+            "limit": 20,
+            "offset": 0,
+            "results": [
+                {
+                    "note_ref": "general-info:1",
+                    "title": "CLI Note",
+                    "type": "general-info",
+                    "source": "cli",
+                }
+            ],
+        }
+        with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+            result = self.runner.invoke(app, ["notes", "list", "--project", "1", "--json"])
+
+        self.assertEqual(result.exit_code, 0)
+        payload = json.loads(result.stdout)
+        self.assertEqual(payload["results"][0]["note_ref"], "general-info:1")
+
+    def test_notes_list_passes_filters_to_api_client(self):
+        fake_client = mock.Mock()
+        fake_client.list_notes.return_value = {
+            "project_id": 1,
+            "count": 0,
+            "limit": 5,
+            "offset": 10,
+            "results": [],
+        }
+
+        with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+            result = self.runner.invoke(
+                app,
+                [
+                    "notes",
+                    "list",
+                    "--project",
+                    "1",
+                    "--limit",
+                    "5",
+                    "--offset",
+                    "10",
+                    "--type",
+                    "general-info",
+                    "--source",
+                    "cli",
+                    "--tags",
+                    "field,urgent",
+                    "--query",
+                    "terminal",
+                    "--json",
+                ],
+            )
+
+        self.assertEqual(result.exit_code, 0)
+        fake_client.list_notes.assert_called_once_with(
+            1,
+            limit=5,
+            offset=10,
+            note_type="general-info",
+            source="cli",
+            tags=["field", "urgent"],
+            query="terminal",
+        )
+
+    def test_projects_list_json_outputs_paginated_payload(self):
+        fake_client = mock.Mock()
+        fake_client.projects_list.return_value = {
+            "count": 1,
+            "limit": 20,
+            "offset": 0,
+            "results": [
+                {
+                    "id": 1,
+                    "name": "CLI Project",
+                }
+            ],
+        }
+
+        with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+            result = self.runner.invoke(app, ["projects", "list", "--json"])
+
+        self.assertEqual(result.exit_code, 0)
+        payload = json.loads(result.stdout)
+        self.assertEqual(payload["results"][0]["name"], "CLI Project")
+        fake_client.projects_list.assert_called_once_with(limit=20, offset=0, query=None)
+
+    def test_projects_show_calls_api_client(self):
+        fake_client = mock.Mock()
+        fake_client.project_show.return_value = {
+            "id": 7,
+            "name": "Hospital South Wing",
+            "counts": {"rooms": 3, "zones": 2, "ahus": 1},
+            "location": "Los Angeles",
+            "time_zone": "America/Los_Angeles",
+        }
+
+        with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+            result = self.runner.invoke(app, ["projects", "show", "7"])
+
+        self.assertEqual(result.exit_code, 0)
+        self.assertIn("Hospital South Wing", result.stdout)
+        fake_client.project_show.assert_called_once_with(7)
+
+    def test_rooms_list_passes_filters_to_api_client(self):
+        fake_client = mock.Mock()
+        fake_client.list_rooms.return_value = {
+            "project_id": 1,
+            "count": 0,
+            "limit": 5,
+            "offset": 10,
+            "results": [],
+        }
+
+        with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+            result = self.runner.invoke(
+                app,
+                [
+                    "rooms",
+                    "list",
+                    "--project",
+                    "1",
+                    "--limit",
+                    "5",
+                    "--offset",
+                    "10",
+                    "--query",
+                    "operating",
+                    "--json",
+                ],
+            )
+
+        self.assertEqual(result.exit_code, 0)
+        fake_client.list_rooms.assert_called_once_with(1, limit=5, offset=10, query="operating")
+
+    def test_calc_recalculate_stale_passes_mode_scope_and_force(self):
+        fake_client = mock.Mock()
+        fake_client.calc_recalculate_stale.return_value = {
+            "message": "Queued stale recalculation.",
+        }
+
+        with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+            result = self.runner.invoke(
+                app,
+                [
+                    "calc",
+                    "recalculate-stale",
+                    "--project",
+                    "1",
+                    "--scope",
+                    "zones",
+                    "--mode",
+                    "sync",
+                    "--force",
+                    "--json",
+                ],
+            )
+
+        self.assertEqual(result.exit_code, 0)
+        fake_client.calc_recalculate_stale.assert_called_once_with(1, scope="zones", mode="sync", force=True)
+
+    def test_design_day_run_reads_json_payload_from_file(self):
+        fake_client = mock.Mock()
+        fake_client.design_day_run.return_value = {
+            "id": 42,
+            "state": "QUEUED",
+        }
+
+        with tempfile.NamedTemporaryFile("w+", encoding="utf-8") as handle:
+            json.dump({"zones": [{"zone_id": 1}]}, handle)
+            handle.flush()
+
+            with mock.patch.object(auth, "get_authenticated_client", return_value=(fake_client, "http://localhost:8000")):
+                result = self.runner.invoke(
+                    app,
+                    ["design-day", "run", "--project", "1", "--input", handle.name, "--json"],
+                )
+
+        self.assertEqual(result.exit_code, 0)
+        fake_client.design_day_run.assert_called_once_with(1, {"zones": [{"zone_id": 1}]})

{ventilatepro_cli-0.1.0 → ventilatepro_cli-0.2.0}/ventilatepro/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"