Added light.Toggle func and documentation for On, Off, Toggle.

2 files changed, 15 insertions, 1 deletions

diff --git a/light.go b/light.go
index 2672171..d1908e2 100644
--- a/light.go
+++ b/light.go
@@ -50,15 +50,25 @@ type LightState struct {
     XYIncrement          *[2]float32     `json:"xy_inc,omitempty"`
 }
 
+// light.TurnOff will change the light state to the "Off" mode.
 func (self *Light) TurnOff() {
     SetLightState(self, LightState{On: false})
 }
 
+// light.TurnOn will change the light state to the "On" mode.
 func (self *Light) TurnOn() {
     SetLightState(self, LightState{On: true})
 }
 
-
+// light.Toggle will change the light state to "On" if
+// the light is off or "Off" if the light is on.
+func (self *Light) Toggle() {
+    if self.State.On {
+        self.TurnOff()
+    } else {
+        self.TurnOn()
+    }
+}
 
 // SetLightState will modify light attributes such as on/off, saturation,
 // brightness, and more. See `SetLightState` struct.
diff --git a/light_test.go b/light_test.go
index c9a16a5..6c85eff 100644
--- a/light_test.go
+++ b/light_test.go
@@ -27,4 +27,8 @@ func TestSetLightState(t *testing.T) {
     selectedLight.TurnOff()
     time.Sleep(time.Second)
     selectedLight.TurnOn()
+    time.Sleep(time.Second)
+    selectedLight.Toggle()
+    time.Sleep(time.Second)
+    selectedLight.Toggle()
 }