modulitiz-micro 2.45.0__py311-none-any.whl → 2.46.0__py311-none-any.whl

modulitiz_micro/rete/ModuloNetworking.py

@@ -1,72 +1,67 @@
-import os
-import re
-import socket
-from contextlib import closing
-from uuid import getnode
-
-from _socket import gaierror
-
-from modulitiz_nano.ModuloListe import ModuloListe
-from modulitiz_nano.ModuloStringhe import ModuloStringhe
-from modulitiz_nano.eccezioni.EccezioneRuntime import EccezioneRuntime
-from modulitiz_nano.sistema.ModuloSystem import ModuloSystem
-
-
-class ModuloNetworking(object):
-	@staticmethod
-	def getMacAddress()->str:
-		mac=("%012X" % getnode())
-		return mac
-
-	@staticmethod
-	def getLocalIp()->str|None:
-		"""
-		Returns private local IP address.
-		"""
-		sockObj = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-		sockObj.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
-		try:
-			# doesn't even have to be reachable
-			sockObj.connect(('255.255.255.255', 1))
-			indirizzoIp = sockObj.getsockname()[0]
-		except gaierror:
-			indirizzoIp = None
-		finally:
-			sockObj.close()
-		return indirizzoIp
-
-	@staticmethod
-	def isHttpPortOpen(host:str|None,port:int)->bool:
-		# controllo host
-		if host is None:
-			host="127.0.0.1"
-		# controllo porta
-		with closing(socket.socket(socket.AF_INET, socket.SOCK_STREAM)) as sock:
-			if sock.connect_ex((host, port)) == 0:
-				return True
-		return False
-
-	@staticmethod
-	def checkPing(ipAddress:str)->bool:
-		# build command
-		cmd="ping "
-		regexPercPacketsLost=r"(\d{1,3})\% "
-		if ModuloSystem.isWindows():
-			cmd+="-n"
-			regexPercPacketsLost=r"\("+regexPercPacketsLost
-		elif os.name=='posix':
-			cmd+="-W 5 -c"
-			regexPercPacketsLost=r", "+regexPercPacketsLost
-		else:
-			raise EccezioneRuntime("Tipologia del sistema operativo non riconosciuta: "+os.name)
-		cmd+=" 1 "+ipAddress
-		# execute command
-		outputComando=ModuloStringhe.normalizzaEol(ModuloSystem.systemCallReturnOutput(cmd,None))
-		rows=outputComando.split("\n")
-		rows=ModuloListe.eliminaElementiVuoti(rows)
-		for row in rows:
-			if ModuloStringhe.contains(row, "%"):
-				regexOutput=re.search(regexPercPacketsLost,row)
-				if regexOutput is not None:
-					return int(regexOutput.group(1).strip())==0
-		return False
+import os
+import socket
+from contextlib import closing
+from uuid import getnode
+
+from _socket import gaierror
+
+from modulitiz_nano.ModuloListe import ModuloListe
+from modulitiz_nano.ModuloStringhe import ModuloStringhe
+from modulitiz_nano.eccezioni.EccezioneRuntime import EccezioneRuntime
+from modulitiz_nano.sistema.ModuloSystem import ModuloSystem
+
+
+class ModuloNetworking(object):
+	@staticmethod
+	def getMacAddress()->str:
+		mac=("%012X" % getnode())
+		return mac
+
+	@staticmethod
+	def getLocalIp()->str|None:
+		"""
+		Returns private local IP address.
+		"""
+		sockObj = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+		sockObj.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
+		try:
+			# doesn't even have to be reachable
+			sockObj.connect(('255.255.255.255', 1))
+			indirizzoIp = sockObj.getsockname()[0]
+		except gaierror:
+			indirizzoIp = None
+		finally:
+			sockObj.close()
+		return indirizzoIp
+
+	@staticmethod
+	def isHttpPortOpen(host:str|None,port:int)->bool:
+		# controllo host
+		if host is None:
+			host="127.0.0.1"
+		# controllo porta
+		with closing(socket.socket(socket.AF_INET, socket.SOCK_STREAM)) as sock:
+			if sock.connect_ex((host, port)) == 0:
+				return True
+		return False
+
+	@staticmethod
+	def checkPing(ipAddress:str)->bool:
+		# build command
+		cmd="ping "
+		textToSearch="="
+		if ModuloSystem.isWindows():
+			cmd+="-n"
+			textToSearch=" TTL"+textToSearch
+		elif os.name=='posix':
+			cmd+="-W 5 -c"
+			textToSearch=" ttl"+textToSearch
+		else:
+			raise EccezioneRuntime("Tipologia del sistema operativo non riconosciuta: "+os.name)
+		cmd+=" 1 "+ipAddress
+		# execute command
+		outputComando=ModuloStringhe.normalizzaEol(ModuloSystem.systemCallReturnOutput(cmd,None))
+		rows=outputComando.split("\n")
+		rows=ModuloListe.eliminaElementiVuoti(rows)
+		rowsMatching=[x for x in rows if ModuloStringhe.contains(x,textToSearch)]
+		return len(rowsMatching)==1

modulitiz_micro/rete/ModuloOpenVpn.py

@@ -1,15 +1,15 @@
-from modulitiz_nano.sistema.ModuloSystem import ModuloSystem
-
-
-class ModuloOpenVpn(object):
-	def __init__(self,percorsoOpenVpn:str):
-		self.__percorsoOpenVpn=percorsoOpenVpn
-	
-	def startVpn(self,isOpenVpnAlreadyRunning:bool,filenameOvpn:str):
-		"""
-		Send a command to start vpn to a new or already running instance of the GUI.
-		https://community.openvpn.net/openvpn/wiki/OpenVPN-GUI-New#gui-help
-		"""
-		subCmd="--command connect" if isOpenVpnAlreadyRunning else "--connect"
-		cmd=r'start "" "{}" {} {}.ovpn'.format(self.__percorsoOpenVpn,subCmd,filenameOvpn)
-		ModuloSystem.systemCallWaitAndClose(cmd,False)
+from modulitiz_nano.sistema.ModuloSystem import ModuloSystem
+
+
+class ModuloOpenVpn(object):
+	def __init__(self,percorsoOpenVpn:str):
+		self.__percorsoOpenVpn=percorsoOpenVpn
+	
+	def startVpn(self,isOpenVpnAlreadyRunning:bool,filenameOvpn:str):
+		"""
+		Send a command to start vpn to a new or already running instance of the GUI.
+		https://community.openvpn.net/openvpn/wiki/OpenVPN-GUI-New#gui-help
+		"""
+		subCmd="--command connect" if isOpenVpnAlreadyRunning else "--connect"
+		cmd=r'start "" "{}" {} {}.ovpn'.format(self.__percorsoOpenVpn,subCmd,filenameOvpn)
+		ModuloSystem.systemCallWaitAndClose(cmd,False)

modulitiz_micro/rete/email/EmailBean.py

@@ -1,5 +1,5 @@
-class EmailBean(object):
-	def __init__(self,diz:dict):
-		self.destinatario:str=diz['destinatario']
-		self.user:str=diz['user']
-		self.password:str=diz['password']
+class EmailBean(object):
+	def __init__(self,diz:dict):
+		self.destinatario:str=diz['destinatario']
+		self.user:str=diz['user']
+		self.password:str=diz['password']

modulitiz_micro/rete/email/ModuloEmail.py

@@ -1,90 +1,90 @@
-import smtplib
-
-from modulitiz_nano.ModuloDate import ModuloDate
-from modulitiz_nano.ModuloListe import ModuloListe
-from modulitiz_nano.ModuloStringhe import ModuloStringhe
-
-
-class ModuloEmail(object):
-	SERVER_GOOGLE_INVIO=('smtp.gmail.com',smtplib.SMTP_SSL_PORT)
-	SERVER_VIRGILIO_INVIO=('out.virgilio.it',smtplib.SMTP_SSL_PORT)
-	
-	def __init__(self,credenzialiServer:tuple,user:str|None,password:str|None,isDebug:bool=False):
-		self.credenzialiServer=credenzialiServer
-		self.isDebug=isDebug
-		self.connEmail=None
-		self.user=user
-		self.password=password
-		self.isLogged=False
-	
-	def login(self,user:str|None=None,password:str|None=None):
-		if self.isLogged:
-			return
-		# controllo se usare le credenziali dei parametri o quelle della classe
-		if user is not None:
-			self.user=user
-		if password is not None:
-			self.password=password
-		# mi collego
-		self.connEmail=smtplib.SMTP_SSL(*self.credenzialiServer)
-		if self.isDebug:
-			self.connEmail.set_debuglevel(1)
-		# se serve setto l'autenticazione
-		if self.user is not None and self.password is not None:
-			self.connEmail.login(self.user,self.password)
-		self.isLogged=True
-	
-	def sendWithLoginAndClose(self,destinatari:str|list|tuple, oggetto:str, messaggio:str,
-			isHtml:bool)->dict:
-		# check if already logged
-		if not self.isLogged:
-			self.login(self.user,self.password)
-		# invio email
-		try:
-			errors=self.send(None,destinatari,oggetto,messaggio,isHtml)
-		except Exception as ex:
-			self.close()
-			raise ex
-		# chiudo la connessione
-		self.close()
-		return errors
-	
-	def send(self, mittente:str|None,destinatari:str|list|tuple, oggetto:str, messaggio:str,
-			isHtml:bool, dataInvio=ModuloDate.now(), cc=None, ccn=None)->dict:
-		# controllo i parametri
-		dataInvio=ModuloDate.dateToString(dataInvio)
-		if isinstance(destinatari, str):
-			destinatari=[destinatari]
-		if mittente is None:
-			mittente=self.user
-		domain=self.user.split("@")[-1]
-		messageId=f"{ModuloDate.getSecs()}@{domain}"
-		# creo il messaggio
-		message=f"""Date: {dataInvio}
-From: {mittente}
-Subject: {oggetto}
-To: {", ".join(destinatari)}
-Message-ID: <{messageId}>
-"""
-		if not ModuloListe.isEmpty(cc):
-			message+=("Cc: "+", ".join(cc))+"\n"
-		if not ModuloListe.isEmpty(ccn):
-			message+=("Bcc: "+", ".join(ccn))+"\n"
-		message+="Content-Type: text/html;\n"
-		# converto il messaggio in formato html
-		if not isHtml:
-			messaggio=ModuloStringhe.normalizzaEol(messaggio).replace("\n","<br/>\n")
-		messaggio=messaggio.encode(ModuloStringhe.CODIFICA_ASCII,"xmlcharrefreplace").decode(ModuloStringhe.CODIFICA_UTF8)
-		message+="\n"+messaggio
-		# invio la mail
-		try:
-			return self.connEmail.sendmail(mittente,destinatari,message)
-		except smtplib.SMTPServerDisconnected as ex:
-			return {"":str(ex)}
-	
-	def close(self):
-		if self.connEmail is None:
-			return
-		self.connEmail.quit()
-		self.connEmail=None
-		self.isLogged=False
+import smtplib
+
+from modulitiz_nano.ModuloDate import ModuloDate
+from modulitiz_nano.ModuloListe import ModuloListe
+from modulitiz_nano.ModuloStringhe import ModuloStringhe
+
+
+class ModuloEmail(object):
+	SERVER_GOOGLE_INVIO=('smtp.gmail.com',smtplib.SMTP_SSL_PORT)
+	SERVER_VIRGILIO_INVIO=('out.virgilio.it',smtplib.SMTP_SSL_PORT)
+	
+	def __init__(self,credenzialiServer:tuple,user:str|None,password:str|None,isDebug:bool=False):
+		self.credenzialiServer=credenzialiServer
+		self.isDebug=isDebug
+		self.connEmail=None
+		self.user=user
+		self.password=password
+		self.isLogged=False
+	
+	def login(self,user:str|None=None,password:str|None=None):
+		if self.isLogged:
+			return
+		# controllo se usare le credenziali dei parametri o quelle della classe
+		if user is not None:
+			self.user=user
+		if password is not None:
+			self.password=password
+		# mi collego
+		self.connEmail=smtplib.SMTP_SSL(*self.credenzialiServer)
+		if self.isDebug:
+			self.connEmail.set_debuglevel(1)
+		# se serve setto l'autenticazione
+		if self.user is not None and self.password is not None:
+			self.connEmail.login(self.user,self.password)
+		self.isLogged=True
+	
+	def sendWithLoginAndClose(self,destinatari:str|list|tuple, oggetto:str, messaggio:str,
+			isHtml:bool)->dict:
+		# check if already logged
+		if not self.isLogged:
+			self.login(self.user,self.password)
+		# invio email
+		try:
+			errors=self.send(None,destinatari,oggetto,messaggio,isHtml)
+		except Exception as ex:
+			self.close()
+			raise ex
+		# chiudo la connessione
+		self.close()
+		return errors
+	
+	def send(self, mittente:str|None,destinatari:str|list|tuple, oggetto:str, messaggio:str,
+			isHtml:bool, dataInvio=ModuloDate.now(), cc=None, ccn=None)->dict:
+		# controllo i parametri
+		dataInvio=ModuloDate.dateToString(dataInvio)
+		if isinstance(destinatari, str):
+			destinatari=[destinatari]
+		if mittente is None:
+			mittente=self.user
+		domain=self.user.split("@")[-1]
+		messageId=f"{ModuloDate.getSecs()}@{domain}"
+		# creo il messaggio
+		message=f"""Date: {dataInvio}
+From: {mittente}
+Subject: {oggetto}
+To: {", ".join(destinatari)}
+Message-ID: <{messageId}>
+"""
+		if not ModuloListe.isEmpty(cc):
+			message+=("Cc: "+", ".join(cc))+"\n"
+		if not ModuloListe.isEmpty(ccn):
+			message+=("Bcc: "+", ".join(ccn))+"\n"
+		message+="Content-Type: text/html;\n"
+		# converto il messaggio in formato html
+		if not isHtml:
+			messaggio=ModuloStringhe.normalizzaEol(messaggio).replace("\n","<br/>\n")
+		messaggio=messaggio.encode(ModuloStringhe.CODIFICA_ASCII,"xmlcharrefreplace").decode(ModuloStringhe.CODIFICA_UTF8)
+		message+="\n"+messaggio
+		# invio la mail
+		try:
+			return self.connEmail.sendmail(mittente,destinatari,message)
+		except smtplib.SMTPServerDisconnected as ex:
+			return {"":str(ex)}
+	
+	def close(self):
+		if self.connEmail is None:
+			return
+		self.connEmail.quit()
+		self.connEmail=None
+		self.isLogged=False

modulitiz_micro/rete/http/ModuloHttp.py

@@ -1,119 +1,119 @@
-import gzip
-import json
-import logging
-import ssl
-import urllib
-from urllib.parse import urlencode
-from urllib.request import Request
-
-import brotli
-
-from modulitiz_nano.ModuloBase64 import ModuloBase64
-from modulitiz_nano.ModuloStringhe import ModuloStringhe
-from modulitiz_nano.eccezioni.EccezioneRuntime import EccezioneRuntime
-from modulitiz_nano.files.ModuloLogging import ModuloLogging
-from modulitiz_micro.rete.http.ModuloHttpConnectionSafe import ModuloHttpConnectionSafe
-from modulitiz_micro.rete.http.beans.HttpResponseBean import HttpResponseBean
-from modulitiz_micro.rete.http.decorators.catchAndRaiseHttpExceptions import catchAndRaiseHttpExceptions
-
-
-class ModuloHttp(object):
-	"""
-	Utility per gestione richieste di rete secondo il protocollo HTTP.
-	"""
-	
-	UA_ANDROID="Mozilla/5.0 (Linux; Android 12.0; SM-G900P Build/LRX21T) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.87 Mobile Safari/537.36"
-	
-	UA_MACOS_CHROME="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36"
-	UA_WINDOWS_CHROME="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36"
-	UA_WINDOWS_FIREFOX="Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:86.0) Gecko/20100101 Firefox/86.0"
-	
-	UAS=[UA_MACOS_CHROME,UA_WINDOWS_CHROME,UA_WINDOWS_FIREFOX]
-	
-	URL_CERCA_GOOGLE="https://www.google.it/search?q="
-	# https://ipecho.net/plain removed because it can return either ipv4 or ipv6 depending on your ISP/Internet connection
-	URLS_GET_IPV4=('https://ipinfo.io/ip','https://api.ipify.org','https://ipv4.seeip.org')
-	
-	REGEX_IPV4_ADDRESS=r"\b(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\b"
-	
-	STATUS_OK=200
-	STATUS_OK_PARTIAL_CONTENT=206
-	
-	
-	def __init__(self,url:str,logger:ModuloLogging|None,useProxy:bool=False):
-		logging.getLogger("urllib3").propagate=False
-		
-		self.__requestObj=Request(url)
-		self.__logger=logger
-		
-		self.setUserAgent(self.UA_WINDOWS_FIREFOX)
-		self.addHeader('Accept-Encoding','gzip, deflate, br')		# questo serve per ridurre la dimensione della risposta
-		if useProxy:
-			self.addHeader('Origin','localhost')
-		self.connectionSafe=ModuloHttpConnectionSafe(self.__logger)
-	
-	def doGet(self,retries:int,ignoreCerts:bool=False)->HttpResponseBean:
-		"""
-		Esegue una richiesta di tipo GET
-		"""
-		if retries==0:
-			return self.__getOrPost(ignoreCerts)
-		return self.connectionSafe.run(retries,0,self.__getOrPost,ignoreCerts)
-	
-	def doPost(self, postData:dict, asJson:bool, retries:int,ignoreCerts:bool=False)->HttpResponseBean:
-		"""
-		Esegue una richiesta di tipo POST
-		"""
-		if not asJson:
-			postDataEncoded=urlencode(postData)
-		else:
-			postDataEncoded=json.dumps(postData)
-			self.addHeader("Content-Type","application/json; charset=utf-8")
-		postDataEncoded=postDataEncoded.encode()
-		self.__requestObj.data=postDataEncoded
-		if retries==0:
-			return self.__getOrPost(ignoreCerts)
-		return self.connectionSafe.run(retries,0,self.__getOrPost,ignoreCerts)
-	
-	@catchAndRaiseHttpExceptions
-	def __getOrPost(self, ignoreCerts:bool)->HttpResponseBean:
-		# ignoro certificati
-		ctx=None
-		if ignoreCerts:
-			ctx=ssl.create_default_context()
-			ctx.check_hostname=False
-			ctx.verify_mode=ssl.CERT_NONE
-		# send request
-		with urllib.request.urlopen(self.__requestObj,context=ctx) as response:
-			responseBody=response.read()
-			responseHeaders=response.info()
-			status=response.status
-		# se il server manda il contenuto in formato compresso lo decomprimo
-		contentEncoding=responseHeaders.get('Content-Encoding')
-		if contentEncoding=="gzip":
-			responseBody=gzip.decompress(responseBody)
-		elif contentEncoding=="br":
-			responseBody=brotli.decompress(responseBody)
-		elif contentEncoding is not None and contentEncoding!= "deflate":
-			raise EccezioneRuntime("Codifica '"+contentEncoding+"' non gestita.")
-		return HttpResponseBean(status,responseBody,responseHeaders)
-	
-	# opzioni aggiuntive
-	def addHeader(self,nome:str,valore):
-		if ModuloStringhe.isEmpty(valore):
-			return
-		self.__requestObj.add_header(nome,valore)
-	
-	def setUserAgent(self,userAgent:str=None):
-		if ModuloStringhe.isEmpty(userAgent):
-			userAgent=self.UA_ANDROID
-		else:
-			userAgent=userAgent.strip()
-		self.addHeader('User-Agent',userAgent)
-	
-	def setDownloadRange(self,inizio:int,fine:int):
-		self.addHeader('Range',"bytes="+str(inizio)+"-"+str(fine))
-	
-	def setAuthenticationBasic(self,username:str,password:str):
-		authStr=ModuloBase64.codificaStr('%s:%s' % (username, password))
-		self.addHeader('Authorization',"Basic "+authStr)
+import gzip
+import json
+import logging
+import ssl
+import urllib
+from urllib.parse import urlencode
+from urllib.request import Request
+
+import brotli
+
+from modulitiz_nano.ModuloBase64 import ModuloBase64
+from modulitiz_nano.ModuloStringhe import ModuloStringhe
+from modulitiz_nano.eccezioni.EccezioneRuntime import EccezioneRuntime
+from modulitiz_nano.files.ModuloLogging import ModuloLogging
+from modulitiz_micro.rete.http.ModuloHttpConnectionSafe import ModuloHttpConnectionSafe
+from modulitiz_micro.rete.http.beans.HttpResponseBean import HttpResponseBean
+from modulitiz_micro.rete.http.decorators.catchAndRaiseHttpExceptions import catchAndRaiseHttpExceptions
+
+
+class ModuloHttp(object):
+	"""
+	Utility per gestione richieste di rete secondo il protocollo HTTP.
+	"""
+	
+	UA_ANDROID="Mozilla/5.0 (Linux; Android 12.0; SM-G900P Build/LRX21T) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.87 Mobile Safari/537.36"
+	
+	UA_MACOS_CHROME="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36"
+	UA_WINDOWS_CHROME="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36"
+	UA_WINDOWS_FIREFOX="Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:86.0) Gecko/20100101 Firefox/86.0"
+	
+	UAS=[UA_MACOS_CHROME,UA_WINDOWS_CHROME,UA_WINDOWS_FIREFOX]
+	
+	URL_CERCA_GOOGLE="https://www.google.it/search?q="
+	# https://ipecho.net/plain removed because it can return either ipv4 or ipv6 depending on your ISP/Internet connection
+	URLS_GET_IPV4=('https://ipinfo.io/ip','https://api.ipify.org','https://ipv4.seeip.org')
+	
+	REGEX_IPV4_ADDRESS=r"\b(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\b"
+	
+	STATUS_OK=200
+	STATUS_OK_PARTIAL_CONTENT=206
+	
+	
+	def __init__(self,url:str,logger:ModuloLogging|None,useProxy:bool=False):
+		logging.getLogger("urllib3").propagate=False
+		
+		self.__requestObj=Request(url)
+		self.__logger=logger
+		
+		self.setUserAgent(self.UA_WINDOWS_FIREFOX)
+		self.addHeader('Accept-Encoding','gzip, deflate, br')		# questo serve per ridurre la dimensione della risposta
+		if useProxy:
+			self.addHeader('Origin','localhost')
+		self.connectionSafe=ModuloHttpConnectionSafe(self.__logger)
+	
+	def doGet(self,retries:int,ignoreCerts:bool=False)->HttpResponseBean:
+		"""
+		Esegue una richiesta di tipo GET
+		"""
+		if retries==0:
+			return self.__getOrPost(ignoreCerts)
+		return self.connectionSafe.run(retries,0,self.__getOrPost,ignoreCerts)
+	
+	def doPost(self, postData:dict, asJson:bool, retries:int,ignoreCerts:bool=False)->HttpResponseBean:
+		"""
+		Esegue una richiesta di tipo POST
+		"""
+		if not asJson:
+			postDataEncoded=urlencode(postData)
+		else:
+			postDataEncoded=json.dumps(postData)
+			self.addHeader("Content-Type","application/json; charset=utf-8")
+		postDataEncoded=postDataEncoded.encode()
+		self.__requestObj.data=postDataEncoded
+		if retries==0:
+			return self.__getOrPost(ignoreCerts)
+		return self.connectionSafe.run(retries,0,self.__getOrPost,ignoreCerts)
+	
+	@catchAndRaiseHttpExceptions
+	def __getOrPost(self, ignoreCerts:bool)->HttpResponseBean:
+		# ignoro certificati
+		ctx=None
+		if ignoreCerts:
+			ctx=ssl.create_default_context()
+			ctx.check_hostname=False
+			ctx.verify_mode=ssl.CERT_NONE
+		# send request
+		with urllib.request.urlopen(self.__requestObj,context=ctx) as response:
+			responseBody=response.read()
+			responseHeaders=response.info()
+			status=response.status
+		# se il server manda il contenuto in formato compresso lo decomprimo
+		contentEncoding=responseHeaders.get('Content-Encoding')
+		if contentEncoding=="gzip":
+			responseBody=gzip.decompress(responseBody)
+		elif contentEncoding=="br":
+			responseBody=brotli.decompress(responseBody)
+		elif contentEncoding is not None and contentEncoding!= "deflate":
+			raise EccezioneRuntime("Codifica '"+contentEncoding+"' non gestita.")
+		return HttpResponseBean(status,responseBody,responseHeaders)
+	
+	# opzioni aggiuntive
+	def addHeader(self,nome:str,valore):
+		if ModuloStringhe.isEmpty(valore):
+			return
+		self.__requestObj.add_header(nome,valore)
+	
+	def setUserAgent(self,userAgent:str=None):
+		if ModuloStringhe.isEmpty(userAgent):
+			userAgent=self.UA_ANDROID
+		else:
+			userAgent=userAgent.strip()
+		self.addHeader('User-Agent',userAgent)
+	
+	def setDownloadRange(self,inizio:int,fine:int):
+		self.addHeader('Range',"bytes="+str(inizio)+"-"+str(fine))
+	
+	def setAuthenticationBasic(self,username:str,password:str):
+		authStr=ModuloBase64.codificaStr('%s:%s' % (username, password))
+		self.addHeader('Authorization',"Basic "+authStr)