Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

feat(cli): Add control commands (set temperature, on/off, speed)

Aperta
  • Qualcosa non va?
#145 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
python
Ambito
cli

Direzione di ricerca

Inizia dal punto di ingresso della CLI, dove OmniLogic viene istanziato e viene chiamato refresh(), e confronta il gruppo set proposto con il gruppo get esistente. Segui le primitive della libreria elencate e la ricerca delle apparecchiature tramite omni.backyard.bow. Il lavoro è completo quando i comandi proposti per riscaldamento, solare, apparecchiature, velocità e luci invocano i controlli corrispondenti con gli argomenti documentati.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

The CLI currently only exposes read-only commands (get and debug subgroups). The library itself fully supports equipment control via methods like heater.set_temperature(), pump.set_speed(), light.turn_on(), etc., but there is no way to invoke these operations from the command line.

Motivation

Users who want to script pool control (e.g., cron jobs, home automation integrations, or wrapping the CLI in an HTTP API) currently have to write Python code using the library directly. Adding a set command group to the CLI would make equipment control accessible without any custom code.

Use cases
  • Scripting: omnilogic --host 192.168.1.100 set heater-temp 1 4 82 to set pool heater to 82°F from a shell script
  • HTTP wrappers: Lightweight API services that shell out to the CLI for control commands
  • Debugging/testing: Quickly toggle equipment during development without writing async Python

Proposed CLI interface

# Heater temperature control
omnilogic set heater-temp <bow_id> <equip_id> <temperature>
omnilogic set solar-temp <bow_id> <equip_id> <temperature>

# Equipment on/off
omnilogic set equipment-on <bow_id> <equip_id>
omnilogic set equipment-off <bow_id> <equip_id>

# Pump/filter speed
omnilogic set speed <bow_id> <equip_id> <percent>

# Light control
omnilogic set light-show <bow_id> <equip_id> <show_id> [--brightness N] [--speed N]

Implementation notes

  • The high-level library already has all the primitives: heater.set_temperature(), pump.set_speed(), light.turn_on(), light.set_show(), etc.
  • The CLI already instantiates OmniLogic and calls refresh() in the entrypoint, so adding a set command group would follow the same pattern as the existing get group.
  • Equipment lookup by bow_id/system_id can use omni.backyard.bow and iterate equipment collections.

Context

I ran into this gap while building a containerized HTTP API wrapper for my OmniLogic system. I ended up importing pyomnilogic_local directly to get temperature control since the CLI had no way to set heater temperatures. Happy to contribute a PR if this aligns with the project direction.

Lingua principale
Python
Stelle
10
Fork
13
Merge medio
5m
PR unite (30g)
2

Preparare l'ambiente

  • Include un Dockerfile o un file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di cryptk/python-omnilogic-local

Tutte le issue di cryptk/python-omnilogic-local

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.