irc_socket 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e4c693a95c5ee11f00d4801bbb01747635a2fb134858dd9312a96224e1e31180
+  data.tar.gz: f512fa98cb41980cdb6006f243f701f961c6c3f025addb4f50014b65b3987cd1
+SHA512:
+  metadata.gz: 49476fa472445c39e051f50528e211af8103669a6545bfb5f4500d96c347c5a5b066801bf89fc158459816f2dcb08de249e92bb5df542d221492bcefe5251370
+  data.tar.gz: 8c7cfca56dbb7b0570f893307fae06c7f200f64d4e0a318fe1ba36fd3165aa144fba9620b82dbf61a51398ce245bf561d8ae2ff26253fa5f9889933d1b5dfa01

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Lee Jarvis
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,35 @@
+== Description
+
+IRCSocket is an IRC wrapper around a TCPSocket. It implements all of the major
+commands laid out in {RFC 2812}[http://irchelp.org/irchelp/rfc/rfc2812.txt].
+All these commands are available as instance methods of an IRCSocket Object.
+
+API documentation is available {here}[http://rdoc.injekt.net/irc-socket]
+
+== Example
+  irc = IRCSocket.new('irc.freenode.org')
+  irc.connect
+
+  if irc.connected?
+    irc.nick "HulkHogan"
+    irc.user "Hulk", 0, "*", "I am Hulk Hogan"
+
+    while line = irc.read
+
+      # Join a channel after MOTD
+      if line.split[1] == '376'
+        irc.join "#mychannel"
+      end
+
+      puts "Received: #{line}"
+    end
+  end
+
+== Installation
+  gem install irc-socket
+
+Or alternatively you can clone the Github repository
+  git clone https://github.com/injekt/irc-socket
+
+== Notes
+I may have missed something in the RFC. Patches welcome.

data/lib/irc_socket.rb

@@ -0,0 +1,300 @@
+require 'socket'
+
+# == Author
+# * Lee Jarvis - ljjarvis@gmail.com
+#
+# == Description
+# IRCSocket is an IRC wrapper around a TCPSocket. It implements all of the major 
+# commands laid out in {RFC 2812}[http://irchelp.org/irchelp/rfc/rfc2812.txt].
+# All these commands are available as instance methods of an IRCSocket Object.
+#
+# == Example
+#  irc = IRCSocket.new('irc.freenode.org')
+#  irc.connect
+#
+#  if irc.connected?
+#    irc.nick "HulkHogan"
+#    irc.user "Hulk", 0, "*", "I am Hulk Hogan"
+#
+#    while line = irc.read
+#         
+#      # Join a channel after MOTD
+#      if line.split[1] == '376'
+#        irc.join "#mychannel"
+#      end
+#
+#      puts "Received: #{line}"
+#    end
+#  end
+#
+# === Block Form
+#  IRCSocket.new('irc.freenode.org') do |irc|
+#    irc.nick "SpongeBob"
+#    irc.user "Spongey", 0, "*", "Square Pants"
+#
+#    puts irc.read
+#  end
+class IRCSocket
+
+  # The server our socket is connected to
+  attr_reader :server
+
+  # The port our socket is connected on
+  attr_reader :port
+
+  # The TCPSocket instance
+  attr_reader :socket
+
+  # Creates a new IRCSocket and automatically connects
+  #
+  # === Example
+  #  irc = IRCSocket.open('irc.freenode.org')
+  #
+  #  while data = irc.read
+  #    puts data
+  #  end
+  def self.open(server, port=6667, ssl=false)
+    irc = new(server, port, ssl)
+    irc.connect
+    irc
+  end
+  
+  # Create a new IRCSocket to connect to +server+ on +port+. Defaults to port 6667.
+  # If an optional code block is given, it will be passed an instance of the IRCSocket.
+  #
+  # NOTE: Using the block form does not mean the socket will send the applicable QUIT
+  # command to leave the IRC server. You must send this yourself.
+  def initialize(server, port=6667, ssl=false)
+    @server = server
+    @port = port
+    @ssl = ssl
+
+    @socket = nil
+    @connected = false
+
+    if block_given?
+      connect
+      yield self      
+    end
+  end
+  
+  # Check if our socket is alive and connected to an IRC server
+  def connected?
+    @connected
+  end
+  alias connected connected?
+  
+  # Connect to an IRC server, returns true on a successful connection, or
+  # raises otherwise
+  def connect
+    socket = TCPSocket.new(server, port)
+
+    if @ssl
+      require 'openssl'
+
+      ssl = OpenSSL::SSL::SSLContext.new
+      ssl.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      @socket = OpenSSL::SSL::SSLSocket.new(socket, ssl)
+      @socket.sync = true
+      @socket.connect
+    else
+      @socket = socket
+    end
+  rescue Interrupt
+    raise
+  rescue Exception
+    raise
+  else
+    @connected = true
+  end
+
+  # Read the next line in from the server. If no arguments are passed
+  # the line will have the CRLF chomp'ed. Returns nil if no data could be read
+  def read(chompstr="\r\n")
+    if data = @socket.gets("\r\n")
+      data.chomp!(chompstr) if chompstr
+      data
+    else
+      nil
+    end
+  rescue IOError
+    nil
+  end
+
+  # Write to our Socket and append CRLF
+  def write(data)
+    @socket.write(data + "\r\n")
+  rescue IOError
+    raise
+  end
+
+  # Sugar for #write
+  def raw(*args) # :nodoc:
+    args.last.insert(0, ':') unless args.last.nil?
+    write args.join(' ').strip
+  end
+
+  # More sugar
+  def write_optional(command, *optional) # :nodoc:
+    command = "#{command} #{optional.join(' ')}" if optional
+    write(command.strip)
+  end
+  private :raw, :write_optional
+
+  # Send PASS command
+  def pass(password)
+    write("PASS #{password}")
+  end
+
+  # Send NICK command
+  def nick(nickname)
+    write("NICK #{nickname}")
+  end
+
+  # Send USER command 
+  def user(user, mode, unused, realname)
+    write("USER #{user} #{mode} #{unused} :#{realname}")
+  end
+
+  # Send OPER command
+  def oper(name, password)
+    write("OPER #{name} #{password}")
+  end
+
+  # Send the MODE command.
+  # Should probably implement a better way of doing this
+  def mode(channel, *modes)
+    write("MODE #{channel} #{modes.join(' ')}")
+  end
+
+  # Send QUIT command
+  def quit(message=nil)
+    raw("QUIT", message)
+  end
+
+  # Send JOIN command - Join a channel with given password
+  def join(channel, password=nil)
+    write_optional("JOIN #{channel}", password)
+  end
+
+  # Send PART command
+  def part(channel, message=nil)
+    raw("PART", channel, message)
+  end
+
+  # Send TOPIC command
+  def topic(channel, topic=nil)
+    raw("TOPIC", channel, topic)
+  end
+
+  # Send NAMES command
+  def names(*channels)
+    write("NAMES #{channels.join(',') unless channels.empty?}")
+  end
+
+  # Send LIST command
+  def list(*channels)
+    write("LIST #{channels.join(',') unless channels.empty?}")
+  end
+
+  # Send INVITE command
+  def invite(nickname, channel)
+    write("INVITE #{nickname} #{channel}")
+  end
+
+  # Send KICK command
+  def kick(channel, user, comment=nil)
+    raw("KICK", channel, user, comment)
+  end
+
+  # Send PRIVMSG command
+  def privmsg(target, message)
+    write("PRIVMSG #{target} :#{message}")
+  end
+
+  # Send NOTICE command
+  def notice(target, message)
+    write("NOTICE #{target} :#{message}")
+  end
+
+  # Send MOTD command
+  def motd(target=nil)
+    write_optional("MOTD", target)
+  end
+
+  # Send VERSION command
+  def version(target=nil)
+    write_optional("VERSION", target)
+  end
+
+  # Send STATS command
+  def stats(*params)
+    write_optional("STATS", params)
+  end
+
+  # Send TIME command
+  def time(target=nil)
+    write_optional("TIME", target)
+  end
+
+  # Send INFO command
+  def info(target=nil)
+    write_optional("INFO", target)
+  end
+
+  # Send SQUERY command
+  def squery(target, message)
+    write("SQUERY #{target} :#{message}")
+  end
+
+  # Send WHO command
+  def who(*params)
+    write_optional("WHO", params)
+  end
+
+  # Send WHOIS command
+  def whois(*params)
+    write_optional("WHOIS", params)
+  end
+
+  # Send WHOWAS command
+  def whowas(*params)
+    write_optional("WHOWAS", params)
+  end
+
+  # Send KILL command
+  def kill(user, message)
+    write("KILL #{user} :#{message}")
+  end
+
+  # Send PING command
+  def ping(server)
+    write("PING #{server}")
+  end
+
+  # Send PONG command
+  def pong(server)
+    write("PONG #{server}")
+  end
+
+  # Send AWAY command
+  def away(message=nil)
+    raw("AWAY", message)
+  end
+
+  # Send USERS command
+  def users(target=nil)
+    write_optional("USERS", target)
+  end
+
+  # Send USERHOST command
+  def userhost(*users)
+    write("USERHOST #{users.join(' ')}")
+  end
+
+  # Close our socket instance
+  def close
+    @socket.close if connected?
+  end
+end
+

data/spec/irc_socket_spec.rb

@@ -0,0 +1,92 @@
+require File.expand_path('../../lib/irc-socket', __FILE__)
+
+class IRCSocket
+  def write(data)
+    return data
+  end
+  
+  def read(chompstr="\r\n")
+    str = "foo bar baz\r\n"
+    str.chomp!(chompstr) if chompstr
+  end
+end
+
+commands = [
+  [:pass,    %w(foobar),                        "PASS foobar"],
+  [:nick,    %(ipsum),                          "NICK ipsum"],
+  [:user,    ["guest", 0, '*', "real name"],    "USER guest 0 * :real name"],
+  [:oper,    %w(foo bar),                       "OPER foo bar"],
+  [:mode,    %w(#foo +v bar),                   "MODE #foo +v bar"],
+  [:quit,    %w(goodbye),                       "QUIT :goodbye"],
+  [:join,    %w(#mychan),                       "JOIN #mychan"],
+  [:part,    %w(#mychan),                       "PART #mychan"],
+  [:part,    %w(#mychan cya!),                  "PART #mychan :cya!",           "with part message"],
+  [:topic,   %w(#mychan newtopic),              "TOPIC #mychan :newtopic"],
+  [:names,   %w(#foo #bar),                     "NAMES #foo,#bar"],
+  [:list,    %w(#foo #bar),                     "LIST #foo,#bar"],
+  [:invite,  %w(foo #mychan),                   "INVITE foo #mychan"],
+  [:kick,    %w(#chan villian),                 "KICK #chan villian"],
+  [:kick,    %w(#chan villian gtfo!),           "KICK #chan villian :gtfo!",    "with kick reason"],
+  [:privmsg, ['#chan', 'foo bar baz'],          "PRIVMSG #chan :foo bar baz"],
+  [:notice,  ['#chan', 'foo bar baz'],          "NOTICE #chan :foo bar baz"],
+  [:motd,    %w(someserver),                    "MOTD someserver"],
+  [:version, %w(anotherserver),                 "VERSION anotherserver"],
+  [:stats,   %w(m server),                      "STATS m server"],
+  [:time,    %w(irc.someserver.net),            "TIME irc.someserver.net"],
+  [:info,    %w(foobar),                        "INFO foobar"],
+  [:squery,  %w(irchelp HELPME),                "SQUERY irchelp :HELPME"],
+  [:who,     %w(*.com o),                       "WHO *.com o"],
+  [:whois,   %w(foo.org user),                  "WHOIS foo.org user"],
+  [:whowas,  %w(foo.org user),                  "WHOWAS foo.org user"],
+  [:kill,    ['badperson', 'get out!'],         "KILL badperson :get out!"],
+  [:ping,    %w(010123444),                     "PING 010123444"],
+  [:pong,    %w(irc.foobar.org),                "PONG irc.foobar.org"],
+  [:away,    [],                                "AWAY"],
+  [:away,    ['gone for lunch'],              "AWAY :gone for lunch"],
+  [:users,   %w(irc.foobar.org),                "USERS irc.foobar.org"],
+  [:userhost, %w(foo bar baz),                  "USERHOST foo bar baz"],
+]
+
+describe "IRCSocket" do
+  before do
+    @irc = IRCSocket.new('irc.myserver.net')
+  end
+  
+  describe "::new" do
+    it "should return an IRCSocket" do
+      @irc.class.should == IRCSocket
+    end
+
+    it "should default to port 6667" do
+      @irc.port.should == 6667
+    end
+
+    it "should not automatically connect" do
+      @irc.connected.should == false
+    end
+
+    it "should set socket instance as nil" do
+      @irc.socket.should == nil
+    end
+  end
+
+  describe "#read" do
+    it "should chomp CRLF by default" do
+      @irc.read.should == "foo bar baz"
+      @irc.read.should_not == "foo bar baz\r\n"
+    end
+  end
+
+  describe "IRC commands as per rfc2812" do
+    commands.each do |requirements|
+      meth, params, pass, extra = *requirements
+      describe "##{meth}" do
+        it "should send a #{meth.to_s.upcase} command #{extra if extra}" do
+          @irc.send(meth, *params).should == pass
+        end
+      end
+    end
+  end
+
+end
+

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: irc_socket
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Lee Jarvis
+- Ken Spencer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-11-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+description: An IRC wrapper around TCPSocket
+email: me+irc_socket@iotaspencer.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.rdoc
+- lib/irc_socket.rb
+- spec/irc_socket_spec.rb
+homepage: http://rubydoc.info/github/IotaSpencer/irc_socket
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.8.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: An IRC wrapper around TCPSocket
+test_files: []