iirc 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0fe307700ed349facc2bfced87e9f2081534b3aa8f5807e104e923c29970d63a
+  data.tar.gz: 53f7ed40fc8fc50f0f10cfb05baed481b0e9cea39158f28ccf4bc3d2f672f4b9
+SHA512:
+  metadata.gz: b7505abc4e38ecf5b78c3f3159841b06250399457012e8d7c94415e56ef0a3f439a3e6e3523fceed31c5dcb9454288807d30a52f7377c3126e20a1417b7960b2
+  data.tar.gz: d1a53a1d19cd9da9db10eada940432597638dab3c5b07a61aa34fe04f3d02a90ac813e700d5cacdeb9497b6d57914364412e2fa6853f8209da02456be06055cc

data/.github/workflows/main.yml

@@ -0,0 +1,16 @@
+name: Ruby
+
+on: [push,pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.7.4
+        bundler-cache: true
+    - name: Run the default task
+      run: bundle exec rake

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+## [Unreleased]
+
+## [0.2.0] - 2022-03-12
+
+- Extracted Bot::AmbientEvents
+- Extracted IRCv3::LabeledRequests
+
+## [0.1.0] - 2022-03-12
+
+- Library extracted from bot (developed since Dec 2021)
+- Yay first release \o/

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in iirc.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "minitest", "~> 5.0"

data/README.md

@@ -0,0 +1,35 @@
+# 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.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'iirc'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install iirc
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/awfulcooking/iirc.

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "iirc"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/iirc.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "lib/iirc/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "iirc"
+  spec.version       = IIRC::VERSION
+  spec.authors       = ["mooff"]
+  spec.email         = ["mooff@awful.cooking"]
+
+  spec.summary       = "Lean, mean IRC processing machine"
+  spec.description   = "A composable toolkit for IRC bots"
+  spec.homepage      = "https://github.com/awfulcooking/iirc"
+  spec.required_ruby_version = ">= 2.6.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/awfulcooking/iirc"
+  spec.metadata["changelog_uri"] = "https://github.com/awfulcooking/iirc/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+
+  # For more information and examples about making a new gem, checkout our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/lib/iirc/bot/ambient.rb

@@ -0,0 +1,50 @@
+module IIRC
+  module Bot::AmbientEvents
+    private
+      def configure_ambient_events
+        hook :set_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 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)
+        end
+      end
+  end
+
+  module Bot::AmbientVerbs
+    include Bot::AmbientEvents
+
+    def join(channel=ambient_target) super end
+    def part(channel=ambient_target, reason='') super end
+    def msg(channel=ambient_target, msg) super end
+    def act(channel=ambient_target, msg) super end
+    def cycle(channel=ambient_target, reason='') super end
+    def mode(channel=ambient_target, mode) super end
+    alias :say :msg
+  end
+
+  module Bot::AmbientEvents::LabeledRequests
+    def labeled_request(*)
+      initial_evt = ambient_event
+      super do |reply|
+        with_ambient_event(initial_evt) { yield reply }
+      end
+    end
+  end
+end

data/lib/iirc/bot/autojoin.rb

@@ -0,0 +1,18 @@
+module IIRC
+  module Bot::AutoJoin
+    private def configure_autojoin_hook
+      on :'001', :autojoin!
+    end
+
+    def autojoin!
+      for channel in autojoin_channels
+        self << "JOIN #{channel}"
+      end
+    end
+
+    # override this to read from e.g. redis, config
+    def autojoin_channels
+      []
+    end
+  end
+end

data/lib/iirc/bot/channels.rb

@@ -0,0 +1,35 @@
+module IIRC
+  module Bot::Channels
+    def channels
+      @channels ||= Set.new
+    end
+
+    private
+      def configure_channel_tracking
+        hook :track_self_channels
+      end
+
+      def track_self_channels(evt)
+        case evt.verb
+        when :'001'
+          channels.clear
+        when :join
+          if me === evt.sender
+            for c in evt.target.split(',')
+              channels << c
+            end
+          end
+        when :part
+          if me === evt.sender
+            for c in evt.target.split(',')
+              channels.delete(c)
+            end
+          end
+        when :kick
+          if me === evt.args[1]
+            channels.delete(evt.target)
+          end
+        end
+      end
+  end
+end

data/lib/iirc/bot/configure.rb

@@ -0,0 +1,43 @@
+module IIRC
+  module Bot::Configure
+    def self.included(m)
+      require 'set'
+      m.extend ClassMethods
+    end
+
+    module ClassMethods
+      def configure_actions
+        @configures ||= Set.new
+      end
+
+      def configure action=nil, &blk
+        configure_actions << (action || blk)
+      end
+    end
+
+    def initialize(*)
+      super if defined? super
+      configure!
+    end
+
+    def configure!
+      for action in configure_actions
+        if action.is_a? Symbol
+          send(action)
+        else
+          instance_exec(&action)
+        end
+      end
+    end
+
+    private def configure_actions
+      singleton_class.ancestors
+        .filter   { |m| m.respond_to?(:configure_actions) }
+        .flat_map { |m| m.configure_actions.to_a }
+        .concat((methods + private_methods).grep(/^configure_(?!actions)/))
+        .compact
+        .uniq
+    end
+  end
+
+end

data/lib/iirc/bot/formatting.rb

@@ -0,0 +1,11 @@
+module IIRC
+  module Bot::Formatting
+    module_function
+      def bold s; "#{s}"; end
+      def italic s; "#{s}"; end
+      def strike s; "#{s}"; end
+      def underline s; "#{s}"; end
+      def strip s; s.gsub /\x03(?:\d{1,2}(?:,\d{1,2})?)?/, ''; end
+      alias :strip_formatting :strip
+  end
+end

data/lib/iirc/bot/hooks.rb

@@ -0,0 +1,66 @@
+module IIRC
+  module Bot::Hooks
+    def hooks
+      @hooks ||= Hash.new { |h,v| h[v] = Set.new }
+    end
+
+    def on verb=nil, action=nil, &blk
+      if action and blk
+        define_singleton_method(action, blk)
+        singleton_class.send :private, action
+      end
+
+      if action or blk
+        hooks[verb] << (action || blk)
+      else
+        hooks[verb]
+      end
+    end
+
+    def hook action=nil, &blk
+      on nil, action, &blk
+    end
+
+    def off verb, action=nil, &blk
+      action ||= blk
+      if action
+        hooks[verb].delete action
+      else
+        hooks[verb].clear
+      end
+    end
+
+    def fire! verb, *args, **kwargs
+      if respond_to? :"on_#{verb}"
+        send(:"on_#{verb}", *args, **kwargs)
+      end
+      for action in [*hooks[nil], *hooks[verb]]
+        call action, *args, **kwargs
+      end
+    rescue StopIteration
+      StopIteration
+    end
+
+    def call action, *args, **kwargs
+      case action
+      when Symbol
+        args = method(action).arity.then { |n| n.negative? ? args : args[...n] }
+        send(action, *args, **kwargs)
+      else
+        action.call(*args, **kwargs)
+      end
+    end
+
+    def run
+      lines { |line|
+        begin
+          evt = parse(line)
+          fire! evt.verb, evt
+        rescue Exception => ex
+          puts ex.message
+          puts ex.backtrace
+        end
+      }
+    end
+  end
+end

data/lib/iirc/bot/ircv3/batches.rb

@@ -0,0 +1,45 @@
+module IIRC
+  module Bot::IRCv3
+    class Batch < Event
+      attr_accessor :events
+
+      def events
+        @events ||= []
+      end
+    end
+
+    module Batches
+      def configure_batches
+        hook :receive_batches
+      end
+
+      def batches_in_flight
+        @batches_in_flight ||= {}
+      end
+
+      def receive_batches evt
+        return if evt.is_a? Batch # fully formed synthetic batch
+
+        if evt.verb == :batch
+          ± = evt.target[0]
+          id = evt.target[1..]
+
+          if ± == '+'
+            batches_in_flight[id] = Batch.new(
+              sender: evt.sender,
+              verb: evt.verb,
+              args: evt.args.dup.tap { |args| args[0] = id },
+              tags: evt.tags,
+            )
+          else
+            fire! :batch, batches_in_flight.delete(id)
+          end
+          raise StopIteration
+        elsif evt.tags['batch']
+          id = evt.tags['batch']
+          batches_in_flight[id].events << evt
+        end
+      end
+    end
+  end
+end

data/lib/iirc/bot/ircv3/caps.rb

@@ -0,0 +1,17 @@
+module IIRC
+  module Bot::IRCv3
+    module Caps
+      def caps
+        raise NotImplementedError.new
+      end
+
+      def cap? name
+        caps.include? name
+      end
+
+      def cap! name
+        self << "CAP REQ :#{name}"
+      end
+    end
+  end
+end

data/lib/iirc/bot/ircv3/labeled_requests.rb

@@ -0,0 +1,27 @@
+module IIRC
+  module Bot::IRCv3
+    module LabeledRequests
+      def labeled_request(line)
+        SecureRandom.alphanumeric(8).tap { |id|
+          labeled_requests[id] = -> evt { yield evt }
+          self << "@label=#{id} #{line}"
+        }
+      end
+
+      def labeled_requests
+        @requests ||= {}
+      end
+
+      private
+        def configure_labeled_requests
+          hook :dispatch_replies
+        end
+
+        def dispatch_replies(evt)
+          if evt.tags['label']
+            labeled_requests.delete(evt.tags['label'])&.call(evt)
+          end
+        end
+    end
+  end
+end

data/lib/iirc/bot/ircv3/parsing.rb

@@ -0,0 +1,18 @@
+module IIRC
+  module Bot::IRCv3
+    module Parsing
+      autoload :IRCParser, 'ircparser'
+
+      def parse(line)
+        msg = IRCParser::Message.parse(line.chomp)
+
+        Bot::Event.new.tap { |evt|
+          evt.sender = IRCParser::RFCWireFormat.__stringify_prefix(msg.prefix) if msg.prefix
+          evt.tags = msg.tags
+          evt.verb = msg.command.downcase.to_sym
+          evt.args = msg.parameters
+        }
+      end
+    end
+  end
+end

data/lib/iirc/bot/members.rb

@@ -0,0 +1,32 @@
+module IIRC
+  module Bot::Members
+    def self.configure_actions
+      [:listen_for_names]
+    end
+
+    def members
+      @members ||= {}
+    end
+
+    private
+      def listen_for_names
+        on :'353', :receive_names
+        on :'366', :receive_names_end
+      end
+
+      def receive_names evt
+        names = evt.args[3]
+        channel = evt.args[2]
+        members_receiving[channel].concat names.tr('&+@%~', '').split(' ')
+      end
+
+      def receive_names_end evt
+        channel = evt.args[1]
+        members[channel] = members_receiving.delete(channel)
+      end
+
+      def members_receiving
+        @members_receiving ||= Hash.new { |h,k| h[k] = [] }
+      end
+  end
+end

data/lib/iirc/bot/oper_up.rb

@@ -0,0 +1,15 @@
+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
+  end
+end

data/lib/iirc/bot/parsing.rb

@@ -0,0 +1,24 @@
+module IIRC
+  module Bot::Parsing
+    def parse(line)
+      Bot::Event.new.tap { |evt|
+        words = line.chomp.split " "
+
+        if words[0] and words[0].start_with? ":"
+          evt.sender = words.shift[1..]
+        end
+
+        evt.verb = words.shift.downcase.to_sym
+
+        while word = words.shift
+          if word.start_with? ':'
+            evt.args << [word[1..], *words].join(' ')
+            break
+          else
+            evt.args << word
+          end
+        end
+      }
+    end
+  end
+end

data/lib/iirc/bot/pong.rb

@@ -0,0 +1,7 @@
+module IIRC
+  module Bot::Pong
+    def on_ping evt
+      self << "PONG :#{evt.args[0]}"
+    end
+  end
+end

data/lib/iirc/bot/reading.rb

@@ -0,0 +1,9 @@
+module IIRC
+  module Bot::Reading
+    def lines
+      loop {
+        yield socket.readline.force_encoding('utf-8').encode
+      }
+    end
+  end
+end

data/lib/iirc/bot/redis.rb

@@ -0,0 +1,11 @@
+module IIRC
+  module Bot::Redis
+    def self.included(*)
+      require 'redis'
+    end
+
+    def redis
+      @redis ||= ::Redis.new
+    end
+  end
+end

data/lib/iirc/bot/regex_hooks.rb

@@ -0,0 +1,20 @@
+module IIRC
+  module Bot::RegexHooks
+    def regex_hooks
+      hooks.filter { |k,v| Regexp === k }.freeze
+    end
+
+    private
+      def configure_regex_hooks
+        on :privmsg, :do_regex_matches
+      end
+
+      def do_regex_matches(evt)
+        regex_hooks
+          .filter { |k,v| k === evt.message }
+          .each_value { |actions|
+            actions.each { |action| call action, evt }
+          }
+      end
+  end
+end

data/lib/iirc/bot/track_own_nick.rb

@@ -0,0 +1,9 @@
+module IIRC
+  module Bot::TrackOwnNick
+    def on_nick evt
+      if me === evt.sender
+        self.user.nick = evt.args[0]
+      end
+    end
+  end
+end

data/lib/iirc/bot/verbs.rb

@@ -0,0 +1,25 @@
+module IIRC
+  module Bot::Verbs
+    def join(channel) self << "JOIN #{channel}" end
+    def part(channel, reason=nil) self << "PART #{channel}#{" :#{reason}" if reason}" end
+    def names(channel) self << "NAMES #{channel}" end
+    def who(target) self << "WHO #{target}" end
+    def msg(target, msg) for line in msg.to_s.lines; self << "PRIVMSG #{target} :#{line.chomp}"; end; self end
+    def act(target, msg) for line in msg.to_s.lines; self << "PRIVMSG #{target} :\001ACTION #{line.chomp}\001"; end; self end
+    def notice(target,msg) for line in msg.to_s.lines; self << "NOTICE #{target} :#{line.chomp}"; end; self end
+    def quit(msg='Quitting') self << "QUIT :#{msg}" end
+    def invite(target, channel) self << "INVITE #{target} #{channel}" end
+    def cycle(target, reason='') part(target, reason); join(target) end
+    def nick(new) self << "NICK #{new}" end
+    def ping(token=nil) self << (token ? "PING :#{token}" : "PING") end
+    def pong(token=nil) self << (token ? "PONG :#{token}" : "PONG") end
+    def mode(target, mode) self << "MODE #{target} #{mode}" end
+    def wallops(msg) for line in msg.to_s.lines; self << "WALLOPS :#{line.chomp}"; end; self end
+    def kill(target, msg='.') self << "KILL #{target} :#{msg}" end
+    def kick(channel, target, msg='') self << "KICK #{channel} #{target} :#{msg}" end
+    def topic(channel, new_topic='') self << (new_topic ? "TOPIC #{channel} :#{new_topic.lines.first.chomp}" : "TOPIC #{channel}") end
+
+    alias :privmsg :msg
+    alias :say :msg
+  end
+end

data/lib/iirc/bot.rb

@@ -0,0 +1,38 @@
+module IIRC
+  class Bot
+    attr_accessor :socket
+    attr_accessor :user
+    alias :me :user
+
+    def <<(text)
+      socket << text + "\r\n"
+      self
+    end
+
+    def to_s
+      "[#{self.class.name}:#{user.nick}]"
+    end
+
+    def inspect
+      "<#{me}>"
+    end
+
+    def initialize(socket=nil, user={})
+      super() if defined? super
+      self.socket = socket
+      self.user = user.is_a?(User) ? user : User.new(**user)
+    end
+
+    def register!
+      ensure_registration_info!
+      self << "USER #{me.username} 0 0 :#{me.realname}"
+      self << "NICK #{me.nick}"
+    end
+
+    private def ensure_registration_info!
+      me.username ||= me.nick.downcase
+      me.realname ||= me.nick
+      raise ArgumentError.new('no nick given') unless me.nick && !me.nick.empty?
+    end
+  end
+end

data/lib/iirc/event.rb

@@ -0,0 +1,29 @@
+module IIRC
+  class Event
+    attr_accessor :sender, :verb, :args, :tags
+
+    def initialize(sender: nil, verb: nil, args: nil, tags: nil)
+      self.sender = sender
+      self.verb = verb
+      self.args = args
+      self.tags = tags
+    end
+
+    def sender=(v)
+      v.extend Sender if v
+      @sender = v
+    end
+
+    def args=(v)
+      @args = v || []
+    end
+
+    def target
+      args.first
+    end
+
+    def message
+      args.last
+    end
+  end
+end

data/lib/iirc/sender.rb

@@ -0,0 +1,29 @@
+module IIRC
+  module Sender
+    def user
+      @user ||= User.from_sender(self)
+    end
+
+    def server?
+      user.nil?
+    end
+
+    def user?
+      not user.nil?
+    end
+
+    def nick; user&.nick end
+    def username; user&.username end
+    def host; user&.host end
+
+    def to_prefix
+      ":#{self}"
+    end
+
+    def to_s
+      delete_prefix(':')
+    end
+
+    alias :inspect :to_prefix
+  end
+end

data/lib/iirc/user.rb

@@ -0,0 +1,57 @@
+module IIRC
+  class User
+    attr_accessor :nick, :username, :realname, :host
+    alias :name  :realname
+    alias :gecos :realname
+
+    class << self
+      def from_sender(str)
+        str = str[1..] if str.start_with? ':'
+
+        username, _, host = str.partition("@")
+        nick, _, username = username.partition("!")
+
+        return nil if nick.include? '.' # sender is a server, not a user
+
+        nick = nil if nick.empty?
+        username = nil if username.empty?
+        host = nil if host.empty?
+
+        new(nick: nick, username: username, host: host)
+      end
+    end
+
+    def initialize(nick:nil,username:nil,realname:nil,host:nil)
+      self.nick = nick
+      self.username = username
+      self.realname = realname
+      self.host = host
+    end
+
+    def to_s
+      "#{nick}".tap do |s|
+        if username and host
+          s << "!#{username}@#{host}"
+        end
+      end
+    end
+
+    def to_prefix
+      ":#{self}"
+    end
+
+    def ===(other)
+      if other.respond_to? :nick
+        nick and nick.downcase == other.nick.downcase
+      elsif other.is_a? String
+        if other.include? ' ' or other.include? '.'
+          false
+        elsif nick
+          nick and nick.downcase == User.from_source(other)&.nick&.downcase
+        end
+      else
+        false
+      end
+    end
+  end
+end

data/lib/iirc/version.rb

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

data/lib/iirc.rb

@@ -0,0 +1,55 @@
+require_relative "iirc/version"
+
+require_relative "iirc/event"
+require_relative "iirc/sender"
+require_relative "iirc/user"
+
+require_relative "iirc/bot"
+require_relative "iirc/bot/ambient"
+require_relative "iirc/bot/autojoin"
+require_relative "iirc/bot/channels"
+require_relative "iirc/bot/configure"
+require_relative "iirc/bot/formatting"
+require_relative "iirc/bot/hooks"
+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/reading"
+require_relative "iirc/bot/redis"
+require_relative "iirc/bot/regex_hooks"
+require_relative "iirc/bot/track_own_nick"
+require_relative "iirc/bot/verbs"
+
+require_relative "iirc/bot/ircv3/caps"
+require_relative "iirc/bot/ircv3/parsing"
+require_relative "iirc/bot/ircv3/batches"
+require_relative "iirc/bot/ircv3/labeled_requests"
+
+module IIRC
+  class Error < StandardError; end
+
+  class Bot
+    include Reading
+    include Parsing
+    include Hooks
+    include Configure
+    include Pong
+    include TrackOwnNick
+  end
+
+  class IRCv3Bot < Bot
+    include IRCv3::Parsing
+    include IRCv3::Caps
+    include IRCv3::Batches
+    include IRCv3::LabeledRequests
+  end
+
+  class Batteries < IRCv3Bot
+    include Channels
+    include Members
+    include Formatting
+    include AutoJoin
+    include Verbs
+  end
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: iirc
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- mooff
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2022-03-12 00:00:00.000000000 Z
+dependencies: []
+description: A composable toolkit for IRC bots
+email:
+- mooff@awful.cooking
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".gitignore"
+- CHANGELOG.md
+- Gemfile
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- iirc.gemspec
+- lib/iirc.rb
+- lib/iirc/bot.rb
+- lib/iirc/bot/ambient.rb
+- lib/iirc/bot/autojoin.rb
+- lib/iirc/bot/channels.rb
+- lib/iirc/bot/configure.rb
+- lib/iirc/bot/formatting.rb
+- lib/iirc/bot/hooks.rb
+- lib/iirc/bot/ircv3/batches.rb
+- lib/iirc/bot/ircv3/caps.rb
+- lib/iirc/bot/ircv3/labeled_requests.rb
+- lib/iirc/bot/ircv3/parsing.rb
+- lib/iirc/bot/members.rb
+- lib/iirc/bot/oper_up.rb
+- lib/iirc/bot/parsing.rb
+- lib/iirc/bot/pong.rb
+- lib/iirc/bot/reading.rb
+- lib/iirc/bot/redis.rb
+- lib/iirc/bot/regex_hooks.rb
+- lib/iirc/bot/track_own_nick.rb
+- lib/iirc/bot/verbs.rb
+- lib/iirc/event.rb
+- lib/iirc/sender.rb
+- lib/iirc/user.rb
+- lib/iirc/version.rb
+homepage: https://github.com/awfulcooking/iirc
+licenses: []
+metadata:
+  homepage_uri: https://github.com/awfulcooking/iirc
+  source_code_uri: https://github.com/awfulcooking/iirc
+  changelog_uri: https://github.com/awfulcooking/iirc/blob/main/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.5
+signing_key: 
+specification_version: 4
+summary: Lean, mean IRC processing machine
+test_files: []