amalgam-lang 10.4.1__py3-none-macosx_12_0_x86_64.whl → 12.0.0__py3-none-macosx_12_0_x86_64.whl

amalgam/api.py

@@ -1,6 +1,8 @@
+from __future__ import annotations
+
 from ctypes import (
-    byref, cast, c_bool, c_char, c_char_p, c_double, c_size_t, c_uint64, c_void_p,
-    cdll, POINTER, Structure
+    _Pointer, Array, byref, c_bool, c_char, c_char_p, c_double, c_size_t, c_uint64, c_void_p,
+    cast, cdll, POINTER, Structure
 )
 from datetime import datetime
 import gc
@@ -8,7 +10,7 @@ import logging
 from pathlib import Path
 import platform
 import re
-from typing import Any, List, Optional, Tuple, Union
+import typing as t
 import warnings
 
 # Set to amalgam
@@ -21,6 +23,7 @@ class _LoadEntityStatus(Structure):
 
     This is implemented with ctypes for accessing binary Amalgam builds.
     """
+
     _fields_ = [
         ("loaded", c_bool),
         ("message", POINTER(c_char)),
@@ -34,8 +37,17 @@ class LoadEntityStatus:
 
     This is implemented with python types and is meant to wrap _LoadEntityStatus
     which uses ctypes and directly interacts with the Amalgam binaries.
+
+    Parameters
+    ----------
+    api : Amalgam
+        The Python Amalgam interface.
+    c_status : _LoadEntityStatus, optional
+        _LoadEntityStatus instance.
     """
-    def __init__(self, api, c_status: _LoadEntityStatus = None):
+
+    def __init__(self, api: Amalgam, c_status: t.Optional[_LoadEntityStatus] = None):
+        """Initialize LoadEntityStatus."""
         if c_status is None:
             self.loaded = True
             self.message = ""
@@ -45,7 +57,15 @@ class LoadEntityStatus:
             self.message = api.char_p_to_bytes(c_status.message).decode("utf-8")
             self.version = api.char_p_to_bytes(c_status.version).decode("utf-8")
 
-    def __str__(self):
+    def __str__(self) -> str:
+        """
+        Return a human-readable string representation.
+
+        Returns
+        -------
+        str
+            The human-readable string representation.
+        """
         return f"{self.loaded},\"{self.message}\",\"{self.version}\""
 
 
@@ -57,28 +77,34 @@ class Amalgam:
 
     Parameters
     ----------
-    library_path : Path or str
-        Path to either the amalgam DLL, DyLib or SO (Windows, MacOS or
-        Linux, respectively). If not specified it will build a path to the
+    library_path : Path or str, optional
+        Path to either the amalgam DLL, DyLib or SO (Windows, MacOS
+        or Linux, respectively). If not specified it will build a path to the
         appropriate library bundled with the package.
 
     append_trace_file : bool, default False
         If True, new content will be appended to a trace file if the file
         already exists rather than creating a new file.
 
-    execution_trace_dir : Union[str, None], default None
-        A directory path for writing trace files.
+    arch : str, optional
+        The platform architecture of the embedded Amalgam library.
+        If not provided, it will be automatically detected.
+        (Note: arm64_8a architecture must be manually specified!)
+
+    execution_trace_dir : str, optional
+        A directory path for writing trace files. If ``None``, then
+        the current working directory will be used.
 
     execution_trace_file : str, default "execution.trace"
         The full or relative path to the execution trace used in debugging.
 
-    gc_interval : int, default None
-        If set, garbage collection will be forced at the specified interval
-        of amalgam operations. Note that this reduces memory consumption at
-        the compromise of performance. Only use if models are exceeding
-        your host's process memory limit or if paging to disk. As an
-        example, if this operation is set to 0 (force garbage collection
-        every operation), it results in a performance impact of 150x.
+    gc_interval : int, optional
+        If set, garbage collection will be forced at the specified
+        interval of amalgam operations. Note that this reduces memory
+        consumption at the compromise of performance. Only use if models are
+        exceeding your host's process memory limit or if paging to disk. As an
+        example, if this operation is set to 0 (force garbage collection every
+        operation), it results in a performance impact of 150x.
         Default value does not force garbage collection.
 
     library_postfix : str, optional
@@ -87,12 +113,12 @@ class Amalgam:
         it within library_path. If neither are available, -mt (multi-threaded)
         will be used.
 
-    max_num_threads : int or None, default None
-        If a multithreaded Amalgam binary is used, sets the maximum number
-        of threads to the value specified. If 0, will use the number of
+    max_num_threads : int, optional
+        If a multithreaded Amalgam binary is used, sets the maximum
+        number of threads to the value specified. If 0, will use the number of
         visible logical cores. Default None will not attempt to set this value.
 
-    sbf_datastore_enabled : bool or None, default None
+    sbf_datastore_enabled : bool, optional
         If true, sbf tree structures are enabled.
 
     trace : bool, optional
@@ -110,19 +136,20 @@ class Amalgam:
 
     def __init__(  # noqa: C901
         self,
-        library_path: Optional[Union[Path, str]] = None,
+        library_path: t.Optional[Path | str] = None,
         *,
-        arch: Optional[str] = None,
+        arch: t.Optional[str] = None,
         append_trace_file: bool = False,
-        execution_trace_dir: Optional[str] = None,
+        execution_trace_dir: t.Optional[str] = None,
         execution_trace_file: str = "execution.trace",
-        gc_interval: Optional[int] = None,
-        library_postfix: Optional[str] = None,
-        max_num_threads: Optional[int] = None,
-        sbf_datastore_enabled: Optional[bool] = None,
-        trace: Optional[bool] = None,
+        gc_interval: t.Optional[int] = None,
+        library_postfix: t.Optional[str] = None,
+        max_num_threads: t.Optional[int] = None,
+        sbf_datastore_enabled: t.Optional[bool] = None,
+        trace: t.Optional[bool] = None,
         **kwargs
     ):
+        """Initialize Amalgam instance."""
         if len(kwargs):
             warnings.warn(f'Unexpected keyword arguments '
                           f'[{", ".join(list(kwargs.keys()))}] '
@@ -177,7 +204,7 @@ class Amalgam:
         self.load_command_log_entry = None
 
     @classmethod
-    def _get_allowed_postfixes(cls, library_dir: Path) -> List[str]:
+    def _get_allowed_postfixes(cls, library_dir: Path) -> list[str]:
         """
         Return list of all library postfixes allowed given library directory.
 
@@ -199,7 +226,7 @@ class Amalgam:
         return list(allowed_postfixes)
 
     @classmethod
-    def _parse_postfix(cls, filename: str) -> Union[str, None]:
+    def _parse_postfix(cls, filename: str) -> str | None:
         """
         Determine library postfix given a filename.
 
@@ -222,10 +249,10 @@ class Amalgam:
     @classmethod
     def _get_library_path(
         cls,
-        library_path: Optional[Union[Path, str]] = None,
-        library_postfix: Optional[str] = None,
-        arch: Optional[str] = None
-    ) -> Tuple[Path, str]:
+        library_path: t.Optional[Path | str] = None,
+        library_postfix: t.Optional[str] = None,
+        arch: t.Optional[str] = None
+    ) -> tuple[Path, str]:
         """
         Return the full Amalgam library path and its library_postfix.
 
@@ -235,14 +262,15 @@ class Amalgam:
 
         Parameters
         ----------
-        library_path : Path or str, default None
-            Optional, The path to the Amalgam shared library.
-        library_postfix : str, default "-mt"
-            Optional, The library type as specified by a postfix to the word
+        library_path : Path or str, optional
+            The path to the Amalgam shared library.
+        library_postfix : str, optional
+            The library type as specified by a postfix to the word
             "amalgam" in the library's filename. E.g., the "-mt" in
-            `amalgam-mt.dll`.
-        arch : str, default None
-            Optional, the platform architecture of the embedded Amalgam
+            `amalgam-mt.dll`. If left unspecified, "-mt" will be used where
+            supported, otherwise "-st".
+        arch : str, optional
+            The platform architecture of the embedded Amalgam
             library. If not provided, it will be automatically detected.
             (Note: arm64_8a architecture must be manually specified!)
 
@@ -367,7 +395,7 @@ class Amalgam:
         self.amlg.IsSBFDataStoreEnabled.restype = c_bool
         return self.amlg.IsSBFDataStoreEnabled()
 
-    def set_amlg_flags(self, sbf_datastore_enabled: bool = True) -> None:
+    def set_amlg_flags(self, sbf_datastore_enabled: bool = True):
         """
         Set various amalgam flags for data structure and compute features.
 
@@ -376,7 +404,7 @@ class Amalgam:
         sbf_datastore_enabled : bool, default True
             If true, sbf tree structures are enabled.
         """
-        self.amlg.SetSBFDataStoreEnabled.argtype = [c_bool]
+        self.amlg.SetSBFDataStoreEnabled.argtypes = [c_bool]
         self.amlg.SetSBFDataStoreEnabled.restype = c_void_p
         self.amlg.SetSBFDataStoreEnabled(sbf_datastore_enabled)
 
@@ -396,7 +424,7 @@ class Amalgam:
 
         return result
 
-    def set_max_num_threads(self, max_num_threads: int = 0) -> None:
+    def set_max_num_threads(self, max_num_threads: int = 0):
         """
         Set the maximum number of threads.
 
@@ -409,14 +437,14 @@ class Amalgam:
             of threads to the value specified. If 0, will use the number of
             visible logical cores.
         """
-        self.amlg.SetMaxNumThreads.argtype = [c_size_t]
+        self.amlg.SetMaxNumThreads.argtypes = [c_size_t]
         self.amlg.SetMaxNumThreads.restype = c_void_p
 
         self._log_execution(f"SET_MAX_NUM_THREADS {max_num_threads}")
         result = self.amlg.SetMaxNumThreads(max_num_threads)
         self._log_reply(result)
 
-    def reset_trace(self, file: str) -> None:
+    def reset_trace(self, file: str):
         """
         Close the open trace file and opens a new one with the specified name.
 
@@ -452,11 +480,11 @@ class Amalgam:
         self.trace.flush()
 
     def __str__(self) -> str:
-        """Implement the str() method."""
+        """Return a human-readable string representation."""
         return (f"Amalgam Path:\t\t {self.library_path}\n"
                 f"Amalgam GC Interval:\t {self.gc_interval}\n")
 
-    def __del__(self) -> None:
+    def __del__(self):
         """Implement a "destructor" method to finalize log files, if any."""
         if (
             getattr(self, 'debug', False) and
@@ -467,7 +495,7 @@ class Amalgam:
             except Exception:  # noqa - deliberately broad
                 pass
 
-    def _log_comment(self, comment: str) -> None:
+    def _log_comment(self, comment: str):
         """
         Log a comment into the execution trace file.
 
@@ -482,7 +510,7 @@ class Amalgam:
             self.trace.write("# NOTE >" + str(comment) + "\n")
             self.trace.flush()
 
-    def _log_reply(self, reply: Any) -> None:
+    def _log_reply(self, reply: t.Any):
         """
         Log a raw reply from the amalgam process.
 
@@ -497,9 +525,9 @@ class Amalgam:
             self.trace.write("# RESULT >" + str(reply) + "\n")
             self.trace.flush()
 
-    def _log_time(self, label: str) -> None:
+    def _log_time(self, label: str):
         """
-        Log a labelled timestamp to the tracefile.
+        Log a labelled timestamp to the trace file.
 
         Parameters
         ----------
@@ -512,7 +540,7 @@ class Amalgam:
                              f"{f'{dt:%f}'[:3]}\n")
             self.trace.flush()
 
-    def _log_execution(self, execution_string: str) -> None:
+    def _log_execution(self, execution_string: str):
         """
         Log an execution string.
 
@@ -533,7 +561,7 @@ class Amalgam:
             self.trace.write(execution_string + "\n")
             self.trace.flush()
 
-    def gc(self) -> None:
+    def gc(self):
         """Force garbage collection when called if self.force_gc is set."""
         if (
             self.gc_interval is not None
@@ -546,11 +574,11 @@ class Amalgam:
 
     def str_to_char_p(
         self,
-        value: Union[str, bytes],
-        size: Optional[int] = None
-    ) -> c_char:
+        value: str | bytes,
+        size: t.Optional[int] = None
+    ) -> Array[c_char]:
         """
-        Convert a string to a C char pointer.
+        Convert a string to an Array of C char.
 
         User must call `del` on returned buffer
 
@@ -558,14 +586,14 @@ class Amalgam:
         ----------
         value : str or bytes
             The value of the string.
-        size : int or None
-            The size of the string. If not provided, the length of the
-            string is used.
+        size : int, optional
+            The size of the string. If not provided, the length of
+            the string is used.
 
         Returns
         -------
-        c_char
-            A C char pointer for the string.
+        Array of c_char
+            An Array of C char datatypes which form the given string
         """
         if isinstance(value, str):
             value = value.encode('utf-8')
@@ -574,27 +602,27 @@ class Amalgam:
         buf.value = value
         return buf
 
-    def char_p_to_bytes(self, p: POINTER(c_char)) -> bytes:
+    def char_p_to_bytes(self, p: _Pointer[c_char] | c_char_p) -> bytes | None:
         """
-        Copies a native C char pointer to bytes, cleaning up native memory correctly.
+        Copy native C char pointer to bytes, cleaning up memory correctly.
 
         Parameters
         ----------
-        p : LP_char_p
-            C pointer to string to convert
+        p : c_char_p
+            The char pointer to convert
 
         Returns
         -------
-        bytes
-            The byte-encoded string from C pointer
+        bytes or None
+            The byte-encoded char
         """
-        bytes = cast(p, c_char_p).value
+        bytes_str = cast(p, c_char_p).value
 
-        self.amlg.DeleteString.argtypes = c_char_p,
+        self.amlg.DeleteString.argtypes = [c_char_p]
         self.amlg.DeleteString.restype = None
         self.amlg.DeleteString(p)
 
-        return bytes
+        return bytes_str
 
     def get_json_from_label(self, handle: str, label: str) -> bytes:
         """
@@ -613,7 +641,7 @@ class Amalgam:
             The byte-encoded json representation of the amalgam label.
         """
         self.amlg.GetJSONPtrFromLabel.restype = POINTER(c_char)
-        self.amlg.GetJSONPtrFromLabel.argtype = [c_char_p, c_char_p]
+        self.amlg.GetJSONPtrFromLabel.argtypes = [c_char_p, c_char_p]
         handle_buf = self.str_to_char_p(handle)
         label_buf = self.str_to_char_p(label)
 
@@ -634,8 +662,8 @@ class Amalgam:
         self,
         handle: str,
         label: str,
-        json: Union[str, bytes]
-    ) -> None:
+        json: str | bytes
+    ):
         """
         Set a label in amalgam using json.
 
@@ -649,7 +677,7 @@ class Amalgam:
             The json representation of the label value.
         """
         self.amlg.SetJSONToLabel.restype = c_void_p
-        self.amlg.SetJSONToLabel.argtype = [c_char_p, c_char_p, c_char_p]
+        self.amlg.SetJSONToLabel.argtypes = [c_char_p, c_char_p, c_char_p]
         handle_buf = self.str_to_char_p(handle)
         label_buf = self.str_to_char_p(label)
         json_buf = self.str_to_char_p(json)
@@ -710,7 +738,7 @@ class Amalgam:
         LoadEntityStatus
             Status of LoadEntity call.
         """
-        self.amlg.LoadEntity.argtype = [
+        self.amlg.LoadEntity.argtypes = [
             c_char_p, c_char_p, c_bool, c_bool, c_bool, c_bool, c_char_p, c_char_p]
         self.amlg.LoadEntity.restype = _LoadEntityStatus
         handle_buf = self.str_to_char_p(handle)
@@ -757,7 +785,7 @@ class Amalgam:
         LoadEntityStatus
             Status of VerifyEntity call.
         """
-        self.amlg.VerifyEntity.argtype = [c_char_p]
+        self.amlg.VerifyEntity.argtypes = [c_char_p]
         self.amlg.VerifyEntity.restype = _LoadEntityStatus
         amlg_path_buf = self.str_to_char_p(amlg_path)
 
@@ -806,7 +834,7 @@ class Amalgam:
         bool
             True if cloned successfully, False if not.
         """
-        self.amlg.CloneEntity.argtype = [
+        self.amlg.CloneEntity.argtypes = [
             c_char_p, c_char_p, c_char_p, c_bool, c_char_p, c_char_p]
         handle_buf = self.str_to_char_p(handle)
         clone_handle_buf = self.str_to_char_p(clone_handle)
@@ -842,9 +870,9 @@ class Amalgam:
         *,
         update_persistence_location: bool = False,
         store_contained: bool = False
-    ) -> None:
+    ):
         """
-        Stores an entity to the file type specified within amlg_path.
+        Store entity to the file type specified within amlg_path.
 
         Parameters
         ----------
@@ -857,7 +885,7 @@ class Amalgam:
         store_contained : bool
             If set to true, contained entities will be stored.
         """
-        self.amlg.StoreEntity.argtype = [
+        self.amlg.StoreEntity.argtypes = [
             c_char_p, c_char_p, c_bool, c_bool]
         handle_buf = self.str_to_char_p(handle)
         amlg_path_buf = self.str_to_char_p(amlg_path)
@@ -880,7 +908,7 @@ class Amalgam:
     def destroy_entity(
         self,
         handle: str
-    ) -> None:
+    ):
         """
         Destroys an entity.
 
@@ -889,7 +917,7 @@ class Amalgam:
         handle : str
             The handle of the amalgam entity.
         """
-        self.amlg.DestroyEntity.argtype = [c_char_p]
+        self.amlg.DestroyEntity.argtypes = [c_char_p]
         handle_buf = self.str_to_char_p(handle)
 
         self._log_execution(f"DESTROY_ENTITY \"{self.escape_double_quotes(handle)}\"")
@@ -905,7 +933,7 @@ class Amalgam:
         rand_seed: str
     ) -> bool:
         """
-        Sets an entity's random seed.
+        Set entity's random seed.
 
         Parameters
         ----------
@@ -919,7 +947,7 @@ class Amalgam:
         bool
             True if the set was successful, false if not.
         """
-        self.amlg.SetRandomSeed.argtype = [c_char_p, c_char_p]
+        self.amlg.SetRandomSeed.argtypes = [c_char_p, c_char_p]
         self.amlg.SetRandomSeed.restype = c_bool
 
         handle_buf = self.str_to_char_p(handle)
@@ -935,7 +963,7 @@ class Amalgam:
         self.gc()
         return result
 
-    def get_entities(self) -> List[str]:
+    def get_entities(self) -> list[str]:
         """
         Get loaded top level entities.
 
@@ -944,7 +972,7 @@ class Amalgam:
         list of str
             The list of entity handles.
         """
-        self.amlg.GetEntities.argtype = [POINTER(c_uint64)]
+        self.amlg.GetEntities.argtypes = [POINTER(c_uint64)]
         self.amlg.GetEntities.restype = POINTER(c_char_p)
         num_entities = c_uint64()
         entities = self.amlg.GetEntities(byref(num_entities))
@@ -960,7 +988,7 @@ class Amalgam:
         self,
         handle: str,
         label: str,
-        json: Union[str, bytes]
+        json: str | bytes
     ) -> bytes:
         """
         Execute a label with parameters provided in json format.
@@ -980,7 +1008,7 @@ class Amalgam:
             A byte-encoded json representation of the response.
         """
         self.amlg.ExecuteEntityJsonPtr.restype = POINTER(c_char)
-        self.amlg.ExecuteEntityJsonPtr.argtype = [
+        self.amlg.ExecuteEntityJsonPtr.argtypes = [
             c_char_p, c_char_p, c_char_p]
         handle_buf = self.str_to_char_p(handle)
         label_buf = self.str_to_char_p(label)
@@ -1004,199 +1032,6 @@ class Amalgam:
 
         return result
 
-    def set_number_value(self, handle: str, label: str, value: float) -> None:
-        """
-        Set a numeric value to a label in an amalgam entity.
-
-        Parameters
-        ----------
-        handle : str
-            The handle of the amalgam entity.
-        label : str
-            The label to set.
-        value : float
-            A numeric value to assign to a label.
-        """
-        self.amlg.SetNumberValue.restype = c_void_p
-        self.amlg.SetNumberValue.argtype = [c_char_p, c_char_p, c_double]
-        handle_buf = self.str_to_char_p(handle)
-        label_buf = self.str_to_char_p(label)
-        val = c_double(value)
-
-        self.amlg.SetNumberValue(handle_buf, label_buf, val)
-
-        del handle_buf
-        del label_buf
-        del val
-        self.gc()
-
-    def get_number_value(self, handle: str, label: str) -> float:
-        """
-        Retrieve the numeric value of a label in an amalgam entity.
-
-        Parameters
-        ----------
-        handle : str
-            The handle of the amalgam entity.
-        label : str
-            The label to execute.
-
-        Returns
-        -------
-        float
-            The numeric value of the label.
-        """
-        self.amlg.GetNumberValue.restype = c_double
-        self.amlg.GetNumberValue.argtype = [c_char_p, c_char_p]
-        handle_buf = self.str_to_char_p(handle)
-        label_buf = self.str_to_char_p(label)
-
-        result = self.amlg.GetNumberValue(handle_buf, label_buf)
-
-        del handle_buf
-        del label_buf
-
-        return result
-
-    def set_string_value(
-        self,
-        handle: str,
-        label: str,
-        value: Union[str, bytes]
-    ) -> None:
-        """
-        Set a string value to a label in an amalgam entity.
-
-        Parameters
-        ----------
-        handle : str
-            The handle of the amalgam entity.
-        label : str
-            The label to set.
-        value : str or bytes
-            A string value.
-        """
-        self.amlg.SetStringValue.restype = c_void_p
-        self.amlg.SetStringValue.argtype = [c_char_p, c_char_p, c_char_p]
-        handle_buf = self.str_to_char_p(handle)
-        label_buf = self.str_to_char_p(label)
-        val_buf = self.str_to_char_p(value)
-
-        self.amlg.SetStringValue(handle_buf, label_buf, val_buf)
-
-        del handle_buf
-        del label_buf
-        del val_buf
-        self.gc()
-
-    def get_string_value(self, handle: str, label: str) -> Union[bytes, None]:
-        """
-        Retrieve a string value from a label in an amalgam entity.
-
-        Parameters
-        ----------
-        handle : str
-            The handle of the amalgam entity.
-        label : str
-            The label to retrieve.
-
-        Returns
-        -------
-        bytes or None
-            The byte-encoded string value of the label in the amalgam entity.
-        """
-        self.amlg.GetStringListPtr.restype = POINTER(c_char_p)
-        self.amlg.GetStringListPtr.argtype = [c_char_p, c_char_p]
-        handle_buf = self.str_to_char_p(handle)
-        label_buf = self.str_to_char_p(label)
-
-        size = self.amlg.GetStringListLength(handle_buf, label_buf)
-        value_buf = self.amlg.GetStringListPtr(handle_buf, label_buf)
-        result = None
-        if value_buf is not None and size > 0:
-            result = value_buf[0]
-
-        del handle_buf
-        del label_buf
-        del value_buf
-        self.gc()
-
-        return result
-
-    def set_string_list(
-        self,
-        handle: str,
-        label: str,
-        value: List[Union[str, bytes]]
-    ) -> None:
-        """
-        Set a list of strings to an amalgam entity.
-
-        Parameters
-        ----------
-        handle : str
-            The handle of the amalgam entity.
-        label : str
-            The label to set.
-        value : list of str or list of bytes
-            A 1d list of string values.
-        """
-        self.amlg.SetStringList.restype = c_void_p
-        self.amlg.SetStringList.argtype = [
-            c_char_p, c_char_p, POINTER(c_char_p), c_size_t]
-
-        size = len(value)
-        value_buf = (c_char_p * size)()
-        for i in range(size):
-            if isinstance(value[i], bytes):
-                value_buf[i] = c_char_p(value[i])
-            else:
-                value_buf[i] = c_char_p(value[i].encode('utf-8'))
-
-        handle_buf = self.str_to_char_p(handle)
-        label_buf = self.str_to_char_p(label)
-        self.amlg.SetStringList(handle_buf, label_buf, value_buf, size)
-
-        del handle_buf
-        del label_buf
-        del value_buf
-        self.gc()
-
-    def get_string_list(self, handle: str, label: str) -> List[bytes]:
-        """
-        Retrieve a list of numbers from a label in an amalgam entity.
-
-        Parameters
-        ----------
-        handle : str
-            The handle of the amalgam entity.
-        label : str
-            The label to execute.
-
-        Returns
-        -------
-        list of bytes
-            A 1d list of byte-encoded string values from the label in the
-            amalgam entity.
-        """
-        self.amlg.GetStringListLength.restype = c_size_t
-        self.amlg.GetStringListLength.argtype = [c_char_p, c_char_p]
-        self.amlg.GetStringListPtr.restype = POINTER(c_char_p)
-        self.amlg.GetStringListPtr.argtype = [c_char_p, c_char_p]
-        handle_buf = self.str_to_char_p(handle)
-        label_buf = self.str_to_char_p(label)
-
-        size = self.amlg.GetStringListLength(handle_buf, label_buf)
-        value_buf = self.amlg.GetStringListPtr(handle_buf, label_buf)
-        value = [value_buf[i] for i in range(size)]
-
-        del handle_buf
-        del label_buf
-        del value_buf
-        self.gc()
-
-        return value
-
     def get_version_string(self) -> bytes:
         """
         Get the version string of the amalgam dynamic library.
@@ -1232,7 +1067,7 @@ class Amalgam:
     @staticmethod
     def escape_double_quotes(s: str) -> str:
         """
-        Get the string with backslashes preceeding contained double quotes.
+        Get the string with backslashes preceding contained double quotes.
 
         Parameters
         ----------

amalgam/lib/darwin/amd64/docs/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "51.4.1"
+  "version": "54.0.0"
 }

amalgam/lib/version.json

@@ -1,8 +1,8 @@
 {
   "version": {
-    "amalgam": "51.4.1",
-    "amalgam_sha": "3672a26c78d6dcc2f3a9def3cbf26dcfa7b9e156",
-    "amalgam_url": "https://github.com/howsoai/amalgam/releases/tag/51.4.1",
+    "amalgam": "54.0.0",
+    "amalgam_sha": "7d51deac4e5fd97c813c5c23a366a559913f5262",
+    "amalgam_url": "https://github.com/howsoai/amalgam/releases/tag/54.0.0",
     "amalgam_build_date": "",
     "amalgam_display_title": ""
   }

{amalgam_lang-10.4.1.dist-info → amalgam_lang-12.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: amalgam-lang
-Version: 10.4.1
+Version: 12.0.0
 Summary: A direct interface with Amalgam compiled DLL or so.
 Author: Howso Incorporated
 Author-email: support@howso.com
@@ -753,6 +753,11 @@ The wrapper handles the Amalgam language binary (so/dll/dylib) automatically for
 amlg = Amalgam(library_path="/path/to/amalgam-mt.so")
 ```
 
+## Testing
+There is a `Pytest` unit test suite located in `amalgam/test`. The tests in `test_standalone.py` will only execute if an `Amalgam` binary is located in the default expected path of `amalgam/lib/{os}/{architecture}`.
+
+To specify whether `test_standalone.py` should use single-threaded or multi-threaded `Amalgam` (assuming the appropriate binary is in the above path), set the `AMALGAM_LIBRARY_POSTFIX` environment variable to the desired postfix, e.g., `-st` or `-mt`.
+
 ## License
 
 [License](LICENSE.txt)

amalgam_lang-12.0.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+amalgam/__init__.py,sha256=oHu7Zr4eGDUqj93pLwz8t7gLa8lpAx6Q-xbGiJ3nJx0,18
+amalgam/api.py,sha256=IWS--0NCnhsadMYSna2gLllNxG_i3HpymY3eXbugwDU,36796
+amalgam/lib/version.json,sha256=KO3uhOlJvvs6p4aUi7N9GFKOBT7YksAVYMUStRYo_eg,250
+amalgam/lib/darwin/amd64/amalgam-mt-noavx.dylib,sha256=6342n0WTt0YIjKca-STuqarAGaVataO5UXgR7dZ2FRg,2994384
+amalgam/lib/darwin/amd64/amalgam-mt.dylib,sha256=nXnEvODfeNsXQydNd7qfjl99zuEpcyQPNCFDvyLXS98,2940904
+amalgam/lib/darwin/amd64/amalgam-omp.dylib,sha256=3lEuExdY3qminSin-xv38342SSjppt15wkKdIVSb7oc,3324680
+amalgam/lib/darwin/amd64/amalgam-st.dylib,sha256=ScuH5CaJ16P5HsPp7S7I6tJrvqRBAYb_JamEB3KKPa0,2822456
+amalgam/lib/darwin/amd64/docs/version.json,sha256=8rii1FbVYrPfX-FZhrjjqZAiEFHC2xJq_OOL2-WTR9E,25
+amalgam_lang-12.0.0.dist-info/LICENSE.txt,sha256=2xqHuoHohba7gpcZZKtOICRjzeKsQANXG8WoV9V35KM,33893
+amalgam_lang-12.0.0.dist-info/METADATA,sha256=aPV_QuyaRPZpcMc0WXOr7Kufk1NjmGdwwx-DldON-kQ,43834
+amalgam_lang-12.0.0.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
+amalgam_lang-12.0.0.dist-info/top_level.txt,sha256=rmPHU144SyaB25u5-FAQyECAQnJ39NvuJEcKXMRcdBo,8
+amalgam_lang-12.0.0.dist-info/RECORD,,

{amalgam_lang-10.4.1.dist-info → amalgam_lang-12.0.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.40.0)
+Generator: setuptools (70.1.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

amalgam_lang-10.4.1.dist-info/RECORD

@@ -1,13 +0,0 @@
-amalgam/__init__.py,sha256=oHu7Zr4eGDUqj93pLwz8t7gLa8lpAx6Q-xbGiJ3nJx0,18
-amalgam/api.py,sha256=ni3a4vRa90ITImg4uI4zd3CBaxC5pb_LXBT1xs9i88c,41742
-amalgam/lib/version.json,sha256=ne0Xe6jPEIVEQgh7P0NWbTIeXWZPVrD8rSqtKsSe1u8,250
-amalgam/lib/darwin/amd64/amalgam-mt-noavx.dylib,sha256=HhTucmx6PqPXbeHCP1c78mG6mH3ZsJ7x93rsC7ERaPU,3048968
-amalgam/lib/darwin/amd64/amalgam-mt.dylib,sha256=srtCzXAveZ-XBl-iXs1yhJ_rQfH6AAA7HnKqezR6MC0,2979104
-amalgam/lib/darwin/amd64/amalgam-omp.dylib,sha256=kO3aKbsfXKf4H1EbBLdpk-fp7rVAhWYvtDauS8FrDlA,3362896
-amalgam/lib/darwin/amd64/amalgam-st.dylib,sha256=6-AxESZc6oOFEcB_rAq4QPx2mLtb3YKq2izLrI3h3GM,2877072
-amalgam/lib/darwin/amd64/docs/version.json,sha256=iKjvZ70DlRowMIpa3SK8UqxNFik0A5bs005Nw6jh9oA,25
-amalgam_lang-10.4.1.dist-info/LICENSE.txt,sha256=2xqHuoHohba7gpcZZKtOICRjzeKsQANXG8WoV9V35KM,33893
-amalgam_lang-10.4.1.dist-info/METADATA,sha256=CVvRFPYiUjFdis60Qadj6I75SuXZjRRvKWiaAfCD4iY,43353
-amalgam_lang-10.4.1.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-amalgam_lang-10.4.1.dist-info/top_level.txt,sha256=rmPHU144SyaB25u5-FAQyECAQnJ39NvuJEcKXMRcdBo,8
-amalgam_lang-10.4.1.dist-info/RECORD,,