iirc 0.3.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c856c393db0b7645fa204d003750816cda3ce860b2be538e523f7d8bcf56b4e
-  data.tar.gz: 74252990a51523295d3dc788579b1f7ea456a995939e35d8c6004556742b7117
+  metadata.gz: 393add51d4c945dfa67c0459aee623d0cd0611ebd891a67dba43179fdfc71010
+  data.tar.gz: 9cc245c08ecb2aa1dd3ba29992620fa611d6fb021a300fae7476f26a02cfcc2a
 SHA512:
-  metadata.gz: 1c02d3b4eac6f4bebb0d2cb46e9241594021f07cb4fa2464508203bab3f1402f98901dd138efa1676d2de7fa678ac3117b08256ae819658c02819ff7dc2adeed
-  data.tar.gz: bb1fbf17c4f574f099a1b0c47d4e6aa087658c51137c8019facc151ccfd93591125c45b5bd327af6e75a85ae0d3f8ccea434da78b424c5f1c563c8f281413c2e
+  metadata.gz: 61bc31ca365d0ad70a84d7ad32352c5feb9ba656f594011c1693d6a43c4e0a54ac31524e8ea8826a1ce19a2e18c079b7edc58c3e083216413cccf268fb2d98ad
+  data.tar.gz: a772002465744f4325b5d2dd3c2f8d412b6d09f35743ea93da6e2490396c4f1d90f8d9a1924dcd6eb14030ab0bce76a937524bd4dc5b94b5ec97b6e19b9bf024

data/.yardopts

@@ -0,0 +1 @@
+--markup=markdown --private --protected

data/CHANGELOG.md

@@ -1,9 +1,37 @@
+## [0.4.2] - 2022-03-29
+
+- Fix example in README
+
+## [0.4.1] - 2022-03-29
+
+- [ISupport] Add module to process RPL_ISUPPORT
+- [ISupport] Add Inquiry helpers + docs
+
+## [0.4.0] - 2022-03-27
+
+- [Numerics] Add module with constants imported from ircdocs.horse
+  - Run `rake numerics` to re-import.
+
+- [IIRC.run,IIRC.dial] Support passing a symbol as ssl_context
+	- e.g. ssl_context: :no_verify instead of ssl_context: IIRC::SSL.no_verify
+
+- The AmbientEvents modules have been reorganised
+  - AmbientVerbs is now Ambient::Verbs
+  - AmbientEvents => Ambient::Events
+  - AmbientEvents::{LabeledRequests,ReplyTarget} => Ambient::{LabeledRequests,ReplyTarget}
+
+- #ambient_reply_target() has been replaced with #reply_target(evt=ambient_event)
+
+- [Bot.run] Set nick to class name if no param is given
+  - `MyBot.run('irc.libera.chat')` is enough to connect to Libera as 'MyBot'
+
 ## [0.3.0] - 2022-03-26
 
 - [Bot] Include ReplyTarget
 - [Hooks] Refactor
 - Add AcceptInvites module
 - Improve Greeter example
+- [IIRC.run,IIRC.dial] now accept local_host, local_port keyword arguments
 
 ## [0.2.9] - 2022-03-24
 

data/Gemfile

@@ -8,3 +8,6 @@ gemspec
 gem "rake", "~> 13.0"
 
 gem "minitest", "~> 5.0"
+
+gem "redcarpet", "= 3.5.1" # for Markdown docs (README.md)
+gem "yard"

data/README.md

@@ -1,8 +1,26 @@
 # Lean, mean IRC processing machine
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/iirc`. To experiment with that code, run `bin/console` for an interactive prompt.
+```ruby
+require 'iirc'
+
+class CoolBot < IIRC::IRCv3Bot
+  include Verbs
+
+  def configure_coolness
+    on /^!poke/, :poke_back
+  end
 
-TODO: Delete this and the text above, and describe your gem
+  def poke_back(evt)
+    act reply_target(evt), "pokes #{evt.sender.nick} back!!!"
+  end
+
+  def autojoin_channels
+    ['##coolness']
+  end
+end
+
+CoolBot.run 'irc.libera.chat' if __FILE__ == $0
+```
 
 ## Installation
 
@@ -22,7 +40,7 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+TODO: Flesh out usage instructions here
 
 ## Development
 

data/Rakefile

@@ -15,4 +15,63 @@ RDoc::Task.new do |rd|
   rd.options = ["--all"]
 end
 
+task :numerics do
+  require 'yaml'
+  require 'open-uri'
+
+  data = YAML.load URI.open('https://raw.githubusercontent.com/ircdocs/irc-defs/gh-pages/_data/numerics.yaml')
+  revision = data['file']['revision']
+
+  puts "Loaded numerics.yaml revision #{revision}"
+
+  open(File.join(__dir__, 'lib/iirc/numerics.rb'), 'w+') do |out|
+    out << <<~HEADER
+      module IIRC
+        # Definitions imported from ircdocs.horse
+        # @version #{revision}
+        # @see https://raw.githubusercontent.com/ircdocs/irc-defs/gh-pages/_data/numerics.yaml
+        # @see https://defs.ircdocs.horse/defs/numerics.html
+        module Numerics
+    HEADER
+
+    values = data['values'].reject { |v| v['obsolete'] }
+    counts = values.map { |v| v['name'] }.tally
+
+    constants = {}
+
+    for row in values
+      out << "    # #{row['comment'].squeeze(' ').tr("\r", '').gsub("\n", ' ').strip}\n" if row['comment']
+      out << "    # @format #{row['numeric']} #{row['format'].strip}\n" if row['format']
+
+      name = row['name']
+      if counts[name] > 1 and row['origin']
+        name += '_' + row['origin'].gsub(/[^[:alnum:]]/, '_').gsub(/_{2,}/, '_').sub(/_$/, '').upcase
+      end
+      if constants[name]
+        name += '_ALT'
+        if constants[name]
+          fail <<~MSG
+            Couldn't derive a unique name for #{name}.
+            Previous source: #{constants[name].inspect}
+          MSG
+        end
+      end
+
+      constants[name] = row
+
+      out << "    #{name} = #{row['numeric'].to_sym.inspect}"
+      out << "\n"
+    end
+
+    out << <<~FOOTER
+        end
+      end
+    FOOTER
+  end
+
+  puts "%d numerics." % data['values'].count
+  system('wc', File.join(__dir__, 'lib/iirc/numerics.rb'))
+end
+
 task default: :test
+

data/lib/iirc/bot/ambient.rb

@@ -1,60 +1,61 @@
 require_relative "reply_target"
 
 module IIRC
-  module Bot::AmbientEvents
-    private
-      def configure_ambient_events
-        hook :set_ambient_event
-      end
+  module Bot::Ambient
+    module Events
+      private
+        def configure_ambient_events
+          hook :set_ambient_event
+        end
 
-      def ambient_event
-        Thread.current[:ambient_event]
-      end
+        def ambient_event
+          Thread.current[:ambient_event]
+        end
 
-      def ambient_target; ambient_event&.target; end
-      def ambient_sender; ambient_event&.sender; end
+        def ambient_target; ambient_event&.target; end
+        def ambient_sender; ambient_event&.sender; end
 
-      def set_ambient_event(evt)
-        Thread.current[:ambient_event] = evt
-      end
+        def set_ambient_event(evt)
+          Thread.current[:ambient_event] = evt
+        end
 
-      def with_ambient_event(evt)
-        initial_event = ambient_event
-        set_ambient_event(evt)
-        begin
-          yield evt
-        ensure
-          set_ambient_event(initial_event)
+        def with_ambient_event(evt)
+          initial_event = ambient_event
+          set_ambient_event(evt)
+          begin
+            yield evt
+          ensure
+            set_ambient_event(initial_event)
+          end
         end
-      end
-  end
+    end
 
-  module Bot::AmbientEvents::LabeledRequests
-    def labeled_request(*)
-      initial_evt = ambient_event
-      super do |reply|
-        with_ambient_event(initial_evt) { yield reply }
+    module LabeledRequests
+      def labeled_request(*)
+        initial_evt = ambient_event
+        super do |reply|
+          with_ambient_event(initial_evt) { yield reply }
+        end
       end
     end
-  end
 
-  module Bot::AmbientEvents::ReplyTarget
-    include Bot::ReplyTarget
-    def ambient_reply_target
-      reply_target(ambient_event)
+    module ReplyTarget
+      def reply_target(evt=ambient_event) super end
+    end
+
+    module Verbs
+      include Events
+      include ReplyTarget
+
+      def join(channel=reply_target) super end
+      def part(channel=reply_target, reason='') super end
+      def msg(target=reply_target, msg) super end
+      def act(target=reply_target, msg) super end
+      def cycle(channel=reply_target, reason='') super end
+      def mode(target=reply_target, mode) super end
+      alias :say :msg
     end
-  end
 
-  module Bot::AmbientVerbs
-    include Bot::AmbientEvents
-    include Bot::AmbientEvents::ReplyTarget
-
-    def join(channel=ambient_reply_target) super end
-    def part(channel=ambient_reply_target, reason='') super end
-    def msg(channel=ambient_reply_target, msg) super end
-    def act(channel=ambient_reply_target, msg) super end
-    def cycle(channel=ambient_reply_target, reason='') super end
-    def mode(channel=ambient_reply_target, mode) super end
-    alias :say :msg
+    include Verbs
   end
-end
+end

data/lib/iirc/bot/isupport.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module IIRC
+  # Parses RPL_ISUPPORT (005) events into a Hash.
+  #
+  # These are sent by servers after registration to provide info about the network,
+  # what the server supports, and how it behaves.
+  #
+  # Provides a Hash of the raw values, extended with helper methods which process them.
+  #
+  # @see https://defs.ircdocs.horse/defs/isupport.html List of tokens and their values (defs.ircdocs.horse)
+  # @see https://datatracker.ietf.org/doc/html/draft-hardy-irc-isupport-00
+  # @see https://datatracker.ietf.org/doc/html/draft-brocklesby-irc-isupport-00
+  module Bot::ISupport
+    # Hash of tokens sent by the server after registration indicating feature support and limits.
+    # @return [Hash#extend(Inquiry)] the raw isupport key=>value pairs. keys with no value are assigned +true+.
+    def isupport
+      @isupport ||= {}.extend(Inquiry)
+    end
+
+    private
+      def configure_isupport
+        on :'005', :store_isupport
+      end
+
+      def store_isupport(evt)
+        tokens = evt.args[1..-2]
+
+        for token in tokens
+          name, value = token.split('=', 2)
+          isupport[name] = value.freeze || true
+        end
+      end
+  end
+
+  # Methods for inquiry into a Hash of raw ISUPPORT key=>value pairs.
+  # These are mixed in to the Hash returned by {ISupport#isupport}.
+  #
+  # The key=>value format returned by #isupport won't change.
+  # Rather, methods which process the values can be added here.
+  module Bot::ISupport::Inquiry
+    # Whether or not the server supports a user mode which lets clients mark themselves as bots.
+    def bot_mode?
+      !!bot_mode
+    end
+
+    # User mode which can be used to mark clients as bots.
+    # @return [String] mode char (usually 'B')
+    # @return [nil] if mode is not supported
+    def bot_mode
+      self['BOT']
+    end
+
+    # A string indicating the case mapping used by the server to determine case-insensitive equality
+    # of channel names and nick names.
+    #
+    # @note IIRC does not currently perform case-insensitive comparisons. This may change in future.
+    # @return [String] the name of the casemapping. e.g. 'ascii', 'rfc1459', 'rfc3454'
+    def case_mapping
+      self['CASEMAPPING']
+    end
+
+    # Characters used as channel prefixes by this server.
+    # @see https://defs.ircdocs.horse/defs/chantypes.html
+    # @return [Array] prefixes, e.g. ['#', '&']
+    def channel_prefixes
+      (@channel_prefixes ||= self['CHANTYPES']&.chars.freeze) || ['#'].freeze
+    end
+  end
+end

data/lib/iirc/bot/members.rb

@@ -1,15 +1,11 @@
 module IIRC
   module Bot::Members
-    def self.configure_actions
-      [:listen_for_names]
-    end
-
     def members
       @members ||= {}
     end
 
     private
-      def listen_for_names
+      def configure_members_tracking
         on :'353', :receive_names
         on :'366', :receive_names_end
       end

data/lib/iirc/bot.rb

@@ -30,7 +30,7 @@ module IIRC
     end
 
     private def ensure_registration_info!
-      me.username ||= me.nick.downcase
+      me.username ||= me.nick&.downcase
       me.realname ||= me.nick
       raise ArgumentError.new('no nick given') unless me.nick && !me.nick.empty?
     end