Shellmin::StateManager

State Management System

Provides persistent key-value storage for scripts with per-server, per-module isolation. State is stored as JSON files in ~/.config/shellmin/state/ with the format: {host_name}.{module_name}.json

Features

• Per-server isolation: Each host has its own state namespace
• Per-module isolation: Each module has its own state within a host
• JSON persistence: Human-readable JSON format for state files
• Thread-safe operations: File locking prevents race conditions
• Automatic cleanup: Old state files are cleaned up periodically

Usage in Scripts

# Set a state value
shellmin state set installed_version "1.2.3"

# Get a state value
version=$(shellmin state get installed_version)

# Check if state key exists
if shellmin state has installed_version; then
  echo "Already installed version $version"
fi

# List all state keys
shellmin state list

# Remove a state key
shellmin state remove installed_version

State File Structure

{
  "installed_version": "1.2.3",
  "last_updated": "2024-01-15T10:30:00Z",
  "configuration": {
    "port": 8080,
    "ssl": true
  }
}