cakewalk 3.0.0

data/examples/plugins/google.rb

@@ -0,0 +1,36 @@
+require 'cakewalk'
+require 'open-uri'
+require 'nokogiri'
+require 'cgi'
+
+class Google
+  include Cakewalk::Plugin
+  match /google (.+)/
+
+  def search(query)
+    url = "http://www.google.com/search?q=#{CGI.escape(query)}"
+    res = Nokogiri.parse(open(url).read).at("h3.r")
+
+    title = res.text
+    link = res.at('a')[:href]
+    desc = res.at("./following::div").children.first.text
+    CGI.unescape_html "#{title} - #{desc} (#{link})"
+  rescue
+    "No results found"
+  end
+
+  def execute(m, query)
+    m.reply(search(query))
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.server = "irc.libera.chat"
+    c.nick   = "MrCakewalk"
+    c.channels = ["#cakewalk-bots"]
+    c.plugins.plugins = [Google]
+  end
+end
+
+bot.start

data/examples/plugins/hello.rb

@@ -0,0 +1,22 @@
+require 'cakewalk'
+
+class Hello
+  include Cakewalk::Plugin
+
+  match "hello"
+
+  def execute(m)
+    m.reply "Hello, #{m.user.nick}"
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.server = "irc.libera.chat"
+    c.channels = ["#cakewalk-bots"]
+    c.plugins.plugins = [Hello]
+  end
+end
+
+bot.start
+

data/examples/plugins/hooks.rb

@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+require 'cakewalk'
+
+class HooksDemo
+  include Cakewalk::Plugin
+
+  hook :pre, method: :generate_random_number
+  def generate_random_number(m)
+    # Hooks are called in the same thread as the handler and thus
+    # using thread local variables is possible.
+    Thread.current[:rand] = Kernel.rand
+  end
+
+  hook :post, method: :cheer
+  def cheer(m)
+    m.reply "Yay, I successfully ran a command…"
+  end
+
+  match "rand"
+  def execute(m)
+    m.reply "Random number: " + Thread.current[:rand].to_s
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.nick            = "cakewalk_hooks"
+    c.server          = "irc.libera.chat"
+    c.channels        = ["#cakewalk-bots"]
+    c.verbose         = true
+    c.plugins.plugins = [HooksDemo]
+  end
+end
+
+
+bot.start

data/examples/plugins/join_part.rb

@@ -0,0 +1,42 @@
+require 'cakewalk'
+
+class JoinPart
+  include Cakewalk::Plugin
+
+  match /join (.+)/, method: :join
+  match /part(?: (.+))?/, method: :part
+
+  def initialize(*args)
+    super
+
+    @admins = ["injekt", "DominikH"]
+  end
+
+  def check_user(user)
+    user.refresh # be sure to refresh the data, or someone could steal
+                 # the nick
+    @admins.include?(user.authname)
+  end
+
+  def join(m, channel)
+    return unless check_user(m.user)
+    Channel(channel).join
+  end
+
+  def part(m, channel)
+    return unless check_user(m.user)
+    channel ||= m.channel
+    Channel(channel).part if channel
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.server = "irc.libera.chat"
+    c.nick   = "CakewalkBot"
+    c.channels = ["#cakewalk-bots"]
+    c.plugins.plugins = [JoinPart]
+  end
+end
+
+bot.start

data/examples/plugins/lambdas.rb

@@ -0,0 +1,35 @@
+require 'cakewalk'
+
+class DirectAddressing
+  include Cakewalk::Plugin
+
+  # Note: the lambda will be executed in the context it has been
+  # defined in, in this case the class DirectAddressing (and not an
+  # instance of said class).
+  #
+  # The reason we are using a lambda is that the bot's nick can change
+  # and the prefix has to be up to date.
+  set :prefix, lambda{ |m| Regexp.new("^" + Regexp.escape(m.bot.nick + ": " ))}
+
+  match "hello", method: :greet
+  def greet(m)
+    m.reply "Hello to you, too."
+  end
+
+  match "rename", method: :rename
+  def rename(m)
+    @bot.nick += "_"
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.nick            = "cakewalk_lambda"
+    c.server          = "irc.libera.chat"
+    c.channels        = ["#cakewalk-bots"]
+    c.verbose         = true
+    c.plugins.plugins = [DirectAddressing]
+  end
+end
+
+bot.start

data/examples/plugins/last_nick.rb

@@ -0,0 +1,24 @@
+require 'cakewalk'
+
+class Nickchange
+  include Cakewalk::Plugin
+  listen_to :nick
+
+  def listen(m)
+    # This will send a PM to the user who changed their nick and inform
+    # them of their old nick.
+    m.reply "Your old nick was: #{m.user.last_nick}" ,true
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.nick            = "cakewalk_nickchange"
+    c.server          = "irc.libera.chat"
+    c.channels        = ["#cakewalk-bots"]
+    c.verbose         = true
+    c.plugins.plugins = [Nickchange]
+  end
+end
+
+bot.start

data/examples/plugins/msg.rb

@@ -0,0 +1,22 @@
+require 'cakewalk'
+
+class Messenger
+  include Cakewalk::Plugin
+
+  match /msg (.+?) (.+)/
+  def execute(m, receiver, message)
+    User(receiver).send(message)
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.server = "irc.libera.chat"
+    c.nick   = "CakewalkBot"
+    c.channels = ["#cakewalk-bots"]
+    c.plugins.plugins = [Messenger]
+  end
+end
+
+bot.start
+

data/examples/plugins/multiple_matches.rb

@@ -0,0 +1,32 @@
+require 'cakewalk'
+
+class MultiCommands
+  include Cakewalk::Plugin
+  match /command1 (.+)/, method: :command1
+  match /command2 (.+)/, method: :command2
+  match /^command3 (.+)/, use_prefix: false
+
+  def command1(m, arg)
+    m.reply "command1, arg: #{arg}"
+  end
+
+  def command2(m, arg)
+    m.reply "command2, arg: #{arg}"
+  end
+
+  def execute(m, arg)
+    m.reply "command3, arg: #{arg}"
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.nick            = "cakewalk_multi"
+    c.server          = "irc.libera.chat"
+    c.channels        = ["#cakewalk-bots"]
+    c.verbose         = true
+    c.plugins.plugins = [MultiCommands]
+  end
+end
+
+bot.start

data/examples/plugins/own_events.rb

@@ -0,0 +1,37 @@
+require 'cakewalk'
+
+class RandomNumberGenerator
+  def initialize(bot)
+    @bot = bot
+  end
+
+  def start
+    while true
+      sleep 5 # pretend that we are waiting for some kind of entropy
+      @bot.handlers.dispatch(:random_number, nil, Kernel.rand)
+    end
+  end
+end
+
+class DoSomethingRandom
+  include Cakewalk::Plugin
+
+  listen_to :random_number
+  def listen(m, number)
+    Channel("#cakewalk-bots").send "I got a random number: #{number}"
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.nick            = "cakewalk_events"
+    c.server          = "irc.libera.chat"
+    c.channels        = ["#cakewalk-bots"]
+    c.verbose         = true
+    c.plugins.plugins = [DoSomethingRandom]
+  end
+end
+
+
+Thread.new { RandomNumberGenerator.new(bot).start }
+bot.start

data/examples/plugins/seen.rb

@@ -0,0 +1,45 @@
+require 'cakewalk'
+
+class Seen
+  class SeenStruct < Struct.new(:who, :where, :what, :time)
+    def to_s
+      "[#{time.asctime}] #{who} was seen in #{where} saying #{what}"
+    end
+  end
+
+  include Cakewalk::Plugin
+  listen_to :channel
+  match /seen (.+)/
+
+  def initialize(*args)
+    super
+    @users = {}
+  end
+
+  def listen(m)
+    @users[m.user.nick] = SeenStruct.new(m.user, m.channel, m.message, Time.now)
+  end
+
+  def execute(m, nick)
+    if nick == @bot.nick
+      m.reply "That's me!"
+    elsif nick == m.user.nick
+      m.reply "That's you!"
+    elsif @users.key?(nick)
+      m.reply @users[nick].to_s
+    else
+      m.reply "I haven't seen #{nick}"
+    end
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.server   = 'irc.libera.chat'
+    c.channels = ["#cakewalk-bots"]
+    c.plugins.plugins  = [Seen]
+  end
+end
+
+bot.start
+

data/examples/plugins/timer.rb

@@ -0,0 +1,22 @@
+require 'cakewalk'
+
+class TimedPlugin
+  include Cakewalk::Plugin
+
+  timer 5, method: :timed
+  def timed
+    Channel("#cakewalk-bots").send "5 seconds have passed"
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.nick            = "cakewalk_timer"
+    c.server          = "irc.libera.chat"
+    c.channels        = ["#cakewalk-bots"]
+    c.verbose         = true
+    c.plugins.plugins = [TimedPlugin]
+  end
+end
+
+bot.start

data/examples/plugins/url_shorten.rb

@@ -0,0 +1,33 @@
+require 'open-uri'
+require 'cakewalk'
+
+class TinyURL
+  include Cakewalk::Plugin
+
+  listen_to :channel
+
+  def shorten(url)
+    url = open("http://tinyurl.com/api-create.php?url=#{URI.escape(url)}").read
+    url == "Error" ? nil : url
+  rescue OpenURI::HTTPError
+    nil
+  end
+
+  def listen(m)
+    urls = URI.extract(m.message, "http")
+    short_urls = urls.map { |url| shorten(url) }.compact
+    unless short_urls.empty?
+      m.reply short_urls.join(", ")
+    end
+  end
+end
+
+bot = Cakewalk::Bot.new do
+  configure do |c|
+    c.server = "irc.libera.chat"
+    c.channels = ["#cakewalk-bots"]
+    c.plugins.plugins = [TinyURL]
+  end
+end
+
+bot.start

data/lib/cakewalk/ban.rb

@@ -0,0 +1,50 @@
+require "cakewalk/mask"
+module Cakewalk
+  # This class represents channel bans.
+  class Ban
+    # @return [Mask] A {Mask} object for non-extended bans
+    # @return [String] A String object for extended bans (see {#extended})
+    attr_reader :mask
+
+    # The user who created the ban. Might be nil on networks that do
+    # not strictly follow the RFCs, for example IRCnet in some(?)
+    # cases.
+    #
+    # @return [User, nil] The user who created the ban
+    attr_reader :by
+
+    # @return [Time]
+    attr_reader :created_at
+
+    # @return [Boolean] whether this is an extended ban (as used by for example Freenode)
+    attr_reader :extended
+
+    # @param [String, Mask] mask The mask
+    # @param [User, nil] by The user who created the ban.
+    # @param [Time] at The time at which the ban was created
+    def initialize(mask, by, at)
+      @by, @created_at = by, at
+      if mask =~ /^[\$~]/
+        @extended = true
+        @mask     = mask
+      else
+        @extended = false
+        @mask = Mask.from(mask)
+      end
+    end
+
+    # @return [Boolean] true if the ban matches `user`
+    # @raise [Exceptions::UnsupportedFeature] Cakewalk does not support
+    #   Freenode's extended bans
+    def match(user)
+      raise UnsupportedFeature, "extended bans are not supported yet" if @extended
+      @mask =~ user
+    end
+    alias_method :=~, :match
+
+    # @return [String]
+    def to_s
+      @mask.to_s
+    end
+  end
+end