Feature 21 add toggle method

README.md

@@ -91,6 +91,12 @@ Disables your app from auto-launching at startup. Returns a Promise.
 Returns a Promise which resolves to a Boolean; `true` if your app is set to launch on startup.
 
 
+### `.toggle(value)`
+
+**`value`** - (Optional) Boolean
+
+Toggles the auto-launch to the desired state. If value is not specified it will be toggled to the inverted state.
+
 ## How does it work?
 
 ### Linux / FreeBSD

src/index.coffee

@@ -56,6 +56,19 @@ module.exports = class AutoLaunch
     isEnabled: => @api.isEnabled @opts.appName, @opts.mac
 
 
+    toggle: (value = undefined) =>
+        return @isEnabled(@opts.appName).then (isEnabled) =>
+            if isEnabled and (value == false or value == undefined)
+                # If auto launch is enabled and we want to disable it
+                return @disable(@opts.appName)
+            else if !isEnabled and (value == true or value == undefined)
+                # If auto launch is disabled and we want to enable it
+                return @enable(@opts)
+            else
+                # If the value is already what we want, return the current state
+                return isEnabled
+
+
     ### Private ###
 
 
@@ -115,4 +128,4 @@ module.exports = class AutoLaunch
             @opts.appName = tempPath[tempPath.length - 1]
             # Remove ".app" from the appName if it exists
             if @opts.appName.indexOf('.app', @opts.appName.length - '.app'.length) isnt -1
-                @opts.appName = @opts.appName.substr(0, @opts.appName.length - '.app'.length)
+                @opts.appName = @opts.appName.substr(0, @opts.appName.length - '.app'.length)

tests/index.coffee

@@ -94,6 +94,77 @@ describe 'node-auto-launch', ->
             autoLaunch.disable().catch done
             return
 
+    describe '.toggle', ->
+        beforeEach ->
+            autoLaunchHelper.ensureDisabled()
+
+        it 'should enable auto launch', (done) ->
+            autoLaunch.toggle(true)
+            .then () ->
+                autoLaunch.isEnabled()
+            .then (enabled) ->
+                expect(enabled).to.equal true
+                done()
+            .catch done
+            return
+
+        it 'should disable auto launch', (done) ->
+            before ->
+                autoLaunchHelper.ensureEnabled()
+            autoLaunch.toggle(false)
+            .then () ->
+                autoLaunch.isEnabled()
+            .then (enabled) ->
+                expect(enabled).to.equal false
+                done()
+            .catch done
+            return
+
+        it 'should toggle auto launch', (done) ->
+            autoLaunch.toggle()
+            .then () ->
+                autoLaunch.isEnabled()
+            .then (enabled) ->
+                expect(enabled).to.equal true
+                return autoLaunch.toggle()
+            .then () ->
+                autoLaunch.isEnabled()
+            .then (enabled) ->
+                expect(enabled).to.equal false
+                done()
+            .catch done
+            return
+
+        it 'should do nothing if already enabled', (done) ->
+            autoLaunchHelper.ensureEnabled()
+            autoLaunch.toggle(true)
+            .then () ->
+                autoLaunch.isEnabled()
+            .then (enabled) ->
+                expect(enabled).to.equal true
+                done()
+            .catch done
+            return
+
+        it 'should do nothing if already disabled', (done) ->
+            autoLaunchHelper.ensureDisabled()
+            autoLaunch.toggle(false)
+            .then () ->
+                autoLaunch.isEnabled()
+            .then (enabled) ->
+                expect(enabled).to.equal false
+                done()
+            .catch done
+            return
+
+        it 'should catch errors', (done) ->
+            autoLaunchHelper.mockApi
+                disable: ->
+                    Promise.reject()
+
+            autoLaunch.disable().catch done
+            return
+
     return unless followsXDG
 
     describe 'testing .appName', ->