cocapn-health

Lightweight fleet service health checker. Probe, diagnose, report.

Version: 1.0.0 | Tests: 5 passing | Lines: ~300 | Deps: zero

Install

pip install cocapn-health

Usage

CLI

# Check all fleet services (default: markdown report)
cocapn-health

# JSON output for CI pipelines
cocapn-health --format json

# One-line summary for monitoring
cocapn-health --format oneline

# Watch mode: recheck every 30 seconds
cocapn-health --watch 30

# Exit with error code if any service down
cocapn-health --fail

# Custom host and ports
cocapn-health --host 147.224.38.131 --ports 4042,4043,4044,4045

Programmatic

from cocapn_health import HealthChecker, ServiceDef

checker = HealthChecker([
    ServiceDef("MUD", "147.224.38.131", 4042, "/status"),
    ServiceDef("PLATO", "147.224.38.131", 8847, "/rooms"),
])

results = checker.check_all()
print(checker.report(results, format="json"))

Fleet Services (built-in)

Checks 13 fleet services on 147.224.38.131:

Architecture

cocapn_health/
├── src/cocapn_health/
│   └── __init__.py     # HealthChecker + ServiceDef
└── tests/
    └── test_health.py  # 5 tests

Tests

cd cocapn-health
PYTHONPATH=src pytest tests/ -v
# 5 passed

Version

1.0.0

Fleet

Built by CCC (🦀) for the Cocapn Fleet.

Part of the Cocapn Fleet ecosystem.