lingo-api 23.0.2

# The Python Interface to LINGO.

This package requires Lingo and a valid license key. Please refer to the [Lingo user manual](https://lindo.com/downloads/PDF/LINGO.pdf) for installation instructions, and to learn more about the Lingo modeling language.

## LINGO 23 Release

Package version 23.0.2 targets the LINGO 23.0.155 SDK and requires Python 3.9 or newer. The Windows build matrix covers Python 3.9 through 3.15. Linux builds use the matching LINGO 23 SDK archive and Python matrix configured in the Dockerfile. The Python package version is independent of the native LINGO SDK version.

On 64-bit Windows, set LINGO64_23_HOME to the LINGO 23 installation directory. On Linux, set LINGO_23_HOME to the LINGO 23 installation directory. Use window_build.bat for Windows builds and Dockerfile for Linux builds.

## Installation For LINGO 21

This python package can be installed with pip. It is assumed Lingo 21 is installed on host system.

For administrative users:

`bash > pip install lingo_api `

For standard (non-administrative) users:

`bash > pip install lingo_api --user `

## Installation For LINGO 20

This python package can be installed with pip. It is assumed Lingo 20 is installed on host system.

For administrative users:

`bash > pip install lingo_api==20.0.9 `

For standard (non-administrative) users:

`bash > pip install lingo_api==20.0.9 --user `

## Testing

A quick way to test the installation is to run `bash > python -m lingo_test `

It is also good to test the LINGO API on one of the included examples. ` > cd examples/CHESS > python chess.py `

## Possible errors due to misconfiguration

If the user does not have the correct LINGO environment variable set, they will not be able to load the lingo_api library instead they will receive an error message.

To fix the problem follow these steps

### Using Windows On the command line depending on the users LINGO installation:

LINGO 21 on windows 64-bit `dos > setx LINGO64_21_HOME "C:\path\to\LINGO64_21" ` LINGO 21 on windows 32-bit `dos > setx LINGO_21_HOME "C:\path\to\LINGO21" `

LINGO 20 on windows 64-bit `dos > setx LINGO64_20_HOME "C:\path\to\LINGO64_20" ` LINGO 20 on windows 32-bit `dos > setx LINGO_20_HOME "C:\path\to\LINGO20" `

### Using Linux On the command line depending on the users LINGO installation:

LINGO 23 For standard (non-administrative) users: ` $ export LINGO_23_HOME="$HOME/LINGO64_23" ` For administrative users: ` $ export LINGO_23_HOME="/opt/LINGO64_23" `

If a shared library cannot be loaded, add the LINGO library directory to the loader path: ` $ export LD_LIBRARY_PATH="$LINGO_23_HOME/bin/linux64${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}" `

To have these variables set automatically, add the relevant lines to the ~/.bashrc or ~/.bash_profile file.

## How to Build Wheel and Install (for package managers)

To build the python package on any operating system first start by creating a whl file. From the top of the lingoapi-python directory run the command.

`bash > python -m build `

If the command is successful a new directory named dist is created in the lingoapi-python directory. The new directory will have two files with extension .whl and .tar.gz. For example, if the LINGO API is built it on Windows using Python 3.10 the new directory will look like this.

`bash ├── dist │ ├── lingo_api-x.y.z-cp310-cp310-win_amd64.whl │ └── lingo-x.y.z.tar.gz `

The package can now be installed locally using the command. `bash > pip install dist/*.whl `