Class: Cinch::Network

Inherits:
Object
  • Object
show all
Defined in:
lib/cinch/network.rb

Overview

This class allows querying the IRC network for its name and used server software as well as certain non-standard behaviour.

Since:

  • 2.0.0

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, ircd) ⇒ Network

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Note:

The user should not create instances of this class but use IRC#network instead.

Returns a new instance of Network.

Parameters:

  • name (Symbol)
  • ircd (Symbol)

Since:

  • 2.0.0



33
34
35
36
37
 
# File 'lib/cinch/network.rb', line 33

def initialize(name, ircd)
  @name         = name
  @ircd         = ircd
  @capabilities = []
end

Instance Attribute Details

#capabilities ⇒ Array<Symbol>

network.

Returns:

  • (Array<Symbol>) —

    All client capabilities supported by the

Since:

  • 2.0.0



23
24
25
 
# File 'lib/cinch/network.rb', line 23

def capabilities
  @capabilities
end

#ircd ⇒ Symbol

Returns The server software used by the network. :unknown if the software couldn’t be detected.

Returns:

  • (Symbol) —

    The server software used by the network. :unknown if the software couldn’t be detected.

Since:

  • 2.0.0



16
17
18
 
# File 'lib/cinch/network.rb', line 16

def ircd
  @ircd
end

#name ⇒ Symbol

Returns The name of the network. :unknown if the network couldn’t be detected.

Returns:

  • (Symbol) —

    The name of the network. :unknown if the network couldn’t be detected.

Since:

  • 2.0.0



9
10
11
 
# File 'lib/cinch/network.rb', line 9

def name
  @name
end

Instance Method Details

#default_messages_per_second ⇒ Numeric

Returns The messages per second value that best suits the current network.

Returns:

  • (Numeric) —

    The messages per second value that best suits the current network

Since:

  • 2.0.0



84
85
86
87
88
89
90
91
 
# File 'lib/cinch/network.rb', line 84

def default_messages_per_second
  case @name
  when :freenode
    0.7
  else
    0.5
  end
end

#default_server_queue_size ⇒ Integer

Returns The server queue size value that best suits the current network.

Returns:

  • (Integer) —

    The server queue size value that best suits the current network

Since:

  • 2.0.0



95
96
97
98
99
100
101
102
 
# File 'lib/cinch/network.rb', line 95

def default_server_queue_size
  case @name
  when :quakenet
    40
  else
    10
  end
end

#jtv? ⇒ Boolean

Returns True if connected to JTV.

Returns:

  • (Boolean) —

    True if connected to JTV

Since:

  • 2.0.0



62
63
64
 
# File 'lib/cinch/network.rb', line 62

def jtv?
  @name == :jtv
end

#ngametv? ⇒ Boolean

Returns True if connected to NgameTV.

Returns:

  • (Boolean) —

    True if connected to NgameTV

Since:

  • 2.0.0



57
58
59
 
# File 'lib/cinch/network.rb', line 57

def ngametv?
  @name == :ngametv
end

#owner_list_mode ⇒ String?

Returns The mode used for getting the list of channel owners, if any.

Returns:

  • (String, nil) —

    The mode used for getting the list of channel owners, if any

Since:

  • 2.0.0



41
42
43
 
# File 'lib/cinch/network.rb', line 41

def owner_list_mode
  return "q" if @ircd == :unreal || @ircd == :inspircd
end

#quiet_list_mode ⇒ String?

Returns The mode used for getting the list of channel quiets, if any.

Returns:

  • (String, nil) —

    The mode used for getting the list of channel quiets, if any

Since:

  • 2.0.0



47
48
49
 
# File 'lib/cinch/network.rb', line 47

def quiet_list_mode
  return "q" if @ircd == :"ircd-seven"
end

#unknown_ircd? ⇒ Boolean

Returns True if we do not know which software the server is running.

Returns:

  • (Boolean) —

    True if we do not know which software the server is running

Since:

  • 2.0.0



74
75
76
 
# File 'lib/cinch/network.rb', line 74

def unknown_ircd?
  @ircd == :unknown
end

#unknown_network? ⇒ Boolean

Returns True if we do not know which network we are connected to.

Returns:

  • (Boolean) —

    True if we do not know which network we are connected to

Since:

  • 2.0.0



68
69
70
 
# File 'lib/cinch/network.rb', line 68

def unknown_network?
  @name == :unknown
end

#whois_only_one_argument? ⇒ Boolean

Returns Does WHOIS only support one argument?.

Returns:

  • (Boolean) —

    Does WHOIS only support one argument?

Since:

  • 2.0.0



52
53
54
 
# File 'lib/cinch/network.rb', line 52

def whois_only_one_argument?
  @name == :jtv
end