gamsapi 53.2.0__tar.gz → 53.3.0__tar.gz

{gamsapi-53.2.0/src/gamsapi.egg-info → gamsapi-53.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gamsapi
-Version: 53.2.0
+Version: 53.3.0
 Summary: GAMS Python API
 Home-page: https://www.gams.com/
 Author: GAMS Development Corporation
@@ -52,23 +52,23 @@ Provides-Extra: transfer
 Requires-Dist: pandas<3.1,>=2.2.2; extra == "transfer"
 Requires-Dist: scipy; extra == "transfer"
 Provides-Extra: all
-Requires-Dist: sqlalchemy; extra == "all"
-Requires-Dist: pyodbc; extra == "all"
-Requires-Dist: pymysql; extra == "all"
-Requires-Dist: urllib3; extra == "all"
-Requires-Dist: pyyaml; extra == "all"
-Requires-Dist: openpyxl>=3.1.0; extra == "all"
-Requires-Dist: cerberus; extra == "all"
-Requires-Dist: python_dateutil; extra == "all"
 Requires-Dist: ipython; extra == "all"
+Requires-Dist: python_dateutil; extra == "all"
+Requires-Dist: scipy; extra == "all"
 Requires-Dist: numpy; extra == "all"
+Requires-Dist: ply; extra == "all"
+Requires-Dist: psycopg2-binary; extra == "all"
+Requires-Dist: pymysql; extra == "all"
 Requires-Dist: pymssql; extra == "all"
 Requires-Dist: pydantic; extra == "all"
-Requires-Dist: psycopg2-binary; extra == "all"
-Requires-Dist: ply; extra == "all"
-Requires-Dist: scipy; extra == "all"
+Requires-Dist: urllib3; extra == "all"
+Requires-Dist: pyodbc; extra == "all"
+Requires-Dist: cerberus; extra == "all"
+Requires-Dist: openpyxl>=3.1.0; extra == "all"
 Requires-Dist: certifi; extra == "all"
 Requires-Dist: pandas<3.1,>=2.2.2; extra == "all"
+Requires-Dist: sqlalchemy; extra == "all"
+Requires-Dist: pyyaml; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

gamsapi-53.3.0/VERSION

@@ -0,0 +1 @@
+53.3.0

gamsapi-53.3.0/src/gams/_version.py

@@ -0,0 +1 @@
+__version__ = "53.3.0"

{gamsapi-53.2.0 → gamsapi-53.3.0}/src/gams/transfer/_internals/algorithms.py

@@ -22,15 +22,17 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 #
+from __future__ import annotations
 
 import itertools
 import random
-import numpy as np
-import pandas as pd
 import gams.transfer._abcs as abcs
-from typing import Sequence, Tuple, Union, List, Optional, TYPE_CHECKING
+from typing import Sequence, TYPE_CHECKING
 
 if TYPE_CHECKING:
+    import pandas as pd
+    import numpy as np
+
     from gams.transfer.syms import Set, Parameter, Variable, Equation
 
 
@@ -62,8 +64,8 @@ def check_all_same(iterable1: Sequence, iterable2: Sequence) -> bool:
 
 
 def get_keys_and_values(
-    symobj: Union["Set", "Parameter", "Variable", "Equation"], mode: str
-) -> Tuple[np.ndarray, np.ndarray]:
+    symobj: Set | Parameter | Variable | Equation, mode: str
+) -> tuple[np.ndarray, np.ndarray]:
     """
     Gets the keys and values of a specific symbol.
 
@@ -76,7 +78,7 @@ def get_keys_and_values(
 
     Returns
     -------
-    Tuple[ndarray, ndarray]
+    tuple[ndarray, ndarray]
         The tuple includes the symbol's keys and values.
 
     Raises
@@ -84,6 +86,8 @@ def get_keys_and_values(
     ValueError
         If the given mode is niether 'string' nor 'category'.
     """
+    import numpy as np
+
     if symobj.records is None:
         if isinstance(symobj, abcs.ABCSet):
             arrkeys = np.full(
@@ -201,6 +205,8 @@ def convert_to_categoricals_str(
     -----
     - This function assumes that the lengths of `arrkeys` and `arrvals` are compatible.
     """
+    import pandas as pd
+
     has_domains = arrkeys.size > 0
     has_values = arrvals.size > 0
 
@@ -234,6 +240,8 @@ def convert_to_categoricals_str(
 def convert_to_categoricals_cat(
     arrkeys: np.ndarray, arrvals: np.ndarray, unique_uels: Sequence
 ) -> pd.DataFrame:
+    import pandas as pd
+
     has_domains = arrkeys.size > 0
     has_values = arrvals.size > 0
 
@@ -262,7 +270,7 @@ def convert_to_categoricals_cat(
     return df
 
 
-def generate_unique_labels(labels: Union[list, str]) -> List[str]:
+def generate_unique_labels(labels: list | str) -> list[str]:
     """
     Generate unique labels from a list of labels.
 
@@ -273,7 +281,7 @@ def generate_unique_labels(labels: Union[list, str]) -> List[str]:
 
     Returns
     -------
-    List[str]
+    list[str]
         A list of labels with uniqueness enforced. If the input list contains duplicates, this
         function appends numeric suffixes to make the labels unique. If the input is not a list,
         it is converted to a single-element list.
@@ -295,7 +303,7 @@ def generate_unique_labels(labels: Union[list, str]) -> List[str]:
     return labels
 
 
-def cartesian_product(*arrays: Tuple[np.ndarray]) -> np.ndarray:
+def cartesian_product(*arrays: tuple[np.ndarray]) -> np.ndarray:
     """
     Calculate the Cartesian product of multiple input arrays.
 
@@ -305,7 +313,7 @@ def cartesian_product(*arrays: Tuple[np.ndarray]) -> np.ndarray:
 
     Parameters
     ----------
-    *arrays : Tuple[ndarray]
+    *arrays : tuple[ndarray]
         Multiple input arrays for which the Cartesian product is calculated.
 
     Returns
@@ -339,6 +347,7 @@ def cartesian_product(*arrays: Tuple[np.ndarray]) -> np.ndarray:
            [2, 'B', 0.2]], dtype=object)
 
     """
+    import numpy as np
 
     la = len(arrays)
     dtype = np.result_type(*arrays)
@@ -353,7 +362,7 @@ def cartesian_product(*arrays: Tuple[np.ndarray]) -> np.ndarray:
 def choice_no_replace(
     choose_from: int,
     n_choose: int,
-    seed: Optional[int] = None,
+    seed: int | None = None,
 ) -> np.ndarray:
     """
     Randomly select 'n_choose' unique items from a pool of 'choose_from' items without replacement.
@@ -398,6 +407,7 @@ def choice_no_replace(
     >>> choice_no_replace(100, 10, seed=42)
     array([8, 9, 19, 41, 60, 68, 71, 82, 94, 96])
     """
+    import numpy as np
 
     if not isinstance(seed, (int, type(None))):
         raise TypeError("Argument 'seed' must be type int or NoneType")

{gamsapi-53.2.0 → gamsapi-53.3.0}/src/gams/transfer/_internals/specialvalues.py

@@ -22,22 +22,25 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 #
+from __future__ import annotations
 
 import struct
-import numpy as np
-import pandas as pd
-from typing import Union
+from typing import TYPE_CHECKING
 
+if TYPE_CHECKING:
+    import pandas as pd
 
 class SpecialValues:
     NA = struct.unpack(">d", bytes.fromhex("fffffffffffffffe"))[0]
-    _NA_INT64 = np.float64(NA).view(np.uint64)
     EPS = -0.0
     UNDEF = float("nan")
     POSINF = float("inf")
     NEGINF = float("-inf")
 
+    @staticmethod
     def _convertNPfloat64(records, sv_name):
+        import numpy as np
+
         if not (
             isinstance(records, np.ndarray) and np.issubdtype(records.dtype, np.float64)
         ):
@@ -51,7 +54,8 @@ class SpecialValues:
                 ) from err
         return records
 
-    def isEps(records: Union[int, float, str, pd.Series, pd.DataFrame]) -> bool:
+    @staticmethod
+    def isEps(records: int | float | str | pd.Series | pd.DataFrame) -> bool:
         """
         Check if the input records represent a value close to zero with specific considerations for different data types.
 
@@ -72,10 +76,13 @@ class SpecialValues:
         Exception
             If the data structure passed in 'records' could not be converted to a numpy array (dtype=float) for testing.
         """
+        import numpy as np
+
         records = SpecialValues._convertNPfloat64(records, "EPS")
         return (records == 0) & (np.signbit(records))
 
-    def isNA(records: Union[int, float, str, pd.Series, pd.DataFrame]) -> bool:
+    @staticmethod
+    def isNA(records: int | float | str | pd.Series | pd.DataFrame) -> bool:
         """
         Check if values in records represent GAMS NA (Not Available) values.
 
@@ -96,10 +103,14 @@ class SpecialValues:
         Exception
             If the data structure passed in 'records' could not be converted to a numpy array (dtype=float) for testing.
         """
+        import numpy as np
+
+        _NA_INT64 = np.float64(SpecialValues.NA).view(np.uint64)
         records = SpecialValues._convertNPfloat64(records, "NA")
-        return records.view(np.uint64) == SpecialValues._NA_INT64
+        return records.view(np.uint64) == _NA_INT64
 
-    def isUndef(records: Union[int, float, str, pd.Series, pd.DataFrame]) -> bool:
+    @staticmethod
+    def isUndef(records: int | float | str | pd.Series | pd.DataFrame) -> bool:
         """
         Determine if the given input(s) represent GAMS "undef" values.
 
@@ -120,10 +131,14 @@ class SpecialValues:
         Exception
             If the data structure passed in 'records' could not be converted to a numpy array (dtype=float) for testing.
         """
+        import numpy as np
+
+        _NA_INT64 = np.float64(SpecialValues.NA).view(np.uint64)
         records = SpecialValues._convertNPfloat64(records, "UNDEF")
-        return np.isnan(records) & (records.view(np.uint64) != SpecialValues._NA_INT64)
+        return np.isnan(records) & (records.view(np.uint64) != _NA_INT64)
 
-    def isPosInf(records: Union[int, float, str, pd.Series, pd.DataFrame]) -> bool:
+    @staticmethod
+    def isPosInf(records: int | float | str | pd.Series | pd.DataFrame) -> bool:
         """
         Check if the input records represent positive infinity.
 
@@ -144,10 +159,13 @@ class SpecialValues:
         Exception
             If the data structure passed in 'records' could not be converted to a numpy array (dtype=float) for testing.
         """
+        import numpy as np
+
         records = SpecialValues._convertNPfloat64(records, "POSINF")
         return np.isposinf(records)
 
-    def isNegInf(records: Union[int, float, str, pd.Series, pd.DataFrame]) -> bool:
+    @staticmethod
+    def isNegInf(records: int | float | str | pd.Series | pd.DataFrame) -> bool:
         """
         Check if the input records represent negative infinity.
 
@@ -168,5 +186,7 @@ class SpecialValues:
         Exception
             If the data structure passed in 'records' could not be converted to a numpy array (dtype=float) for testing.
         """
+        import numpy as np
+
         records = SpecialValues._convertNPfloat64(records, "NEGINF")
         return np.isneginf(records)