highspy-extras 1.15.0__tar.gz

highspy_extras-1.15.0/CMakeLists.txt

@@ -0,0 +1,24 @@
+# CMakeLists.txt for highspy-extras wheel
+# The wheel only wraps the standalone highs_extras shared library.
+# Use the dedicated extras-library mode so the top-level build adds the
+# highs_extras target and installs it into the highspy-extras package.
+
+cmake_minimum_required(VERSION 3.15...3.27)
+
+# Resolve parent repo from either current dir (sdist) or parent (standard build)
+if(EXISTS "${CMAKE_CURRENT_LIST_DIR}/extern/CMakeLists.txt")
+    set(_PARENT_DIR "${CMAKE_CURRENT_LIST_DIR}")
+else()
+    set(_PARENT_DIR "${CMAKE_CURRENT_LIST_DIR}/..")
+endif()
+
+list(APPEND CMAKE_MODULE_PATH "${_PARENT_DIR}/cmake")
+include(vcpkg)
+project(highs_extras LANGUAGES C CXX)
+
+add_subdirectory("${_PARENT_DIR}/extern" "${CMAKE_CURRENT_BINARY_DIR}/extern")
+
+install(TARGETS highs_extras
+    RUNTIME DESTINATION highspy_extras
+    LIBRARY DESTINATION highspy_extras
+)

highspy_extras-1.15.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: highspy-extras
+Version: 1.15.0
+Summary: HiGHS external dependencies extension for highspy
+Author-Email: HiGHS developers <highsopt@gmail.com>
+License-Expression: Apache-2.0 AND BSD-3-Clause
+License-File: THIRD_PARTY_NOTICES.md
+Classifier: Programming Language :: Python :: 3 :: Only
+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
+Project-URL: Source Code, https://github.com/ERGO-Code/HiGHS
+Project-URL: Bug Tracker, https://github.com/ERGO-Code/HiGHS/issues
+Requires-Python: >=3.9
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Description-Content-Type: text/markdown
+
+# highspy-extras
+
+Extension package for [highspy](https://pypi.org/project/highspy/) that enables access to external dependencies with licensing terms different from HiGHS, such as Apache 2.0.
+
+The HiPO Interior Point Method (IPM) solver currently uses these external dependencies to provide enhanced performance for linear and quadratic programming problems. Other algorithms may also rely on `highspy-extras` in the future.
+
+## Installation
+
+Install directly:
+
+```bash
+pip install highspy-extras
+```
+
+Or install via the highspy optional dependency:
+
+```bash
+pip install highspy[extras]
+```
+
+At present, the optional dependency installs support needed for HiPO.
+
+## Usage
+
+When `highspy-extras` is installed, HiGHS can use algorithms that depend on these external libraries. Note that `highspy-extras` is automatically consumed by `highspy` and does not need to be imported manually. At present this primarily means the HiPO solver. You can explicitly select HiPO:
+
+```python
+import highspy
+
+# Create a HiGHS instance
+h = highspy.Highs()
+
+# Load your model
+h.readModel("model.mps")
+
+# Set solver to use HiPO
+h.setOptionValue("solver", "hipo")
+
+# Solve
+h.run()
+```
+
+For debugging library packaging issues, you can also query the ABI version reported directly by the shared library:
+
+```python
+import highspy_extras
+
+print(highspy_extras.__version__)
+print(highspy_extras.get_library_version())
+```
+
+## Requirements
+
+- Python >= 3.9
+
+- BLAS library
+The highspy-extras wheels on PyPI and conda-forge ship with a bundled OpenBLAS.
+
+When installing locally from source, the requirement is:
+  - OpenBLAS on Windows and Linux:
+    - Install with vcpkg
+    - Install with apt on Linux
+    - Set BUILD_OPENBLAS=ON in cmake, to fetch and build OpenBLAS as a subproject
+  - Apple Accelerate on MacOS:
+    - MacOS comes with the Accelerate framework pre-installed
+
+## License
+
+Apache 2.0 - see the license and `THIRD_PARTY_NOTICES` in the [HiGHS repository](https://github.com/ERGO-Code/HiGHS) for details.

highspy_extras-1.15.0/README.md

@@ -0,0 +1,69 @@
+# highspy-extras
+
+Extension package for [highspy](https://pypi.org/project/highspy/) that enables access to external dependencies with licensing terms different from HiGHS, such as Apache 2.0.
+
+The HiPO Interior Point Method (IPM) solver currently uses these external dependencies to provide enhanced performance for linear and quadratic programming problems. Other algorithms may also rely on `highspy-extras` in the future.
+
+## Installation
+
+Install directly:
+
+```bash
+pip install highspy-extras
+```
+
+Or install via the highspy optional dependency:
+
+```bash
+pip install highspy[extras]
+```
+
+At present, the optional dependency installs support needed for HiPO.
+
+## Usage
+
+When `highspy-extras` is installed, HiGHS can use algorithms that depend on these external libraries. Note that `highspy-extras` is automatically consumed by `highspy` and does not need to be imported manually. At present this primarily means the HiPO solver. You can explicitly select HiPO:
+
+```python
+import highspy
+
+# Create a HiGHS instance
+h = highspy.Highs()
+
+# Load your model
+h.readModel("model.mps")
+
+# Set solver to use HiPO
+h.setOptionValue("solver", "hipo")
+
+# Solve
+h.run()
+```
+
+For debugging library packaging issues, you can also query the ABI version reported directly by the shared library:
+
+```python
+import highspy_extras
+
+print(highspy_extras.__version__)
+print(highspy_extras.get_library_version())
+```
+
+## Requirements
+
+- Python >= 3.9
+
+- BLAS library
+The highspy-extras wheels on PyPI and conda-forge ship with a bundled OpenBLAS.
+
+When installing locally from source, the requirement is:
+  - OpenBLAS on Windows and Linux:
+    - Install with vcpkg
+    - Install with apt on Linux
+    - Set BUILD_OPENBLAS=ON in cmake, to fetch and build OpenBLAS as a subproject
+  - Apple Accelerate on MacOS:
+    - MacOS comes with the Accelerate framework pre-installed
+
+## License
+
+Apache 2.0 - see the license and `THIRD_PARTY_NOTICES` in the [HiGHS repository](https://github.com/ERGO-Code/HiGHS) for details.

highspy_extras-1.15.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,78 @@
+# Third Party Licenses and Acknowledgements
+
+The majority of the HiGHS source code is available under the [MIT license](https://opensource.org/license/MIT).
+
+Code in the `/extern` directory was originally developed by third-parties and is
+licensed under additional licenses.
+
+## amd
+
+The source code in `/extern/amd` is distributed under the [BSD-3 license](https://opensource.org/license/bsd-3-clause)
+at `/extern/amd/License.txt`.
+
+It was originally developed by Timothy Davis.
+
+The upstream source code is available at:
+
+ * https://github.com/DrTimothyAldenDavis/SuiteSparse
+
+To avoid compiling this code into HiGHS, use `-DHIPO=OFF` (the default value).
+
+## cli
+
+The source code in `/extern/CLI11.hpp` is distributed under a license stated in the source code. Although the license is not named, the text appears to correspond to the [BSD-3 license](https://opensource.org/license/bsd-3-clause).
+
+The upstream source code is available at:
+
+* https://github.com/CLIUtils/CLI11
+
+CLI11 is only used to parse command line input for the HiGHS executable, so does not affect the license status of the HiGHS library or language interfaces to it.
+
+## metis
+
+The source code in `/extern/metis` is distributed under the [Apache 2.0 license](https://opensource.org/license/apache-2-0)
+at `/extern/metis/LICENSE.txt`.
+
+It was originally developed by George Karypis.
+
+The upstream source code is available at:
+
+ * https://github.com/KarypisLab/METIS
+ * https://github.com/KarypisLab/GKlib
+
+To avoid compiling this code into HiGHS, use `-DHIPO=OFF` (the default value).
+
+## pdqsort
+
+The source code in `/extern/pdqsort` is distributed under the [zlib license](https://opensource.org/license/zlib)
+at `/extern/pdqsort/license.txt`.
+
+It was originally developed by Orson Peters.
+
+The upstream source code is available at:
+
+ * https://github.com/orlp/pdqsort
+
+## rcm
+
+The source code in `/extern/rcm` is distributed under the [MIT license](https://opensource.org/license/MIT)
+at `/extern/rcm/LICENSE`.
+
+It was originally developed by Alan George, Joseph Liu, and John Burkardt.
+
+The upstream source code is available at:
+
+ * https://people.sc.fsu.edu/~jburkardt/cpp_src/rcm/rcm.html
+
+To avoid compiling this code into HiGHS, use `-DHIPO=OFF` (the default value).
+
+## zstr
+
+The source code in `/extern/zstr` is distributed under the [MIT license](https://opensource.org/license/MIT)
+at `/extern/zstr/LICENSE`.
+
+It was originally developed by Matei David.
+
+The upstream source code is available at:
+
+ * https://github.com/mateidavid/zstr

highspy_extras-1.15.0/Version.txt

@@ -0,0 +1,4 @@
+HIGHS_MAJOR=1
+HIGHS_MINOR=15
+HIGHS_PATCH=0
+#PRE_RELEASE=YES

highspy_extras-1.15.0/build_backend.py

@@ -0,0 +1,60 @@
+"""Thin wrapper around scikit-build-core that stages parent-repo files
+into the project tree before building the sdist."""
+
+import shutil
+from pathlib import Path
+
+try:
+    import tomllib
+except ModuleNotFoundError:
+    import tomli as tomllib
+
+from scikit_build_core import build as _orig
+
+_HERE = Path(__file__).resolve().parent
+_PARENT = _HERE.parent
+
+
+def _get_sdist_include():
+    with open(_HERE / "pyproject.toml", "rb") as f:
+        cfg = tomllib.load(f)
+    return cfg.get("tool", {}).get("scikit-build", {}).get("sdist", {}).get("include", [])
+
+
+def build_sdist(sdist_directory, config_settings=None):
+    created = []
+    try:
+        for name in _get_sdist_include():
+            dst, src = _HERE / name, _PARENT / name
+            print(f"Staging {src} -> {dst}")
+            if dst.exists() or not src.exists():
+                continue
+
+            # Track any new parent dirs so they can be cleaned up
+            new_dirs = []
+            for parent in reversed(dst.relative_to(_HERE).parents[:-1]):
+                d = _HERE / parent
+                if d.exists():
+                    break
+                new_dirs.append(d)
+
+            if new_dirs:
+                new_dirs[0].mkdir(parents=True)
+                created.extend(reversed(new_dirs))
+
+            (shutil.copytree if src.is_dir() else shutil.copy2)(src, dst)
+            created.append(dst)
+        return _orig.build_sdist(sdist_directory, config_settings)
+    finally:
+        for p in reversed(created):
+            shutil.rmtree(p) if p.is_dir() else p.unlink(missing_ok=True)
+
+
+# Re-export everything else unchanged.
+build_wheel = _orig.build_wheel
+build_editable = _orig.build_editable
+get_requires_for_build_sdist = _orig.get_requires_for_build_sdist
+get_requires_for_build_wheel = _orig.get_requires_for_build_wheel
+get_requires_for_build_editable = _orig.get_requires_for_build_editable
+prepare_metadata_for_build_wheel = _orig.prepare_metadata_for_build_wheel
+prepare_metadata_for_build_editable = _orig.prepare_metadata_for_build_editable

highspy_extras-1.15.0/cmake/CheckAtomic.cmake

@@ -0,0 +1,74 @@
+# atomic builtins are required for threading support.
+INCLUDE(CheckCXXSourceCompiles)
+INCLUDE(CheckLibraryExists)
+
+function(check_working_cxx_atomics varname)
+  set(OLD_CMAKE_REQUIRED_FLAGS ${CMAKE_REQUIRED_FLAGS})
+  set(CMAKE_REQUIRED_FLAGS "${CMAKE_REQUIRED_FLAGS} -std=c++11")
+  CHECK_CXX_SOURCE_COMPILES("
+#include <atomic>
+std::atomic<int> x;
+std::atomic<short> y;
+std::atomic<char> z;
+int main() {
+  ++z;
+  ++y;
+  return ++x;
+}
+" ${varname})
+  set(CMAKE_REQUIRED_FLAGS ${OLD_CMAKE_REQUIRED_FLAGS})
+endfunction(check_working_cxx_atomics)
+
+function(check_working_cxx_atomics64 varname)
+  set(OLD_CMAKE_REQUIRED_FLAGS ${CMAKE_REQUIRED_FLAGS})
+  set(CMAKE_REQUIRED_FLAGS "-std=c++11 ${CMAKE_REQUIRED_FLAGS}")
+  CHECK_CXX_SOURCE_COMPILES("
+#include <atomic>
+#include <cstdint>
+std::atomic<uint64_t> x (0);
+int main() {
+  uint64_t i = x.load(std::memory_order_relaxed);
+  (void)i;
+  return 0;
+}
+" ${varname})
+  set(CMAKE_REQUIRED_FLAGS ${OLD_CMAKE_REQUIRED_FLAGS})
+endfunction(check_working_cxx_atomics64)
+
+# Check for (non-64-bit) atomic operations.
+if(MSVC)
+  set(HAVE_CXX_ATOMICS_WITHOUT_LIB True)
+elseif(LLVM_COMPILER_IS_GCC_COMPATIBLE OR CMAKE_CXX_COMPILER_ID MATCHES "XL" OR CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+  check_working_cxx_atomics(HAVE_CXX_ATOMICS_WITHOUT_LIB)
+  if(NOT HAVE_CXX_ATOMICS_WITHOUT_LIB)
+    check_library_exists(atomic __atomic_fetch_add_4 "" HAVE_LIBATOMIC)
+    if(HAVE_LIBATOMIC)
+      list(APPEND CMAKE_REQUIRED_LIBRARIES atomic)
+      check_working_cxx_atomics(HAVE_CXX_ATOMICS_WITH_LIB)
+      if(NOT HAVE_CXX_ATOMICS_WITH_LIB)
+        message(FATAL_ERROR "Host compiler must support std::atomic!")
+      endif()
+    else()
+      message(FATAL_ERROR "Host compiler appears to require libatomic, but cannot find it.")
+    endif()
+  endif()
+endif()
+
+# Check for 64-bit atomic operations.
+if(MSVC)
+  set(HAVE_CXX_ATOMICS64_WITHOUT_LIB True)
+elseif(LLVM_COMPILER_IS_GCC_COMPATIBLE OR CMAKE_CXX_COMPILER_ID MATCHES "XL" OR CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+  check_working_cxx_atomics64(HAVE_CXX_ATOMICS64_WITHOUT_LIB)
+  if(NOT HAVE_CXX_ATOMICS64_WITHOUT_LIB)
+    check_library_exists(atomic __atomic_load_8 "" HAVE_CXX_LIBATOMICS64)
+    if(HAVE_CXX_LIBATOMICS64)
+      list(APPEND CMAKE_REQUIRED_LIBRARIES atomic)
+      check_working_cxx_atomics64(HAVE_CXX_ATOMICS64_WITH_LIB)
+      if(NOT HAVE_CXX_ATOMICS64_WITH_LIB)
+        message(FATAL_ERROR "Host compiler must support 64-bit std::atomic!")
+      endif()
+    else()
+      message(FATAL_ERROR "Host compiler appears to require libatomic for 64-bit operations, but cannot find it.")
+    endif()
+  endif()
+endif()

highspy_extras-1.15.0/cmake/FindCUDAConf.cmake

@@ -0,0 +1,44 @@
+set(CUDA_LIBRARY-NOTFOUND, OFF)
+message(NOTICE "Finding CUDA environment")
+message(NOTICE "    - CUDA Home detected at $ENV{CUDA_HOME}")
+set(CMAKE_CUDA_ARCHITECTURES "all")
+
+# On Windows users should set -DCMAKE_CUDA_PATH="..." when configuring CMake. 
+# For all test setups CUPDLP_FIND_CUDA was not required on Windows.
+if (NOT WIN32)
+        set(CMAKE_CUDA_PATH "$ENV{CUDA_HOME}")
+endif()
+# For local testing.
+# set(CMAKE_CUDA_PATH "C:\\Program Files\\NVIDIA GPU Computing Toolkit\\CUDA\\v12.9")
+
+# message(STATUS "CMAKE_CUDA_PATH  ${CMAKE_CUDA_PATH}")
+
+set(CMAKE_CUDA_COMPILER "${CMAKE_CUDA_PATH}/bin/nvcc")
+
+enable_language(CUDA)
+
+find_library(CUDA_LIBRARY_ART
+        NAMES cudart
+        HINTS "${CMAKE_CUDA_PATH}/lib64/"
+        HINTS "${CMAKE_CUDA_PATH}/lib/x64"
+        REQUIRED
+)
+find_library(CUDA_LIBRARY_SPS
+        NAMES cusparse
+        HINTS "${CMAKE_CUDA_PATH}/lib64/"
+        HINTS "${CMAKE_CUDA_PATH}/lib/x64/"
+        REQUIRED
+)
+find_library(CUDA_LIBRARY_BLS
+        NAMES cublas
+        HINTS "${CMAKE_CUDA_PATH}/lib64/"
+        HINTS "${CMAKE_CUDA_PATH}/lib/x64/"
+        REQUIRED
+)
+if (${CUDA_LIBRARY-NOTFOUND})
+    message(WARNING "    - CUDA Libraries not detected at $ENV{CUDA_HOME}")
+else ()
+    message(NOTICE "    - CUDA Libraries detected at $ENV{CUDA_HOME}")
+    set(CUDA_LIBRARY ${CUDA_LIBRARY_ART} ${CUDA_LIBRARY_SPS} ${CUDA_LIBRARY_BLS})
+    message(NOTICE "    -   :${CUDA_LIBRARY}")
+endif ()