has-marstek-local-api

How to create, update, and manage Changesets for release preparation in this repository

Guidance for using correct energy and power metrics in Home Assistant energy features

High-level Home Assistant integration best practices, quality scale cues, and testing/CI expectations for custom components

Patterns for Home Assistant config flows, discovery handlers, options flows, and reauth for custom components

Project-specific patterns for the Marstek integration (config flow, coordinator, scanner, entities, translations)

Practical test/CI playbook for Home Assistant custom components (config flow, coordinator, entities, diagnostics)

Repo-specific guidance for maintaining the Marstek integration (UDP Open API, polling, discovery/scanner) in a Home Assistant-friendly way

How this integration talks to Marstek devices via the local Open API over UDP (JSON messages) and how to handle errors safely

Guide for developing and maintaining mock Marstek battery devices for local testing and devcontainer environments

Python best practices for code style, type hints, error handling, naming, documentation, and modern patterns based on PEP 8, PEP 257, PEP 20, and Google Python Style Guide

Python testing best practices covering pytest, unittest.mock, property-based testing with Hypothesis, fixtures, and mocking patterns

Guide for creating and maintaining user-facing agent skills