home_assistant

Description:

home assistant

home_assistant #



A Dart library for interacting with Home Assistant APIs.
Introduction #
The home_assistant package provides a convenient way to interact with Home Assistant APIs from your Dart or Flutter applications. With this package, you can easily connect to your Home Assistant instance, retrieve information about entities, control devices, and perform various actions using Home Assistant services.
Features #

Connect to your Home Assistant instance with an API token.
Verify the Home Assistant API's status.
Fetch information about entities and their states.
Control devices and entities.
Access Home Assistant services programmatically.

Installation #
To use this package, add home_assistant as a dependency in your pubspec.yaml file.
dependencies:
home_assistant: ^1.0.0 # Use the latest version from pub.dev
copied to clipboard
Then, import the library in your Dart code:
import 'package:home_assistant/home_assistant.dart';
copied to clipboard
Getting Started #
Here's how to get started with the home_assistant package:
// Initialize the Home Assistant instance.
final homeAssistant = HomeAssistant(
baseUrl: 'https://your-home-assistant-url.com',
bearerToken: 'your-api-token',
);

// Verify if the Home Assistant API is working.
final isApiWorking = await homeAssistant.verifyApiIsWorking();
if (isApiWorking) {
print('Home Assistant API is working.');
} else {
print('Home Assistant API is not working.');
}

// Fetch a list of entities.
final entities = await homeAssistant.fetchStates();
print('Entities: $entities');

// Control a switch.
try {
await homeAssistant.turnOnSwitch('switch.entity_id');
print('Switch turned on.');
} catch (e) {
print('Failed to turn on the switch: $e');
}
copied to clipboard
For more detailed usage and examples, please refer to the documentation.
Contributing #
We welcome contributions! If you find a bug or have a feature request, please open an issue on GitHub. If you want to contribute code, please fork the repository and submit a pull request.