tonylofgren/aurora-smart-home/ha-integration-dev

TIMESTAMPS: dt_util.now() / dt_util.utcnow() - NEVER datetime.now()
ATTRIBUTES: JSON-SERIALIZABLE ONLY - NO DATACLASSES, NO DATETIME OBJECTS
ASYNC: aiohttp FOR HTTP - NEVER requests
STORAGE: entry.runtime_data - NEVER hass.data[DOMAIN]

User request
    │
    ▼
Clarify: API type, auth, entities
    │
    ▼
Ask: HACS preparation?
    │
    ▼
Select template
    │
    ▼
Read relevant references
    │
    ▼
Generate integration code
    │
    ▼
Run pre-completion checklist
    │
    ├──if HACS=yes──▶ Generate HACS files ──▶ Deliver integration
    │
    └──if HACS=no───▶ Deliver integration

"""<Module purpose>.
Generated by aurora@aurora-smart-home (ha-integration-dev skill)
https://github.com/tonylofgren/aurora-smart-home
"""

custom_components/my_integration/
├── manifest.json       # Metadata, dependencies
├── __init__.py         # Setup, config entry
├── const.py            # Constants, DOMAIN
├── config_flow.py      # UI configuration
├── coordinator.py      # Data fetching (optional)
├── sensor.py           # Entity platform
├── strings.json        # UI strings
└── translations/       # Localization

my-integration/                      # Repository root
├── custom_components/
│   └── my_integration/
│       ├── manifest.json            # With documentation, issue_tracker, codeowners
│       ├── __init__.py
│       ├── const.py
│       ├── config_flow.py
│       ├── coordinator.py
│       ├── sensor.py
│       ├── strings.json
│       └── translations/
├── hacs.json                        # HACS metadata
├── README.md                        # Installation + usage docs
├── LICENSE                          # MIT license
└── .github/
    └── workflows/
        └── validate.yaml            # HACS + Hassfest CI

{
  "name": "My Integration",
  "render_readme": true,
  "homeassistant": "2024.1.0",
  "generated_with": "aurora@aurora-smart-home (ha-integration-dev skill) | https://github.com/tonylofgren/aurora-smart-home"
}

{
  "domain": "my_integration",
  "name": "My Integration",
  "version": "1.0.0",
  "documentation": "https://github.com/USERNAME/REPO",
  "issue_tracker": "https://github.com/USERNAME/REPO/issues",
  "codeowners": ["@USERNAME"],
  "config_flow": true,
  "iot_class": "cloud_polling",
  "requirements": []
}

# My Integration
 
> *Generated by [aurora@aurora-smart-home (ha-integration-dev skill)](https://github.com/tonylofgren/aurora-smart-home)*
 
[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/hacs/integration)
[![GitHub Release](https://img.shields.io/github/release/USERNAME/REPO.svg)](https://github.com/USERNAME/REPO/releases)
 
Description of the integration.
 
## Installation
 
### HACS (Recommended)
1.Open HACS → Integrations → Custom repositories
2.Add `https://github.com/USERNAME/REPO` as Integration
3.Search and install "My Integration"
4.Restart Home Assistant
 
### Manual
1.Copy `custom_components/my_integration` to your `custom_components/`
2.Restart Home Assistant
 
## Configuration
 
1.Go to Settings → Integrations
2.Click "+ Add Integration"
3.Search for "My Integration"

name: Validate
 
on:
  push:
  pull_request:
  schedule:
    - cron: "0 0 * * *"
 
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: HACS Validation
        uses: hacs/action@main
        with:
          category: integration
 
      - name: Hassfest Validation
        uses: home-assistant/actions/hassfest@master

# __init__.py
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant
DOMAIN = "my_integration"
PLATFORMS = ["sensor"]
type MyConfigEntry = ConfigEntry[MyCoordinator]  # Typed runtime_data
async def async_setup_entry(hass: HomeAssistant, entry: MyConfigEntry) -> bool:
    coordinator = MyCoordinator(hass, entry)
    await coordinator.async_config_entry_first_refresh()
    entry.runtime_data = coordinator  # Replaces hass.data[DOMAIN][entry_id]
    await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
    return True

@dataclass(frozen=True, kw_only=True)
class MySensorDescription(SensorEntityDescription):
    value_fn: Callable[[dict], StateType]

type MyConfigEntry = ConfigEntry[MyCoordinator]

hass.services.async_register(
    DOMAIN, "get_data", handler,
    supports_response=SupportsResponse.ONLY,
)

ir.async_create_issue(
    hass, DOMAIN, "auth_failed",
    is_fixable=True,
    severity=ir.IssueSeverity.ERROR,
)

from homeassistant.util import dt as dt_util