forked from p15670423/monkey
Agent: Fix docstrings in TCPRelay
This commit is contained in:
parent
d478e99227
commit
1d394bbd2e
|
@ -16,7 +16,9 @@ class RelayUser:
|
||||||
|
|
||||||
|
|
||||||
class TCPRelay(Thread):
|
class TCPRelay(Thread):
|
||||||
"""Provides and manages a TCP proxy connection."""
|
"""
|
||||||
|
Provides and manages a TCP proxy connection.
|
||||||
|
"""
|
||||||
|
|
||||||
def __init__(
|
def __init__(
|
||||||
self,
|
self,
|
||||||
|
@ -58,7 +60,11 @@ class TCPRelay(Thread):
|
||||||
self._stopped.set()
|
self._stopped.set()
|
||||||
|
|
||||||
def on_user_connected(self, user: str):
|
def on_user_connected(self, user: str):
|
||||||
"""Handle new user connection."""
|
"""
|
||||||
|
Handle new user connection.
|
||||||
|
|
||||||
|
:param user: A user which will be added to the relay
|
||||||
|
"""
|
||||||
with self._lock:
|
with self._lock:
|
||||||
self._potential_users = [u for u in self._potential_users if u.address != user]
|
self._potential_users = [u for u in self._potential_users if u.address != user]
|
||||||
self._relay_users.append(RelayUser(user, time()))
|
self._relay_users.append(RelayUser(user, time()))
|
||||||
|
@ -68,16 +74,28 @@ class TCPRelay(Thread):
|
||||||
pass
|
pass
|
||||||
|
|
||||||
def relay_users(self) -> List[RelayUser]:
|
def relay_users(self) -> List[RelayUser]:
|
||||||
"""Get the list of users connected to the relay."""
|
"""
|
||||||
|
Get the list of users connected to the relay.
|
||||||
|
"""
|
||||||
with self._lock:
|
with self._lock:
|
||||||
return self._relay_users.copy()
|
return self._relay_users.copy()
|
||||||
|
|
||||||
def on_potential_new_user(self, user: str):
|
def on_potential_new_user(self, user: str):
|
||||||
"""Notify TCPRelay that a new user may try and connect."""
|
"""
|
||||||
|
Notify TCPRelay that a new user may try and connect.
|
||||||
|
|
||||||
|
:param user: A potential user that tries to connect to the relay
|
||||||
|
"""
|
||||||
with self._lock:
|
with self._lock:
|
||||||
self._potential_users.append(RelayUser(user, time()))
|
self._potential_users.append(RelayUser(user, time()))
|
||||||
|
|
||||||
def on_user_data_received(self, data: bytes, user: str) -> bool:
|
def on_user_data_received(self, data: bytes, user: str) -> bool:
|
||||||
|
"""
|
||||||
|
Disconnect a user which a specific starting data.
|
||||||
|
|
||||||
|
:param data: The data that a relay recieved
|
||||||
|
:param user: User which send the data
|
||||||
|
"""
|
||||||
if data.startswith(RELAY_CONTROL_MESSAGE):
|
if data.startswith(RELAY_CONTROL_MESSAGE):
|
||||||
self._disconnect_user(user)
|
self._disconnect_user(user)
|
||||||
return False
|
return False
|
||||||
|
|
Loading…
Reference in New Issue