bin/rbot

   1 #!/usr/bin/env ruby
   2
   3 =begin rdoc
   4
   5 = rbot main executable
   6
   7 Usage:
   8
   9   % rbot [options] [config directory]
  10
  11 == Options
  12
  13 [-h, --help]
  14     display a help message and exit
  15 [-v, --version]
  16     display version information and exit
  17 [-d, --debug]
  18     enable debug messages
  19 [-l, --loglevel _level_]
  20     sets the minimum log level verbosity
  21 [-b, --background]
  22     background (daemonize) the bot
  23 [-p, --pidfile _filename_]
  24     write the bot pid to _filename_
  25
  26 The default config directory is <tt>~/.rbot</tt>.
  27
  28 The default pidfile is <tt><i>botdir</i>/rbot.pid</tt>.
  29
  30 The logfile is located at <tt><i>botdir</i>/<i>botname</i>.log</tt>, and
  31 the default loglevel is 1 (INFO messages). Possible values for the loglevel
  32 are 0 (DEBUG), 1 (INFO), 2 (WARN), 3 (ERROR), 4 (FATAL).
  33
  34 Please note that the logfile doesn't contain IRC logs (which are located at
  35 <tt><i>botdir</i>/logs/*</tt>, but only rbot diagnostic messages.
  36
  37 =end
  38
  39 # Copyright (C) 2002 Tom Gilbert.
  40 #
  41 # Permission is hereby granted, free of charge, to any person obtaining a copy
  42 # of this software and associated documentation files (the "Software"), to
  43 # deal in the Software without restriction, including without limitation the
  44 # rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  45 # sell copies of the Software, and to permit persons to whom the Software is
  46 # furnished to do so, subject to the following conditions:
  47 #
  48 # The above copyright notice and this permission notice shall be included in
  49 # all copies of the Software and its documentation and acknowledgment shall be
  50 # given in the documentation and software packages that this Software was
  51 # used.
  52 #
  53 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  54 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  55 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  56 # THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
  57 # IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  58 # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  59
  60 $VERBOSE=true
  61
  62 require 'etc'
  63 require 'getoptlong'
  64 require 'fileutils'
  65
  66 $version="0.9.11-git"
  67 $opts = Hash.new
  68
  69 if $version =~ /git/
  70   if defined?(SCM_DIR) and File.exists?(File.join(SCM_DIR, '.git'))
  71     begin
  72       git_out = `git status`
  73       git_out.match(/^# On branch (.*)\n/)
  74       if $1 # git 1.5.x
  75         branch = $1.dup || "unknown"
  76         changed = git_out.match(/^# Change(.*)\n/)
  77         rev = "revision "
  78         git_out = `git log -1 --pretty=format:"%h%n%b%n%ct"`.split("\n")
  79         rev << git_out.first
  80         $version_timestamp = git_out.last.to_i
  81         if git_out[1].match(/^git-svn-id: \S+@(\d+)/)
  82           rev << "(svn #{$1})"
  83         end
  84         rev << ", local changes" if changed
  85       else # older gits
  86         git_out = `git branch`
  87         git_out.match(/^\* (.*)\n/)
  88         branch = $1.dup rescue "unknown"
  89         rev = "revision " + `git rev-parse HEAD`[0,6]
  90       end
  91     rescue => e
  92       puts e.inspect
  93       branch = "unknown branch"
  94       rev = "unknown revision"
  95     end
  96
  97     $version << " (#{branch} branch, #{rev})"
  98   else
  99     up = File.dirname(__FILE__) + "/.."
 100     rev = " (unknown revision)"
 101     begin
 102       svn_out = `svn info #{up}`
 103       if svn_out =~ /Last Changed Rev: (\d+)/
 104         rev = " (revision #{$1}"
 105       end
 106       svn_st = `svn st #{up}`
 107       if svn_st =~ /^[MDA] /
 108         rev << ", local changes"
 109       end
 110       rev << ")"
 111     rescue => e
 112       puts e.inspect
 113     end
 114     $version += rev
 115   end
 116 end
 117
 118 orig_opts = ARGV.dup
 119
 120 opts = GetoptLong.new(
 121   ["--background", "-b", GetoptLong::NO_ARGUMENT],
 122   ["--debug", "-d", GetoptLong::NO_ARGUMENT],
 123   ["--help",  "-h", GetoptLong::NO_ARGUMENT],
 124   ["--loglevel",  "-l", GetoptLong::REQUIRED_ARGUMENT],
 125   ["--trace",  "-t", GetoptLong::REQUIRED_ARGUMENT],
 126   ["--pidfile", "-p", GetoptLong::REQUIRED_ARGUMENT],
 127   ["--version", "-v", GetoptLong::NO_ARGUMENT]
 128 )
 129
 130 $debug = $DEBUG
 131 $daemonize = false
 132
 133 opts.each {|opt, arg|
 134   $debug = true if(opt == "--debug")
 135   $daemonize = true if(opt == "--background")
 136   $opts[opt.sub(/^-+/, "")] = arg
 137 }
 138
 139 $cl_loglevel = $opts["loglevel"].to_i if $opts["loglevel"]
 140
 141 if ($opts["trace"])
 142   set_trace_func proc { |event, file, line, id, binding, classname|
 143     if classname.to_s == $opts["trace"]
 144       printf "TRACE: %8s %s:%-2d %10s %8s\n", event, File.basename(file), line, id, classname
 145     end
 146   }
 147 end
 148
 149 defaultlib = File.expand_path(File.dirname($0) + '/../lib')
 150
 151 if File.directory? "#{defaultlib}/rbot"
 152   unless $:.include? defaultlib
 153     $:.unshift defaultlib
 154   end
 155 end
 156
 157 begin
 158   require 'rbot/ircbot'
 159 rescue LoadError => e
 160   puts "Error: couldn't find the rbot/ircbot module (or one of its dependencies)\n"
 161   puts e
 162   exit 2
 163 end
 164
 165 if ($opts["version"])
 166   puts "rbot #{$version}"
 167   exit 0
 168 end
 169
 170 if ($opts["help"])
 171   puts "usage: rbot [options] [config directory]"
 172   puts "  -h, --help         this message"
 173   puts "  -v, --version      version information"
 174   puts "  -d, --debug        enable debug messages"
 175   puts "  -l, --loglevel     sets the log level verbosity"
 176   puts "  -b, --background   background (daemonize) the bot"
 177   puts "  -p, --pidfile      write the bot pid to file"
 178   puts "config directory defaults to ~/.rbot"
 179   exit 0
 180 end
 181
 182 if(bot = Irc::Bot.new(ARGV.shift, :argv => orig_opts))
 183   # just run the bot
 184   bot.mainloop
 185 end
 186