package-maximizer 0.20.0__tar.gz

package_maximizer-0.20.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,28 @@
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: dominicusin
+
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What went wrong?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Steps or minimal example
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: Package Maximizer version
+    validations:
+      required: true

package_maximizer-0.20.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,21 @@
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: dominicusin
+
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What problem does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: Why is this useful?
+    validations:
+      required: false

package_maximizer-0.20.0/.github/dependabot.yml

@@ -0,0 +1,12 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+    allow:
+      - dependency-type: direct
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly

package_maximizer-0.20.0/.github/pull_request_template.md

@@ -0,0 +1,25 @@
+name: Pull request
+about: Submit a change for review
+title: ''
+labels: ''
+assignees: dominicusin
+
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What changed and why?
+    validations:
+      required: true
+  - type: textarea
+    id: checks
+    attributes:
+      label: Checks
+      description: Confirm local verification
+      value: |
+        - [ ] make test passes
+        - [ ] flake8 critical check passes
+        - [ ] docs updated if behavior changed
+    validations:
+      required: true

package_maximizer-0.20.0/.github/release-template.md

@@ -0,0 +1,14 @@
+# GitHub release notes template.
+
+## What's changed
+
+- {Add a summary of user-facing changes}
+
+## Compatibility
+
+- {Breaking changes or migration notes, if any}
+
+## Verification
+
+- `make test`
+- Local CLI checks for affected commands

package_maximizer-0.20.0/.github/workflows/ci.yml

@@ -0,0 +1,200 @@
+name: Package Maximizer CI/CD
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+  release:
+    types: [ published ]
+
+env:
+  PYTHON_VERSION: "3.11"
+
+jobs:
+  # ─── Security checks ────────────────────────────────────────
+  security:
+    name: Security Audit
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python
+      uses: actions/setup-python@v7
+      with:
+        python-version: "3.11"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        pip install bandit safety
+
+    - name: Run Bandit security linter
+      run: |
+        bandit -r package_maximizer/ -ii -f json -o bandit-report.json || true
+        bandit -r package_maximizer/ -ii --severity-level medium
+
+    - name: Check for known vulnerabilities
+      run: safety check -r requirements.txt --full-report || true
+
+    - name: Upload security report
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: security-report
+        path: bandit-report.json
+
+  # ─── Linting ────────────────────────────────────────────────
+  lint:
+    name: Code Quality
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python
+      uses: actions/setup-python@v7
+      with:
+        python-version: "3.11"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements-dev.txt
+
+    - name: Lint with flake8 (critical only)
+      run: |
+        flake8 package_maximizer/ tests/ --count --select=E9,F63,F7,F82 --show-source --statistics
+
+    - name: Lint with flake8 (style, non-blocking)
+      run: |
+        flake8 package_maximizer/ tests/ --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+    # Blocking checks — no || true (CI must catch regressions)
+    # Safe: these commands have no user-controlled input
+    - name: Type check with mypy
+      run: mypy package_maximizer/core/ package_maximizer/solvers/ package_maximizer/adapters/ --ignore-missing-imports
+
+    - name: Check formatting with black
+      run: black --check package_maximizer/ tests/
+
+    - name: Check imports with isort
+      run: isort --check-only package_maximizer/ tests/
+
+  # ─── Tests across matrix ────────────────────────────────────
+  test:
+    name: Test (${{ matrix.os }}, Python ${{ matrix.python-version }})
+    needs: [security, lint]
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v7
+      with:
+        fetch-depth: 0
+        fetch-tags: true
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v7
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Cache pip packages
+      uses: actions/cache@v6
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements*.txt') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+
+    - name: Install system dependencies (Ubuntu)
+      if: matrix.os == 'ubuntu-latest'
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y gcc g++ libffi-dev
+
+    - name: Install Python dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        pip install -e ".[dev,web,solvers,tui]"
+        pip install pytest-xdist
+
+    - name: Run tests with pytest
+      env:
+        # Fatals coverage gate only where all heavy solvers build (ubuntu).
+        # On macOS/Windows ortools/pysat cannot always compile, so their
+        # modules stay uncovered and a hard gate would always fail there.
+        COV_FAIL_UNDER: ${{ matrix.os == 'ubuntu-latest' && '85' || '' }}
+      shell: bash
+      run: |
+        GATE_FLAG=""
+        if [ -n "$COV_FAIL_UNDER" ]; then
+          GATE_FLAG="--cov-fail-under=$COV_FAIL_UNDER"
+        fi
+        pytest tests/ -v --cov=package_maximizer --cov-report=xml --cov-report=term $GATE_FLAG --tb=short
+
+    - name: Upload coverage to Codecov
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
+      uses: codecov/codecov-action@v7
+      continue-on-error: true
+      with:
+        file: ./coverage.xml
+        flags: unittests
+        name: codecov-ubuntu-py311
+
+  # ─── Build package ─────────────────────────────────────────
+  build:
+    name: Build Distribution
+    runs-on: ubuntu-latest
+    needs: [test]
+    steps:
+    - uses: actions/checkout@v7
+      with:
+        fetch-depth: 0
+        fetch-tags: true
+
+    - name: Set up Python
+      uses: actions/setup-python@v7
+      with:
+        python-version: "3.11"
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Build package
+      run: python -m build
+
+    - name: Check package with twine
+      run: twine check dist/*
+
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+  # ─── Publish to PyPI ────────────────────────────────────────
+  publish:
+    name: Publish to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release' && github.event.action == 'published'
+    environment: production
+    permissions:
+      id-token: write
+
+    steps:
+    - uses: actions/download-artifact@v8
+      with:
+        name: dist
+        path: dist/
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

package_maximizer-0.20.0/.github/workflows/publish-test.yml

@@ -0,0 +1,40 @@
+name: Publish to TestPyPI
+
+on:
+  workflow_dispatch:
+
+permissions: {}
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with: {fetch-depth: 0, fetch-tags: true}
+      - uses: actions/setup-python@v7
+        with: {python-version: "3.11"}
+      - run: python -m pip install --upgrade build setuptools_scm
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-test
+          path: dist/
+
+  testpypi-publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/package-maximizer
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with: {name: dist-test, path: dist}
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@v1.14.2
+        with:
+          repository-url: https://test.pypi.org/legacy/
+        # Uses GitHub OIDC Trusted Publishing (permissions: id-token: write above).
+        # The TestPyPI project "package-maximizer" must have a trusted publisher configured.

package_maximizer-0.20.0/.github/workflows/publish.yml

@@ -0,0 +1,42 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions: {}
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with: {fetch-depth: 0, fetch-tags: true}
+      - uses: actions/setup-python@v7
+        with: {python-version: "3.11"}
+      - name: Install build tools
+        run: python -m pip install --upgrade build setuptools_scm
+      - name: Build sdist and wheel
+        run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  pypi-publish:
+    name: Upload to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/package-maximizer
+    permissions: {}
+    steps:
+      - uses: actions/download-artifact@v8
+        with: {name: dist, path: dist}
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.14.2
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

package_maximizer-0.20.0/.gitignore

@@ -0,0 +1,160 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.db
+*.sqlite
+benchmark_results/
+cache/
+logs/
+temp/
+optimization_results.db
+package_maximizer.log
+*.optimized.Dockerfile
+optimal_modules.sh

package_maximizer-0.20.0/.gitleaks.toml

@@ -0,0 +1,18 @@
+# .gitleaks.toml — Gitleaks secret-scan config for Package Maximizer.
+
+title = "gitleaks config for Package Maximizer"
+
+[extend]
+useDefault = true
+
+[allowlist]
+description = "Allowlist non-sensitive patterns in docs/tests/config"
+paths = [
+  '''^\.github/ISSUE_TEMPLATE/''',
+  '''^\.github/pull_request_template\.md$''',
+  '''^tests/''',
+  '''^docs/''',
+  '''^CHANGELOG\.md$''',
+  '''^CONTRIBUTING\.md$''',
+  '''^SECURITY\.md$''',
+]

package_maximizer-0.20.0/.readthedocs.yaml

@@ -0,0 +1,18 @@
+# .readthedocs.yaml — ReadTheDocs build configuration.
+# Docs are built from the /docs directory using Sphinx.
+
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+  commands:
+    - python -m pip install --upgrade pip
+    - python -m pip install -e ".[dev,web,tui]"
+    - python -m pip install sphinx sphinx-rtd-theme myst-parser
+    - sphinx-build -b html docs $READTHEDOCS_OUTPUT/html
+
+sphinx:
+  configuration: docs/conf.py