RubyGems - steam-condenser - Versions diffs - 1.3.8.1 → 1.3.9 - Mend

steam-condenser 1.3.8.1 → 1.3.9

Files changed (476) hide show

data/pkg/steam-condenser-1.3.8.1/doc/Server.html ADDED Viewed

@@ -0,0 +1,886 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>
+  Module: Server
+    &mdash; Metior — API Documentation
+</title>
+  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  hasFrames = window.top.frames.main ? true : false;
+  relpath = '';
+  framesUrl = "frames.html#!" + escape(window.location.href);
+</script>
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+    <a href="_index.html">Index (S)</a> &raquo;
+    <span class="title">Server</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+      Class List
+    </a>
+    <a class="full_list_link" id="method_list_link"
+        href="method_list.html">
+      Method List
+    </a>
+    <a class="full_list_link" id="file_list_link"
+        href="file_list.html">
+      File List
+    </a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Module: Server
+</h1>
+<dl class="box">
+    <dt class="r1">Included in:</dt>
+    <dd class="r1"><span class='object_link'><a href="GameServer.html" title="GameServer (module)">GameServer</a></span>, <span class='object_link'><a href="MasterServer.html" title="MasterServer (class)">MasterServer</a></span></dd>
+    <dt class="r2 last">Defined in:</dt>
+    <dd class="r2 last">lib/steam/servers/server.rb</dd>
+</dl>
+<div class="clear"></div>
+<h2>Overview</h2><div class="docstring">
+  <div class="discussion">
+<p>This module is included by all classes implementing server functionality</p>
+<p>It provides basic name resolution features and the ability to rotate
+between
+different IP addresses belonging to a single DNS name.</p>
+  </div>
+</div>
+<div class="tags">
+<p class="tag_title">Author:</p>
+<ul class="author">
+    <li>
+        <div class='inline'>
+<p>Sebastian Staudt</p>
+</div>
+    </li>
+</ul>
+</div>
+  <h2>Instance Attribute Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small></h2>
+  <ul class="summary">
+      <li class="public ">
+  <span class="summary_signature">
+      <a href="#host_names-instance_method" title="#host_names (instance method)">- (Array&lt;String&gt;) <strong>host_names</strong> </a>
+  </span>
+      <span class="note title readonly">readonly</span>
+    <span class="summary_desc"><div class='inline'>
+<p>Returns a list of host names associated with this server.</p>
+</div></span>
+</li>
+      <li class="public ">
+  <span class="summary_signature">
+      <a href="#ip_addresses-instance_method" title="#ip_addresses (instance method)">- (Array&lt;String&gt;) <strong>ip_addresses</strong> </a>
+  </span>
+      <span class="note title readonly">readonly</span>
+    <span class="summary_desc"><div class='inline'>
+<p>Returns a list of IP addresses associated with this server.</p>
+</div></span>
+</li>
+  </ul>
+    <h2>
+      Instance Method Summary
+      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
+    </h2>
+    <ul class="summary">
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#disconnect-instance_method" title="#disconnect (instance method)">- (Object) <strong>disconnect</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Disconnect the connections to this server.</p>
+</div></span>
+</li>
+        <li class="protected ">
+  <span class="summary_signature">
+      <a href="#failsafe-instance_method" title="#failsafe (instance method)">- (Object) <strong>failsafe</strong>(&amp;proc) </a>
+  </span>
+  <span class="note title protected">protected</span>
+    <span class="summary_desc"><div class='inline'>
+<p>Execute an action in the context of this server&#39;s current IP address.</p>
+</div></span>
+</li>
+        <li class="protected ">
+  <span class="summary_signature">
+      <a href="#init_socket-instance_method" title="#init_socket (instance method)">- (Object) <strong>init_socket</strong> </a>
+  </span>
+  <span class="note title protected">protected</span>
+  <span class="abstract note title">abstract</span>
+    <span class="summary_desc"><div class='inline'>
+<p>Initializes the socket(s) to communicate with the server.</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#initialize-instance_method" title="#initialize (instance method)">- (Object) <strong>initialize</strong>(address, port = nil) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Creates a new server instance with the given address and port.</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#rotate_ip-instance_method" title="#rotate_ip (instance method)">- (Boolean) <strong>rotate_ip</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Rotate this server&#39;s IP address to the next one in the IP list.</p>
+</div></span>
+</li>
+    </ul>
+  <div id="instance_attr_details" class="attr_details">
+    <h2>Instance Attribute Details</h2>
+      <span id=""></span>
+      <div class="method_details first">
+  <h3 class="signature first" id="host_names-instance_method">
+    - (<tt>Array&lt;String&gt;</tt>) <strong>host_names</strong>  <span class="extras">(readonly)</span>
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Returns a list of host names associated with this server</p>
+  </div>
+</div>
+<div class="tags">
+<p class="tag_title">Returns:</p>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt>Array&lt;String&gt;</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>The host names of this server</p>
+</div>
+    </li>
+</ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+19
+20
+21</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/steam/servers/server.rb', line 19</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_host_names'>host_names</span>
+  <span class='ivar'>@host_names</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <span id=""></span>
+      <div class="method_details ">
+  <h3 class="signature " id="ip_addresses-instance_method">
+    - (<tt>Array&lt;String&gt;</tt>) <strong>ip_addresses</strong>  <span class="extras">(readonly)</span>
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Returns a list of IP addresses associated with this server</p>
+  </div>
+</div>
+<div class="tags">
+<p class="tag_title">Returns:</p>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt>Array&lt;String&gt;</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>The IP addresses of this server</p>
+</div>
+    </li>
+</ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+24
+25
+26</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/steam/servers/server.rb', line 24</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_ip_addresses'>ip_addresses</span>
+  <span class='ivar'>@ip_addresses</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+  <div id="instance_method_details" class="method_details_list">
+    <h2>Instance Method Details</h2>
+      <div class="method_details first">
+  <h3 class="signature first" id="disconnect-instance_method">
+    - (<tt>Object</tt>) <strong>disconnect</strong>
+</h3><div class="docstring">
+  <div class="discussion">
+  <div class="note notetag">
+    <strong>Note:</strong>
+    <div class='inline'>
+<p>In the base implementation this does nothing, only
+connection-based
+communication channels have to be disconnected.</p>
+</div>
+  </div>
+<p>Disconnect the connections to this server</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+59
+60</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/steam/servers/server.rb', line 59</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_disconnect'>disconnect</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="failsafe-instance_method">
+    - (<tt>Object</tt>) <strong>failsafe</strong>(&amp;proc)  <span class="extras">(protected)</span>
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Execute an action in the context of this server&#39;s current IP address</p>
+<p>Any failure will cause the IP to rotate to the next IP in the server&#39;s
+IP
+list and the execution will be repeated for the next IP address. If the
+IP
+rotation reaches the end of the list, the error will be reraised.</p>
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+    <li>
+        <span class='name'>proc</span>
+        <span class='type'>(<tt>Proc</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>The action to be executed in a failsafe way</p>
+</div>
+    </li>
+</ul>
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+      <li><span class='object_link'><a href="#rotate_ip-instance_method" title="Server#rotate_ip (method)">#rotate_ip</a></span></li>
+  </ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/steam/servers/server.rb', line 96</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_failsafe'>failsafe</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_proc'>proc</span><span class='rparen'>)</span>
+  <span class='kw'>begin</span>
+    <span class='id identifier rubyid_proc'>proc</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span>
+  <span class='kw'>rescue</span>
+    <span class='id identifier rubyid_raise'>raise</span> <span class='gvar'>$!</span> <span class='kw'>if</span> <span class='id identifier rubyid_rotate_ip'>rotate_ip</span>
+    <span class='kw'>if</span> <span class='gvar'>$DEBUG</span>
+      <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Request failed, retrying for </span><span class='embvar'>#</span><span class='ivar'>@ip_address</span><span class='tstring_content'>...</span><span class='tstring_end'>&quot;</span></span>
+    <span class='kw'>end</span>
+    <span class='id identifier rubyid_failsafe'>failsafe</span> <span class='op'>&amp;</span><span class='id identifier rubyid_proc'>proc</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="init_socket-instance_method">
+    - (<tt>Object</tt>) <strong>init_socket</strong>  <span class="extras">(protected)</span>
+</h3><div class="docstring">
+  <div class="discussion">
+    <div class="note abstract">
+  <strong>This method is abstract.</strong>
+  <div class='inline'>
+<p>Must be implemented in including classes to prepare sockets for
+server
+communication</p>
+</div>
+</div>
+<p>Initializes the socket(s) to communicate with the server</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+112
+113</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/steam/servers/server.rb', line 112</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_init_socket'>init_socket</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="initialize-instance_method">
+    - (<tt>Object</tt>) <strong>initialize</strong>(address, port = nil)
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Creates a new server instance with the given address and port</p>
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+    <li>
+        <span class='name'>address</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>Either an IP address, a DNS name or one of them
+combined with the port
+number. If a port number is given, e.g.
+&#39;server.example.com:27016&#39;
+it will override the second argument.</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>port</span>
+        <span class='type'>(<tt>Fixnum</tt>)</span>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+        &mdash;
+        <div class='inline'>
+<p>The port the server is listening on</p>
+</div>
+    </li>
+</ul>
+<p class="tag_title">Raises:</p>
+<ul class="raise">
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="SteamCondenserError.html" title="SteamCondenserError (class)">SteamCondenserError</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>if an host name cannot be resolved</p>
+</div>
+    </li>
+</ul>
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+      <li>init_socket</li>
+  </ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/steam/servers/server.rb', line 34</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='id identifier rubyid_address'>address</span><span class='comma'>,</span> <span class='id identifier rubyid_port'>port</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_address'>address</span> <span class='op'>=</span> <span class='id identifier rubyid_address'>address</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span>
+  <span class='id identifier rubyid_address'>address</span><span class='comma'>,</span> <span class='id identifier rubyid_port'>port</span> <span class='op'>=</span> <span class='id identifier rubyid_address'>address</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>:</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='int'>2</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_address'>address</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>:</span><span class='tstring_end'>&#39;</span></span>
+  <span class='ivar'>@host_names</span>   <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
+  <span class='ivar'>@ip_addresses</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
+  <span class='ivar'>@ip_index</span>     <span class='op'>=</span> <span class='int'>0</span>
+  <span class='ivar'>@port</span>         <span class='op'>=</span> <span class='id identifier rubyid_port'>port</span>
+  <span class='const'>Socket</span><span class='period'>.</span><span class='id identifier rubyid_getaddrinfo'>getaddrinfo</span><span class='lparen'>(</span><span class='id identifier rubyid_address'>address</span><span class='comma'>,</span> <span class='id identifier rubyid_port'>port</span><span class='comma'>,</span> <span class='const'>Socket</span><span class='op'>::</span><span class='const'>AF_INET</span><span class='comma'>,</span> <span class='const'>Socket</span><span class='op'>::</span><span class='const'>SOCK_DGRAM</span><span class='rparen'>)</span><span class='period'>.</span>
+         <span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_address'>address</span><span class='op'>|</span>
+    <span class='ivar'>@host_names</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_address'>address</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span>
+    <span class='ivar'>@ip_addresses</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_address'>address</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span>
+  <span class='kw'>end</span>
+  <span class='ivar'>@ip_address</span> <span class='op'>=</span> <span class='ivar'>@ip_addresses</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span>
+  <span class='id identifier rubyid_init_socket'>init_socket</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="rotate_ip-instance_method">
+    - (<tt>Boolean</tt>) <strong>rotate_ip</strong>
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Rotate this server&#39;s IP address to the next one in the IP list</p>
+<p>If this method returns <code>true</code>, it indicates that all IP
+addresses have been
+used, hinting at the server(s) being unreachable. An
+appropriate action
+should be taken to inform the user.</p>
+<p>Servers with only one IP address will always cause this method to
+return
+<code>true</code> and the sockets will not be reinitialized.</p>
+  </div>
+</div>
+<div class="tags">
+<p class="tag_title">Returns:</p>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt>Boolean</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p><code>true</code>, if the IP list reached its end. If the list
+contains
+only one IP address, this method will instantly return
+<code>true</code></p>
+</div>
+    </li>
+</ul>
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+      <li><span class='object_link'><a href="#init_socket-instance_method" title="Server#init_socket (method)">#init_socket</a></span></li>
+  </ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+75
+76
+77
+78
+79
+80
+81
+82
+83
+84</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/steam/servers/server.rb', line 75</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_rotate_ip'>rotate_ip</span>
+  <span class='kw'>return</span> <span class='kw'>true</span> <span class='kw'>if</span> <span class='ivar'>@ip_addresses</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span> <span class='op'>==</span> <span class='int'>1</span>
+  <span class='ivar'>@ip_index</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='ivar'>@ip_index</span> <span class='op'>+</span> <span class='int'>1</span><span class='rparen'>)</span> <span class='op'>%</span> <span class='ivar'>@ip_addresses</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span>
+  <span class='ivar'>@ip_address</span> <span class='op'>=</span> <span class='ivar'>@ip_addresses</span><span class='lbracket'>[</span><span class='ivar'>@ip_index</span><span class='rbracket'>]</span>
+  <span class='id identifier rubyid_init_socket'>init_socket</span>
+  <span class='ivar'>@ip_index</span> <span class='op'>==</span> <span class='int'>0</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+</div>
+    <div id="footer">
+  Generated on Tue Jul 22 07:10:14 2014 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.8.7.3 (ruby-2.0.0).
+</div>
+  </body>
+</html>