Class: Slack::RealTime::Client

Inherits:
Object
  • Object
show all
Includes:
Api::Message, Api::MessageId, Api::Ping, Api::Typing
Defined in:
lib/slack/real_time/client.rb

Defined Under Namespace

Classes: ClientAlreadyStartedError, ClientNotStartedError

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Api::Typing

#typing

Methods included from Api::Message

#message

Methods included from Api::Ping

#ping

Constructor Details

#initialize(options = {}) ⇒ Client

Returns a new instance of Client.



26
27
28
29
30
31
32
33
34
# File 'lib/slack/real_time/client.rb', line 26

def initialize(options = {})
  @callbacks = Hash.new { |h, k| h[k] = [] }
  Slack::RealTime::Config::ATTRIBUTES.each do |key|
    send("#{key}=", options.key?(key) ? options[key] : Slack::RealTime.config.send(key))
  end
  @token ||= Slack.config.token
  @logger ||= (Slack::Config.logger || Slack::Logger.default)
  @web_client = Slack::Web::Client.new(token: token, logger: logger)
end

Class Attribute Details

.eventsObject

Returns the value of attribute events.



15
16
17
# File 'lib/slack/real_time/client.rb', line 15

def events
  @events
end

Instance Attribute Details

#storeObject

Returns the value of attribute store.



19
20
21
# File 'lib/slack/real_time/client.rb', line 19

def store
  @store
end

#urlObject

Returns the value of attribute url.



20
21
22
# File 'lib/slack/real_time/client.rb', line 20

def url
  @url
end

#web_clientObject

Returns the value of attribute web_client.



18
19
20
# File 'lib/slack/real_time/client.rb', line 18

def web_client
  @web_client
end

Class Method Details

.configObject



76
77
78
# File 'lib/slack/real_time/client.rb', line 76

def config
  Config
end

.configureObject



72
73
74
# File 'lib/slack/real_time/client.rb', line 72

def configure
  block_given? ? yield(config) : config
end

Instance Method Details

#on(type, &block) ⇒ Object



42
43
44
45
# File 'lib/slack/real_time/client.rb', line 42

def on(type, &block)
  type = type.to_s
  callbacks[type] << block
end

#run_loopObject



81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
# File 'lib/slack/real_time/client.rb', line 81

def run_loop
  @socket.connect! do |driver|
    @callback.call(driver) if @callback

    driver.on :open do |event|
      logger.debug("#{self.class}##{__method__}") { event.class.name }
      open(event)
      callback(event, :open)
    end

    driver.on :message do |event|
      logger.debug("#{self.class}##{__method__}") { "#{event.class}, #{event.data}" }
      dispatch(event)
    end

    driver.on :close do |event|
      logger.debug("#{self.class}##{__method__}") { event.class.name }
      callback(event, :close)
      close(event)
      callback(event, :closed)
    end
  end
end

#start!(&block) ⇒ Object

Start RealTime client and block until it disconnects.



48
49
50
51
52
# File 'lib/slack/real_time/client.rb', line 48

def start!(&block)
  @callback = block if block_given?
  @socket = build_socket
  @socket.start_sync(self)
end

#start_async(&block) ⇒ Object

Start RealTime client and return immediately. The RealTime::Client will run in the background.



56
57
58
59
60
# File 'lib/slack/real_time/client.rb', line 56

def start_async(&block)
  @callback = block if block_given?
  @socket = build_socket
  @socket.start_async(self)
end

#started?Boolean

Returns:

  • (Boolean)


67
68
69
# File 'lib/slack/real_time/client.rb', line 67

def started?
  @socket && @socket.connected?
end

#stop!Object



62
63
64
65
# File 'lib/slack/real_time/client.rb', line 62

def stop!
  raise ClientNotStartedError unless started?
  @socket.disconnect! if @socket
end