ws_lite

Successor to websocket-client-simple with OpenSSL 3.x fixes and improved connection reliability.

Add this line to your application's Gemfile:

gem 'ws_lite'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install ws_lite

require 'ws_lite'

ws = WSLite.connect 'ws://example.com:8888'

ws.on :message do |msg|
  puts msg.data
end

ws.on :open do
  ws.send 'hello!!!'
end

ws.on :close do |e|
  p e
  exit 1
end

ws.on :error do |e|
  p e
end

loop do
  ws.send STDIN.gets.strip
end

connect runs a given block before connecting websocket

WSLite.connect 'ws://example.com:8888' do |ws|
  ws.on :open do
    puts "connect!"
  end

  ws.on :message do |msg|
    puts msg.data
  end
end

Pass a custom OpenSSL::SSL::SSLContext for full control over TLS settings:

ctx = OpenSSL::SSL::SSLContext.new
ctx.verify_mode = OpenSSL::SSL::VERIFY_PEER

ws = WSLite.connect 'wss://example.com', ssl_context: ctx

By default, OP_IGNORE_UNEXPECTED_EOF is enabled on OpenSSL 3.x to prevent SSL_read: unexpected eof while reading errors when servers close connections without a TLS close_notify alert.

$ bundle install
$ rake

Bug reports and pull requests are welcome on GitHub at https://github.com/carter2099/ws_lite.

The gem is available as open source under the terms of the MIT License.