Files
LEDMatrix/test/web_interface/integration/test_plugin_operations.py
ChuckandClaude Opus 5.5 b09434a418 refactor(plugins): the display publishes plugin runtime state; retire plugin_state.json (#690)
Stage 2 of the web plugin catalog, after #688.

- The display publishes a plugin runtime snapshot (plugin_runtime.py) to
  the shared cache: per plugin loaded, lifecycle state, a short redacted
  error summary, the version it loaded and when, plus published_at /
  stale_after / running. Written on change (throttled to 10 s; the
  RUNNING/ENABLED flip of an ordinary update is not a change) and once a
  minute otherwise; cleanup() publishes running: false.
- The web reads it back and restores loaded / state / error_info in
  /api/v3/plugins/installed (plus loaded_version, loaded_at and
  data.runtime). Only a live snapshot counts; stale, stopped or missing
  answers null and says which.
- data/plugin_state.json is retired: every reader and writer moved to
  config + disk (desired) or the snapshot (observed). Nothing in it was
  non-derivable, so nothing is migrated and an existing file is left
  unread. The web-side PluginStateManager (state_manager.py) is removed;
  the display's plugin_state.PluginStateManager is the only state machine.
- StateReconciliation compares config + disk with the snapshot, reporting
  enabled-but-not-loaded and older-version-loaded as no_action findings.
- Backups list installed manifests with enabled from config.json.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 10:48:14 -04:00

178 lines
6.0 KiB
Python

"""
Integration tests for plugin operations (install, update, uninstall).
"""
import unittest
import tempfile
import shutil
from pathlib import Path
from src.plugin_system.operation_queue import PluginOperationQueue
from src.plugin_system.operation_types import OperationType
from src.plugin_system.operation_history import OperationHistory
class TestPluginOperationsIntegration(unittest.TestCase):
"""Integration tests for plugin operations."""
def setUp(self):
"""Set up test fixtures."""
self.temp_dir = Path(tempfile.mkdtemp())
# Initialize components
self.operation_queue = PluginOperationQueue(max_history=100)
# No state manager: installed / enabled / version are read from disk
# and config.json, not from a plugin_state.json record.
self.operation_history = OperationHistory(
history_file=str(self.temp_dir / "history.json"),
max_records=100
)
def tearDown(self):
"""Clean up test fixtures."""
self.operation_queue.shutdown()
shutil.rmtree(self.temp_dir)
def test_install_operation_flow(self):
"""Test complete install operation flow."""
plugin_id = "test-plugin"
# Enqueue install operation
operation_id = self.operation_queue.enqueue_operation(
OperationType.INSTALL,
plugin_id,
{"version": "1.0.0"}
)
self.assertIsNotNone(operation_id)
# Get operation status
operation = self.operation_queue.get_operation_status(operation_id)
self.assertEqual(operation.operation_type, OperationType.INSTALL)
self.assertEqual(operation.plugin_id, plugin_id)
# Record in history
history_id = self.operation_history.record_operation(
operation_type="install",
plugin_id=plugin_id,
status="in_progress",
operation_id=operation_id
)
self.assertIsNotNone(history_id)
# Verify history
history = self.operation_history.get_history(plugin_id=plugin_id)
self.assertEqual([r.operation_type for r in history], ["install"])
def test_update_operation_flow(self):
"""Test complete update operation flow."""
plugin_id = "test-plugin"
# Enqueue update operation
operation_id = self.operation_queue.enqueue_operation(
OperationType.UPDATE,
plugin_id,
{"from_version": "1.0.0", "to_version": "2.0.0"}
)
self.assertIsNotNone(operation_id)
# Record in history
self.operation_history.record_operation(
operation_type="update",
plugin_id=plugin_id,
status="in_progress",
operation_id=operation_id
)
# Verify history
history = self.operation_history.get_history(plugin_id=plugin_id)
self.assertEqual([r.operation_type for r in history], ["update"])
def test_uninstall_operation_flow(self):
"""Test complete uninstall operation flow."""
plugin_id = "test-plugin"
# Enqueue uninstall operation
operation_id = self.operation_queue.enqueue_operation(
OperationType.UNINSTALL,
plugin_id
)
self.assertIsNotNone(operation_id)
# Record in history
self.operation_history.record_operation(
operation_type="uninstall",
plugin_id=plugin_id,
status="in_progress",
operation_id=operation_id
)
# Verify history
history = self.operation_history.get_history(plugin_id=plugin_id)
self.assertEqual([r.operation_type for r in history], ["uninstall"])
def test_operation_history_tracking(self):
"""Test that operations are tracked in history."""
plugin_id = "test-plugin"
# Perform multiple operations
operations = [
("install", "1.0.0"),
("update", "2.0.0"),
("uninstall", None)
]
for op_type, version in operations:
history_id = self.operation_history.record_operation(
operation_type=op_type,
plugin_id=plugin_id,
status="completed"
)
self.assertIsNotNone(history_id)
# Get history
history = self.operation_history.get_history(limit=10, plugin_id=plugin_id)
# Verify all operations recorded
self.assertEqual(len(history), 3)
self.assertEqual(history[0].operation_type, "uninstall")
self.assertEqual(history[1].operation_type, "update")
self.assertEqual(history[2].operation_type, "install")
def test_concurrent_operation_prevention(self):
"""Test that concurrent operations on same plugin are prevented."""
plugin_id = "test-plugin"
# Enqueue first operation
op1_id = self.operation_queue.enqueue_operation(
OperationType.INSTALL,
plugin_id
)
# Get the operation to check its status
op1 = self.operation_queue.get_operation_status(op1_id)
self.assertIsNotNone(op1)
# Try to enqueue second operation
# Note: If the first operation completes quickly, it may not raise an error
# The prevention only works for truly concurrent (pending/running) operations
try:
op2_id = self.operation_queue.enqueue_operation(
OperationType.UPDATE,
plugin_id
)
# If no exception, the first operation may have completed already
# This is acceptable - the mechanism prevents truly concurrent operations
except ValueError as e:
# Expected behavior when first operation is still pending/running
self.assertIn("already has an active operation", str(e))
if __name__ == '__main__':
unittest.main()