pytest-balance 0.1.0__tar.gz

pytest_balance-0.1.0/.commitlintrc.yml

@@ -0,0 +1,2 @@
+extends:
+  - "@commitlint/config-conventional"

pytest_balance-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,115 @@
+name: CI
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  commitlint:
+    name: Commit messages
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+      - uses: wagoid/commitlint-github-action@f133a0d95090ef2609192b4a21f54e20af819ea9 # v6
+
+  format:
+    name: Format
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+        with:
+          enable-cache: true
+      - run: uv sync
+      - run: uv run ruff format --check src tests
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+        with:
+          enable-cache: true
+      - run: uv sync
+      - run: uv run ruff check src tests
+
+  lock:
+    name: Lockfile
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+        with:
+          enable-cache: true
+      - run: uv lock --check
+
+  typecheck:
+    name: Typecheck
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+        with:
+          enable-cache: true
+      - run: uv sync
+      - run: uv run mypy src
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+        with:
+          enable-cache: true
+      - run: uv sync --python ${{ matrix.python-version }}
+      - run: uv run pytest --cov --cov-report=xml --tb=short
+        if: matrix.python-version == '3.14'
+      - run: uv run pytest --tb=short
+        if: matrix.python-version != '3.14'
+      - uses: codecov/codecov-action@75cd11691c0faa626561e295848008c8a7dddffe # v5
+        if: matrix.python-version == '3.14'
+        with:
+          files: coverage.xml
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
+
+  test-without-xdist:
+    name: Test (without xdist)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+        with:
+          enable-cache: true
+      - run: uv sync --no-group dev
+      - run: uv run pytest --tb=short -k "not test_xdist"

pytest_balance-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,115 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  ci-check:
+    name: CI Gate
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Verify tag matches package version
+        env:
+          TAG_REF: ${{ github.ref }}
+        run: |
+          TAG="${TAG_REF#refs/tags/v}"
+          PY_VER=$(python3 -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          echo "Tag: $TAG | pyproject: $PY_VER"
+          if [ "$TAG" != "$PY_VER" ]; then
+            echo "::error::Tag v$TAG does not match pyproject.toml version $PY_VER"
+            exit 1
+          fi
+
+      - run: uv sync
+      - run: uv run ruff format --check src tests
+      - run: uv run ruff check src tests
+      - run: uv run mypy src
+      - run: uv run pytest --tb=short
+
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+      - run: uv build
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: [build, ci-check]
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    environment: PyPI
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
+        with:
+          attestations: true
+
+  release:
+    name: GitHub Release
+    needs: [build, ci-check]
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          name: dist
+          path: dist/
+
+      - name: Generate checksums
+        run: |
+          cd dist
+          sha256sum * > SHA256SUMS
+
+      - name: Generate release notes
+        id: cliff
+        uses: orhun/git-cliff-action@c93ef52f3d0ddcdcc9bd5447d98d458a11cd4f72 # v4
+        with:
+          config: cliff.toml
+          args: --latest --strip header
+        env:
+          GITHUB_REPO: ${{ github.repository }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: softprops/action-gh-release@153bb8e04406b158c6c84fc1615b65b24149a1fe # v2
+        with:
+          body: ${{ steps.cliff.outputs.content }}
+          prerelease: ${{ contains(github.ref_name, 'a') || contains(github.ref_name, 'b') || contains(github.ref_name, 'rc') }}
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+            dist/SHA256SUMS

pytest_balance-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+
+# Tool caches (pytest, mypy, ruff)
+.cache/
+
+# Virtual environments
+.venv/
+
+# Duration store
+.balance/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+
+# Coverage
+.coverage
+
+# Review
+.full-review/
+
+# Ongoing documentation
+docs/

pytest_balance-0.1.0/CHANGELOG.md

@@ -0,0 +1,77 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2026-06-15
+
+### Added
+- **store:** Estimate from call-phase durations only
+- **store:** Dedup merged records per phase
+- **plugin:** Set outcome on recorded durations
+- **store:** Record test outcome in durations
+
+
+## [0.1.0a3] - 2026-06-10
+
+### Added
+- **cli:** Add --alpha to the standalone plan command
+- **cli:** Expose --balance-ema-alpha to the ema estimator
+- **cli:** Validate the EMA alpha range
+
+
+### Changed
+- **store:** Name the default EMA alpha constant
+
+
+## [0.1.0a2] - 2026-06-09
+
+### Added
+- **algorithms:** Add LPT compute_order
+- **xdist:** Record scheduling history for invariant diagnostics
+- **xdist:** Fail loud on scheduler bookkeeping invariant
+
+
+### Changed
+- **xdist:** Subclass WorkStealingScheduling
+
+
+## [0.1.0a1] - 2026-04-09
+
+### Added
+- Add release workflow, changelog config, and commit linting
+- **xdist:** Add duration-aware scheduler with work-stealing
+- Add plugin core with CI splitting and duration recording
+- Add post-run balance report
+- **ci:** Add duration-aware CI test splitter
+- **ci:** Add CI environment auto-detection
+- **store:** Add JSONL merger with dedup
+- **store:** Add JSONL reader with EMA/median/last estimation
+- **store:** Add JSONL duration writer
+- **algorithms:** Add scope-aware test partitioner
+- **algorithms:** Add LPT partitioning algorithm
+- **store:** Add TestDuration and DurationEstimate models
+- Initialize project scaffolding
+
+
+### Changed
+- Fix warnings, naming, and scheduler performance
+- Defer plugin imports to reduce pytest startup overhead
+- Stream JSONL reads to reduce memory usage
+
+
+### Fixed
+- **xdist:** Initialize numnodes from tx spec config
+- Correct README CI file patterns and sanitize run_id
+- Align build config and clean up project metadata
+- Address critical review findings
+
+
+
+[0.1.0]: https://github.com/ggueret/pytest-balance/compare/v0.1.0a3...v0.1.0
+
+[0.1.0a3]: https://github.com/ggueret/pytest-balance/compare/v0.1.0a2...v0.1.0a3
+
+[0.1.0a2]: https://github.com/ggueret/pytest-balance/compare/v0.1.0a1...v0.1.0a2
+
+[0.1.0a1]: https://github.com/ggueret/pytest-balance/tree/v0.1.0a1
+<!-- generated by git-cliff -->

pytest_balance-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geoffrey Guéret
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pytest_balance-0.1.0/Makefile

@@ -0,0 +1,28 @@
+.PHONY: install lint typecheck test format check all clean
+
+install:
+	uv sync
+
+lint:
+	uv run ruff check src tests
+
+typecheck:
+	uv run mypy src
+
+test:
+	uv run pytest
+
+format:
+	uv run ruff format src tests
+	uv run ruff check --fix src tests
+
+check:
+	uv run ruff format --check src tests
+	uv run ruff check src tests
+	uv run mypy src
+
+all: lint typecheck test
+
+clean:
+	rm -rf .cache .coverage htmlcov dist build *.egg-info
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true