behave-pool 1.0.0__tar.gz

behave_pool-1.0.0/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.{yaml,yml,toml,json}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false

behave_pool-1.0.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,71 @@
+name: Bug report
+description: Report a bug or unexpected behavior
+title: "[bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to file a bug report!
+        Please fill out the information below to help us reproduce and fix the issue.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of the bug.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: |
+        Minimal steps to reproduce the behavior.
+        Include a feature file, step definitions, and the exact command you ran.
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: What actually happened. Include error output or logs if available.
+    validations:
+      required: true
+  - type: input
+    id: behave-version
+    attributes:
+      label: behave version
+      description: Output of `pip show behave | grep Version`
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      description: Output of `python --version`
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+    validations:
+      required: true
+  - type: textarea
+    id: config
+    attributes:
+      label: behave.ini or command line
+      description: Your behave configuration or the exact `behave` command you ran.
+    validations:
+      required: false

behave_pool-1.0.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/MathiasPaulenko/behave-pool/security/policy
+    about: Please report security vulnerabilities privately per SECURITY.md.
+  - name: Discussions
+    url: https://github.com/MathiasPaulenko/behave-pool/discussions
+    about: Ask questions and discuss ideas in GitHub Discussions.

behave_pool-1.0.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,31 @@
+name: Feature request
+description: Suggest a new feature or enhancement
+title: "[feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature!
+        Please describe what you'd like and why it would be useful.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this feature solve?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: What you'd like to see happen.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Any workarounds or alternative approaches you've considered.
+    validations:
+      required: false

behave_pool-1.0.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,20 @@
+## Summary
+
+<!-- Brief description of what this PR does -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation
+- [ ] Refactor
+
+## Checklist
+
+- [ ] `make check` passes (lint + format + test)
+- [ ] `make test-cov` passes with >= 90% coverage
+- [ ] New behavior is covered by tests
+- [ ] `CHANGELOG.md` updated under `[Unreleased]`
+- [ ] `mypy --strict` passes with no errors
+- [ ] Code of Conduct compliance reviewed

behave_pool-1.0.0/.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+      - python
+    groups:
+      dev-dependencies:
+        patterns:
+          - "pytest*"
+          - "ruff"
+          - "mypy"
+          - "build"
+          - "pre-commit"
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+      - github-actions

behave_pool-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,62 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - run: ruff format --check .
+      - run: mypy --strict behave_pool
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+        include:
+          - os: windows-latest
+            python-version: "3.13"
+          - os: macos-latest
+            python-version: "3.13"
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest tests/ -v --cov --cov-report=xml
+      - uses: codecov/codecov-action@v5
+        with:
+          files: ./coverage.xml
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

behave_pool-1.0.0/.github/workflows/docs.yml

@@ -0,0 +1,45 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build-deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install docs dependencies
+        run: pip install -e ".[docs]"
+
+      - name: Build site
+        run: mkdocs build --strict
+
+      - uses: actions/configure-pages@v5
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./site
+
+      - id: deployment
+        uses: actions/deploy-pages@v4

behave_pool-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,96 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "pyproject.toml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      bump: ${{ steps.version.outputs.bump }}
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Detect version bump
+        id: version
+        run: |
+          NEW_VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          echo "version=$NEW_VERSION" >> "$GITHUB_OUTPUT"
+          if git rev-parse "v$NEW_VERSION" >/dev/null 2>&1; then
+            echo "bump=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "bump=true" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Build distributions
+        if: steps.version.outputs.bump == 'true'
+        run: |
+          pip install build ruff mypy
+          ruff check .
+          ruff format --check .
+          mypy --strict behave_pool
+          python -m build
+      - uses: actions/upload-artifact@v4
+        if: steps.version.outputs.bump == 'true'
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI (Trusted Publishing)
+    needs: build
+    if: needs.build.outputs.bump == 'true'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  release:
+    name: Create GitHub Release
+    needs: [build, publish]
+    if: needs.build.outputs.bump == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - name: Create git tag
+        run: |
+          TAG="v${{ needs.build.outputs.version }}"
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "Tag $TAG already exists; skipping creation."
+          else
+            git tag "$TAG"
+            git push origin "$TAG"
+          fi
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2.3.2
+        with:
+          tag_name: "v${{ needs.build.outputs.version }}"
+          generate_release_notes: true
+          files: dist/*

behave_pool-1.0.0/.gitignore

@@ -0,0 +1,49 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+dist/
+dist_test/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Environment variables
+.env
+.env.*
+
+# Caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Type checking
+*.pyi.mypy-cache
+
+# Internal design specs
+ref/
+site/
+
+# IDE
+.idea/
+.vscode/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# behave-pool temp files
+.behave-pool-timing.json
+tmp/

behave_pool-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-added-large-files
+      - id: detect-private-key
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: [--check]
+      - id: ruff-format

behave_pool-1.0.0/CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-07-31
+
+### Added
+
+- Initial project setup: scaffold, CI/CD, pre-commit, MkDocs configuration.
+- `ParallelRunner` stub that delegates to standard Behave `Runner` (passthrough mode).
+- `TimingStore` for persisting historical work unit durations as JSON.
+- LPT (Longest Processing Time) load balancing via `--parallel-balance lpt|fifo`.
+- `--parallel-timing-file` CLI option for custom timing file path.
+- `@serial` tag support: two-phase dispatch (parallel then serial).
+- Behave runner entry point (`behave.runners`) for `--runner=` registration.
+
+### Fixed
+
+- `TimingStore.load()` now catches `TypeError` for non-numeric JSON values.
+- `TimingStore.save()` now uses atomic writes (temp file + rename) to prevent corruption.
+- `TimingStore.save()` narrowed `except Exception` to `except OSError`.
+- `WorkerRunner._write_report()` now reflects actual feature pass/fail status.
+- `WorkerRunner._write_report()` now catches all exceptions (not just `OSError`),
+  preventing non-serializable feature data from causing `TypeError` to propagate
+  and incorrectly marking a work unit as failed.
+- `WorkerRunner.run_work_unit()` now resets `self.aborted` before each work unit,
+  preventing silent feature skips in subsequent work units after a KeyboardInterrupt
+  or other abort in a previous work unit.
+- `WorkerRunner.teardown()` is now safe when `setup()` did not complete.
+- `WorkerRunner.run_work_unit()` now parses feature files from `WorkUnit.feature_path`
+  via `parse_features` before running, fixing zero-feature execution in workers.
+- `WorkerRunner.load_step_definitions()` now sets `self.step_registry` from the global
+  Behave step registry, fixing `feature.run()` crashes in worker processes.
+- `WorkerRunner._worker_run_loop()` now catches `EOFError`/`OSError` on closed task
+  queue and exits gracefully instead of crashing.
+- `WorkerRunner._worker_run_loop()` uses `task_queue.get(timeout=5)` instead of
+  blocking `get()` to allow periodic `stop_event` checks.
+- `ParallelRunner._dispatch()` skips launching parallel workers when batch is empty.
+- `ParallelRunner._dispatch()` sets `stop_event` for workers that exceed join timeout.
+- `ParallelRunner._dispatch()` skips serial phase when `stop_event` is set during
+  parallel phase, preventing infinite block.
+- `ParallelRunner._dispatch()` replaces `task_queue.join()` with `worker.join(timeout=300)`
+  and explicit queue drain, preventing deadlock when workers exit prematurely or hang indefinitely.
+  Workers that don't terminate within the timeout are now forcibly terminated via
+  `WorkerProcess.terminate()`.
+- `ParallelRunner._collect()` detects missing results from crashed workers and treats
+  them as failures.
+- `ParallelRunner._collect()` narrows `except` clause to `queue.Empty`/`EOFError`/`OSError`.
+- `ParallelRunner._dispatch()` now returns the list of actually dispatched work units.
+  `_run_parallel()` passes only dispatched units to `_collect()`, preventing false
+  "missing results" warnings and a 30-second wait for serial units that were never
+  enqueued when `stop_event` was set during the parallel phase.
+- `ParallelRunner._run_parallel()` cleans up queues in `finally` block.
+- `ConfigSnapshot` now includes `parallel`, `parallel_scheme`, `parallel_balance`,
+  `parallel_timing_file`, `dry_run`, and `use_nested_step_modules` fields.
+- `_make_config()` now sets all parallel-related fields from `ConfigSnapshot`.
+- Entry point group corrected from `behave.plugins` to `behave.runners` in
+  `pyproject.toml`.
+- `__init__.py` docstring corrected: feature-level parallelization, not scenario.
+- `config.py` help text corrected: removed stale scenario reference.
+- `iterator.py` error message corrected: removed stale F9 reference.
+- `_worker_run_loop()` now sets `stop_event` when a worker aborts, ensuring other
+  workers stop cooperatively and the coordinator skips the serial phase. Without
+  this, the aborted worker's sentinel remained in the queue and another worker
+  could consume it and exit early, leaving work units unprocessed.
+- Removed dead `TYPE_CHECKING` block in `work_unit.py`.
+- Added picklability regression tests for `WorkerResult` and `WorkUnit`, both
+  of which are sent through `multiprocessing.Queue` / `JoinableQueue` and must
+  survive pickle round-trips.
+- `ParallelRunner._collect()` now accepts a `deadline_seconds` parameter
+  (default 30s) so tests can exercise the missing-result path without waiting
+  the full 30-second deadline.
+- Added regression test verifying `WorkerRunner.run_work_unit()` catches
+  `parse_features` exceptions and returns a failed `WorkerResult` instead of
+  propagating.

behave_pool-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,135 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances
+  of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+**<mathias@paulenko.dev>**.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][mozilla-coc].
+
+For answers to common questions about this code of conduct, see the
+[FAQ][faq].
+
+The translation is available at
+[<https://www.contributor-covenant.org/translations/>][translations].
+
+[homepage]: <https://www.contributor-covenant.org>
+[v2.1]: <https://www.contributor-covenant.org/version/2/1/code_of_conduct.html>
+[mozilla-coc]: <https://www.mozilla.org/en-US/about/governance/policies/enforcement/>
+[faq]: <https://www.contributor-covenant.org/faq>
+[translations]: <https://www.contributor-covenant.org/translations>