akaer 0.3.0 → 1.0.0

data/.travis.yml

@@ -1,5 +1,8 @@
+language: ruby
 rvm:
   - 1.8.7
   - 1.9.2
   - 1.9.3
 script: bundle exec rake spec:coverage
+notifications:
+  email: false

data/Gemfile.lock

@@ -1,51 +1,48 @@
 PATH
   remote: .
   specs:
-    akaer (0.3.0)
-      cowtech-extensions (~> 2.7.0)
-      cowtech-lib (~> 2.0.0)
-      hashie (~> 1.2.0)
-      rainbow (~> 1.1.0)
+    akaer (1.0.0)
+      bovem (>= 0.5.0)
+      gli (~> 1.6.0)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    actionpack (3.2.6)
-      activemodel (= 3.2.6)
-      activesupport (= 3.2.6)
+    actionpack (3.2.7)
+      activemodel (= 3.2.7)
+      activesupport (= 3.2.7)
       builder (~> 3.0.0)
       erubis (~> 2.7.0)
-      journey (~> 1.0.1)
+      journey (~> 1.0.4)
       rack (~> 1.4.0)
       rack-cache (~> 1.2)
       rack-test (~> 0.6.1)
       sprockets (~> 2.1.3)
-    activemodel (3.2.6)
-      activesupport (= 3.2.6)
+    activemodel (3.2.7)
+      activesupport (= 3.2.7)
       builder (~> 3.0.0)
-    activesupport (3.2.6)
+    activesupport (3.2.7)
       i18n (~> 0.6)
       multi_json (~> 1.0)
+    bovem (0.6.0)
+      lazier (~> 1.0)
+      rainbow (~> 1.1.0)
     builder (3.0.0)
     coderay (1.0.7)
-    cowtech-extensions (2.7.1)
-      actionpack (~> 3.0)
-      json (~> 1.7.0)
-      tzinfo (~> 0.3.0)
-    cowtech-lib (2.0.2)
-      open4
     diff-lcs (1.1.3)
     erubis (2.7.0)
     github-markup (0.7.2)
-    hashie (1.2.0)
+    gli (1.6.0)
     hike (1.2.1)
     i18n (0.6.0)
     journey (1.0.4)
-    json (1.7.3)
+    json (1.7.4)
+    lazier (1.0.1)
+      actionpack (~> 3.0)
+      json (~> 1.7.0)
+      tzinfo (~> 0.3.0)
     method_source (0.8)
     multi_json (1.3.6)
-    net-dns (0.7.1)
-    open4 (1.3.0)
     pry (0.9.10)
       coderay (~> 1.0.5)
       method_source (~> 0.8)
@@ -85,8 +82,7 @@ PLATFORMS
 DEPENDENCIES
   akaer!
   github-markup (~> 0.7.0)
-  net-dns (~> 0.7.0)
-  pry (~> 0.9.10)
+  pry
   rake (~> 0.9.0)
   redcarpet (~> 2.1.0)
   rspec (~> 2.11.0)

data/README.md

@@ -4,21 +4,26 @@
 [![Dependency Status](https://gemnasium.com/ShogunPanda/akaer.png?travis)](https://gemnasium.com/ShogunPanda/akaer)
 
 A small utility to add aliases to network interfaces.
+
 http://github.com/ShogunPanda/akaer
 
 ## Description
 
-Akaer is a small utility that adds and remove aliases to your network interfaces. This is useful in web development.
+Akaer is a small utility that adds and removes aliases to your network interfaces. This is useful in web development.
 
 ## Basic usage
 
 1. Install the gem:
 
-	`gem install akaer`
+ 	```sh
+	gem install akaer
+	```
 
 2. Run the application:
 
-	`akaer`
+	```sh
+	akaer
+ 	```
 
 **You're done!**
 
@@ -33,23 +38,23 @@ By defaults, Akaer uses a configuration file in `~/.akaer_config`, but you can c
 The file is a plain Ruby file with a single `config` object that supports the following directives.
 
 * `interface`: The network interface to manage. `lo0` by default.
-* `address`: A specific list of aliases to manage.
-* `start-address`: The address to start sequential address. `10.0.0.1` by default. Not used if `addresses` is specified.
+* `addresses`: A specific list of aliases to manage.
+* `start_address`: The address to start sequential address. `10.0.0.1` by default. Not used if `addresses` is specified.
 * `aliases`: The number of sequential addresses to add. 5 by default.
+* `add_command`: The command to run for adding an alias. `sudo ifconfig @INTERFACE@ alias @ALIAS@` by default.
+* `remove_command`: The command to run for removing an alias. `sudo ifconfig @INTERFACE@ -alias @ALIAS@` by default.
 * `log_file`: The default log file. By default it logs to standard output.
 * `log_level`: The default log level. Valid values are from 0 to 5 where 0 means "all messages".
-
-## Remarks
-
-Akaer is tightly coupled with the UNIX tools, so it won't work for Windows.
+* `dry_run`: Only show which modifications will be done.
+* `quiet`: Do not show any message.
 
 ## Contributing to akaer
 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
-* Fork the project
-* Start a feature/bugfix branch
-* Commit and push until you are happy with your contribution
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
 * Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
 * Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
 

data/akaer.gemspec

@@ -21,16 +21,13 @@ Gem::Specification.new do |gem|
   gem.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   gem.require_paths = ["lib"]
 
-  gem.add_dependency("cowtech-extensions", "~> 2.7.0")
-  gem.add_dependency("cowtech-lib", "~> 2.0.0")
-  gem.add_dependency("hashie", "~> 1.2.0")
-  gem.add_dependency("rainbow", "~> 1.1.0")
+  gem.add_dependency("bovem", ">= 0.5.0")
+  gem.add_dependency("gli", "~> 1.6.0")
 
   gem.add_development_dependency("rspec", "~> 2.11.0")
   gem.add_development_dependency("rake", "~> 0.9.0")
   gem.add_development_dependency("simplecov", "~> 0.6.0")
-  gem.add_development_dependency("pry", "~> 0.9.10")
-  gem.add_development_dependency("net-dns", "~> 0.7.0")
+  gem.add_development_dependency("pry", ">= 0")
   gem.add_development_dependency("yard", "~> 0.8.0")
   gem.add_development_dependency("redcarpet", "~> 2.1.0")
   gem.add_development_dependency("github-markup", "~> 0.7.0")

data/bin/akaer

@@ -6,4 +6,86 @@
 
 require "rubygems"
 require "akaer"
-Akaer::Application.start
+require "gli"
+
+include GLI
+
+program_desc("A small utility to add aliases to network interfaces.")
+version(Akaer::Version::STRING)
+
+desc("The default interface to manage.")
+default_value("lo0")
+arg_name("INTERFACE")
+flag(:i, :interface)
+
+desc("The default list of aliases to add.")
+default_value([])
+arg_name("ADDRESSES")
+flag(:A, :addresses)
+
+desc("The starting address for sequential aliases.")
+default_value("10.0.0.1")
+arg_name("ADDRESS")
+flag(:s, :"start-address")
+
+desc("The number of aliases to add.")
+default_value(5)
+arg_name("ALIASES")
+flag(:S, :aliases)
+
+desc("The command to run for adding an alias.")
+default_value("sudo ifconfig @INTERFACE@ alias @ALIAS@")
+arg_name("COMMAND")
+flag(:c, :"add-command")
+
+desc("The command to run for adding an alias.")
+default_value("sudo ifconfig @INTERFACE@ -alias @ALIAS@")
+arg_name("COMMAND")
+flag(:C, :"remove-command")
+
+desc("The default log file.")
+default_value("STDOUT")
+arg_name("LOG")
+flag([:l, :log])
+
+desc("The default log level. Valid values are from 0 to 5 where 0 means \"all messages\".")
+default_value(1)
+arg_name("LEVEL")
+flag([:L, :"log-level"])
+
+desc("Only show which modifications will be done")
+switch([:n, :"dry-run"])
+
+desc("Do not show any message.")
+switch([:q, :quiet])
+
+desc("Add aliases.")
+command [:a, :add] do |c|
+  c.action do |globals, locals, args|
+    Akaer::Application.instance(globals, locals, args).action_add()
+  end
+end
+
+desc("Remove aliases.")
+command [:r, :remove] do |c|
+  c.action do |globals, locals, args|
+    Akaer::Application.instance(globals, locals, args).action_remove()
+  end
+end
+
+desc("Install the application for autolaunch.")
+command [:i, :install] do |c|
+  c.action do |globals, locals, args|
+    Akaer::Application.instance(globals, locals, args).action_install()
+  end
+end
+
+desc("Uninstall the application from autolaunch.")
+command [:u, :uninstall] do |c|
+  c.action do |globals, locals, args|
+    Akaer::Application.instance(globals, locals, args).action_uninstall()
+  end
+end
+
+ARGV << "help" if ARGV.length == 0
+exit(GLI.run(ARGV))

data/lib/akaer.rb

@@ -4,16 +4,9 @@
 # Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
 #
 
-require "cowtech-extensions"
-require "cowtech-lib"
+require "bovem"
 require "ipaddr"
-require "hashie"
-require "rainbow"
-require "pathname"
 
 require "akaer/version" if !defined?(Akaer::Version)
-require "akaer/errors"
-require "akaer/logger"
 require "akaer/configuration"
-require "akaer/application"
-
+require "akaer/application"

data/lib/akaer/application.rb

@@ -4,104 +4,312 @@
 # Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
 #
 
-require "cowtech-lib"
-require "ipaddr"
+# A small utility to add aliases to network interfaces.
+module Akaer
+  # The main Akaer application.
+  class Application
+    # The {Configuration Configuration} of this application.
+    attr_reader :config
 
-class Fixnum
-  def i(num = 3)
-    self.to_s.rjust(num, "0")
-  end
-end
+    # The arguments passed via command-line.
+    attr_reader :args
 
-module Akaer
-  class Application < Cowtech::Lib::Script
-    def self.start
-      self.new
+    # The logger for this application.
+    attr_accessor :logger
+
+    # Creates a new application.
+    #
+    # @param globals [Hash] Global options.
+    # @param locals [Hash] Local command options.
+    # @param args [Array] Extra arguments.
+    def initialize(globals = {}, locals = {}, args = [])
+      @args = {
+        :global => globals,
+        :local => locals,
+        :args => args
+      }
+
+      # Setup logger
+      Bovem::Logger.start_time = Time.now
+      @logger = Bovem::Logger.create(Bovem::Logger.get_real_file(@args[:global][:log_file]) || Bovem::Logger.default_file, Logger::INFO)
+
+      # Open configuration
+      begin
+        overrides = {
+          :interface => @args[:global][:interface],
+          :addresses => @args[:global][:addresses],
+          :start_address => @args[:global][:"start-address"],
+          :aliases => @args[:global][:aliases],
+          :add_command => @args[:global][:"add-command"],
+          :remove_command => @args[:global][:"remove-command"],
+          :log_file => @args[:global][:"log-file"],
+          :log_level => @args[:global][:"log-level"],
+          :dry_run => @args[:global][:"dry-run"],
+          :quiet => @args[:global][:quiet]
+        }.reject {|k,v| v.nil? }
+
+        @config = Akaer::Configuration.new(@args[:global][:config], overrides, @logger)
+
+        @logger = nil
+        @logger = self.get_logger
+      rescue Bovem::Errors::InvalidConfiguration => e
+        @logger ? @logger.fatal(e.message) : Bovem::Logger.create("STDERR").fatal("Cannot log to #{config.log_file}. Exiting...")
+        raise ::SystemExit
+      end
+
+      self
     end
 
-    def initialize
-      super(:args => {:name => "Interface aliases", :version => 1.0, :description => "A small utility to add aliases to network interfaces.", :usage => "Usage: #{ARGV[0]} [OPTIONS] [add|remove]"})
+    # Checks if we are running on MacOS X.
+    # System services are only available on that platform.
+    #
+    # @return [Boolean] `true` if the current platform is MacOS X, `false` otherwise.
+    def is_osx?
+      ::Config::CONFIG['host_os'] =~ /^darwin/
     end
 
-    def add_options
-      @options_parser << [
-        {:name => "configuration", :short => "-c", :long => "--configuration", :type => :string, :help => "Configuration file. By default is the standard output", :meta => "FILE", :required => false, :default => "~/.akaer_config"},
-        {:name => "interface", :short => "-i", :long => "--interface", :type => :string, :help => "Interface", :meta => "INTERFACE", :required => false, :default => "lo0"},
-        {:name => "addresses", :short => "-A", :long => "--addresses", :type => :list, :help => "Addresses to add", :required => false, :default => []},
-        {:name => "start-address", :short => "-s", :long => "--start-address", :type => :string, :help => "Starting address (not used if --addresses is specified).", :meta => "ADDRESS", :required => false, :default => "10.0.0.1"},
-        {:name => "aliases", :short => "-S", :long => "--aliases", :type => :int, :help => "Number of aliases to add", :meta => "NUMBER", :required => false, :default => 5},
-        {:name => "log-file", :short => "-l", :long => "--log-file", :type => :string, :help => "Log file. By default is the standard output", :meta => "FILE", :required => false, :default => "STDOUT"},
-        {:name => "log-level", :short => "-L", :long => "--log-level", :type => :int, :help => "The default log level. Valid values are from 0 to 5 where 0 means \"all messages\".", :meta => "NUMBER", :required => false, :default => Logger::INFO},
-        {:name => "dry-run", :short => "-n", :long => "--dry-run", :type => :bool, :help => "Do not really execute actions."},
-        {:name => "quiet", :short => "-q", :long => "--quiet", :type => :bool, :help => "Do not show any message", :required => false, :default => false}
-      ]
+    # Checks if and address is a valid IPv4 address.
+    #
+    # @param address [String] The address to check.
+    # @return [Boolean] `true` if the address is a valid IPv4 address, `false` otherwise.
+    def is_ipv4?(address)
+      address = address.ensure_string
+
+      mo = /\A(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})\Z/.match(address)
+      rv = (mo && mo.captures.all? {|i| i.to_i < 256}) ? true : false
     end
 
-    def execute_command(interface, action, ip, prefix = "")
-      prefix += " " if !prefix.blank?
-      @logger.info("#{prefix}#{(action == "add" ? "Adding" : "Removing").bright} alias #{ip.bright} #{action == "add" ? "to" : "from"} interface #{interface.bright}.")
-      system("sudo ifconfig #{interface} #{action == "add" ? "alias" : "-alias"} #{ip}")
+    # Checks if and address is a valid IPv4 address.
+    #
+    # @param address [String] The address to check.
+    # @return [Boolean] `true` if the address is a valid IPv4 address, `false` otherwise.
+    def is_ipv6?(address)
+      address = address.ensure_string
+
+      rv = catch(:valid) do
+        # IPv6 (normal)
+        throw(:valid, true) if /\A[\dA-Fa-f]{1,4}(:[\dA-Fa-f]{1,4})*\Z/ =~ address
+        throw(:valid, true) if /\A[\dA-Fa-f]{1,4}(:[\dA-Fa-f]{1,4})*::([\dA-Fa-f]{1,4}(:[\dA-Fa-f]{1,4})*)?\Z/ =~ address
+        throw(:valid, true) if /\A::([\dA-Fa-f]{1,4}(:[\dA-Fa-f]{1,4})*)?\Z/ =~ address
+        # IPv6 (IPv4 compat)
+        throw(:valid, true) if /\A[\dA-Fa-f]{1,4}(:[\dA-Fa-f]{1,4})*:/ =~ address && self.is_ipv4?($')
+        throw(:valid, true) if /\A[\dA-Fa-f]{1,4}(:[\dA-Fa-f]{1,4})*::([\dA-Fa-f]{1,4}(:[\dA-Fa-f]{1,4})*:)?/ =~ address && self.is_ipv4?($')
+        throw(:valid, true) if /\A::([\dA-Fa-f]{1,4}(:[\dA-Fa-f]{1,4})*:)?/ =~ address && self.is_ipv4?($')
+
+        false
+      end
     end
 
-    def run
-      @logger = Akaer::Logger.create(@options_parser["log-file"], @options_parser["log-level"])
 
-      command = (@options_parser.args[0] || "add").downcase
-      aliases = []
-      target_address = ""
+    # Pads a number to make it print friendly.
+    #
+    # @param num [Fixnum] The number to pad.
+    # @param len [Fixnum] The minimum length of the padded string.
+    # @return [String] The padded number.
+    def pad_number(num, len = nil)
+      num.to_integer.to_s.rjust([len.to_integer, 2].max, "0")
+    end
 
-      # Parse configuration file
-      configuration = Akaer::Configuration.load(@options_parser["configuration"], @logger)
+    # Gets the current logger of the application.
+    #
+    # @return [Logger] The current logger of the application.
+    def get_logger
+      @logger ||= Bovem::Logger.create(Bovem::Logger.default_file, @config.log_level, @log_formatter)
+    end
 
-      # Now merge with the options
-      @options_parser[].each_pair do |option, value|
-        key = option.to_s.gsub("-", "_")
-        configuration[key] = value if configuration.has_key?(key) && @options_parser.provided?(option)
-      end
+    # Gets the path for the launch agent file.
+    #
+    # @param name [String] The base name for the agent.
+    # @return [String] The path for the launch agent file.
+    def launch_agent_path(name = "it.cowtech.akaer")
+      ENV["HOME"] + "/Library/LaunchAgents/#{name}.plist"
+    end
 
-      # Instantiate the logger
-      logger = Akaer::Logger.create(configuration.log_file, configuration.log_level)
+    # Executes a shell command.
+    #
+    # @param command [String] The command to execute.
+    # @return [Boolean] `true` if command succeeded, `false` otherwise.
+    def execute_command(command)
+      Kernel.system(command)
+    end
 
-      # Create address
-      if !["add", "remove"].include?(command) then
-        @logger.fatal("\"Please choose an action between \"add\" or \"remove\".")
-        abort
-      end
+    # Computes the list of address to manage.
+    #
+    # @param type [Symbol] The type of addresses to consider. Valid values are `:ipv4`, `:ipv6`, otherwise all addresses are considered.
+    # @return [Array] The list of addresses to add or remove from the interface.
+    def compute_addresses(type = :all)
+      rv = []
 
-      begin
-        if configuration.addresses.blank? then
-          target_address = configuration.start_address
-          temp = IPAddr.new(target_address)
-
-          [configuration.aliases, 1].max.times do
-            aliases << temp.to_s
-            temp = temp.succ
-            target_address = temp.to_s
-          end
-        else
-          configuration.addresses.each do |t|
-            target_address = t
-            aliases << IPAddr.new(target_address)
+      if self.config.addresses.present? # We have an explicit list
+        rv = self.config.addresses
+
+        # Now filter the addresses
+        filters = [type != :ipv6 ? :ipv4 : nil, type != :ipv4 ? :ipv6 : nil].compact
+        rv = rv.select {|address|
+          filters.any? {|filter| self.send("is_#{filter}?", address) }
+        }.compact.uniq
+      else
+        begin
+          ip = IPAddr.new(self.config.start_address.ensure_string)
+          raise ArgumentError if (type == :ipv4 && !ip.ipv4?) || (type == :ipv6 && !ip.ipv6?)
+
+          (self.config.aliases > 0 ? self.config.aliases : 5).times do
+            rv << ip.to_s
+            ip = ip.succ
           end
+        rescue ArgumentError
         end
-      rescue ArgumentError => e
-        logger.fatal("\"#{target_address}\" is not a valid IP address.")
-        abort
       end
 
-      if !@options_parser["dry-run"] then
-        total = aliases.length
-        rj = total.to_s.length
-        aliases.each_with_index do |a, i|
-          prefix = "[#{(i + 1).to_s.rjust(rj, "0")}/#{total}]"
-          if !self.execute_command(configuration.interface, command, a, prefix) then
-            logger.fatal("#{command == "add" ? "Adding" : "Removing"} alias #{a} failed.")
-            abort
-          end
-        end
+      rv
+    end
+
+    # Adds or removes an alias from the interface
+    #
+    # @param type [Symbol] The operation to execute. Can be `:add` or `:remove`.
+    # @param address [String] The address to manage.
+    # @return [Boolean] `true` if operation succedeed, `false` otherwise.
+    def manage(type, address)
+      rv = true
+
+      # Compute the command
+      command = (type == :remove) ? self.config.remove_command : self.config.add_command
+
+      # Interpolate
+      command = command.gsub("@INTERFACE@", self.config.interface).gsub("@ALIAS@", address) + " > /dev/null 2>&1"
+
+      # Compute the prefix
+      @addresses ||= self.compute_addresses
+      length = self.pad_number(@addresses.length)
+      index = (@addresses.index(address) || 0) + 1
+      prefix = ["[".color(:cyan), self.pad_number(index, length.length).bright, "/".color(:cyan), length.bright, "]".color(:cyan)].join("")
+
+      # Now execute
+      if !self.config.dry_run then
+        @logger.info("#{prefix} #{(type == :remove ? "Removing" : "Adding").bright} address #{address.bright} #{type != :remove ? "to" : "from"} interface #{self.config.interface.bright}...") if !self.config.quiet
+        rv = self.execute_command(command)
+
+        # TODO: The end badge.
+      else
+        @logger.info("#{prefix} I will #{(type == :remove ? "remove" : "add").bright} address #{address.bright} #{type != :remove ? "to" : "from"} interface #{self.config.interface.bright}.") if !self.config.quiet
+      end
+
+      rv
+    end
+
+    # Adds aliases to the interface.
+    #
+    # @return [Boolean] `true` if action succedeed, `false` otherwise.
+    def action_add
+      addresses = self.compute_addresses
+
+      if addresses.present? then
+        # Now, for every address, call the command
+        addresses.all? {|address|
+          self.manage(:add, address)
+        }
+      else
+        @logger.error("No valid addresses to add to the interface found.") if !self.config.quiet
+      end
+    end
+
+    # Removes aliases from the interface.
+    #
+    # @return [Boolean] `true` if action succedeed, `false` otherwise.
+    def action_remove
+      addresses = self.compute_addresses
+
+      if addresses.present? then
+        # Now, for every address, call the command
+        addresses.all? {|address|
+          self.manage(:remove, address)
+        }
       else
-        @logger.info("I will #{command.bright} #{aliases.length == 1 ? "this alias" : "these aliases"} #{command == "add" ? "to" : "from"} interface #{configuration.interface.bright}: #{aliases.collect {|a| a.bright}.join(", ")}.")
+        @logger.error("No valid addresses to remove from the interface found.") if !self.config.quiet
+      end
+    end
+
+    # Installs the application into the autolaunch.
+    #
+    # @return [Boolean] `true` if action succedeed, `false` otherwise.
+    def action_install
+      logger = get_logger
+
+      if !self.is_osx? then
+        logger.fatal("Install akaer on autolaunch is only available on MacOSX.") if !self.config.quiet
+        return false
+      end
+
+      launch_agent = self.launch_agent_path
+
+      begin
+        logger.info("Creating the launch agent in #{launch_agent} ...") if !self.config.quiet
+
+        args = $ARGV ? $ARGV[0, $ARGV.length - 1] : []
+
+        plist = {"KeepAlive" => false, "Label" => "it.cowtech.akaer", "Program" => (::Pathname.new(Dir.pwd) + $0).to_s, "ProgramArguments" => args, "RunAtLoad" => true}
+        ::File.open(launch_agent, "w") {|f|
+          f.write(plist.to_json)
+          f.flush
+        }
+        self.execute_command("plutil -convert binary1 \"#{launch_agent}\"")
+      rescue => e
+        logger.error("Cannot create the launch agent.") if !self.config.quiet
+        return false
       end
+
+      begin
+        logger.info("Loading the launch agent ...") if !self.config.quiet
+        self.execute_command("launchctl load -w \"#{launch_agent}\" > /dev/null 2>&1")
+      rescue => e
+        logger.error("Cannot load the launch agent.") if !self.config.quiet
+        return false
+      end
+
+      true
+    end
+
+    # Uninstalls the application from the autolaunch.
+    #
+    # @return [Boolean] `true` if action succedeed, `false` otherwise.
+    def action_uninstall
+      logger = self.get_logger
+
+      if !self.is_osx? then
+        logger.fatal("Install akaer on autolaunch is only available on MacOSX.") if !self.config.quiet
+        return false
+      end
+
+      launch_agent = self.launch_agent_path
+
+      # Unload the launch agent.
+      begin
+        self.execute_command("launchctl unload -w \"#{launch_agent}\" > /dev/null 2>&1")
+      rescue => e
+        logger.warn("Cannot unload the launch agent.") if !self.config.quiet
+      end
+
+      # Delete the launch agent.
+      begin
+        logger.info("Deleting the launch agent #{launch_agent} ...")
+        ::File.delete(launch_agent)
+      rescue => e
+        logger.warn("Cannot delete the launch agent.") if !self.config.quiet
+        return false
+      end
+
+      true
+    end
+
+    # Returns a unique (singleton) instance of the application.
+    # @param globals [Hash] Global options.
+    # @param locals [Hash] Local command options.
+    # @param args [Array] Extra arguments.
+    # @param force [Boolean] If to force recreation of the instance.
+    # @return [Application] The unique (singleton) instance of the application.
+    def self.instance(globals = {}, locals = {}, args = [], force = false)
+      @instance = nil if force
+      @instance ||= Akaer::Application.new(globals, locals, args)
     end
   end
 end