butler 1.8.0

data/data/butler/plugins/irc/action.rb

@@ -0,0 +1,36 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "action"
+
+def on_trigger
+	return answer(usage) if @message.arguments.length < 3
+	@butler.irc.action(@message.post_arguments[2], @message.arguments[1])
+	answer(:sent)
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Lets butler perform an action in a channel or query (like a /me or /action message)
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+  :sent:
+    en: Performed action
+:usage:
+  en: |
+    ![b]action![o] (![c(green)]nick![o] | ![c(green)]channel![o]) *![c(blue)]text![o])
+:help:
+  en:
+    "": |
+      Lets butler perform an action in a channel or query (like a /me or /action message)

data/data/butler/plugins/irc/join.rb

@@ -0,0 +1,38 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "join"
+
+def on_trigger
+	return answer(usage) unless @message.arguments[1]
+	answer(:joining, :name => @message.arguments[1])
+	@butler.join(@message.arguments[1])
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Let Butler join channels
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+  :joining:
+    en: Joining channel <%= name %>.
+:usage:
+  en: |
+    ![b]join![o] ![c(green)]channel![o]
+:help:
+  en:
+    "": |
+      You can use 'join' to let butler join other channels.
+    "related": |
+      Related triggers: part.

data/data/butler/plugins/irc/notice.rb

@@ -0,0 +1,36 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "notice"
+
+def on_trigger
+	return answer(usage) if @message.arguments.length < 3
+	@butler.irc.notice(@message.post_arguments[2], @message.arguments[1])
+	answer(:sent)
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Let butler send a notice to a user or channel
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+  :sent:
+    en: Sent the message
+:usage:
+  en: |
+    ![b]notice![o] (![c(green)]nick![o] | ![c(green)]channel![o])
+:help:
+  "":
+    en: |
+      Let butler send a notice to a user or channel.

data/data/butler/plugins/irc/part.rb

@@ -0,0 +1,38 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "part"
+
+def on_trigger
+	return answer(usage) unless @message.arguments[1]
+	answer(:parting, :name => @message.arguments[1])
+	@butler.irc.part(@message.arguments[1])
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Let Butler part from channels
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+  :parting:
+    en: Parting channel <%= name %>.
+:usage:
+  en: |
+    ![b]part![o] ![c(green)]channel![o]
+:help:
+  en:
+    "": |
+      You can use 'join' to let butler part from channels.
+    "related": |
+      Related triggers: join.

data/data/butler/plugins/irc/privmsg.rb

@@ -0,0 +1,36 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "privmsg"
+
+def on_trigger
+	return answer(usage) if @message.arguments.length < 3
+	@butler.irc.privmsg(@message.post_arguments[2], @message.arguments[1])
+	answer(:sent)
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Let butler send a private message to a user or channel
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+  :sent:
+    en: Sent the message
+:usage:
+  en: |
+    ![b]privmsg![o] (![c(green)]nick![o] | ![c(green)]channel![o])
+:help:
+  en:
+    "": |
+      Let butler send a private message to a user or channel.

data/data/butler/plugins/irc/quit.rb

@@ -0,0 +1,36 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "quit"
+
+def on_trigger
+	@butler.irc.quit(@message.post_arguments[1] || localize(:default_reason))
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Lets Butler quit from IRC and disconnect from the server.
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+  :default_reason:
+    en: I was terminated! Bye!
+:usage:
+  en: |
+    ![b]quit![o] [*![c(blue)]reason![o]]
+:help:
+  en:
+    "": |
+      You can use 'quit' to let butler quit from irc and disconnect.
+    "related": |
+      Related triggers: reconnect.

data/data/butler/plugins/operator/deop.rb

@@ -0,0 +1,41 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "deop"
+
+def on_trigger
+	channels, nicks = [], message.arguments[1..-1]
+	channames = @butler.channels.channel_names
+
+	channels << nicks.pop while channames.include?(nicks.last.downcase)
+	nicks    << @message.from.nick if nicks.empty?
+	channels << @message.channel.to_str if channels.empty?
+
+	channels.each { |channel|
+		@butler.irc.deop(channel, *nicks)
+	}
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Revoke a users op via butler.
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+:usage:
+  en: |
+    ![b]deop![o] [![c(green)]nick![o] ...] [![c(green)]channel![o] ...]
+:help:
+  en:
+    "": |
+      Revoke a users op via butler.

data/data/butler/plugins/operator/devoice.rb

@@ -0,0 +1,41 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "devoice"
+
+def on_trigger
+	channels, nicks = [], message.arguments[1..-1]
+	channames = @butler.channels.channel_names
+
+	channels << nicks.pop while channames.include?(nicks.last.downcase)
+	nicks    << @message.from.nick if nicks.empty?
+	channels << @message.channel.to_str if channels.empty?
+
+	channels.each { |channel|
+		@butler.irc.devoice(channel, *nicks)
+	}
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Revoke a users voice via butler.
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+:usage:
+  en: |
+    ![b]devoice![o] [![c(green)]nick![o] ...] [![c(green)]channel![o] ...]
+:help:
+  en:
+    "": |
+      Revoke a users voice via butler.

data/data/butler/plugins/operator/limit.rb

@@ -0,0 +1,47 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+extend OnHandlers
+
+trigger "limit"
+
+configuration(
+	"channels" => []
+)
+
+def on_mode(*args)
+end
+
+def on_trigger
+	limit = @message.arguments[1].downcase
+	limit = limit == "off" ? nil : Integer(limit)
+rescue
+	answer(:invalid_limit, :limit => limit)
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: A slowly shifting channel-limit to avoid join-floods.
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+  :invalid_limit:
+    en: |
+      <%= limit %> is not a valid limit, use either 'off' or a positive number.
+:usage:
+  en: |
+    ![b]limit![o] ('off' | ![c(green)]int![o]) *![c(green)]channel![o] ...
+:help:
+  en:
+    "": |
+      A slowly shifting channel-limit to avoid join-floods.

data/data/butler/plugins/operator/op.rb

@@ -0,0 +1,41 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "op"
+
+def on_trigger
+	channels, nicks = [], message.arguments[1..-1]
+	channames = @butler.channels.channel_names
+
+	channels << nicks.pop while channames.include?(nicks.last.downcase)
+	nicks    << @message.from.nick if nicks.empty?
+	channels << @message.channel.to_str if channels.empty?
+
+	channels.each { |channel|
+		@butler.irc.op(channel, *nicks)
+	}
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Grant a user op via butler.
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+:usage:
+  en: |
+    ![b]op![o] [![c(green)]nick![o] ...] [![c(green)]channel![o] ...]
+:help:
+  en:
+    "": |
+      Grant a user op via butler.

data/data/butler/plugins/operator/voice.rb

@@ -0,0 +1,41 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "voice"
+
+def on_trigger
+	channels, nicks = [], message.arguments[1..-1]
+	channames = @butler.channels.channel_names
+
+	channels << nicks.pop while channames.include?(nicks.last.downcase)
+	nicks    << @message.from.nick if nicks.empty?
+	channels << @message.channel.to_str if channels.empty?
+
+	channels.each { |channel|
+		@butler.irc.voice(channel, *nicks)
+	}
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Grant a user voice via butler.
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+:strings:
+:usage:
+  en: |
+    ![b]voice![o] [![c(green)]nick![o] ...] [![c(green)]channel![o] ...]
+:help:
+  en:
+    "": |
+      Grant a user voice via butler.

data/data/butler/plugins/public/help.rb

@@ -0,0 +1,69 @@
+#--
+# Copyright 2007 by Stefan Rusterholz.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+
+
+trigger "help"
+
+def on_trigger
+	if @message.arguments[1] then
+		plugin = plugin = @butler.plugins.identify(@message.arguments[1])
+		if plugin then
+			help = @butler.plugins[plugin].help
+			help = help[@message.language] || help["en"]
+			if @message.arguments.last == "+" then
+				topics = help.keys.sort[1..-1].map { |t| "'#{t}'" }.columnize(5)
+				answer(:topics, :topics => topics)
+			else
+				key = @message.arguments[2..-1].join(" ")
+				if help = help[key] then
+					answer(help.result(self))
+				else
+					answer(key.empty? ? :nohelp : :notopic, :topic => key)
+				end
+			end
+		else
+			answer :noplugin
+		end
+	else
+		help = plugin().help
+		help = help[@message.language] || help["en"]
+		answer(help[""].result(self))
+	end
+end
+
+__END__
+--- 
+:revision:
+  :plugin: 1
+:summary:
+  en: Displays helping information about other plugins
+:about:
+  :mail: "apeiros@gmx.net"
+  :version: "1.0.0"
+  :author: "Stefan Rusterholz"
+  :description:
+:strings:
+  :noplugin:
+    en: "No plugin with that name loaded."
+  :nohelp:
+    en: "Plugin doesn't provide any help."
+  :notopic:
+    en: "Plugin doesn't provide help for '<%= topic %>'."
+  :nolang:
+    en: "Plugin doesn't provide help for '<%= topic %>' in that language."
+  :topics:
+    en: |
+      Topics for the plugin:
+      <%= topics %>
+:usage:
+  en: "![b]help![o] [![c(green)]plugin![o] [*![c(blue)]topic![o]]] [+]"
+:help:
+  en:
+    "": |
+      help gives help about itself or a command.
+      If + is the last argument, it will list the available help topics.
+      Use 'plugins list' to get a list of available commands.