PuLP 0.1.0__tar.gz

pulp-0.1.0/.coin-or/projDesc.xml

@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?xml-stylesheet type = "text/xsl" href = "http://www.coin-or.org/projects/autoGen.xsl"?>
+<projectData xmlns="coin-or.org" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="coin-or.org http://www.coin-or.org/projects/autoGen.xsd">
+  <projectBasics>
+    <projectName>PuLP</projectName>
+    <projectDescription>
+  PuLP is an LP modeler written in python. PuLP can generate
+  MPS or LP files and call GLPK, COIN CLP/CBC, CPLEX, GUROBI
+  to solve linear problems.
+    </projectDescription>
+    <projectShortDescription>A Python library for modeling linear and integer programs.</projectShortDescription>
+    <projectManager>Stuart Mitchell </projectManager>
+    <projectHomePage>https://github.com/coin-or/Pulp</projectHomePage>
+    <projectLicense>MIT License</projectLicense>
+    <projectLicenseURL>http://www.opensource.org/licenses/mit-license.php</projectLicenseURL>
+    <coinLinkedProjects/>
+    <otherLinkedPackages>
+      <otherPackage>
+        <packageName>GLPK</packageName>
+        <packageURL>http://www.gnu.org/software/glpk/</packageURL>
+        <requiredOrOptional>Optional</requiredOrOptional>
+      </otherPackage>
+    </otherLinkedPackages>
+    <projectLanguage>python</projectLanguage>
+    <developmentStatus>
+      <activityStatus>Active</activityStatus>
+      <maturityLevel>3</maturityLevel>
+    </developmentStatus>
+    <testedPlatforms>
+      <platform>
+        <operatingSystem>Microsoft Windows</operatingSystem>
+        <compiler>python 2.5</compiler>
+      </platform>
+      <platform>
+        <operatingSystem>Microsoft Windows</operatingSystem>
+        <compiler>python 2.4</compiler>
+      </platform>
+      <platform>
+        <operatingSystem>Linux</operatingSystem>
+        <compiler>python 2.6</compiler>
+      </platform>
+      <platform>
+        <operatingSystem>Linux</operatingSystem>
+        <compiler>python 2.5</compiler>
+      </platform>
+      <platform>
+        <operatingSystem>Linux</operatingSystem>
+        <compiler>python 2.4</compiler>
+      </platform>
+    </testedPlatforms>
+    <projectCategories>
+      <category>Modeling systems</category>
+      <category>Optimization deterministic linear continuous</category>
+      <category>Optimization deterministic linear discrete</category>
+    </projectCategories>
+  </projectBasics>
+  <leftMenuLinks>
+    <documentation>https://coin-or.github.io/pulp/</documentation>
+    <sourceCodeDownload>https://github.com/coin-or/pulp</sourceCodeDownload>
+    <binaryDownload/>
+    <mailingList>https://github.com/coin-or/pulp/discussions</mailingList>
+  </leftMenuLinks>
+</projectData>

pulp-0.1.0/.cursor/rules/project-conventions.mdc

@@ -0,0 +1,36 @@
+---
+description: Core project conventions for PuLP development
+alwaysApply: true
+---
+
+# Project Conventions
+
+## Testing
+
+- Use `unittest` (not pytest) for writing and running unit tests.
+- Run tests via: `uv run python -m unittest discover -s pulp/tests`
+
+## Package Manager
+
+- Always use `uv` for dependency management, package installation, and running tools.
+- Do **not** manually activate the virtual environment; `uv run` handles it automatically.
+- Install packages: `uv pip install <package>`
+- Sync dependencies: `uv sync`
+- Build the project: `uv run maturin develop`
+
+## Linting and formatting
+
+- Use **ruff** for linting and formatting (not black).
+- Run: `uv run ruff check pulp` and `uv run ruff format pulp` (or `ruff format pulp --check` to only check).
+
+## Type checking
+
+- Use **ty** for type checking (not mypy or pyright).
+- Run type checks via: `uv run ty check pulp`
+
+## Rust / Cargo
+
+- Always run Cargo through **uv** (do not invoke `cargo` directly).
+- Check Rust code: `uv run cargo check`
+- Build: `uv run cargo build`
+- Other subcommands: `uv run cargo <subcommand>`

pulp-0.1.0/.cursor/rules/verify-after-changes.mdc

@@ -0,0 +1,14 @@
+---
+description: Run unit tests, ty, and ruff checks after every code change
+alwaysApply: true
+---
+
+# Verify After Every Change
+
+After making any code change to the repo, run all three checks before considering the task done:
+
+1. **Unit tests**: `uv run python -m unittest discover -s pulp/tests`
+2. **Type checking**: `uv run ty check pulp`
+3. **Linting and formatting**: `uv run ruff check pulp` and `uv run ruff format pulp --check`
+
+If any check fails, fix the issues before proceeding. If Rust source files (`src/`) were modified, run `uv run cargo check` and rebuild with `uv run maturin develop`.

pulp-0.1.0/.github/CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing
+
+When contributing to this repository, please first discuss the change you wish to make with the owners of this repository by creating an issue before making a change. 
+
+## Contributor License Agreement
+
+This project belongs to the [COIN-OR](coinor) community and thus follows its guidelines, listed [here](coinor_guidelines). 
+In order to sign the contribution agreement, we use [cla-assistant](_cla_assistant). When a new PR is created, a link will appear that asks the submitter to sign it virtually, in case the github user has not done so already. The only requisite is to have a github account. The link to pulp's CLA is [here](cla).
+
+## Pull Request Process
+
+1. Create a Fork of the project to your own repository.
+1. Create a Branch in your Fork.
+3. Do the changes in your Branch.
+3. Add a Test that checks the change you did. This is done by adding a test function to the test file: `pulp/tests/test_pulp.py` (the function needs to start with `test_`). 
+4. If you have added a new solver API, please provide instructions on how to obtain the solver and, in case it's a commercial solver, also how to get a test or academic license to test the API ourselves.
+5. Create some bigger problems in a separate file where you can time the solution process to see if you are making changes that are more efficient, also use CProfile can help.
+6. Create a Pull Request (PR) when you're done so we can review it.
+6. In case your contribution consists on new functionality, an update on the docs would also be appropriate.
+7. You will be kindly asked to sign a Contributor License Agreement by a COIN-OR sponsored bot before merging your changes.
+
+## Want to contribute but do not know where to start?
+
+Check the [Roadmap][roadmap] for the project to see what you can help with. We're always looking for more examples and better documentation. Or check the issues that have the "help wanted" or "bug" tag.
+
+### Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/
+[roadmap]: https://github.com/coin-or/pulp/projects/1
+[coinor]: https://www.coin-or.org/
+[coinor_guidelines]: https://www.coin-or.org/contributing/code/
+[cla]: https://cla-assistant.io/coin-or/pulp
+[_cla_assistant]: https://github.com/cla-assistant/cla-assistant

pulp-0.1.0/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: pchtsp

pulp-0.1.0/.github/ISSUE_TEMPLATE/Bug_report.md

@@ -0,0 +1,58 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+<!--
+Thanks for coming here to report a bug. :)
+
+Please describe it in the sections below, fill out the correct check boxes with an "x", replacing the space inside [ ], then click the "Submit new issue" button at the bottom
+-->
+
+Details for the issue
+--------------------
+
+#### What did you do?
+
+
+#### What did you expect to see?
+
+
+#### What did you see instead?
+
+
+Useful extra information
+-------------------------
+
+The info below often helps, please fill it out if you're able to. :)
+
+#### What operating system are you using?
+
+- [ ] Windows: ( _version:_ ___ )
+- [ ] Linux: ( _distro:_ ___ )
+- [ ] Mac OS: ( _version:_ ___ )
+- [ ] Other: ___
+
+#### I'm using python version:
+
+- [ ] 3.7
+- [ ] 3.8
+- [ ] 3.9
+- [ ] 3.10
+- [ ] 3.11
+- [ ] Other: ___
+
+#### I installed PuLP via:
+
+- [ ] pypi (python -m pip install pulp)
+- [ ] github (python -m pip install -U git+https://github.com/coin-or/pulp)
+- [ ] Other: ___ (conda?)
+
+#### Did you also
+
+- [ ] Tried out the latest github version: https://github.com/coin-or/pulp
+- [ ] Searched for an existing similar issue: https://github.com/coin-or/pulp/issues?utf8=%E2%9C%93&q=is%3Aissue%20

pulp-0.1.0/.github/ISSUE_TEMPLATE/Feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature Request
+about: Suggest an idea or request a new feature
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+<!-- Thanks for coming here to suggest a new feature. :) -->
+
+Describe the new feature
+--------------------------
+
+
+Additional info
+---------------
+Please answer these questions before submitting your feature request.
+
+#### Is your feature request related to an issue? Please include the issue number.
+
+
+#### Does this feature exist in another product or project? Please provide a link.
+

pulp-0.1.0/.github/ISSUE_TEMPLATE/Question.md

@@ -0,0 +1,21 @@
+---
+name: Question / help
+about: Ask a question related to this project or get support
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+<!--
+Thanks for coming here to ask a question. :)
+
+Before asking your question, please make sure you have:
+
+1. Visited the discussions page (https://github.com/coin-or/pulp/discussions). This is the official way of asking for help.
+2. Visited the pulp's google group archive (https://groups.google.com/forum/#!forum/pulp-or-discuss).
+
+-->
+
+What is your question
+-----------------------

pulp-0.1.0/.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions every week
+      interval: "weekly"

pulp-0.1.0/.github/workflows/CI.yml

@@ -0,0 +1,195 @@
+# Build wheels with maturin and publish to PyPI on tag push.
+# Generated from maturin generate-ci github, merged with Test PyPI + PyPI publish.
+# To refresh the build matrix, run: maturin generate-ci github
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    tags:
+      - '*'
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  linux:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+          - runner: ubuntu-22.04
+            target: s390x
+          - runner: ubuntu-22.04
+            target: ppc64le
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+          manylinux: auto
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-linux-${{ matrix.platform.target }}
+          path: dist
+
+  musllinux:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+          manylinux: musllinux_1_2
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-musllinux-${{ matrix.platform.target }}
+          path: dist
+
+  windows:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: windows-latest
+            target: x64
+            python_arch: x64
+          - runner: windows-latest
+            target: x86
+            python_arch: x86
+          - runner: windows-11-arm
+            target: aarch64
+            python_arch: arm64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.13
+          architecture: ${{ matrix.platform.python_arch }}
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-windows-${{ matrix.platform.target }}
+          path: dist
+
+  macos:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: macos-15-intel
+            target: x86_64
+          - runner: macos-latest
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-macos-${{ matrix.platform.target }}
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-sdist
+          path: dist
+
+  release:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/') || github.event_name == 'workflow_dispatch'
+    needs: [linux, musllinux, windows, macos, sdist]
+    permissions:
+      contents: read
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+      - name: Prepare dist directory
+        run: |
+          mkdir -p dist_all
+          if ls wheels-*/ 1>/dev/null 2>&1; then
+            for d in wheels-*/; do cp -a "$d"/* dist_all/ 2>/dev/null || true; done
+          else
+            cp -a *.whl *.tar.gz dist_all/ 2>/dev/null || true
+          fi
+          ls -la dist_all
+      - name: Publish to Test PyPI
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.test_pypi_password }}
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+          packages-dir: dist_all
+      - name: Publish to PyPI
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.pypi_password }}
+          skip-existing: true
+          packages-dir: dist_all

pulp-0.1.0/.github/workflows/build_docs.yml

@@ -0,0 +1,49 @@
+name: docs
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install uv and set the python version
+      uses: astral-sh/setup-uv@v7
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install Rust
+      uses: dtolnay/rust-toolchain@stable
+    - name: Install dependencies
+      run: uv sync --dev --all-extras
+    - name: Building docs
+      run: cd doc && uv run make html && cd ..
+    # Great extra actions to compose with:
+    # Publish built docs to gh-pages branch.
+    # ===============================
+    - name: Commit documentation changes
+      run: |
+        git clone https://github.com/coin-or/pulp.git --branch gh-pages --single-branch gh-pages
+        rm -rf gh-pages/*
+        cp -r doc/build/html/* gh-pages/
+        cd gh-pages
+        touch .nojekyll
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+        git add .
+        git commit -m "Update documentation" -a || true
+        # The above command will fail if no changes were present, so we ignore
+        # that.
+    - name: Push changes
+      uses: ad-m/github-push-action@master
+      with:
+        branch: gh-pages
+        directory: gh-pages
+        github_token: ${{ secrets.GH_TOKEN }}
+    # ===============================

pulp-0.1.0/.github/workflows/pythonpackage.yml

@@ -0,0 +1,56 @@
+name: Python package
+
+on: [push, pull_request, workflow_dispatch]
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      max-parallel: 21
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12']
+        os: [ubuntu-latest, macOS-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install uv and set the python version
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      - name: Lint and format
+        run: uv run ruff check pulp && uv run ruff format pulp --check
+      - name: Type Check
+        run: uv run ty check pulp
+      - name: install ubuntu-only solvers
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo apt update -qq
+          sudo apt install -qq glpk-utils
+      - name: Install highspy cmd
+        if: matrix.os == 'ubuntu-latest'
+        uses: supplypike/setup-bin@v5
+        with:
+          uri: 'https://github.com/JuliaBinaryWrappers/HiGHSstatic_jll.jl/releases/download/HiGHSstatic-v1.7.1%2B0/HiGHSstatic.v1.7.1.x86_64-linux-gnu-cxx11.tar.gz'
+          subPath: 'bin'
+          name: 'highs'
+          version: '1.7.1'
+      - name: Install SCIP_CMD
+        if: matrix.os == 'ubuntu-latest'
+        uses: supplypike/setup-bin@v5
+        with:
+          uri: 'https://www.scipopt.org/download/release/SCIPOptSuite-9.2.1-Linux-ubuntu24.deb'
+          name: 'SCIPOptSuite-9.2.1-Linux-ubuntu24.deb'
+          version: '9.2.1'
+          command: "sudo apt install -qq ./SCIPOptSuite-9.2.1-Linux-ubuntu24.deb"
+      - name: Install package
+        run: uv pip install -e .
+      - name: Test with pulptest
+        env:
+          PYTHONPATH: .
+        run: uv run --all-extras --no-extra mosek pulp/tests/run_tests.py

pulp-0.1.0/.gitignore

@@ -0,0 +1,72 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# virtualenv
+py-ve*
+
+#cloud9
+.c9
+
+#pycharm
+.idea/
+venv/
+
+# OR files
+*.lp
+*.mps
+*.mst
+*.sol

pulp-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,10 @@
+repos:
+-   repo: https://github.com/ambv/black
+    rev: stable
+    hooks:
+    - id: black
+-   repo: https://github.com/asottile/pyupgrade
+    rev: v3.1.0
+    hooks:
+    -   id: pyupgrade
+        args: [--py37-plus]

pulp-0.1.0/.vscode/tasks.json

@@ -0,0 +1,18 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Run unit tests",
+            "type": "shell",
+            "command": "uv run python -m unittest discover -s pulp/tests -v",
+            "group": {
+                "kind": "test",
+                "isDefault": true
+            },
+            "presentation": {
+                "reveal": "always",
+                "panel": "shared"
+            }
+        }
+    ]
+}

pulp-0.1.0/AUTHORS

@@ -0,0 +1,5 @@
+Roy, J.S
+Mitchell, Stuart A
+Christophe-Marie Duquesne (PYGLPK and YAPOSIB bindings)
+Franco Peschiera
+Antony Phillips