--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/eric7/Documentation/Source/eric7.Cooperation.CooperationClient.html Thu Jul 07 11:23:56 2022 +0200
@@ -0,0 +1,575 @@
+<!DOCTYPE html>
+<html><head>
+<title>eric7.Cooperation.CooperationClient</title>
+<meta charset="UTF-8">
+<link rel="stylesheet" href="styles.css">
+</head>
+<body>
+<a NAME="top" ID="top"></a>
+<h1>eric7.Cooperation.CooperationClient</h1>
+
+<p>
+Module implementing the client of the cooperation package.
+</p>
+<h3>Global Attributes</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Classes</h3>
+
+<table>
+
+<tr>
+<td><a href="#CooperationClient">CooperationClient</a></td>
+<td>Class implementing the client of the cooperation package.</td>
+</tr>
+</table>
+<h3>Functions</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<hr />
+<hr />
+<a NAME="CooperationClient" ID="CooperationClient"></a>
+<h2>CooperationClient</h2>
+
+<p>
+ Class implementing the client of the cooperation package.
+</p>
+<h3>Signals</h3>
+<dl>
+
+<dt>cannotConnect()</dt>
+<dd>
+emitted, if the initial connection fails
+</dd>
+<dt>connectionError(message)</dt>
+<dd>
+emitted when a connection error occurs
+ (string)
+</dd>
+<dt>editorCommand(hash, filename, message)</dt>
+<dd>
+emitted when an editor
+ command has been received (string, string, string)
+</dd>
+<dt>newMessage(user, message)</dt>
+<dd>
+emitted after a new message has
+ arrived (string, string)
+</dd>
+<dt>newParticipant(nickname)</dt>
+<dd>
+emitted after a new participant joined
+ (string)
+</dd>
+<dt>participantLeft(nickname)</dt>
+<dd>
+emitted after a participant left (string)
+</dd>
+</dl>
+<h3>Derived from</h3>
+QObject
+<h3>Class Attributes</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Class Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Methods</h3>
+
+<table>
+
+<tr>
+<td><a href="#CooperationClient.__init__">CooperationClient</a></td>
+<td>Constructor</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.__connectionError">__connectionError</a></td>
+<td>Private slot to handle a connection error.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.__connectionRejected">__connectionRejected</a></td>
+<td>Private slot to handle the rejection of a connection.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.__disconnected">__disconnected</a></td>
+<td>Private slot to handle the disconnection of a chat client.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.__findConnections">__findConnections</a></td>
+<td>Private method to get a list of connection given a nick name.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.__getParticipants">__getParticipants</a></td>
+<td>Private slot to handle the request for a list of participants.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.__newConnection">__newConnection</a></td>
+<td>Private slot to handle a new connection.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.__processParticipants">__processParticipants</a></td>
+<td>Private slot to handle the receipt of a list of participants.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.__readyForUse">__readyForUse</a></td>
+<td>Private slot to handle a connection getting ready for use.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.banKickUser">banKickUser</a></td>
+<td>Public method to ban and kick a user by its nick name.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.banUser">banUser</a></td>
+<td>Public method to ban a user by its nick name.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.chatWidget">chatWidget</a></td>
+<td>Public method to get a reference to the chat widget.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.close">close</a></td>
+<td>Public method to close all connections and stop listening.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.connectToHost">connectToHost</a></td>
+<td>Public method to connect to a host.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.disconnectConnections">disconnectConnections</a></td>
+<td>Public slot to disconnect from the chat network.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.errorString">errorString</a></td>
+<td>Public method to get a human readable error message about the last server error.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.hasConnection">hasConnection</a></td>
+<td>Public method to check for an existing connection.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.hasConnections">hasConnections</a></td>
+<td>Public method to check, if there are any connections established.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.isListening">isListening</a></td>
+<td>Public method to check, if the client is listening for connections.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.kickUser">kickUser</a></td>
+<td>Public method to kick a user by its nick name.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.nickName">nickName</a></td>
+<td>Public method to get the nick name.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.removeConnection">removeConnection</a></td>
+<td>Public method to remove a connection.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.sendEditorCommand">sendEditorCommand</a></td>
+<td>Public method to send an editor command.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.sendMessage">sendMessage</a></td>
+<td>Public method to send a message.</td>
+</tr>
+<tr>
+<td><a href="#CooperationClient.startListening">startListening</a></td>
+<td>Public method to start listening for new connections.</td>
+</tr>
+</table>
+<h3>Static Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+
+<a NAME="CooperationClient.__init__" ID="CooperationClient.__init__"></a>
+<h4>CooperationClient (Constructor)</h4>
+<b>CooperationClient</b>(<i>parent=None</i>)
+
+<p>
+ Constructor
+</p>
+<dl>
+
+<dt><i>parent</i></dt>
+<dd>
+reference to the parent object (QObject)
+</dd>
+</dl>
+<a NAME="CooperationClient.__connectionError" ID="CooperationClient.__connectionError"></a>
+<h4>CooperationClient.__connectionError</h4>
+<b>__connectionError</b>(<i>socketError, connection</i>)
+
+<p>
+ Private slot to handle a connection error.
+</p>
+<dl>
+
+<dt><i>socketError</i> (QAbstractSocket.SocketError)</dt>
+<dd>
+reference to the error object
+</dd>
+<dt><i>connection</i> (Connection)</dt>
+<dd>
+connection that caused the error
+</dd>
+</dl>
+<a NAME="CooperationClient.__connectionRejected" ID="CooperationClient.__connectionRejected"></a>
+<h4>CooperationClient.__connectionRejected</h4>
+<b>__connectionRejected</b>(<i>msg</i>)
+
+<p>
+ Private slot to handle the rejection of a connection.
+</p>
+<dl>
+
+<dt><i>msg</i></dt>
+<dd>
+error message (string)
+</dd>
+</dl>
+<a NAME="CooperationClient.__disconnected" ID="CooperationClient.__disconnected"></a>
+<h4>CooperationClient.__disconnected</h4>
+<b>__disconnected</b>(<i>connection</i>)
+
+<p>
+ Private slot to handle the disconnection of a chat client.
+</p>
+<dl>
+
+<dt><i>connection</i> (Connection)</dt>
+<dd>
+connection that was disconnected
+</dd>
+</dl>
+<a NAME="CooperationClient.__findConnections" ID="CooperationClient.__findConnections"></a>
+<h4>CooperationClient.__findConnections</h4>
+<b>__findConnections</b>(<i>nick</i>)
+
+<p>
+ Private method to get a list of connection given a nick name.
+</p>
+<dl>
+
+<dt><i>nick</i></dt>
+<dd>
+nick name in the format of self.nickName() (string)
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of references to the connection objects (list of
+ Connection)
+</dd>
+</dl>
+<a NAME="CooperationClient.__getParticipants" ID="CooperationClient.__getParticipants"></a>
+<h4>CooperationClient.__getParticipants</h4>
+<b>__getParticipants</b>(<i>reqConnection</i>)
+
+<p>
+ Private slot to handle the request for a list of participants.
+</p>
+<dl>
+
+<dt><i>reqConnection</i> (Connection)</dt>
+<dd>
+reference to the connection to get
+ participants for
+</dd>
+</dl>
+<a NAME="CooperationClient.__newConnection" ID="CooperationClient.__newConnection"></a>
+<h4>CooperationClient.__newConnection</h4>
+<b>__newConnection</b>(<i>connection</i>)
+
+<p>
+ Private slot to handle a new connection.
+</p>
+<dl>
+
+<dt><i>connection</i></dt>
+<dd>
+reference to the new connection (Connection)
+</dd>
+</dl>
+<a NAME="CooperationClient.__processParticipants" ID="CooperationClient.__processParticipants"></a>
+<h4>CooperationClient.__processParticipants</h4>
+<b>__processParticipants</b>(<i>participants</i>)
+
+<p>
+ Private slot to handle the receipt of a list of participants.
+</p>
+<dl>
+
+<dt><i>participants</i></dt>
+<dd>
+list of participants (list of strings of
+ "host:port")
+</dd>
+</dl>
+<a NAME="CooperationClient.__readyForUse" ID="CooperationClient.__readyForUse"></a>
+<h4>CooperationClient.__readyForUse</h4>
+<b>__readyForUse</b>(<i>connection</i>)
+
+<p>
+ Private slot to handle a connection getting ready for use.
+</p>
+<dl>
+
+<dt><i>connection</i> (Connection)</dt>
+<dd>
+connection that got ready for use
+</dd>
+</dl>
+<a NAME="CooperationClient.banKickUser" ID="CooperationClient.banKickUser"></a>
+<h4>CooperationClient.banKickUser</h4>
+<b>banKickUser</b>(<i>nick</i>)
+
+<p>
+ Public method to ban and kick a user by its nick name.
+</p>
+<dl>
+
+<dt><i>nick</i></dt>
+<dd>
+nick name in the format of self.nickName() (string)
+</dd>
+</dl>
+<a NAME="CooperationClient.banUser" ID="CooperationClient.banUser"></a>
+<h4>CooperationClient.banUser</h4>
+<b>banUser</b>(<i>nick</i>)
+
+<p>
+ Public method to ban a user by its nick name.
+</p>
+<dl>
+
+<dt><i>nick</i></dt>
+<dd>
+nick name in the format of self.nickName() (string)
+</dd>
+</dl>
+<a NAME="CooperationClient.chatWidget" ID="CooperationClient.chatWidget"></a>
+<h4>CooperationClient.chatWidget</h4>
+<b>chatWidget</b>(<i></i>)
+
+<p>
+ Public method to get a reference to the chat widget.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+reference to the chat widget (ChatWidget)
+</dd>
+</dl>
+<a NAME="CooperationClient.close" ID="CooperationClient.close"></a>
+<h4>CooperationClient.close</h4>
+<b>close</b>(<i></i>)
+
+<p>
+ Public method to close all connections and stop listening.
+</p>
+<a NAME="CooperationClient.connectToHost" ID="CooperationClient.connectToHost"></a>
+<h4>CooperationClient.connectToHost</h4>
+<b>connectToHost</b>(<i>host, port</i>)
+
+<p>
+ Public method to connect to a host.
+</p>
+<dl>
+
+<dt><i>host</i></dt>
+<dd>
+host to connect to (string)
+</dd>
+<dt><i>port</i></dt>
+<dd>
+port to connect to (integer)
+</dd>
+</dl>
+<a NAME="CooperationClient.disconnectConnections" ID="CooperationClient.disconnectConnections"></a>
+<h4>CooperationClient.disconnectConnections</h4>
+<b>disconnectConnections</b>(<i></i>)
+
+<p>
+ Public slot to disconnect from the chat network.
+</p>
+<a NAME="CooperationClient.errorString" ID="CooperationClient.errorString"></a>
+<h4>CooperationClient.errorString</h4>
+<b>errorString</b>(<i></i>)
+
+<p>
+ Public method to get a human readable error message about the last
+ server error.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+human readable error message about the last server error
+ (string)
+</dd>
+</dl>
+<a NAME="CooperationClient.hasConnection" ID="CooperationClient.hasConnection"></a>
+<h4>CooperationClient.hasConnection</h4>
+<b>hasConnection</b>(<i>senderIp, senderPort=-1</i>)
+
+<p>
+ Public method to check for an existing connection.
+</p>
+<dl>
+
+<dt><i>senderIp</i></dt>
+<dd>
+address of the sender (QHostAddress)
+</dd>
+<dt><i>senderPort</i></dt>
+<dd>
+port of the sender (integer)
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating an existing connection (boolean)
+</dd>
+</dl>
+<a NAME="CooperationClient.hasConnections" ID="CooperationClient.hasConnections"></a>
+<h4>CooperationClient.hasConnections</h4>
+<b>hasConnections</b>(<i></i>)
+
+<p>
+ Public method to check, if there are any connections established.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating the presence of connections (boolean)
+</dd>
+</dl>
+<a NAME="CooperationClient.isListening" ID="CooperationClient.isListening"></a>
+<h4>CooperationClient.isListening</h4>
+<b>isListening</b>(<i></i>)
+
+<p>
+ Public method to check, if the client is listening for connections.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating the listening state (boolean)
+</dd>
+</dl>
+<a NAME="CooperationClient.kickUser" ID="CooperationClient.kickUser"></a>
+<h4>CooperationClient.kickUser</h4>
+<b>kickUser</b>(<i>nick</i>)
+
+<p>
+ Public method to kick a user by its nick name.
+</p>
+<dl>
+
+<dt><i>nick</i></dt>
+<dd>
+nick name in the format of self.nickName() (string)
+</dd>
+</dl>
+<a NAME="CooperationClient.nickName" ID="CooperationClient.nickName"></a>
+<h4>CooperationClient.nickName</h4>
+<b>nickName</b>(<i></i>)
+
+<p>
+ Public method to get the nick name.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+nick name (string)
+</dd>
+</dl>
+<a NAME="CooperationClient.removeConnection" ID="CooperationClient.removeConnection"></a>
+<h4>CooperationClient.removeConnection</h4>
+<b>removeConnection</b>(<i>connection</i>)
+
+<p>
+ Public method to remove a connection.
+</p>
+<dl>
+
+<dt><i>connection</i></dt>
+<dd>
+reference to the connection to be removed
+ (Connection)
+</dd>
+</dl>
+<a NAME="CooperationClient.sendEditorCommand" ID="CooperationClient.sendEditorCommand"></a>
+<h4>CooperationClient.sendEditorCommand</h4>
+<b>sendEditorCommand</b>(<i>projectHash, filename, message</i>)
+
+<p>
+ Public method to send an editor command.
+</p>
+<dl>
+
+<dt><i>projectHash</i></dt>
+<dd>
+hash of the project (string)
+</dd>
+<dt><i>filename</i></dt>
+<dd>
+project relative universal file name of
+ the sending editor (string)
+</dd>
+<dt><i>message</i></dt>
+<dd>
+editor command to be sent (string)
+</dd>
+</dl>
+<a NAME="CooperationClient.sendMessage" ID="CooperationClient.sendMessage"></a>
+<h4>CooperationClient.sendMessage</h4>
+<b>sendMessage</b>(<i>message</i>)
+
+<p>
+ Public method to send a message.
+</p>
+<dl>
+
+<dt><i>message</i></dt>
+<dd>
+message to be sent (string)
+</dd>
+</dl>
+<a NAME="CooperationClient.startListening" ID="CooperationClient.startListening"></a>
+<h4>CooperationClient.startListening</h4>
+<b>startListening</b>(<i>port=-1</i>)
+
+<p>
+ Public method to start listening for new connections.
+</p>
+<dl>
+
+<dt><i>port</i></dt>
+<dd>
+port to listen on (integer)
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple giving a flag indicating success (boolean) and
+ the port the server listens on
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr />
+</body></html>
\ No newline at end of file
