Platform-IRC/scparseirc/__init__.py
2024-10-20 12:13:02 -07:00

110 lines
No EOL
5.4 KiB
Python

"""
IRC Parser for the SugarCaneIRC family.
"""
import socket
import ssl as ssl_module
import threading
__version__ = 0
class SystemMessage: # System message object
def __init__(self, content:str, user:str, typ:str, mention:bool, chan=None):
self.content, self.user, self.type, self.mention, self.chan = content,user,typ,mention,chan
class Message: # Message object
def __init__(self, content:str, chan:str, nick:str):
self.content = content
self.channel = chan
self.nick = nick
class Channel: # Channel object
is_init = False # If the channel's properties are initialized yet
topic = "" # Channel topic
modes = "+nt" # Channel modes
in_channel = True # If the user is in the channel
def __init__(self, name:str):
self.name = name
def info_set(self, topic:str, modes:str): # Socket will automatically initialize the channel object
self.is_init = True
self.topic, self.modes = topic, modes
class User: # User object
def __init__(self, name:str, system:bool=False, realname:str|None=None, username:str|None=None, host:str|None=None):
self.name, self.system, self.realname, self.username = name,system,realname,username
class IRCSession: # Actual IRC session
messages = [] # Cached messages
raw_text = "" # Cached RAW data
chans = [] # Cached channels
connected = False # Connection status
is_ssl = False # Wether the connection uses TLS/SSL
ssl_accept_invalid = False # If SSL is enabled, do not fail to connect if the certificate is invalid.
socket = socket.socket() # Socket
wsocket = None # Wrapped socket (if SSL is enabled)
context = ssl_module.create_default_context() # Context of the SSL module, not to be changed by the client.
def __init__(self, address:str="irc.libera.chat", port:int=6697, nick:str="sweetAsSugar", user:str="ScParse", ssl:bool=True, ssl_igninvalid:bool=False, realname:str="SugarcaneParseIRC user", **kwargs): # Contains the configuration
self.socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
self.context = ssl_module.create_default_context()
self.wsocket = None
self.server, self.port, self.nick, self.user, self.ssl, self.ssl_accept_invalid, self.realname = address,port,nick,user,ssl,ssl_igninvalid,realname
if ssl:
if ssl_igninvalid:
self.context = ssl_module._create_unverified_context()
self.wsocket = self.context.wrap_socket(self.socket, server_hostname=address)
def connect(self): # Attempt to connect
print("Connecting to " + self.server + ":" + str(self.port) + "...")
if self.ssl:
self.wsocket.connect((self.server, self.port))
else:
self.socket.connect((self.server, self.port))
self.connected = True
self.send("USER " + self.user + " " + self.user + " " + self.nick + " :SugarCaneIRC user\n")
self.send(f"NICK {self.nick}\n")
def send(self, content:str): # Attempt to send raw data to the socket
if content[len(content)-1] != "\n":
content+="\n"
if self.ssl:
self.wsocket.send(bytes(content,"UTF-8"))
else:
self.socket.send(bytes(content,"UTF-8"))
def quit(self, message:str="ScParseIRC v"+str(__version__)): # Send the server a signal that the client is about to quit, and rely on the server to close the connection.
self.send("QUIT :" + message + "\n")
self.connected = False
def join(self, chan):
self.chans.append(Channel(chan))
self.send(f"JOIN {chan}")
def close(self):
if self.ssl:
self.wsocket.close()
else:
self.socket.close()
self.connected = False
def get(self): # Attempt to get the raw data and parse it.
# The code is copied from sweeBotIRC btw
if self.ssl:
r = self.wsocket.recv(2040).decode()
else:
r = self.socket.recv(2040).decode()
self.raw_text += r
self.parseall()
if r.find("PING") != -1:
self.send(
"PONG " + r.split()[1] + "\r\n"
)
if not r:
self.connected = False
return r
def parseall(self): # Parse all of the fetched raw data, in a thread.
threading.Thread(target=self._dump_message_cache, kwargs={"content": self.raw_text}).start()
def _dump_message_cache(self, content:str): # The thread of parsing all of the raw data, dumping all of it in the messages list.
self.messages = self.parse(content)
def parse(self, content:str): # Attempt to parse raw data into a Message or SystemMessage object
cache = []
for i in content.replace("\r\n", "\n").split("\n"):
spaced = i.split(" ")
system_ = not "@" in spaced[0]
if len(spaced) > 4:
if spaced[1] == "NOTICE":
cache.append(SystemMessage(content=" ".join(spaced[3:])[1:],user=User(name=spaced[0][1:] if not "@" in spaced[0] else spaced[0][1:].split("!")[0], system=system_), typ="notice", mention=not system_))
if len(cache) == 1:
return cache[0]
else:
return cache
def alive(self): # NOT FINISHED: To minimize exceptions, the client can ask the object if the socket connection is still alive.
return False
def whois(self, nick:str): # NOT FINISHED: Try to /whois the user, will return a user() object or None.
return None