PuLP 3.3.1__tar.gz → 3.3.2__tar.gz

{pulp-3.3.1 → pulp-3.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PuLP
-Version: 3.3.1
+Version: 3.3.2
 Summary: PuLP is an LP modeler written in python. PuLP can generate MPS or LP files and call GLPK, COIN CLP/CBC, CPLEX, and GUROBI to solve linear problems.
 Author: J.S. Roy
 Author-email: "S.A. Mitchell" <pulp@stuartmitchell.com>, Franco Peschiera <pchtsp@gmail.com>
@@ -15,9 +15,11 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python
 Classifier: Topic :: Scientific/Engineering :: Mathematics
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
+Provides-Extra: cbc
+Requires-Dist: cbcbox; extra == "cbc"
 Provides-Extra: open-py
 Requires-Dist: highspy==1.13; extra == "open-py"
 Requires-Dist: pyscipopt; extra == "open-py"
@@ -63,7 +65,7 @@ PuLP is part of the `COIN-OR project <https://www.coin-or.org/>`_.
 Installation
 ================
 
-PuLP requires Python 3.9 or newer.
+PuLP requires Python 3.10 or newer.
 
 The easiest way to install PuLP is with ``pip``. If ``pip`` is available on your system, type::
 
@@ -74,8 +76,15 @@ Otherwise follow the download instructions on the `PyPi page <https://pypi.pytho
 Installing solvers
 ----------------------
 
-PuLP can use a variety of solvers. The default solver is the COIN-OR CBC solver, which is included with PuLP. If you want to use other solvers, PuLP offers a quick way to install most solvers via their pypi package (some require a commercial license for running or for running large models)::
+PuLP can use a variety of solvers. The default solver is the COIN-OR CBC solver via the ``COIN_CMD`` API. Install CBC with::
 
+    python -m pip install pulp[cbc]
+
+If CBC is not available on your system, PuLP falls back to other solvers such as the legacy bundled CBC (``PULP_CBC_CMD``) or GLPK.
+
+To install other solvers, PuLP offers a quick way to install most solvers via their pypi package (some require a commercial license for running or for running large models)::
+
+    python -m pip install pulp[cbc]
     python -m pip install pulp[gurobi]
     python -m pip install pulp[cplex]
     python -m pip install pulp[xpress]
@@ -108,10 +117,14 @@ An expression is a constraint without a right-hand side (RHS) sense (one of ``=`
 
      prob += -4*x + y
 
-To solve the problem  with the default included solver::
+To solve the problem with the default solver (CBC via ``COIN_CMD`` when installed with ``pulp[cbc]``)::
 
      status = prob.solve()
 
+To solve explicitly with CBC::
+
+     status = prob.solve(COIN_CMD(msg=0))
+
 If you want to try another solver to solve the problem::
 
      status = prob.solve(GLPK(msg = 0))
@@ -151,7 +164,7 @@ More Examples
 
 Several tutorial are given in `documentation <https://coin-or.github.io/pulp/CaseStudies/index.html>`_ and pure code examples are available in `examples/ directory <https://github.com/coin-or/pulp/tree/master/examples>`_ .
 
-The examples use the default solver (CBC). To use other solvers they must be available (installed and accessible). For more information on how to do that, see the `guide on configuring solvers <https://coin-or.github.io/pulp/guides/how_to_configure_solvers.html>`_.
+The examples use the default solver (CBC via ``COIN_CMD`` when available). To use other solvers they must be available (installed and accessible). For more information on how to do that, see the `guide on configuring solvers <https://coin-or.github.io/pulp/guides/how_to_configure_solvers.html>`_.
 
 
 For Developers 
@@ -163,12 +176,6 @@ If you want to install the latest version from GitHub you can run::
     python -m pip install -U git+https://github.com/coin-or/pulp
 
 
-On Linux and MacOS systems, you must run the tests to make the default solver executable::
-
-     sudo pulptest
-
-
-
 
 Building the documentation
 --------------------------

{pulp-3.3.1 → pulp-3.3.2}/PuLP.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PuLP
-Version: 3.3.1
+Version: 3.3.2
 Summary: PuLP is an LP modeler written in python. PuLP can generate MPS or LP files and call GLPK, COIN CLP/CBC, CPLEX, and GUROBI to solve linear problems.
 Author: J.S. Roy
 Author-email: "S.A. Mitchell" <pulp@stuartmitchell.com>, Franco Peschiera <pchtsp@gmail.com>
@@ -15,9 +15,11 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python
 Classifier: Topic :: Scientific/Engineering :: Mathematics
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
+Provides-Extra: cbc
+Requires-Dist: cbcbox; extra == "cbc"
 Provides-Extra: open-py
 Requires-Dist: highspy==1.13; extra == "open-py"
 Requires-Dist: pyscipopt; extra == "open-py"
@@ -63,7 +65,7 @@ PuLP is part of the `COIN-OR project <https://www.coin-or.org/>`_.
 Installation
 ================
 
-PuLP requires Python 3.9 or newer.
+PuLP requires Python 3.10 or newer.
 
 The easiest way to install PuLP is with ``pip``. If ``pip`` is available on your system, type::
 
@@ -74,8 +76,15 @@ Otherwise follow the download instructions on the `PyPi page <https://pypi.pytho
 Installing solvers
 ----------------------
 
-PuLP can use a variety of solvers. The default solver is the COIN-OR CBC solver, which is included with PuLP. If you want to use other solvers, PuLP offers a quick way to install most solvers via their pypi package (some require a commercial license for running or for running large models)::
+PuLP can use a variety of solvers. The default solver is the COIN-OR CBC solver via the ``COIN_CMD`` API. Install CBC with::
 
+    python -m pip install pulp[cbc]
+
+If CBC is not available on your system, PuLP falls back to other solvers such as the legacy bundled CBC (``PULP_CBC_CMD``) or GLPK.
+
+To install other solvers, PuLP offers a quick way to install most solvers via their pypi package (some require a commercial license for running or for running large models)::
+
+    python -m pip install pulp[cbc]
     python -m pip install pulp[gurobi]
     python -m pip install pulp[cplex]
     python -m pip install pulp[xpress]
@@ -108,10 +117,14 @@ An expression is a constraint without a right-hand side (RHS) sense (one of ``=`
 
      prob += -4*x + y
 
-To solve the problem  with the default included solver::
+To solve the problem with the default solver (CBC via ``COIN_CMD`` when installed with ``pulp[cbc]``)::
 
      status = prob.solve()
 
+To solve explicitly with CBC::
+
+     status = prob.solve(COIN_CMD(msg=0))
+
 If you want to try another solver to solve the problem::
 
      status = prob.solve(GLPK(msg = 0))
@@ -151,7 +164,7 @@ More Examples
 
 Several tutorial are given in `documentation <https://coin-or.github.io/pulp/CaseStudies/index.html>`_ and pure code examples are available in `examples/ directory <https://github.com/coin-or/pulp/tree/master/examples>`_ .
 
-The examples use the default solver (CBC). To use other solvers they must be available (installed and accessible). For more information on how to do that, see the `guide on configuring solvers <https://coin-or.github.io/pulp/guides/how_to_configure_solvers.html>`_.
+The examples use the default solver (CBC via ``COIN_CMD`` when available). To use other solvers they must be available (installed and accessible). For more information on how to do that, see the `guide on configuring solvers <https://coin-or.github.io/pulp/guides/how_to_configure_solvers.html>`_.
 
 
 For Developers 
@@ -163,12 +176,6 @@ If you want to install the latest version from GitHub you can run::
     python -m pip install -U git+https://github.com/coin-or/pulp
 
 
-On Linux and MacOS systems, you must run the tests to make the default solver executable::
-
-     sudo pulptest
-
-
-
 
 Building the documentation
 --------------------------

{pulp-3.3.1 → pulp-3.3.2}/PuLP.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ pulp/mps_lp.py
 pulp/pulp.py
 pulp/sparse.py
 pulp/utilities.py
+pulp/v4_migration.py
 pulp/apis/__init__.py
 pulp/apis/choco_api.py
 pulp/apis/coin_api.py

{pulp-3.3.1 → pulp-3.3.2}/PuLP.egg-info/requires.txt

@@ -1,4 +1,7 @@
 
+[cbc]
+cbcbox
+
 [copt]
 coptpy
 

{pulp-3.3.1 → pulp-3.3.2}/README.rst

@@ -19,7 +19,7 @@ PuLP is part of the `COIN-OR project <https://www.coin-or.org/>`_.
 Installation
 ================
 
-PuLP requires Python 3.9 or newer.
+PuLP requires Python 3.10 or newer.
 
 The easiest way to install PuLP is with ``pip``. If ``pip`` is available on your system, type::
 
@@ -30,8 +30,15 @@ Otherwise follow the download instructions on the `PyPi page <https://pypi.pytho
 Installing solvers
 ----------------------
 
-PuLP can use a variety of solvers. The default solver is the COIN-OR CBC solver, which is included with PuLP. If you want to use other solvers, PuLP offers a quick way to install most solvers via their pypi package (some require a commercial license for running or for running large models)::
+PuLP can use a variety of solvers. The default solver is the COIN-OR CBC solver via the ``COIN_CMD`` API. Install CBC with::
 
+    python -m pip install pulp[cbc]
+
+If CBC is not available on your system, PuLP falls back to other solvers such as the legacy bundled CBC (``PULP_CBC_CMD``) or GLPK.
+
+To install other solvers, PuLP offers a quick way to install most solvers via their pypi package (some require a commercial license for running or for running large models)::
+
+    python -m pip install pulp[cbc]
     python -m pip install pulp[gurobi]
     python -m pip install pulp[cplex]
     python -m pip install pulp[xpress]
@@ -64,10 +71,14 @@ An expression is a constraint without a right-hand side (RHS) sense (one of ``=`
 
      prob += -4*x + y
 
-To solve the problem  with the default included solver::
+To solve the problem with the default solver (CBC via ``COIN_CMD`` when installed with ``pulp[cbc]``)::
 
      status = prob.solve()
 
+To solve explicitly with CBC::
+
+     status = prob.solve(COIN_CMD(msg=0))
+
 If you want to try another solver to solve the problem::
 
      status = prob.solve(GLPK(msg = 0))
@@ -107,7 +118,7 @@ More Examples
 
 Several tutorial are given in `documentation <https://coin-or.github.io/pulp/CaseStudies/index.html>`_ and pure code examples are available in `examples/ directory <https://github.com/coin-or/pulp/tree/master/examples>`_ .
 
-The examples use the default solver (CBC). To use other solvers they must be available (installed and accessible). For more information on how to do that, see the `guide on configuring solvers <https://coin-or.github.io/pulp/guides/how_to_configure_solvers.html>`_.
+The examples use the default solver (CBC via ``COIN_CMD`` when available). To use other solvers they must be available (installed and accessible). For more information on how to do that, see the `guide on configuring solvers <https://coin-or.github.io/pulp/guides/how_to_configure_solvers.html>`_.
 
 
 For Developers 
@@ -119,12 +130,6 @@ If you want to install the latest version from GitHub you can run::
     python -m pip install -U git+https://github.com/coin-or/pulp
 
 
-On Linux and MacOS systems, you must run the tests to make the default solver executable::
-
-     sudo pulptest
-
-
-
 
 Building the documentation
 --------------------------

{pulp-3.3.1 → pulp-3.3.2}/pulp/__init__.py

@@ -56,6 +56,7 @@ except Exception:
 
 from .constants import VERSION
 
+from .v4_migration import set_v4_migration_warnings
 from .pulp import *
 from .apis import *
 from .utilities import *

{pulp-3.3.1 → pulp-3.3.2}/pulp/apis/__init__.py

@@ -45,14 +45,14 @@ _all_solvers: List[Type[LpSolver]] = [
     CUOPT,
 ]
 
-LpSolverDefault: Optional[Union[PULP_CBC_CMD, GLPK_CMD, COIN_CMD]] = None
+LpSolverDefault: Optional[Union[COIN_CMD, PULP_CBC_CMD, GLPK_CMD]] = None
 # Default solver selection
-if PULP_CBC_CMD().available():
-    LpSolverDefault = PULP_CBC_CMD()
+if COIN_CMD().available():
+    LpSolverDefault = COIN_CMD()
+elif PULP_CBC_CMD(_skip_v4_deprecation=True).available():
+    LpSolverDefault = PULP_CBC_CMD(_skip_v4_deprecation=True)
 elif GLPK_CMD().available():
     LpSolverDefault = GLPK_CMD()
-elif COIN_CMD().available():
-    LpSolverDefault = COIN_CMD()
 
 
 def getSolver(solver: str, *args, **kwargs) -> LpSolver:
@@ -116,7 +116,10 @@ def listSolvers(onlyAvailable: bool = False) -> List[str]:
     """
     result = []
     for s in _all_solvers:
-        solver = s(msg=False)
+        kwargs: Dict[str, Union[str, bool, float, int]] = {"msg": False}
+        if s is PULP_CBC_CMD:
+            kwargs["_skip_v4_deprecation"] = True
+        solver = s(**kwargs)
         if (not onlyAvailable) or solver.available():
             result.append(solver.name)
         del solver

{pulp-3.3.1 → pulp-3.3.2}/pulp/apis/coin_api.py

@@ -48,9 +48,9 @@ import ctypes
 import warnings
 from tempfile import mktemp
 
+from ..v4_migration import v4_deprecation
+
 cbc_path = "cbc"
-if operating_system == "win":
-    cbc_path += ".exe"
 
 coinMP_path = ["libCoinMP.so"]
 # workaround for (https://github.com/coin-or/pulp/issues/802)
@@ -60,6 +60,15 @@ pulp_cbc_path = os.path.join(
     os.path.dirname(__file__), f"../solverdir/cbc/{operating_system}/{arch}/{cbc_path}"
 )
 
+PULP_CBC_CMD_DEPRECATION_MSG = (
+    "PULP_CBC_CMD is deprecated and will be removed in PuLP 4.0. "
+    "Install CBC with `pip install pulp[cbc]` and use COIN_CMD instead."
+)
+
+
+def warn_pulp_cbc_cmd_deprecated(*, stacklevel: int = 2) -> None:
+    v4_deprecation(PULP_CBC_CMD_DEPRECATION_MSG, stacklevel=stacklevel)
+
 
 class COIN_CMD(LpSolver_CMD):
     """The COIN CLP/CBC LP solver
@@ -192,7 +201,7 @@ class COIN_CMD(LpSolver_CMD):
         for option in options:
             cmds += "-" + option + " "
         if self.mip:
-            cmds += "-branch "
+            cmds += "-solve "
         else:
             cmds += "-initialSolve "
         cmds += "-printingOptions all "
@@ -363,11 +372,15 @@ COIN = COIN_CMD
 
 class PULP_CBC_CMD(COIN_CMD):
     """
-    This solver uses a precompiled version of cbc provided with the package
+    Legacy solver that uses a precompiled version of cbc bundled with PuLP.
+
+    Deprecated: will be removed in PuLP 4.0. Install CBC with
+    ``pip install pulp[cbc]`` and use :class:`COIN_CMD` instead.
     """
 
     name = "PULP_CBC_CMD"
-    pulp_cbc_path = pulp_cbc_path
+    pulp_cbc_path = COIN_CMD.executableExtension(pulp_cbc_path)
+    _permissions_ok = True
     try:
         if os.name != "nt":
             if not os.access(pulp_cbc_path, os.X_OK):
@@ -375,61 +388,66 @@ class PULP_CBC_CMD(COIN_CMD):
 
                 os.chmod(pulp_cbc_path, stat.S_IXUSR + stat.S_IXOTH)
     except:  # probably due to incorrect permissions
+        _permissions_ok = False
 
-        def available(self):
-            """True if the solver is available"""
+    def available(self):
+        """True if the solver is available"""
+        if not self._permissions_ok:
             return False
+        return super().available()
 
-        def actualSolve(self, lp, callback=None):
-            """Solve a well formulated lp problem"""
+    def actualSolve(self, lp, **kwargs):
+        """Solve a well formulated lp problem"""
+        if not self._permissions_ok:
             raise PulpSolverError(
                 "PULP_CBC_CMD: Not Available (check permissions on %s)"
                 % self.pulp_cbc_path
             )
+        return super().actualSolve(lp, **kwargs)
 
-    else:
-
-        def __init__(
+    def __init__(
+        self,
+        mip=True,
+        msg=True,
+        timeLimit=None,
+        gapRel=None,
+        gapAbs=None,
+        presolve=None,
+        cuts=None,
+        strong=None,
+        options=None,
+        warmStart=False,
+        keepFiles=False,
+        path=None,
+        threads=None,
+        logPath=None,
+        timeMode="elapsed",
+        maxNodes=None,
+        _skip_v4_deprecation: bool = False,
+    ):
+        if not _skip_v4_deprecation:
+            warn_pulp_cbc_cmd_deprecated(stacklevel=2)
+        if path is not None:
+            raise PulpSolverError("Use COIN_CMD if you want to set a path")
+        COIN_CMD.__init__(
             self,
-            mip=True,
-            msg=True,
-            timeLimit=None,
-            gapRel=None,
-            gapAbs=None,
-            presolve=None,
-            cuts=None,
-            strong=None,
-            options=None,
-            warmStart=False,
-            keepFiles=False,
-            path=None,
-            threads=None,
-            logPath=None,
-            timeMode="elapsed",
-            maxNodes=None,
-        ):
-            if path is not None:
-                raise PulpSolverError("Use COIN_CMD if you want to set a path")
-            # check that the file is executable
-            COIN_CMD.__init__(
-                self,
-                path=self.pulp_cbc_path,
-                mip=mip,
-                msg=msg,
-                timeLimit=timeLimit,
-                gapRel=gapRel,
-                gapAbs=gapAbs,
-                presolve=presolve,
-                cuts=cuts,
-                strong=strong,
-                options=options,
-                warmStart=warmStart,
-                keepFiles=keepFiles,
-                threads=threads,
-                logPath=logPath,
-                timeMode=timeMode,
-                maxNodes=maxNodes,
-            )
+            path=self.pulp_cbc_path,
+            mip=mip,
+            msg=msg,
+            timeLimit=timeLimit,
+            gapRel=gapRel,
+            gapAbs=gapAbs,
+            presolve=presolve,
+            cuts=cuts,
+            strong=strong,
+            options=options,
+            warmStart=warmStart,
+            keepFiles=keepFiles,
+            threads=threads,
+            logPath=logPath,
+            timeMode=timeMode,
+            maxNodes=maxNodes,
+        )
 
 
 def COINMP_DLL_load_dll(path: list[str]):

{pulp-3.3.1 → pulp-3.3.2}/pulp/constants.py

@@ -28,7 +28,7 @@ This file contains the constant definitions for PuLP
 Note that hopefully these will be changed into something more pythonic
 """
 
-VERSION = "3.3.1"
+VERSION = "3.3.2"
 EPS = 1e-7
 
 # variable categories

{pulp-3.3.1 → pulp-3.3.2}/pulp/pulp.py

@@ -133,6 +133,7 @@ from time import time
 from typing import Any, Dict, Literal, Optional, Union, cast, overload
 
 from .apis import LpSolverDefault, PULP_CBC_CMD
+from .apis.coin_api import warn_pulp_cbc_cmd_deprecated
 from .apis.core import clock
 from .utilities import value
 from . import constants as const
@@ -151,19 +152,7 @@ except ImportError:
 
 import re
 
-V4_MIGRATION_WARNINGS = True
-
-
-def set_v4_migration_warnings(enabled: bool) -> None:
-    """Enable or disable PuLP 4.0 migration DeprecationWarnings (default: enabled)."""
-
-    global V4_MIGRATION_WARNINGS
-    V4_MIGRATION_WARNINGS = enabled
-
-
-def _v4_deprecation(message: str, stacklevel: int = 2) -> None:
-    if V4_MIGRATION_WARNINGS:
-        warnings.warn(message, category=DeprecationWarning, stacklevel=stacklevel)
+from .v4_migration import v4_deprecation as _v4_deprecation
 
 
 class LpElement:
@@ -2410,6 +2399,8 @@ class LpProblem:
             solver = self.solver
         if not (solver):
             solver = LpSolverDefault
+            if isinstance(solver, PULP_CBC_CMD):
+                warn_pulp_cbc_cmd_deprecated(stacklevel=3)
         wasNone, dummyVar = self.fixObjective()
         # time it
         self.startClock()
@@ -2452,6 +2443,8 @@ class LpProblem:
             solver = self.solver
         if not (solver):
             solver = LpSolverDefault
+            if isinstance(solver, PULP_CBC_CMD):
+                warn_pulp_cbc_cmd_deprecated(stacklevel=3)
         if not (absoluteTols):
             absoluteTols = [0] * len(objectives)
         if not (relativeTols):

{pulp-3.3.1 → pulp-3.3.2}/pulp/tests/test_pulp.py

@@ -10,6 +10,7 @@ import unittest
 import warnings
 from decimal import Decimal
 from typing import Union, Optional, Type
+from unittest.mock import patch
 
 
 from pulp import (
@@ -1342,7 +1343,7 @@ class BaseSolverTest:
             time_limit = 10
             solver_settings = dict(
                 PULP_CBC_CMD=30,
-                COIN_CMD=30,
+                COIN_CMD=20,
                 SCIP_PY=30,
                 SCIP_CMD=30,
                 GUROBI_CMD=50,
@@ -1901,6 +1902,11 @@ class BaseSolverTest:
 class PULP_CBC_CMDTest(BaseSolverTest.PuLPTest):
     solveInst = solvers.PULP_CBC_CMD
 
+    def setUp(self):
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore", DeprecationWarning)
+            super().setUp()
+
     @staticmethod
     def read_command_line_from_log_file(logPath):
         """
@@ -2534,6 +2540,49 @@ class PuLP4MigrationTests(unittest.TestCase):
             set_v4_migration_warnings(True)
 
 
+class PULP_CBC_CMDDeprecationTest(unittest.TestCase):
+    def test_pulp_cbc_cmd_deprecation_warns(self) -> None:
+        set_v4_migration_warnings(True)
+        try:
+            with self.assertWarns(DeprecationWarning):
+                solvers.PULP_CBC_CMD()
+        finally:
+            set_v4_migration_warnings(True)
+
+    def test_pulp_cbc_cmd_deprecation_respects_v4_flag(self) -> None:
+        set_v4_migration_warnings(False)
+        try:
+            with warnings.catch_warnings():
+                warnings.simplefilter("error", DeprecationWarning)
+                solvers.PULP_CBC_CMD()
+        finally:
+            set_v4_migration_warnings(True)
+
+    def test_pulp_cbc_cmd_skip_v4_deprecation(self) -> None:
+        set_v4_migration_warnings(True)
+        try:
+            with warnings.catch_warnings():
+                warnings.simplefilter("error", DeprecationWarning)
+                solvers.PULP_CBC_CMD(_skip_v4_deprecation=True)
+        finally:
+            set_v4_migration_warnings(True)
+
+    def test_solve_with_pulp_cbc_default_warns(self) -> None:
+        set_v4_migration_warnings(True)
+        default_solver = solvers.PULP_CBC_CMD(_skip_v4_deprecation=True)
+        prob = LpProblem("m")
+        prob.add_variable("x")
+        try:
+            with patch("pulp.pulp.LpSolverDefault", default_solver):
+                with patch.object(
+                    default_solver, "actualSolve", return_value=const.LpStatusOptimal
+                ):
+                    with self.assertWarns(DeprecationWarning):
+                        prob.solve()
+        finally:
+            set_v4_migration_warnings(True)
+
+
 def getSortedDict(prob, keyCons="name", keyVars="name"):
     _dict = prob.toDict()
     _dict["constraints"].sort(key=lambda v: v[keyCons])

pulp-3.3.2/pulp/v4_migration.py

@@ -0,0 +1,19 @@
+"""PuLP 4.0 migration deprecation warnings."""
+
+from __future__ import annotations
+
+import warnings
+
+V4_MIGRATION_WARNINGS = True
+
+
+def set_v4_migration_warnings(enabled: bool) -> None:
+    """Enable or disable PuLP 4.0 migration DeprecationWarnings (default: enabled)."""
+
+    global V4_MIGRATION_WARNINGS
+    V4_MIGRATION_WARNINGS = enabled
+
+
+def v4_deprecation(message: str, stacklevel: int = 2) -> None:
+    if V4_MIGRATION_WARNINGS:
+        warnings.warn(message, category=DeprecationWarning, stacklevel=stacklevel)

{pulp-3.3.1 → pulp-3.3.2}/pyproject.toml

@@ -9,7 +9,7 @@ authors = [
 ]
 maintainers= [{name= "Franco Peschiera", email= "pchtsp@gmail.com"}]
 dependencies = []
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 readme = "README.rst"
 license = "MIT"
 license-files = ["LICENSE"]
@@ -80,7 +80,7 @@ pulptest = "pulp.tests.run_tests:pulpTestAll"
 
 [tool.black]
 line-length = 88
-target-version = ['py37']
+target-version = ['py310']
 include = '\.pyi?$'
 exclude = '/(\.eggs|\.git|\.hg|\.mypy_cache|\.tox|\.venv|_build|buck-out|build|dist)/'
 
@@ -91,6 +91,7 @@ required-environments = [
 
 
 [project.optional-dependencies]
+cbc = ["cbcbox"]
 open_py = ["highspy==1.13", "pyscipopt"]
 public_py = ["gurobipy", "coptpy", 'xpress', "cplex; sys_platform != 'darwin' or python_full_version < '3.12'"]
 highs = ["highspy==1.13"]