iirc 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89d3e4727f759400cf52bf6a8cb23b365d62259ef32fd977c6fcaab0d542fa53
-  data.tar.gz: fc476e509a2ca6e620d6b93bbde705113136926e574860b05bc5508c332f8e51
+  metadata.gz: 2e4ac6446425ac435d2277035d20421968eb778ba3ff980adc1a81a77e9822ef
+  data.tar.gz: 4c19e2b02319359014d0d9f14a5a9d1f757a948bac14bcc5152635dbb7412e50
 SHA512:
-  metadata.gz: c9cbf42882b4aeb2ae080266750d540d5f834a6c55be22d8b75541c7ca4b521492eacae055c21a3bdb716ca691e3db8a685c79d918c353df324ed8f42b9f168d
-  data.tar.gz: 98d82cf28be02e06e32dd8c6978eb0470ca486c6b9f898fb0642e244e2edbaa99f2c0df9aa9fc4491610968d72736cfae05aba8dfddd1fe04fcdf72681389503
+  metadata.gz: 1db175bc3db1cbc464652f8ba5e7153e087851bc803adccd4d8434420095d0431f4e41b2ff31122333ba29895d7c66f609ea3d11d6f7d76f1b0024dbbc55d8f4
+  data.tar.gz: a759db9e4264a582b373bc708948330ea58a26639e66e9610cc9258e3965f810de0101ad97acb6ca095c4a926de4899526e64cc53f46391b0ae91006a8b03114

data/.yardopts

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

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [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

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 "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/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/version.rb

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

data/lib/iirc.rb

@@ -14,6 +14,7 @@ require_relative "iirc/bot/channels"
 require_relative "iirc/bot/configure"
 require_relative "iirc/bot/formatting"
 require_relative "iirc/bot/hooks"
+require_relative "iirc/bot/isupport"
 require_relative "iirc/bot/members"
 require_relative "iirc/bot/oper_up"
 require_relative "iirc/bot/parsing"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iirc
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - mooff
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-27 00:00:00.000000000 Z
+date: 2022-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ircparser
@@ -33,6 +33,7 @@ extra_rdoc_files: []
 files:
 - ".github/workflows/main.yml"
 - ".gitignore"
+- ".yardopts"
 - CHANGELOG.md
 - Gemfile
 - LICENSE
@@ -57,6 +58,7 @@ files:
 - lib/iirc/bot/ircv3/caps.rb
 - lib/iirc/bot/ircv3/labeled_requests.rb
 - lib/iirc/bot/ircv3/parsing.rb
+- lib/iirc/bot/isupport.rb
 - lib/iirc/bot/members.rb
 - lib/iirc/bot/oper_up.rb
 - lib/iirc/bot/parsing.rb