Metadata-Version: 2.4
Name: solentlabs-cable-modem-monitor-core
Version: 3.14.0b10
Summary: Cable Modem Monitor Core — platform-agnostic DOCSIS monitoring engine
Project-URL: Homepage, https://github.com/solentlabs/cable_modem_monitor
Project-URL: Repository, https://github.com/solentlabs/cable_modem_monitor
Project-URL: Documentation, https://github.com/solentlabs/cable_modem_monitor#readme
Project-URL: Issues, https://github.com/solentlabs/cable_modem_monitor/issues
Project-URL: Changelog, https://github.com/solentlabs/cable_modem_monitor/blob/main/CHANGELOG.md
Author: Solent Labs™
License-Expression: MIT
Keywords: cable-modem,docsis,home-assistant,monitoring,snmp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Home Automation
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: defusedxml>=0.7.1
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: requests>=2.32.3
Provides-Extra: cbn
Requires-Dist: cryptography>=44.0; extra == 'cbn'
Provides-Extra: sjcl
Requires-Dist: cryptography>=44.0; extra == 'sjcl'
Description-Content-Type: text/markdown

# Cable Modem Monitor Core

[![PyPI version](https://img.shields.io/pypi/v/solentlabs-cable-modem-monitor-core)](https://pypi.org/project/solentlabs-cable-modem-monitor-core/)
[![Downloads](https://img.shields.io/pypi/dm/solentlabs-cable-modem-monitor-core)](https://pypi.org/project/solentlabs-cable-modem-monitor-core/)
[![Python](https://img.shields.io/pypi/pyversions/solentlabs-cable-modem-monitor-core)](https://pypi.org/project/solentlabs-cable-modem-monitor-core/)
[![CI](https://github.com/solentlabs/cable_modem_monitor/actions/workflows/tests.yml/badge.svg)](https://github.com/solentlabs/cable_modem_monitor/actions/workflows/tests.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

> **Internal dependency of [Cable Modem Monitor](https://github.com/solentlabs/cable_modem_monitor).**
> Not intended for direct use — install the HA integration via [HACS](https://hacs.xyz/).

Platform-agnostic DOCSIS monitoring engine. Provides:

- **Config models** — Pydantic-validated modem configuration (auth, endpoints, parsing)
- **Auth managers** — Pluggable authentication strategies (form, basic, HNAP, PBKDF2, SJCL)
- **Parsers** — Declarative channel and system info extraction from HTML, JSON, and HNAP
- **Orchestration** — Session management, polling coordination, circuit breakers
- **Health monitoring** — ICMP ping and HTTP probes on independent cadence
- **MCP tools** — Onboarding pipeline for new modem configs from HAR captures

## Installation

This package is installed automatically as a dependency of the
[Cable Modem Monitor](https://github.com/solentlabs/cable_modem_monitor)
Home Assistant integration.

```bash
pip install solentlabs-cable-modem-monitor-core
```

## License

MIT
