kongalib 2.0.0__cp310-cp310-win_amd64.whl → 2.0.2__cp310-cp310-win_amd64.whl

kongalib/data_dictionary.py

@@ -23,16 +23,7 @@ TYPE_INT					= 3				#: Tipo di campo SQL INT; i valori ottenuti dalla :meth:`~ko
 TYPE_BIGINT					= 4				#: Tipo di campo SQL BIGINT; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``int``.
 TYPE_FLOAT					= 5				#: Tipo di campo SQL FLOAT; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``float``.
 TYPE_DOUBLE					= 6				#: Tipo di campo SQL DOUBLE; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``float``.
-TYPE_DECIMAL				= 7
-"""Tipo di campo SQL DECIMAL; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo :class:`kongalib.Decimal`.
-
-.. warning:: Konga Server traduce automaticamente questo tipo di dato in BIGINT sul database SQL, e salva i valori decimali come se
-	fossero interi moltiplicati per 1000000. Questo consente una precisione fino a 6 cifre decimali, e permette a Konga Server di operare anche
-	con driver SQL che non supportano nativamente il tipo dato DECIMAL (come SQLite). La traduzione è completamente trasparente per kongalib, in
-	quanto i metodi della classe :class:`kongalib.Client` ricevono e restituiscono oggetti di clase :class:`kongalib.Decimal` per gestire
-	i decimali.
-"""
-
+TYPE_DECIMAL				= 7				#: Tipo di campo SQL DECIMAL; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo :class:`kongalib.Decimal`.
 TYPE_DATE					= 8				#: Tipo di campo SQL DATE; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``datetime.date``.
 TYPE_TIME					= 9				#: Tipo di campo SQL TIME; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``datetime.time``.
 TYPE_TIMESTAMP				= 10			#: Tipo di campo SQL TIMESTAMP; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``datetime.datetime``.
@@ -45,6 +36,7 @@ TYPE_LONGTEXT				= 16			#: Tipo di campo SQL LONGTEXT; i valori ottenuti dalla :
 TYPE_TINYBLOB				= 17			#: Tipo di campo SQL TINYBLOB; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``bytes``.
 TYPE_BLOB					= 18			#: Tipo di campo SQL BLOB; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``bytes``.
 TYPE_LONGBLOB				= 19			#: Tipo di campo SQL LONGBLOB; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``bytes``.
+TYPE_JSON					= 20			#: Tipo di campo SQL JSON; i valori ottenuti dalla :meth:`~kongalib.Client.select_data` saranno di tipo ``unicode``.
 
 
 TABLE_HAS_IMAGES			= 0x1			#: Flag informativo di tabella del data dictionary. Se specificato, i record della tabella possono avere immagini collegate.

kongalib/db.py

@@ -250,14 +250,14 @@ def TimeFromTicks(ticks):
 def TimestampFromTicks(ticks):
 	return Timestamp(*time.localtime(ticks)[:6])
 
-def connect(host, port=0, driver=None, database=None, user=None, password=None):
-	"""Esegue una connessione al server Konga identificato da *host* e *port*, apre *database* usando il *driver* specificato,
-	ed infine si autentica usando *user* e *password*. Restituisce un oggetto :class:`Connection`; da questo è possibile ottenere un oggetto
-	:class:`Cursor` che permette di eseguire query SQL sul database aperto sulla connessione.
+def connect(host, port=0, driver=None, database=None, user=None, password=None, tenant_key=None):
+	"""Esegue una connessione al server Konga identificato da *host* e *port*, usando l'eventuale chiave tenant *tenant_key*, apre *database*
+	usando il *driver* specificato, ed infine si autentica usando *user* e *password*. Restituisce un oggetto :class:`Connection`; da questo
+	è possibile ottenere un oggetto :class:`Cursor` che permette di eseguire query SQL sul database aperto sulla connessione.
 	"""
 	conn = Connection()
 	try:
-		conn.connect({ 'host': host, 'port': port })
+		conn.connect({ 'host': host, 'port': port }, options={ 'tenant_key': tenant_key })
 		conn.open_database(driver, database)
 		conn.authenticate(user, password)
 	except _Error as e:

kongalib/expression.py

@@ -203,6 +203,10 @@ def parse(sql):
 	def p_expression_binop(p):
 		'expression : ID OPERAND VALUE'
 		p[0] = Operand(p[1], p[2], p[3])
+	
+	def p_expression_valueop(p):
+		'expression : VALUE OPERAND VALUE'
+		p[0] = Operand(p[1], p[2], p[3], _HasLogic.LOGIC_NONE, _HasLogic.FLAG_NO_ESCAPE)
 
 	def p_expression_func_fieldop(p):
 		'expression : function OPERAND ID'
@@ -589,6 +593,7 @@ class Expression(_HasLogic):
 		e.logic_op = self.logic_op
 		for child in self.children:
 			e.children.append(child.copy())
+			child.parent = e
 		return e
 	
 	def append(self, operand, logic_op):
@@ -618,8 +623,8 @@ class Expression(_HasLogic):
 				if self.children[index + 1].logic_op & _HasLogic.LOGIC_NOT:
 					op += ' NOT'
 			else:
-				if (len(self.children) == 1) and (self.children[-1].logic_op & _HasLogic.LOGIC_NOT):
-					l[-1].append(True)
+				# if (len(self.children) == 1) and (self.children[-1].logic_op & _HasLogic.LOGIC_NOT):
+				# 	l[-1].append(True)
 				op = None
 			l.append(op)
 		return l

kongalib/scripting.py

@@ -17,7 +17,7 @@ from __future__ import print_function
 from __future__ import absolute_import
 
 from kongalib import Error
-from ._kongalib import get_application_log_path, set_interpreter_timeout, get_interpreter_timeout, get_interpreter_time_left, _set_process_foreground
+from _kongalib import get_application_log_path, set_interpreter_timeout, get_interpreter_timeout, get_interpreter_time_left, _set_process_foreground
 
 import sys
 import os
@@ -148,7 +148,7 @@ def timeout_handler():
 
 
 
-def init_interpreter(init_logging=True):
+def init_interpreter():
 	_State.io.append((sys.stdout, sys.stderr, sys.stdin))
 	try:
 		proxy._initialize()
@@ -223,7 +223,8 @@ class _Controller(threading.Thread):
 		name = None
 		while name != 'exit':
 			try:
-				if not self.conn.poll(0.5):
+				ready = multiprocessing.connection.wait([ self.conn ], 0.5)
+				if not ready:
 					if self.request == _Controller.QUIT_REQUEST:
 						break
 					continue
@@ -278,16 +279,15 @@ class _Controller(threading.Thread):
 
 
 
-def _trampoline(conn, sem, foreground, dll_paths, queue):
+def _trampoline(conn, sem, foreground, env, dll_paths, queue, level):
+	logging.getLogger().setLevel(level)
 	logger = logging.getLogger('script._trampoline')
 	handler = logging.handlers.QueueHandler(queue)
-	handler.setLevel(logging.DEBUG)
+	handler.setLevel(level)
 	logger.addHandler(handler)
-	logger.setLevel(logging.DEBUG)
 	logger.debug('entering interpreter process')
 	try:
-		if foreground:
-			_set_process_foreground()
+		_set_process_foreground(foreground)
 		for path in dll_paths:
 			try:
 				os.add_dll_directory(path)
@@ -295,6 +295,11 @@ def _trampoline(conn, sem, foreground, dll_paths, queue):
 			except:
 				if sys.platform == 'win32':
 					logger.error('error adding DLL directory: %s' % path)
+		for key, value in (env or {}).items():
+			key = str(key)
+			value = str(value)
+			os.environ[key] = value
+			logger.debug('added env variable %s=%s' % (key, value))
 
 		_State.controller = _Controller(conn, sem)
 		_State.controller.start()
@@ -332,6 +337,8 @@ def _trampoline(conn, sem, foreground, dll_paths, queue):
 		except:
 			pass
 		_State.controller.join()
+	except KeyboardInterrupt:
+		logger.debug('user issued a keyboard interrupt')
 	except Exception as e:
 		import traceback
 		logger.critical('unhandled error in interpreter process: %s' % traceback.format_exc())
@@ -356,7 +363,7 @@ class _ControllerProxy(Proxy):
 
 
 class Interpreter(object):
-	def __init__(self, foreground=True):
+	def __init__(self, foreground=True, env=None):
 		self.proc = None
 		self.exc_info = None
 		self.conn = None
@@ -365,7 +372,8 @@ class Interpreter(object):
 		self.queue = multiprocessing.Queue()
 		self.proxy = None
 		self.foreground = foreground
-		self.logger_listener = logging.handlers.QueueListener(self.queue, *logging.getLogger().handlers)
+		self.env = env
+		self.logger_listener = logging.handlers.QueueListener(self.queue, *logging.getLogger().handlers, respect_handler_level=True)
 
 	def __del__(self):
 		with self.lock:
@@ -386,7 +394,7 @@ class Interpreter(object):
 				self.conn, self.client_conn = multiprocessing.Pipe()
 				self.proxy = _ControllerProxy(self.conn).controller
 				self.logger_listener.start()
-				self.proc = multiprocessing.Process(target=_trampoline, args=(self.client_conn, self.sem, self.foreground, _DLL_PATHS, self.queue), daemon=True)
+				self.proc = multiprocessing.Process(target=_trampoline, args=(self.client_conn, self.sem, self.foreground, self.env, _DLL_PATHS, self.queue, logging.getLogger().level), daemon=True)
 				self.proc.start()
 				exitcode = self.proc.exitcode
 				if exitcode is not None:
@@ -426,7 +434,10 @@ class Interpreter(object):
 				self.proc = None
 				self.lock.release()
 				try:
-					proc.terminate()
+					try:
+						proc.terminate()
+					except:
+						pass
 					proc.join(3)
 					if proc.is_alive():
 						try:
@@ -437,13 +448,18 @@ class Interpreter(object):
 					self.lock.acquire()
 
 	def is_running(self):
-		with self.lock:
-			return (self.conn is None) or ((self.proc is not None) and self.proc.is_alive())
+		conn = self.conn
+		proc = self.proc
+		return (conn is None) or ((proc is not None) and proc.is_alive())
 
 	def set_timeout(self, timeout=None, restore=False):
 		with self.lock:
 			if self.proxy is not None:
-				return self.proxy.set_timeout(timeout, restore)
+				func = self.proxy.set_timeout
+			else:
+				func = None
+		if func is not None:
+			return func(timeout, restore)
 
 	def get_time_left(self):
 		with self.lock:
@@ -513,6 +529,7 @@ class _Method(object):
 			if DEBUG:
 				debug_log('[Proxy] call sent in %f secs. Waiting reply: %s' % (time.time() - s, str((self.handler._name, self.name))))
 			
+			multiprocessing.connection.wait([ self.handler._conn ])
 			e, result = self.handler._conn.recv()
 			if DEBUG:
 				s = time.time()
@@ -560,7 +577,8 @@ class _ServerProxy(threading.Thread):
 			self.conn = self.listener.accept()
 			debug_log("[ServerProxy] got proxy")
 			while True:
-				if self.conn.poll(0.1):
+				ready = multiprocessing.connection.wait([ self.conn ], 0.5)
+				if ready:
 					data = self.conn.recv()
 					handler, name, args, kwargs = data
 					if handler in self.handlers:
@@ -635,7 +653,9 @@ class BuiltinHandler(object):
 	
 	def format_exception(self, type, value, tb):
 		import traceback
-		text = [ 'Traceback (most recent call last):\n' ] + traceback.format_list(tb) + traceback.format_exception_only(type, value)
+		if not all([ isinstance(x, str) for x in tb ]):
+			tb = traceback.format_list(tb)
+		text = [ 'Traceback (most recent call last):\n' ] + tb + traceback.format_exception_only(type, value)
 		return ''.join(text)
 	
 	def print_exception(self, type, value, tb):
@@ -721,6 +741,7 @@ def execute(script=None, filename=None, argv=None, path=None, timeout=0, handler
 			else:
 				debug_log("[ServerProxy] unhandled execute exception: %s" % traceback.format_exc())
 				type, value, tb = sys.exc_info()
+				tb = traceback.format_tb(tb)
 			def do_filter(entry):
 				filename = entry[0].replace('\\', '/')
 				if filename.endswith('kongalib/scripting.py') or filename.endswith('__script_host__.py'):
@@ -733,7 +754,7 @@ def execute(script=None, filename=None, argv=None, path=None, timeout=0, handler
 				debug_log('proxy.builtin.print_exception exception:\n%s' % traceback.format_exc())
 		finally:
 			_handlers['builtin']._set_interpreter(None)
-			del interpreter
+			interpreter = None
 			_handlers['builtin']._atexit()
 			try:
 				debug_log("[ServerProxy] done")

{kongalib-2.0.0.dist-info → kongalib-2.0.2.dist-info}/METADATA

@@ -1,36 +1,42 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: kongalib
-Version: 2.0.0
+Version: 2.0.2
 Summary: Konga client library
-Home-page: https://github.com/easybyte-software/kongalib
-Author: EasyByte Software
-Author-email: konga@easybyte.it
+Author-email: EasyByte Software <konga@easybyte.it>
 License: LGPL
+Project-URL: homepage, https://github.com/easybyte-software/kongalib
+Project-URL: documentation, https://public.easybyte.it/docs/current/technical/kongalib/index.html
+Project-URL: repository, https://github.com/easybyte-software/kongalib.git
 Keywords: konga,client,erp
 Classifier: Natural Language :: Italian
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: C++
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
 Classifier: Intended Audience :: Financial and Insurance Industry
-Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
 Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Topic :: Office/Business
 Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: colorama
+Requires-Dist: nest_asyncio
+Dynamic: license-file
 
 Kongalib
 ========
@@ -44,9 +50,9 @@ Kongalib
 .. image:: https://img.shields.io/badge/License-LGPLv3-blue.svg
    :alt: LGPL v3 License
    :target: https://www.gnu.org/licenses/lgpl-3.0.en.html
-.. image:: https://dev.azure.com/easybyte-software/kongalib/_apis/build/status/easybyte-software.kongalib?branchName=master
+.. image:: https://github.com/easybyte-software/kongalib/actions/workflows/build_wheels.yml/badge.svg?event=workflow_dispatch
    :alt: Build Status
-   :target: https://dev.azure.com/easybyte-software/kongalib
+   :target: https://github.com/easybyte-software/kongalib/actions/workflows/build_wheels.yml
 
 Libreria Python di comunicazione con i server `EasyByte Konga`_. Tramite
 *kongalib* è possibile connettersi ad un server Konga (integrato in Konga Pro o
@@ -73,16 +79,16 @@ Se si desidera è possibile compilare i sorgenti. I prerequisiti per compilare
 
 **Windows**
 
-Sono supportate le versioni di Windows dalla 7 in su. Come prerequisiti è
+Sono supportate le versioni di Windows dalla 10 in su. Come prerequisiti è
 necessario installare:
 
-	- Microsoft Visual Studio 2017
+	- Microsoft Visual Studio 2017 o successiva
 	- `SDK di Konga`_
 
 
 **MacOS X**
 
-Sono supportate le versioni di macOS dalla 10.8 in su. Come prerequisiti è
+Sono supportate le versioni di macOS dalla 10.9 in su. Come prerequisiti è
 necessario installare:
 
 	- XCode (assicurarsi di aver installato anche i tool da linea di comando)
@@ -92,9 +98,9 @@ necessario installare:
 **Linux**
 	
 Benchè il pacchetto binario wheel per Linux supporti tutte le distribuzioni
-Linux moderne (specifica `manylinux`), al momento la compilazione da parte di
+Linux moderne (specifica `manylinux_2_28`_), al momento la compilazione da parte di
 terzi è supportata ufficialmente solo se si usa una distribuzione Linux basata su
-Debian, in particolare Ubuntu Linux dalla versione 16.04 in su. Sono necessari i
+Debian, in particolare Ubuntu Linux dalla versione 20.04 in su. Sono necessari i
 seguenti pacchetti *deb*:
 
 	- build-essential
@@ -102,18 +108,15 @@ seguenti pacchetti *deb*:
 	- python-dev
 	- `easybyte-konga-dev`_
 
-La compilazione è possibile tramite la usuale procedura dei pacchetti Python::
+La compilazione come da standard Python è possibile sempre tramite *pip*, eseguendo
+dalla directory dei sorgenti::
 
-	python setup.py install
+	pip install .
 
 
 .. note:: Sotto piattaforma Windows per la corretta compilazione è necessario
-	impostare la variabile d'ambiente `KONGASDK` alla directory d'installazione
-	dell'`SDK di Konga`_. Notare inoltre che l'SDK di Konga è compilato con
-	Visual Studio 2017 e non è compatibile con Python 2.x (che sotto Windows
-	richiede Visual Studio 2008); se si desidera usare *kongalib* con Python 2.x
-	sotto Windows, è necessario usare la *wheel* precompilata installabile
-	tramite *pip*.
+	impostare la variabile d'ambiente `KONGASDK` alla directory d'installazione
+	dell'`SDK di Konga`_.
 
 
 Risorse
@@ -143,5 +146,5 @@ Risorse
 .. _Script di utilità comune per Konga: https://github.com/easybyte-software/konga_scripts
 .. _SDK di Konga: http://public.easybyte.it/downloads/current
 .. _easybyte-konga-dev: http://public.easybyte.it/downloads/current
-.. _manylinux: https://github.com/pypa/manylinux
+.. _manylinux_2_28: https://github.com/pypa/manylinux
 

kongalib-2.0.2.dist-info/RECORD

@@ -0,0 +1,21 @@
+_kongalib.cp310-win_amd64.pdb,sha256=-7fOa1mV-4yfpqLQ4ky7ccEfodaIvGl1KCCmrwt1NXQ,7344128
+_kongalib.cp310-win_amd64.pyd,sha256=erDzZb9JNts0EyaS_l-QNN7LUsu1-hS0u3tE0ym4Qsw,2537984
+kongaui.py,sha256=0sSKUsOo5vLNH3wyUUl4icOL4z4CXqoPAR2fqYQZE7o,20598
+kongautil.py,sha256=PSObmHX6kVf54mtIyBXtxzf4CMHUsj_ppDNSWjY3Y2c,24005
+kongalib/__init__.py,sha256=VPFvthIAm7K668_Fxx_4Wf6rwZCAs6dwBz6DfZtwrLU,12979
+kongalib/async_client.py,sha256=tb6iOHpz3SIRlSyEI5aQ-VpEccmVFSK0V4N5p50wiPY,48219
+kongalib/client.py,sha256=-5YT1V9quD6WKkrp9LgDjO4Y-kq6nQEPTfCRGbi2TfA,59033
+kongalib/constants.py,sha256=r59fg2-CCTWRvKOusxXe9FTBrSAmFt5Esn70DsyEn8s,8793
+kongalib/data_dictionary.py,sha256=a-_aTlZeJPGkxkxzG040A2yrfXf_Stup3CTurh_93B0,11298
+kongalib/db.py,sha256=qnSon_7N5Po0-ww-88mL7DZlGX7_ASIM4tMY9bGGBnk,8354
+kongalib/expression.py,sha256=A7-erKQPF4VroB3ERCTvLYyOv5_gm1a-rxToLNhd8VY,21230
+kongalib/json.py,sha256=-8h3e92hLzsElxZhLgpcoQWfakSYyY0i7vsxB7Z7qtk,2341
+kongalib/lex.py,sha256=tV9VGF97XHRFf0eBICVzTILzH878i_slXLsoktFnZTQ,41797
+kongalib/scripting.py,sha256=SrYq2pubnj-qHl3_oNBEp1caA8zMmsBjQLUxyt_aydE,20410
+kongalib/yacc.py,sha256=UHnHKzBknH7qzIT7xJFIHYKBTzOIxWILtGPdSI29XcE,131768
+kongalib-2.0.2.dist-info/licenses/LICENSE,sha256=LPNKwDiu5awG-TPd0dqYJuC7k4PBPY4LCI_O0LSpW1s,7814
+kongalib-2.0.2.dist-info/METADATA,sha256=sJvnA0zOKI4KGUBXP_xi0f9Axm91pdGBxGCk5DFjcUM,5402
+kongalib-2.0.2.dist-info/WHEEL,sha256=KUuBC6lxAbHCKilKua8R9W_TM71_-9Sg5uEP3uDWcoU,101
+kongalib-2.0.2.dist-info/top_level.txt,sha256=htHdvBd1NQjLXNwXgTzCMPtyfCtorpw6jUZzu09vDYY,37
+kongalib-2.0.2.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+kongalib-2.0.2.dist-info/RECORD,,

{kongalib-2.0.0.dist-info → kongalib-2.0.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.40.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: false
 Tag: cp310-cp310-win_amd64
 

{kongalib-2.0.0.dist-info → kongalib-2.0.2.dist-info}/top_level.txt

@@ -1,3 +1,4 @@
+_kongalib
 kongalib
 kongaui
 kongautil

kongautil.py

@@ -139,7 +139,7 @@ def connect(host=None, port=None, driver=None, database=None, username=None, pas
 	parametri come variabili all'interno di un file di configurazione, nella sezione ``[kongautil.connect]``; tale file deve avere
 	il nome passato a questa funzione con il parametro ``config``, altrimenti verranno ricercati nell'ordine anche il file con lo
 	stesso nome dello script lanciato da terminale, ma con estensione ``.cfg``, il file ``kongalib.cfg`` sempre nella stessa directory
-	da cui si esegue lo script e infine il file ``~/.kongalib`` (sotto Unix) o ``%userprofile%\kongalib.cfg`` (sotto Windows)."""
+	da cui si esegue lo script e infine il file ``~/.kongalib`` (sotto Unix) o ``%userprofile%\\kongalib.cfg`` (sotto Windows)."""
 	if _proxy.is_valid():
 		info = _proxy.util.get_connection_info()
 		if info is not None:
@@ -423,7 +423,7 @@ def print_log(log, title, target=PRINT_TARGET_PREVIEW, filename=None):
 	:func:`print_layout`, passando i parametri *target* e *filename*; viceversa se si esegue fuori da Konga, il log verrà stampato su terminale."""
 	if _proxy.is_valid():
 		template = """<?xml version='1.0' encoding='utf-8'?>
-			<layout version="2" name="%(title)s" title="%(title)s" orientation="vertical" margin_top="75" margin_right="75" margin_bottom="75" margin_left="75">
+			<layout version="3" name="%(title)s" title="%(title)s" orientation="vertical" margin_top="75" margin_right="75" margin_bottom="75" margin_left="75">
 				<init>
 					<![CDATA[set_datasource(Datasource(['id', 'type', 'message'], DATA, 'Master'))
 ]]></init>
@@ -489,6 +489,18 @@ def print_log(log, title, target=PRINT_TARGET_PREVIEW, filename=None):
 
 
 
+def show_log(log, title, size=None, iconsize=32):
+	"""Visualizza il contenuto dell'oggetto *log* di classe :class:`kongalib.Log`; se si esegue questa funzione dall'interno di Konga, il log verrà
+	visualizzato in una finestra dedicata; viceversa se si esegue fuori da Konga, il comportamento di questa funzione equivale a chiamare
+	:func:`print_log` con gli stessi argomenti. La finestra del log mostrerà *title* come messaggio informativo e se specificato avrà dimensione *size*;
+	è possibile specificare anche la dimensione delle icone dei singoli messaggi tramite il parametro *iconsize*."""
+	if _proxy.is_valid():
+		log = _proxy.util.show_log(log.get_messages(), title, size, iconsize)
+	else:
+		print_log(log, title)
+
+
+
 def suspend_timeout():
 	"""Sospende il timeout di esecuzione dello script. La funzione non comporta eccezioni ma non ha alcun effetto se eseguita al di fuori di Konga."""
 	if _proxy.is_valid():

kongalib-2.0.0.dist-info/RECORD

@@ -1,21 +0,0 @@
-kongaui.py,sha256=0sSKUsOo5vLNH3wyUUl4icOL4z4CXqoPAR2fqYQZE7o,20598
-kongautil.py,sha256=6MOLwqxPoub7rezbiq06yBoSPecJISINO6oL2Hf4R_0,23265
-kongalib/__init__.py,sha256=vLzkRCqVlOR0CuUIYp_7lS_STxpKfqJtlVh3UBGTgfI,12910
-kongalib/_kongalib.cp310-win_amd64.pdb,sha256=QVsJ24_Y2gfEijK8NdpFmjcSFYQH5dkF4c4Pby9VtDo,8286208
-kongalib/_kongalib.cp310-win_amd64.pyd,sha256=k0gU6a4RwBEX6VVc-gvM_LvNFNPAx9PH0VnbfuHMElg,2584064
-kongalib/async_client.py,sha256=z8ceGsJv5dD1Zv-TQRsITd_bVh_DHAl5sZ4Xi5sR2xE,46276
-kongalib/client.py,sha256=IkNlc7z7bidO_DNnTd4LDeLxFsI6gkhqZ0jSQa-gWm4,56876
-kongalib/constants.py,sha256=00VYwrvp8zoilLAytniVlToc4bCfpnkIFMPiEGM96C0,128527
-kongalib/data_dictionary.py,sha256=BJbDNnG9HllSSr7gYMz9zVTuOQUqaksT3JT-SL4WWWw,11735
-kongalib/db.py,sha256=Th97qGQvS2xtkNPr_CEUCxwL_8c07E0l4rafe0ZsV8w,8252
-kongalib/expression.py,sha256=gLf0oG4CX3LG0XUpGSsTb8fvXMVIVOWNAnJ_QQK2YpM,21049
-kongalib/json.py,sha256=-8h3e92hLzsElxZhLgpcoQWfakSYyY0i7vsxB7Z7qtk,2341
-kongalib/lex.py,sha256=tV9VGF97XHRFf0eBICVzTILzH878i_slXLsoktFnZTQ,41797
-kongalib/scripting.py,sha256=nu8DbHpo1yXIyKa2s8449xnGEZRMk2bHnBF0BZRQdE0,19711
-kongalib/yacc.py,sha256=UHnHKzBknH7qzIT7xJFIHYKBTzOIxWILtGPdSI29XcE,131768
-kongalib-2.0.0.dist-info/LICENSE,sha256=LPNKwDiu5awG-TPd0dqYJuC7k4PBPY4LCI_O0LSpW1s,7814
-kongalib-2.0.0.dist-info/METADATA,sha256=etd2bJNmuLV-GmMzOAIv8SgBiVpl-R-Til3PC6UVOvI,5301
-kongalib-2.0.0.dist-info/WHEEL,sha256=jrOhEbqKwvzRFSJcbYXlJCyVkgVdHg4_7__YHrdTUfw,102
-kongalib-2.0.0.dist-info/top_level.txt,sha256=JEIFfKoGVQvVGWo76Ykxl-l6nKi9yA1dnkGVqEObuDU,27
-kongalib-2.0.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-kongalib-2.0.0.dist-info/RECORD,,