xevion/go-ha
1
0
Fork 0
mirror of https://github.com/Xevion/go-ha.git synced 2025-12-05 23:15:07 -06:00
Code Issues Packages Projects Releases Wiki Activity

refactor: make fork independent, rename PriorityQueue

Browse Source
This commit is contained in:
Xevion
2025-07-31 15:57:53 -05:00
parent f01f8dd602
commit 1226867b8e
42 changed files with 74 additions and 67 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
README.md
View File

@@ -11,7 +11,7 @@ Gome-Assistant is a new library, and I'm opening it up early to get some user fe
### Installation
```
go get saml.dev/gome-assistant
go get github.com/Xevion/gome-assistant
```
### Generate Entity Constants
@@ -22,8 +22,8 @@ You can generate type-safe constants for all your Home Assistant entities using
```yaml
url: "http://192.168.1.123:8123"
ha_auth_token: "your_auth_token" # Or set HA_AUTH_TOKEN env var
home_zone_entity_id: "zone.home" # Optional: defaults to zone.home
ha_auth_token: "your_auth_token" # Or set HA_AUTH_TOKEN env var
home_zone_entity_id: "zone.home" # Optional: defaults to zone.home
# Optional: List of domains to include when generating constants
# If provided, only these domains will be processed
@@ -37,7 +37,7 @@ exclude_domains: ["device_tracker", "person"]
2. Add a `//go:generate` comment in your project:
```go
//go:generate go run saml.dev/gome-assistant/cmd/generate
//go:generate go run github.com/Xevion/gome-assistant/cmd/generate
```
Optionally use the `-config` flag to customize the file path of the config file.
@@ -87,7 +87,7 @@ The general flow is
3. Start app
```go
import ga "saml.dev/gome-assistant"
import ga "github.com/Xevion/gome-assistant"
// replace with IP and port of your Home Assistant installation
app, err := ga.NewApp(ga.NewAppRequest{
@@ -107,7 +107,7 @@ app.RegisterIntervals(...)
app.Start()
```
A full reference is available on [pkg.go.dev](https://pkg.go.dev/saml.dev/gome-assistant), but all you need to know to get started are the four types of automations in gome-assistant.
A full reference is available on [pkg.go.dev](https://pkg.go.dev/github.com/Xevion/gome-assistant), but all you need to know to get started are the four types of automations in gome-assistant.
- [Daily Schedules](#daily-schedule)
- [Entity Listeners](#entity-listener)
@@ -205,16 +205,17 @@ app.RegisterEventListeners(eventListener)
Event listeners have other functions to change the behavior.
| Function | Info |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| OnlyBetween("03:00", "14:00") | Only run your function between two specified times of day |
| OnlyAfter("03:00") | Only run your function after a specified time of day |
| OnlyBefore("03:00") | Only run your function before a specified time of day |
| Throttle("30s") | Minimum time between function calls |
| Function | Info |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| OnlyBetween("03:00", "14:00") | Only run your function between two specified times of day |
| OnlyAfter("03:00") | Only run your function after a specified time of day |
| OnlyBefore("03:00") | Only run your function before a specified time of day |
| Throttle("30s") | Minimum time between function calls |
| ExceptionDates(time.Time, ...time.Time) | A one time exception on the given date. Time is ignored, applies to whole day. Functions like a "blocklist" |
| ExceptionRange(time.Time, time.Time) | A one time exception between the two date/times. Both date and time are considered. Functions like a "blocklist" |
The callback function receives three parameters:
```go
func myCallback(service *ga.Service, state ga.State, data ga.EventData) {
// You can unmarshal the raw JSON into a type-safe struct

8
app.go
View File

@@ -13,10 +13,10 @@ import (
"github.com/gorilla/websocket"
sunriseLib "github.com/nathan-osman/go-sunrise"
"saml.dev/gome-assistant/internal"
"saml.dev/gome-assistant/internal/http"
pq "saml.dev/gome-assistant/internal/priorityqueue"
ws "saml.dev/gome-assistant/internal/websocket"
"github.com/Xevion/gome-assistant/internal"
"github.com/Xevion/gome-assistant/internal/http"
pq "github.com/Xevion/gome-assistant/internal/priority_queue"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
var ErrInvalidArgs = errors.New("invalid arguments provided")

2
checkers.go
View File

@@ -3,8 +3,8 @@ package gomeassistant
import (
"time"
"github.com/Xevion/gome-assistant/internal"
"github.com/golang-module/carbon"
"saml.dev/gome-assistant/internal"
)
type conditionCheck struct {

2
checkers_test.go
View File

@@ -4,8 +4,8 @@ import (
"errors"
"testing"
"github.com/Xevion/gome-assistant/internal"
"github.com/stretchr/testify/assert"
"saml.dev/gome-assistant/internal"
)
type MockState struct {

2
cmd/generate/main.go
View File

@@ -9,8 +9,8 @@ import (
"strings"
"text/template"
ga "github.com/Xevion/gome-assistant"
"gopkg.in/yaml.v3"
ga "saml.dev/gome-assistant"
)
type Config struct {

2
entitylistener.go
View File

@@ -7,7 +7,7 @@ import (
"github.com/golang-module/carbon"
"saml.dev/gome-assistant/internal"
"github.com/Xevion/gome-assistant/internal"
)
type EntityListener struct {

4
eventListener.go
View File

@@ -7,8 +7,8 @@ import (
"github.com/golang-module/carbon"
"saml.dev/gome-assistant/internal"
ws "saml.dev/gome-assistant/internal/websocket"
"github.com/Xevion/gome-assistant/internal"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
type EventListener struct {

12
example/example.go
View File

@@ -8,10 +8,10 @@ import (
// "example/entities" // Optional import generated entities
ga "saml.dev/gome-assistant"
ga "github.com/Xevion/gome-assistant"
)
//go:generate go run saml.dev/gome-assistant/cmd/generate
//go:generate go run github.com/Xevion/gome-assistant/cmd/generate
func main() {
app, err := ga.NewApp(ga.NewAppRequest{
@@ -24,7 +24,13 @@ func main() {
os.Exit(1)
}
defer app.Cleanup()
defer func() {
slog.Info("Shutting down application...")
if err := app.Close(); err != nil {
slog.Error("Error during shutdown", "error", err)
}
slog.Info("Application shutdown complete")
}()
pantryDoor := ga.
NewEntityListener().

2
example/example_live_test.go
View File

@@ -11,7 +11,7 @@ import (
"github.com/stretchr/testify/suite"
"gopkg.in/yaml.v3"
ga "saml.dev/gome-assistant"
ga "github.com/Xevion/gome-assistant"
)
type (

2
example/go.mod
View File

@@ -6,7 +6,7 @@ require (
github.com/golang-cz/devslog v0.0.8
github.com/stretchr/testify v1.8.4
gopkg.in/yaml.v3 v3.0.1
saml.dev/gome-assistant v0.2.0
github.com/Xevion/gome-assistant v0.2.0
)
require (

4
example/go.sum
View File

@@ -96,5 +96,5 @@ gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
saml.dev/gome-assistant v0.2.0 h1:Clo5DrziTdsYydVUTQfroeBVmToMnNHoObr+k6HhbMY=
saml.dev/gome-assistant v0.2.0/go.mod h1:jsZUtnxANCP0zB2B7iyy4j7sZohMGop8g+5EB2MER3o=
github.com/Xevion/gome-assistant v0.2.0 h1:Clo5DrziTdsYydVUTQfroeBVmToMnNHoObr+k6HhbMY=
github.com/Xevion/gome-assistant v0.2.0/go.mod h1:jsZUtnxANCP0zB2B7iyy4j7sZohMGop8g+5EB2MER3o=

2
go.mod
View File

@@ -1,4 +1,4 @@
module saml.dev/gome-assistant
module github.com/Xevion/gome-assistant
go 1.21

2
internal/priorityqueue/priorityqueue.go → internal/priority_queue/priority_queue.go
View File

@@ -1,4 +1,4 @@
package priorityqueue
package priority_queue
import (
"container/heap"

2
internal/services/adaptive_lighting.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/alarm_control_panel.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

4
internal/services/climate.go
View File

@@ -1,8 +1,8 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
"saml.dev/gome-assistant/types"
ws "github.com/Xevion/gome-assistant/internal/websocket"
"github.com/Xevion/gome-assistant/types"
)
/* Structs */

2
internal/services/cover.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

4
internal/services/event.go
View File

@@ -1,8 +1,8 @@
package services
import (
"saml.dev/gome-assistant/internal"
ws "saml.dev/gome-assistant/internal/websocket"
"github.com/Xevion/gome-assistant/internal"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
type Event struct {

2
internal/services/homeassistant.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
type HomeAssistant struct {

2
internal/services/input_boolean.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/input_button.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/input_datetime.go
View File

@@ -4,7 +4,7 @@ import (
"fmt"
"time"
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/input_number.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/input_text.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/light.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/lock.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/media_player.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

4
internal/services/notify.go
View File

@@ -1,8 +1,8 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
"saml.dev/gome-assistant/types"
ws "github.com/Xevion/gome-assistant/internal/websocket"
"github.com/Xevion/gome-assistant/types"
)
type Notify struct {

2
internal/services/number.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
type Number struct {

2
internal/services/scene.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/script.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

4
internal/services/services.go
View File

@@ -1,8 +1,8 @@
package services
import (
"saml.dev/gome-assistant/internal"
ws "saml.dev/gome-assistant/internal/websocket"
"github.com/Xevion/gome-assistant/internal"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
func BuildService[

2
internal/services/switch.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/timer.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/tts.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/vacuum.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/services/zwavejs.go
View File

@@ -1,7 +1,7 @@
package services
import (
ws "saml.dev/gome-assistant/internal/websocket"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
/* Structs */

2
internal/websocket/websocket.go
View File

@@ -16,7 +16,7 @@ import (
"github.com/gorilla/websocket"
i "saml.dev/gome-assistant/internal"
i "github.com/Xevion/gome-assistant/internal"
)
var ErrInvalidToken = errors.New("invalid authentication token")

2
interval.go
View File

@@ -5,7 +5,7 @@ import (
"log/slog"
"time"
"saml.dev/gome-assistant/internal"
"github.com/Xevion/gome-assistant/internal"
)
type IntervalCallback func(*Service, State)

2
schedule.go
View File

@@ -5,8 +5,8 @@ import (
"log/slog"
"time"
"github.com/Xevion/gome-assistant/internal"
"github.com/golang-module/carbon"
"saml.dev/gome-assistant/internal"
)
type ScheduleCallback func(*Service, State)

4
service.go
View File

@@ -1,8 +1,8 @@
package gomeassistant
import (
"saml.dev/gome-assistant/internal/services"
ws "saml.dev/gome-assistant/internal/websocket"
"github.com/Xevion/gome-assistant/internal/services"
ws "github.com/Xevion/gome-assistant/internal/websocket"
)
type Service struct {

2
state.go
View File

@@ -8,7 +8,7 @@ import (
"github.com/golang-module/carbon"
"saml.dev/gome-assistant/internal/http"
"github.com/Xevion/gome-assistant/internal/http"
)
type State interface {