[MERGE] Merge branch 'release/1.19.0' into 'master'

Release/1.19.0

See merge request devel/gamspy!738

Author: mabdullahsoyturk

.github/workflows/release.yml

@@ -44,7 +44,7 @@ jobs:
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ github.ref_name }}
-          name: Release ${{ github.ref_name }}
+          name: ${{ github.ref_name }}
           body_path: ${{ steps.notes.outputs.path }}
           draft: false
           prerelease: false

.gitlab-ci.yml

@@ -59,8 +59,8 @@ autoupgrade:
     - git fetch origin $CI_COMMIT_REF_NAME
     # Force the local checkout to exactly match the remote branch
     - git checkout -B $CI_COMMIT_REF_NAME origin/$CI_COMMIT_REF_NAME
-    - pip install --upgrade pip && pip install pre-commit uv
-    - pre-commit autoupdate
+    - pip install --upgrade pip && pip install prek uv
+    - prek auto-update
     - uv lock --upgrade
 
     - |

.pre-commit-config.yaml

@@ -17,9 +17,9 @@ repos:
     rev: v1.5.0
     hooks:
     -   id: detect-secrets
-        args: ['--baseline', '.secrets.baseline']
+        args: [ --baseline, .secrets.baseline, --exclude-files, ^docs/user/notebooks/]
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.11
+    rev: v0.14.14
     hooks:
     # Run the linter.
     -   id: ruff-check

.secrets.baseline

@@ -90,10 +90,6 @@
     {
       "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
     },
-    {
-      "path": "detect_secrets.filters.common.is_baseline_file",
-      "filename": ".secrets.baseline"
-    },
     {
       "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
       "min_level": 2
@@ -124,249 +120,15 @@
     },
     {
       "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    },
+    {
+      "path": "detect_secrets.filters.regex.should_exclude_file",
+      "pattern": [
+        "^docs/user/notebooks/"
+      ]
     }
   ],
   "results": {
-    "docs/user/notebooks/clsp.ipynb": [
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/clsp.ipynb",
-        "hashed_secret": "bb627434731f5f33c8fcc0002872ca242fc03504",
-        "is_verified": false,
-        "line_number": 1445
-      },
-      {
-        "type": "Hex High Entropy String",
-        "filename": "docs/user/notebooks/clsp.ipynb",
-        "hashed_secret": "ddcc6520ef0a2310197e6077e695264969277472",
-        "is_verified": false,
-        "line_number": 2619
-      }
-    ],
-    "docs/user/notebooks/clsp_colab.ipynb": [
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/clsp_colab.ipynb",
-        "hashed_secret": "bb627434731f5f33c8fcc0002872ca242fc03504",
-        "is_verified": false,
-        "line_number": 1460
-      },
-      {
-        "type": "Hex High Entropy String",
-        "filename": "docs/user/notebooks/clsp_colab.ipynb",
-        "hashed_secret": "ddcc6520ef0a2310197e6077e695264969277472",
-        "is_verified": false,
-        "line_number": 2634
-      }
-    ],
-    "docs/user/notebooks/nurses.ipynb": [
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/nurses.ipynb",
-        "hashed_secret": "181cbf5064ca8290c09305cf24060581ee70088c",
-        "is_verified": false,
-        "line_number": 1007
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/nurses.ipynb",
-        "hashed_secret": "127bf07a78f871487be9cfbb76b9c29b902fbc50",
-        "is_verified": false,
-        "line_number": 1046
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/nurses.ipynb",
-        "hashed_secret": "cef09f381e9a2f05b79936bfc5fb72ea99f58b08",
-        "is_verified": false,
-        "line_number": 1281
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/nurses.ipynb",
-        "hashed_secret": "a5ef9b01b0ca8cc1844842b851f78b181c06165a",
-        "is_verified": false,
-        "line_number": 1313
-      },
-      {
-        "type": "Hex High Entropy String",
-        "filename": "docs/user/notebooks/nurses.ipynb",
-        "hashed_secret": "ddcc6520ef0a2310197e6077e695264969277472",
-        "is_verified": false,
-        "line_number": 1403
-      }
-    ],
-    "docs/user/notebooks/nurses_colab.ipynb": [
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/nurses_colab.ipynb",
-        "hashed_secret": "181cbf5064ca8290c09305cf24060581ee70088c",
-        "is_verified": false,
-        "line_number": 1022
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/nurses_colab.ipynb",
-        "hashed_secret": "127bf07a78f871487be9cfbb76b9c29b902fbc50",
-        "is_verified": false,
-        "line_number": 1061
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/nurses_colab.ipynb",
-        "hashed_secret": "cef09f381e9a2f05b79936bfc5fb72ea99f58b08",
-        "is_verified": false,
-        "line_number": 1296
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/nurses_colab.ipynb",
-        "hashed_secret": "a5ef9b01b0ca8cc1844842b851f78b181c06165a",
-        "is_verified": false,
-        "line_number": 1328
-      },
-      {
-        "type": "Hex High Entropy String",
-        "filename": "docs/user/notebooks/nurses_colab.ipynb",
-        "hashed_secret": "ddcc6520ef0a2310197e6077e695264969277472",
-        "is_verified": false,
-        "line_number": 1418
-      }
-    ],
-    "docs/user/notebooks/pickstock.ipynb": [
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/pickstock.ipynb",
-        "hashed_secret": "5f2ac0a725fbdb05f197b51a14b9b12707ca2890",
-        "is_verified": false,
-        "line_number": 535
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/pickstock.ipynb",
-        "hashed_secret": "5592bfd00b4d6407217d23234250bb7ad0e631eb",
-        "is_verified": false,
-        "line_number": 579
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/pickstock.ipynb",
-        "hashed_secret": "ee85ca8add17ed65d833f570a4561a9717ac9d52",
-        "is_verified": false,
-        "line_number": 847
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/pickstock.ipynb",
-        "hashed_secret": "3d14de9b758df0de2672e7cc4d66490336034070",
-        "is_verified": false,
-        "line_number": 892
-      }
-    ],
-    "docs/user/notebooks/pickstock_colab.ipynb": [
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/pickstock_colab.ipynb",
-        "hashed_secret": "5f2ac0a725fbdb05f197b51a14b9b12707ca2890",
-        "is_verified": false,
-        "line_number": 541
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/pickstock_colab.ipynb",
-        "hashed_secret": "5592bfd00b4d6407217d23234250bb7ad0e631eb",
-        "is_verified": false,
-        "line_number": 585
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/pickstock_colab.ipynb",
-        "hashed_secret": "ee85ca8add17ed65d833f570a4561a9717ac9d52",
-        "is_verified": false,
-        "line_number": 853
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/pickstock_colab.ipynb",
-        "hashed_secret": "3d14de9b758df0de2672e7cc4d66490336034070",
-        "is_verified": false,
-        "line_number": 898
-      }
-    ],
-    "docs/user/notebooks/tsp.ipynb": [
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp.ipynb",
-        "hashed_secret": "3bca72d93dfc5758e621d9f1ae339214466813f7",
-        "is_verified": false,
-        "line_number": 185
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp.ipynb",
-        "hashed_secret": "d9e7a289a14e7f325cb99dfe30d3e5d4338a5ab1",
-        "is_verified": false,
-        "line_number": 361
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp.ipynb",
-        "hashed_secret": "d46eb772be25bd60768fe663b96be28711f1c175",
-        "is_verified": false,
-        "line_number": 497
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp.ipynb",
-        "hashed_secret": "6e15db5a63ea26c0d006d17508b00aa234772f7d",
-        "is_verified": false,
-        "line_number": 514
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp.ipynb",
-        "hashed_secret": "dfbcf4660ba8fa3d2e04f8cf427c2a4b2e3c6b27",
-        "is_verified": false,
-        "line_number": 531
-      }
-    ],
-    "docs/user/notebooks/tsp_colab.ipynb": [
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp_colab.ipynb",
-        "hashed_secret": "3bca72d93dfc5758e621d9f1ae339214466813f7",
-        "is_verified": false,
-        "line_number": 182
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp_colab.ipynb",
-        "hashed_secret": "d9e7a289a14e7f325cb99dfe30d3e5d4338a5ab1",
-        "is_verified": false,
-        "line_number": 358
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp_colab.ipynb",
-        "hashed_secret": "d46eb772be25bd60768fe663b96be28711f1c175",
-        "is_verified": false,
-        "line_number": 494
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp_colab.ipynb",
-        "hashed_secret": "6e15db5a63ea26c0d006d17508b00aa234772f7d",
-        "is_verified": false,
-        "line_number": 511
-      },
-      {
-        "type": "Base64 High Entropy String",
-        "filename": "docs/user/notebooks/tsp_colab.ipynb",
-        "hashed_secret": "dfbcf4660ba8fa3d2e04f8cf427c2a4b2e3c6b27",
-        "is_verified": false,
-        "line_number": 528
-      }
-    ],
     "tests/integration/test_engine.py": [
       {
         "type": "Secret Keyword",
@@ -377,5 +139,5 @@
       }
     ]
   },
-  "generated_at": "2025-10-09T10:06:42Z"
+  "generated_at": "2026-01-27T21:53:18Z"
 }

AGENTS.md

@@ -0,0 +1,52 @@
+## Project Overview
+
+GAMSPy is built with Python. The codebase is organized into the following layers:
+
+### Root Folders
+- `src/`: Source code
+- `tests/`: Unit and integration tests.
+- `docs/`: Sphinx documentation. 
+- `scripts/`: Development, build, and performance scripts.
+- `ci/`: Yaml files for Gitlab CI jobs.
+
+### Core Architecture (`src/gamspy` folder)
+- `_symbols/` - Implementation of the main symbols in GAMSPy such as Set, Parameter, Variable, Equation and Alias.
+- `_backend/` - Implementation of different backends such as GAMS Engine and NEOS Server to solve models.
+- `_cli/` - GAMSPy CLI implementation.
+- `_algebra/` - Implementation of other structures to help developing models such as Expression, Domain, Number, Sum, Product, Smin, and Smax.
+- `formulations/` - Implementation of different formulations including machine learning and neural network formulations.
+- `math` - Math related expressions.
+- `_container.py` - Implementation of the Container.
+- `_model.py` - Implementation of the model.
+
+## Setting Up A Development Environment
+- Run `uv sync --group dev --group test --group doc` to get the necessary environment for development.
+- If a virtual environment is not already activated, run `source .venv/bin/activate` to activate the environment.
+- Run `uv pip install -e .` before you do any changes.
+
+## Testing
+- You can find all available markers in `pyproject.toml`.
+- Run `pytest -m 'unit'` to run all unit tests.
+- Run `pytest -m 'integration'` to run all integration tests.
+- Run `pytest -m 'model_library'` to run all models in the model library. This requires a GAMS license. Install GAMS license with `gamspy install license $ACCESS_CODE` if `ACCESS_CODE` is available in the environment variables or if it exists in the `.env` file. If `ACCESS_CODE` is not available, do not run model_library tests.
+- Run `pytest -m 'doc'` to run documentation tests.
+
+## Documentation
+- Run `cd docs && make html` to build the documentation.
+- Run `cd docs && make linkchecker` to check the validitiy of the links in the documentation.
+
+## Validating Changes
+- Always run `prek run --all-files` before declaring any work complete, then fix all errors before moving forward.
+- Always run `pytest -m 'unit or integration'` before declaring any work complete, then fix all errors before moving forward.
+
+
+## Coding Guidelines
+- Follow ruff rules specified in pyproject.toml for formatting and linting. 
+
+
+### Code Quality
+
+- If you create any temporary new files, scripts, or helper files for iteration, clean up these files by removing them at the end of the task
+- Never duplicate imports. Always reuse existing imports if they are present.
+- Always use type annotations.
+- Do not duplicate code. Always look for existing utility functions, helpers, or patterns in the codebase before implementing new functionality. Reuse and extend existing code whenever possible.

CHANGELOG.rst

@@ -1,3 +1,29 @@
+GAMSPy 1.19.0 (2026-01-27)
+==========================
+
+Improvements in existing functionality
+--------------------------------------
+- #763: Accept Path-like load_from argument in container.loadRecordsFromGdx function.
+
+Bug fixes
+---------
+- #763: Make loadRecordsFromGdx respect .synchronize attribute of symbols.
+
+Improved documentation
+----------------------
+- #752: Add more examples in API reference.
+
+CI/CD changes
+-------------
+- #757: Replace pre-commit with prek.
+
+Miscellaneous internal changes
+------------------------------
+- #725: Add a new example showing the usage of solution pools.
+- #751: Add AGENTS.md file to guide coding agents.
+- #756: Move dev, test and doc dependencies to depedency groups instead of optional dependencies.
+- #758: Update the validation error message that is raised in case debugging_level is not set.
+
 GAMSPy 1.18.4 (2026-01-10)
 ==========================