iirc 0.2.2 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 248205a308cd5741f52158e5f38dfcc980daa29a0ea2b9365abf2def87201bf2
-  data.tar.gz: d3c872589c3b40007fc8765a10bd4d8e253e055d5357758b5e64a597e6423c93
+  metadata.gz: d5f568a48b28bcd4d10bdf613db4baa4451514e26d77acdbf18d9c988fd8792f
+  data.tar.gz: 2f384b6fd3f8f7e3e43b8b714baad42de702733f0634736abc8a6ede67bb52d9
 SHA512:
-  metadata.gz: 3007089c380e2e591eeb2b4a8c3df65524773f4b8b54e7b5db639015c859939e0ae63f27246637fb625cae77d674404f85c67bac49c7d40dac3cfc8460680339
-  data.tar.gz: 9ceca7ed0c1e76a396d802d9d068ac6a5900d6c6d1bd5e0c2bb21287725175905b58e4fc438b7b39328dd2de5a3d2677b82637bc7801fa7a3bb9e6578a4c8e72
+  metadata.gz: a6b72bfb5048226f87c4d5c8e3d8471885fea226c970da825c66dd8189642a9908e39fabb050a3867c3ddf794eee25e713006333c875164f04707c3bb42459bf
+  data.tar.gz: d0876472a0c3f099f0001555191456ee666033377a2180bcaafa74360b7c46f10277be431c4590b557b7a174f4ca409eea0be7b0ad5644bd8aee4203ee8eefc5

data/CHANGELOG.md

@@ -1,3 +1,34 @@
+## [0.2.7] - 2022-03-16
+
+- Include Bot::RegexHooks in Batteries
+
+## [0.2.6] - 2022-03-16
+
+- Add ircparser dependency
+  - It's technically optional, but it's needed to parse IRCv3 messages
+
+## [0.2.5] - 2022-03-16
+
+- Add dial method. Uses SSL by default, with configurable context
+- Add Bot.run method. Dials, yields an instance, then calls #run
+- Add IIRC() method to top-level for DSL shorthand
+  - See examples/facts.rb
+- Add examples/ (Facts, Greeter, Wolfram)
+
+## [0.2.4] - 2022-03-15
+
+- [Bot::Hooks] Run catch-all hooks before on_#{verb} ones
+- Include Bot::AmbientVerbs in Batteries
+  - Lets you write `say "Hello"` in event handlers instead of `say evt.target, "Hello"`
+  - Defaults the first arg of say,act,join,part,cycle,mode to the target of the current event
+- Add Bot::PrintIO module
+
+## [0.2.3] - 2022-03-14
+
+- Use new configure style for Bot::OperUp
+- Use new configure style for Bot::TrackOwnNick
+- Update own nick from welcome message (001)
+
 ## [0.2.2] - 2022-03-13
 
 - Use escape sequences in formatting.rb for readability

data/examples/facts.rb

@@ -0,0 +1,30 @@
+require "iirc"
+
+IIRC {
+  include IIRC::Bot::PrintIO
+
+  def facts
+    @facts ||= {}
+  end
+
+  def on_privmsg(evt)
+    case evt.message
+    when /^=list\b/
+      say "I know about #{facts.empty? ? 'nothing' : facts.keys.join(', ')}"
+    when /^=tell ([[:alnum:]]+)/
+      say facts[$1] ? "#{$1} is #{facts[$1]}" : "I don't know what that is"
+    when /^=add ([[:alnum:]]+) (.+)/
+      say "Okay, #{$1} is #{$2}"
+      facts[$1] = $2
+    when /^=del ([[:alnum:]]+)/
+      say "Okay, forgetting #{$1}"
+      facts.delete $1
+    end
+  end
+
+  def autojoin_channels
+    ['##facts', '##iirc']
+  end
+
+  run "irc.libera.chat", nick: "FactBot[#{rand(100)}]"
+}

data/examples/greeter.rb

@@ -0,0 +1,16 @@
+require "iirc"
+
+class Greeter < IIRC::Bot
+  include AutoJoin
+  include Verbs
+
+  def on_join(evt)
+    say evt.target, "Hello #{evt.sender.nick}!"
+  end
+
+  def autojoin_channels
+    ['##iirc']
+  end
+end
+
+Greeter.run 'irc.libera.chat', nick: 'GreeterBot' if __FILE__ == $0

data/examples/wolfram.rb

@@ -0,0 +1,39 @@
+require "net/https"
+require "iirc"
+
+class Wolfram < IIRC::Batteries
+  include PrintIO
+
+  def on_privmsg(evt)
+    case evt.message
+    when /^!(what .+)/, /^!(define .+)/
+      answer($1).then { |answer|
+        if answer == "Wolfram|Alpha did not understand your input"
+          case rand(3)
+          when 0
+            say "I have no #{%w(earthly stinkin bloody).sample} idea :)"
+          when 1
+            say "If only I knew..."
+          when 2
+            say "#{evt.sender.nick}: If you ever find out, will you tell me?"
+          end
+        else
+          say answer.capitalize
+        end
+      }
+    end
+  end
+
+  def answer(query)
+    url = URI.parse("https://api.wolframalpha.com/v1/result")
+    url.query = URI.encode_www_form(i: query, appid: ENV['WOLFRAM_APP_ID'])
+
+    Net::HTTP.get(url)
+  end
+
+  def autojoin_channels
+    ['##wolframbot', '##iirc']
+  end
+end
+
+Wolfram.run 'irc.libera.chat', nick: 'WolframBot'+rand(100).to_s

data/iirc.gemspec

@@ -27,7 +27,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
+  spec.add_dependency "ircparser", "= 1.0.0"
 
   # For more information and examples about making a new gem, checkout our
   # guide at: https://bundler.io/guides/creating_gem.html

data/lib/iirc/bot/hooks.rb

@@ -31,10 +31,13 @@ module IIRC
     end
 
     def fire! verb, *args, **kwargs
+      for action in hooks[nil]
+        call action, *args, **kwargs
+      end
       if respond_to? :"on_#{verb}"
         send(:"on_#{verb}", *args, **kwargs)
       end
-      for action in [*hooks[nil], *hooks[verb]]
+      for action in hooks[verb]
         call action, *args, **kwargs
       end
     rescue StopIteration

data/lib/iirc/bot/oper_up.rb

@@ -1,15 +1,12 @@
 module IIRC
   module Bot::OperUp
-    def self.configure_actions
-      [:add_oper_up_hook]
-    end
-
-    def add_oper_up_hook
-      on :'001', :oper_up!
-    end
-
     def oper_up!
       self << "OPER #{ENV['IRC_OPER']}" if ENV['IRC_OPER']
     end
+
+    private
+      def configure_oper_up
+        on :'001', :oper_up!
+      end
   end
 end

data/lib/iirc/bot/print_io.rb

@@ -0,0 +1,12 @@
+module IIRC
+  module Bot::PrintIO
+    def lines
+      super { |line| puts ">> #{line}"; yield line }
+    end
+
+    def <<(line)
+      puts "<< #{line}"
+      super
+    end
+  end
+end

data/lib/iirc/bot/track_own_nick.rb

@@ -1,9 +1,18 @@
 module IIRC
   module Bot::TrackOwnNick
-    def on_nick evt
-      if me === evt.sender
-        self.user.nick = evt.args[0]
+    private
+
+      def configure_own_nick_tracking
+        on :'001', :track_own_nick_from_welcome
+        on :nick,  :track_own_nick_change
+      end
+
+      def track_own_nick_from_welcome evt
+        me.nick = evt.args[0]
+      end
+
+      def track_own_nick_change evt
+        me.nick = evt.args[0] if me === evt.sender
       end
-    end
   end
 end

data/lib/iirc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IIRC
-  VERSION = "0.2.2"
+  VERSION = "0.2.7"
 end

data/lib/iirc.rb

@@ -15,6 +15,7 @@ require_relative "iirc/bot/members"
 require_relative "iirc/bot/oper_up"
 require_relative "iirc/bot/parsing"
 require_relative "iirc/bot/pong"
+require_relative "iirc/bot/print_io"
 require_relative "iirc/bot/reading"
 require_relative "iirc/bot/redis"
 require_relative "iirc/bot/regex_hooks"
@@ -36,6 +37,16 @@ module IIRC
     include Configure
     include Pong
     include TrackOwnNick
+
+    def self.run(host, port=6697, ssl_context: SSL.default_context, **user_params, &blk)
+      socket = IIRC.dial(host, port, ssl_context: ssl_context)
+
+      new(socket, **user_params).tap { |bot|
+        bot.register!
+        bot.tap(&blk) if blk
+        bot.run
+      }
+    end
   end
 
   class IRCv3Bot < Bot
@@ -46,10 +57,64 @@ module IIRC
   end
 
   class Batteries < IRCv3Bot
-    include Channels
-    include Members
-    include Formatting
-    include AutoJoin
-    include Verbs
+    include Bot::Channels
+    include Bot::Members
+    include Bot::Formatting
+    include Bot::AutoJoin
+    include Bot::Verbs
+    include Bot::AmbientVerbs
+    include Bot::RegexHooks
+  end
+
+  module SSL
+    module_function
+
+    def default_context
+      verify_peer_and_hostname
+    end
+
+    def verify_peer_and_hostname
+      verify_peer.tap { |context|
+        context.verify_hostname = true
+      }
+    end
+
+    def verify_peer
+      no_verify.tap { |context|
+        context.verify_mode = OpenSSL::SSL::VERIFY_PEER
+        context.cert_store = OpenSSL::X509::Store.new.tap(&:set_default_paths)
+      }
+    end
+
+    def verify_hostname_only
+      no_verify.tap { |context|
+        context.verify_hostname = true
+      }
+    end
+
+    def no_verify
+      require 'openssl'
+      OpenSSL::SSL::SSLContext.new
+    end
   end
+
+  module_function
+    def dial(host, port=6697, ssl_context: SSL.default_context)
+      require 'socket'
+
+      Socket.tcp(host, port).then { |socket|
+        if ssl_context
+          OpenSSL::SSL::SSLSocket.new(socket, ssl_context).tap { |socket|
+            socket.hostname = host
+            socket.connect
+          }
+        else
+          socket
+        end
+      }
+    end
 end
+
+def IIRC(*args, **kwargs, &blk)
+  Class.new(IIRC::Batteries, &blk)
+end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: iirc
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.7
 platform: ruby
 authors:
 - mooff
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-13 00:00:00.000000000 Z
-dependencies: []
+date: 2022-03-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ircparser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
 description: A composable toolkit for IRC bots
 email:
 - mooff@awful.cooking
@@ -25,6 +39,9 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- examples/facts.rb
+- examples/greeter.rb
+- examples/wolfram.rb
 - iirc.gemspec
 - lib/iirc.rb
 - lib/iirc/bot.rb
@@ -42,6 +59,7 @@ files:
 - lib/iirc/bot/oper_up.rb
 - lib/iirc/bot/parsing.rb
 - lib/iirc/bot/pong.rb
+- lib/iirc/bot/print_io.rb
 - lib/iirc/bot/reading.rb
 - lib/iirc/bot/redis.rb
 - lib/iirc/bot/regex_hooks.rb