Skip to content

Use your TCP connections with working timeout.

License

Notifications You must be signed in to change notification settings

mblumtritt/tcp-client

Repository files navigation

TCPClient version

Use your TCP connections with working timeout.

Description

This gem implements a customizable TCP client class that gives you control over time limits. You can set time limits for individual read or write calls or set a deadline for entire call sequences. It has a very small footprint, no dependencies and is easily useable.

Sample

require 'tcp-client'

# create a configuration:
# - don't use internal buffering
# - use at least TLS 1.2
cfg =
  TCPClient::Configuration.create(
    buffered: false,
    ssl_params: {
      min_version: :TLS1_2
    }
  )

# request to Google.com:
# - limit all network interactions to 1.5 seconds
# - use the Configuration cfg
# - send a simple HTTP get request
# - read the returned message and headers
response =
  TCPClient.with_deadline(1.5, 'www.google.com:443', cfg) do |client|
    client.write("GET / HTTP/1.1\r\nHost: www.google.com\r\n\r\n") #=> 40
    client.readline("\r\n\r\n") #=> see response
  end

puts(response)

For more samples see the examples dir

Installation

You can install the gem in your system with

gem install tcp-client

You can use Bundler to add TCPClient to your own project:

bundle add tcp-client

After that you only need one line of code to have everything together

require 'tcp-client'