pyfltr 3.23.2__tar.gz → 3.24.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.agents/skills/ssot/SKILL.md +2 -2
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.pre-commit-config.yaml +1 -1
- {pyfltr-3.23.2 → pyfltr-3.24.0}/Makefile +6 -2
- {pyfltr-3.23.2 → pyfltr-3.24.0}/PKG-INFO +1 -1
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/development/architecture.md +42 -4
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/configuration.md +3 -1
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/recommended.md +13 -5
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/usage.md +25 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/pipeline.py +57 -40
- pyfltr-3.24.0/pyfltr/command/execution_slot.py +199 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/stage_runner.py +77 -46
- pyfltr-3.24.0/pyfltr/file_lock.py +106 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/history.py +3 -3
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/state/archive.py +79 -36
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/state/cache.py +3 -3
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/state/retention.py +47 -23
- pyfltr-3.24.0/pyfltr/user_cache.py +32 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/parser_review/process_tree.py +19 -12
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/mcp_server_test.py +7 -13
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/mcp_transport_test.py +47 -32
- pyfltr-3.24.0/tests/command/execution_slot_test.py +158 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/process_test.py +23 -53
- pyfltr-3.24.0/tests/integration/archive_retention_test.py +123 -0
- pyfltr-3.24.0/tests/integration/concurrent_runs_helper.py +224 -0
- pyfltr-3.24.0/tests/integration/execution_slot_test.py +282 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/user_state_isolation_test.py +5 -3
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/state/archive_test.py +105 -21
- pyfltr-3.24.0/tests/user_cache_test.py +12 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.agents/skills/grep-replace/SKILL.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.agents/skills/implementation-test-constraints/SKILL.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.agents/skills/output-format/SKILL.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.agents/skills/pyfltr-add-tool/SKILL.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.agents/skills/tool-resolution/SKILL.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.claude/agents/error-parser-reviewer.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.claude/agents/tool-compat-checker.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.claude/rules/dogfooding.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.claude/rules/order.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.claude/rules/subprocess.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.claude/rules/targets.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.editorconfig +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.editorconfig-checker.json +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.gitattributes +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.github/workflows/audit.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.github/workflows/ci.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.github/workflows/docker-build.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.github/workflows/docs.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.github/workflows/release.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.gitignore +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.gitlab-ci.yml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.gitmessage +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.markdownlint-cli2.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.npmrc +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.python-version +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.textlintignore +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.textlintrc.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.vscode/extensions.json +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.vscode/settings.json +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/.yamllint.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/AGENTS.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/LICENSE +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/README.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/cliff.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docker/Dockerfile +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/.markdownlint-cli2.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/development/development.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/configuration-tools.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/custom-commands.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/getting-started.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/grep-replace.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/index.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/recommended-nonpython.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/guide/troubleshooting.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/docs/index.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/mise.lock +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/mise.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/mkdocs.yml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/__main__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/command_info.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/command_selection.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/config_subcmd.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/grep_replace_common.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/grep_subcmd.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/main.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/mcp_models.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/mcp_server.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/mcp_transport.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/mcp_worker.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/output_format.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/overrides.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/parser.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/replace_subcmd.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/runs.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/shell_completion.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/cli/subproject_config.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/colloquial/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/colloquial/__main__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/colloquial/check.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/colloquial/cli.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/colloquial/words.txt +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/colloquial/words_allow.txt +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/braces-3.0.3.patch +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/cache_policy.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/completion.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/core_.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/dispatcher.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/env.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/executor.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/glab.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/linter_fix.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/lychee.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/markdownlint_env.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/mise.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/only_failed.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/precommit.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/precommit_guidance.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/process.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/runner.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/slow_tests.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/snapshot.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/structured_output.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/subproject_loop.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/subprojects.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/targets.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/textlint_fix.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/tool_parallelism.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/tool_resolution.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/two_step/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/two_step/base.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/two_step/prettier.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/two_step/ruff.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/command/vitest.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/config/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/config/config.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/config/editing.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/config/model.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/config/operations.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/config/presets.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/config/selection.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/config/validation.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/diagnostics.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/adaptive.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/jsonl_records.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/matcher.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/operations.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/preview.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/replacer.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/scanner.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/text_render.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/transaction.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/grep_/types.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/link_checks.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/auxiliary.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/code_quality.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/diagnostics.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/formatters.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/github_annotations.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/jsonl.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/logging_.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/positions.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/render.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/sarif.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/output/ui.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/parsing/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/parsing/common.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/parsing/entry.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/parsing/native.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/parsing/pytest.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/parsing/tools.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/paths.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/rule_urls.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/run_options.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/state/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/state/only_failed.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/state/retry.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/state/runs.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/text/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/text/exclude_fence.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/text/fences.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/tools.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyfltr/warnings_.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/pyproject.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/check_distribution.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/check_doc_codeblocks.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/distribution_probe.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/parser_review/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/parser_review/__main__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/parser_review/collect.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/parser_review/compare.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/parser_review/parse_worker.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/parser_review/pytest_forms.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/scripts/parser_review/samples.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/command_info_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/command_selection_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/grep_subcmd_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/main_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/pipeline_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/replace_subcmd_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/runs_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/cli/shell_completion_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/colloquial/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/colloquial/check_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/colloquial/cli_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/cache_policy_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/completion_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/conftest.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/core_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/dispatcher_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/env_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/executor_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/glab_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/linter_fix_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/markdownlint_env_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/mise_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/only_failed_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/precommit_guidance_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/precommit_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/runner_helpers.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/runner_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/slow_tests_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/stage_runner_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/structured_output_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/subproject_loop_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/subprojects_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/targets_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/textlint_fix_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/tool_parallelism_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/tool_resolution_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/two_step/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/two_step/base_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/two_step/prettier_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/two_step/ruff_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/command/vitest_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/config/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/config/config_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/conftest.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/execution_request_helper.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/grep_/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/grep_/adaptive_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/grep_/history_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/grep_/matcher_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/grep_/preview_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/grep_/scanner_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/check_doc_codeblocks_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/cli_option_reference_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/documentation_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/external_paths_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/layers_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/llmstxt_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/lychee_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/module_imports_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/only_failed_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/output_format_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/parser_registration_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/parser_review_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/pipeline_always_targets_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/pipeline_config_files_warning_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/pipeline_fast_targets_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/pipeline_monorepo_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/precommit_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/relative_work_dir_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/replace_failure_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/smoke_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/status_consistency_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/integration/test_placement_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/output/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/output/code_quality_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/output/diagnostics_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/output/github_annotations_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/output/jsonl_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/output/positions_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/output/sarif_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/output/ui_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/parsing/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/parsing/common_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/parsing/data/pytest_runs.json +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/parsing/data/registered_outputs.json +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/parsing/entry_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/parsing/native_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/parsing/pytest_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/parsing/tools_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/paths_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/rule_urls_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/.editorconfig +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/.github/workflows/ci.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/Dockerfile +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/pyproject.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/sample.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/sample.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/sample.sh +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/sample.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/sample.txt +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/sample.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/basic/sample_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/pinact_workspace/.github/workflows/pinned.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/pinact_workspace/.github/workflows/unpinned.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/pinact_workspace/pyproject.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/pre_commit_workspace/.pre-commit-config.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/pre_commit_workspace/pyproject.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/pre_commit_workspace/sample.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/prek_workspace/.pre-commit-config.yaml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/prek_workspace/pyproject.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/prek_workspace/sample.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/textlint_workspace/package.json +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/textlint_workspace/pyproject.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/textlint_workspace/sample.md +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/ts_workspace/eslint.config.js +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/ts_workspace/package.json +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/ts_workspace/pyproject.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/ts_workspace/sample.test.ts +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/ts_workspace/sample.ts +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/ts_workspace/tsconfig.json +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/smoke_data/uv_sort_workspace/pyproject.toml +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/state/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/state/cache_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/state/only_failed_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/state/retry_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/text/__init__.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/text/exclude_fence_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/tests/warnings_test.py +0 -0
- {pyfltr-3.23.2 → pyfltr-3.24.0}/uv.lock +0 -0
|
@@ -5,7 +5,7 @@ description: >
|
|
|
5
5
|
内部リンクのアンカー方針・MkDocsのdocs_dir外参照禁止・規約適用ルール・モジュールパス参照追従・
|
|
6
6
|
SSOT俯瞰(連動更新先の一覧)・機能追加時の文書露出判断を集約する。
|
|
7
7
|
pyfltr/config/config.py・pyfltr/cli/output_format.py・pyfltr/command/runner.py・
|
|
8
|
-
pyfltr/command/mise.py・pyfltr/state/archive.py・pyfltr/state/cache.py・
|
|
8
|
+
pyfltr/command/mise.py・pyfltr/user_cache.py・pyfltr/state/archive.py・pyfltr/state/cache.py・
|
|
9
9
|
docs/guide/*.md・docs/development/*.md・mkdocs.yml・README.md・AGENTS.md・
|
|
10
10
|
.claude/skills/*/SKILL.md・.claude/rules/*.md を編集する際に使用する。
|
|
11
11
|
---
|
|
@@ -50,7 +50,7 @@ description: >
|
|
|
50
50
|
global優先キーの対象範囲(archive/cache系)
|
|
51
51
|
- `pyfltr/config/model.py`の`default_global_config_path`:
|
|
52
52
|
グローバル設定パスの解決ロジック
|
|
53
|
-
- `pyfltr/
|
|
53
|
+
- `pyfltr/user_cache.py`の`default_cache_root`:
|
|
54
54
|
キャッシュルートの解決ロジック
|
|
55
55
|
- `pyfltr/config/model.py`の`DEFAULT_CONFIG`と`pyfltr/tools.py`のツール定義:
|
|
56
56
|
設定キー体系・既定値・runner方針
|
|
@@ -27,7 +27,7 @@ repos:
|
|
|
27
27
|
- id: name-tests-test
|
|
28
28
|
# tests/smoke_data/ 配下は smoke テスト用の入力サンプル群。
|
|
29
29
|
# pytest対象はsmoke_test.py本体のみで、サンプル側は単独実行されないため命名規則の対象外とする。
|
|
30
|
-
exclude: ^tests/(smoke_data/|execution_request_helper\.py$|command/runner_helpers\.py$)
|
|
30
|
+
exclude: ^tests/(smoke_data/|execution_request_helper\.py$|command/runner_helpers\.py$|integration/concurrent_runs_helper\.py$)
|
|
31
31
|
- id: trailing-whitespace
|
|
32
32
|
|
|
33
33
|
- repo: local
|
|
@@ -59,14 +59,18 @@ update-docker-base:
|
|
|
59
59
|
cat "$$tmp" > docker/Dockerfile; rm -f "$$tmp"; \
|
|
60
60
|
grep -nxF "FROM $$image@$$digest AS base" docker/Dockerfile
|
|
61
61
|
|
|
62
|
+
# `format`と`test`は`UV_PYTHON`を外してpyfltrを起動する。`sync`の`--python`は後続のuv起動へ引き継がれず、
|
|
63
|
+
# `UV_PYTHON`を継承するとpyfltr本体と、pyfltrがPython系ツールを起動する`uv run`がその版で仮想環境を再作成するため。
|
|
64
|
+
# 外すと各`uv run`は`.python-version`の基準版を選び、`sync`がそろえた仮想環境をそのまま使う(uv 0.13.1で確認)。
|
|
65
|
+
|
|
62
66
|
# フォーマット + 軽量lint(開発時の手動実行用。自動修正あり)
|
|
63
67
|
# pyfltr fast は fix ステージを内蔵するため、以前の `pyfltr fix` に相当する自動修正も実行される
|
|
64
68
|
format: sync
|
|
65
|
-
uv run pyfltr fast
|
|
69
|
+
env --unset=UV_PYTHON uv run pyfltr fast
|
|
66
70
|
|
|
67
71
|
# 全チェック実行(これを通過すればコミット可能)
|
|
68
72
|
test: sync
|
|
69
|
-
uv run pyfltr run
|
|
73
|
+
env --unset=UV_PYTHON uv run pyfltr run
|
|
70
74
|
|
|
71
75
|
docs:
|
|
72
76
|
uv run mkdocs serve
|
|
@@ -34,9 +34,9 @@ fixステージが失敗した場合は、同じツールの通常ステージ
|
|
|
34
34
|
|
|
35
35
|
| 層 | 配置 | 責務 |
|
|
36
36
|
| --- | --- | --- |
|
|
37
|
-
| 汎用 | `text/`・`colloquial/`・`parsing/`とトップレベルモジュール | フェンス走査・口語表現の検出・診断解析、`tools.py`のツール定義、`diagnostics.py`の型、`rule_urls.py`のURL
|
|
37
|
+
| 汎用 | `text/`・`colloquial/`・`parsing/`とトップレベルモジュール | フェンス走査・口語表現の検出・診断解析、`tools.py`のツール定義、`diagnostics.py`の型、`rule_urls.py`のURL生成、パス・警告・実行オプション、`user_cache.py`のキャッシュルート解決、`file_lock.py`のプロセス間ロック |
|
|
38
38
|
| 設定 | `config/` | 読込・統合・検証・編集・選択・プリセット。組込みツールの値は`tools.py`から導出する |
|
|
39
|
-
| コマンド実行 | `command/` | 実行要求・振り分け・プロセス管理・runner解決・対象選定、`executor.py`と`stage_runner.py
|
|
39
|
+
| コマンド実行 | `command/` | 実行要求・振り分け・プロセス管理・runner解決・対象選定、`executor.py`と`stage_runner.py`の実行制御、`execution_slot.py`の実行枠、キャッシュ判定 |
|
|
40
40
|
| 出力 | `output/` | text・JSONL・SARIF・GitHub Annotations・GitLab Code Quality・TUI、診断表示・logger設定 |
|
|
41
41
|
| 保存 | `state/` | アーカイブとキャッシュの永続化・読取、run_id解決と再実行情報 |
|
|
42
42
|
| 検索と置換 | `grep_/` | 対象解決・走査・置換・履歴・適応的出力 |
|
|
@@ -117,6 +117,33 @@ subprocess起動は`subprocess.Popen`ベースに統一する。
|
|
|
117
117
|
`cli/pipeline.py`は直接実行し、`output/ui.py`は画面通知・中断・結果差し替えをコールバックで渡す。
|
|
118
118
|
Rich UIへの`call_from_thread`とlock取得の差は画面側に残し、ステージ処理の複製とarid抑止を除く。
|
|
119
119
|
|
|
120
|
+
### 検証の実行枠 {#execution-slot}
|
|
121
|
+
|
|
122
|
+
同一ホスト・同一OSアカウントで独立した検証がツールを実行する区間を、`command/execution_slot.py`の実行枠で同時に1つに限る。
|
|
123
|
+
一時領域の容量・inotify上限・CPUなどの共有資源は起動ごとの`jobs`では調停できず、
|
|
124
|
+
別worktree・別リポジトリ・MCPから起動した検証の並列数がホスト上で積み上がるためである。
|
|
125
|
+
|
|
126
|
+
- 保持区間は`command/stage_runner.py`の`run_stages`の全体(fix段の開始から並列段の完了と子プロセスの回収まで)とする。
|
|
127
|
+
CLI・TUI・MCP(要求ごとのworker)とcommit hookからの起動は、いずれもこの関数を通るため個別の接続を要しない。
|
|
128
|
+
対象ファイルの展開・設定解決・実行アーカイブの初期化は枠の外で先に進め、TUIの結果画面での入力待ちは枠の解放後になる。
|
|
129
|
+
外部ツールを起動する処理を新設・変更する場合も`run_stages`の内側で起動し、枠の外で長い処理や入力待ちを行わない
|
|
130
|
+
- 枠の内側では既存の`jobs`、ツール自身のworker数、サブプロジェクト分割をそのまま使う
|
|
131
|
+
- 保持者記録(pid・プロセス生成時刻・cwd)のプロセスが呼出元の祖先なら、取得せずに所有を継承する。
|
|
132
|
+
検証コマンドから起動した子のpyfltrやpytest経由のpyfltrが自己待機で止まらないようにするためであり、
|
|
133
|
+
環境変数を引き継がない子孫にも働くよう、祖先の判定はプロセスツリーで行う
|
|
134
|
+
- 同じプロセスの別スレッドは待つ。同じスレッドの入れ子は再入する
|
|
135
|
+
- 待機は一定間隔の再試行で行い、待機の開始時に`execution-slot`の警告を出力する。
|
|
136
|
+
TUIの協調停止は待機を止めて全コマンドをスキップ扱いにし、CLIのCtrl+Cは例外として伝播する。
|
|
137
|
+
例外で抜ける場合も起動中の子プロセスを停止してから枠を解放する
|
|
138
|
+
- ツールのtimeoutは枠の取得後のツール実行だけに働く
|
|
139
|
+
- ロックは`<キャッシュルート>/locks/`に置く。`PYFLTR_CACHE_DIR`で保存先を変えた実行どうしは別の枠になる。
|
|
140
|
+
保持者が強制終了した場合はOSがロックを解放する
|
|
141
|
+
- 公開する外部仕様は`pyfltr.command.execution_slot.hold`のPython APIだけとし、CLIオプション・設定キー・環境変数は設けない。
|
|
142
|
+
無効化の手段を設けると、起動数による積み上げの構造が残るためである。
|
|
143
|
+
pyfltr以外の検証を起動する呼出元(他のツールのスクリプトなど)は、このAPIで同じ枠を共有する
|
|
144
|
+
- `command`層から`state`層を参照できないため、キャッシュルートの解決は最上位の`user_cache.py`、
|
|
145
|
+
ロックの基本処理は最上位の`file_lock.py`が所有する
|
|
146
|
+
|
|
120
147
|
### ツール解決の失敗扱い
|
|
121
148
|
|
|
122
149
|
`bin-runner` / `js-runner`によるツール起動解決は、対象ファイル0件のときは省略する。
|
|
@@ -697,7 +724,9 @@ pyfltrは2系統のユーザーキャッシュ基盤を持つ。
|
|
|
697
724
|
利用者向けの設定キーは[設定項目](../guide/configuration.md)を、OS別の既定パスは
|
|
698
725
|
[トラブルシューティング](../guide/troubleshooting.md)を参照。
|
|
699
726
|
|
|
700
|
-
保存ルートは`platformdirs.user_cache_dir("pyfltr", appauthor=False)
|
|
727
|
+
保存ルートは`user_cache.py`の`default_cache_root`が`platformdirs.user_cache_dir("pyfltr", appauthor=False)`で解決し、
|
|
728
|
+
環境変数`PYFLTR_CACHE_DIR`で上書きできる。
|
|
729
|
+
置換履歴と[検証の実行枠](#execution-slot)のロックも同じルートの配下に置く。
|
|
701
730
|
プロジェクトローカルにキャッシュを生成しない方針を採用するのは、`.gitignore`運用の負担を増やさず、
|
|
702
731
|
複数プロジェクト横断での参照を可能にするため。
|
|
703
732
|
|
|
@@ -711,9 +740,18 @@ run_idにはULIDを採用する。タイムスタンプ由来で辞書順ソー
|
|
|
711
740
|
|
|
712
741
|
自動クリーンアップは世代数(`archive-max-runs`)・合計サイズ(`archive-max-size-mb`)・
|
|
713
742
|
保存期間(`archive-max-age-days`)の3軸で制御する。
|
|
714
|
-
|
|
743
|
+
いずれかの閾値を超過した時点で、基準時刻(完了したrunは`finished_at`、完了記録の無いrunは`started_at`)の古い順に削除する。
|
|
744
|
+
長い実行は完了した時点で最新の世代になり、終了後の参照に使える保持期間を持つ。
|
|
715
745
|
各設定値に0以下を指定すると対象の軸の自動削除が無効化される。
|
|
716
746
|
|
|
747
|
+
実行中のrunは`runs/<run_id>.lock`のロックを保持し、どの軸でも削除しない(世代数と合計サイズの計数には含める)。
|
|
748
|
+
ロックはrunディレクトリより先に取得し、`finalize_run`か、例外で抜けた場合の`release_run`で解放する。
|
|
749
|
+
保護の判定は保存側(`state/archive.py`)だけが行い、CLI・MCP・hook・TUIの呼出元は個別の保護を実装しない。
|
|
750
|
+
強制終了したrunはOSがロックを解放するため、保存済みの内容を参照できる状態のまま、保持上限で通常どおり回収される。
|
|
751
|
+
共通のクリーンアップ(`state/retention.py`)は稼働中判定と基準時刻を呼出元から受け取り、
|
|
752
|
+
置換履歴は従来どおりディレクトリ名の順と作成時刻で判定する。
|
|
753
|
+
変更前の版のpyfltrはロックを確認しないため、版が混在する環境ではその版のcleanupが実行中のrunを削除し得る。
|
|
754
|
+
|
|
717
755
|
書き込みはツール実行結果を受け取った直後の独立フックとして提供し、TUI・非TUI・
|
|
718
756
|
JSONL stdout有無のいずれでも発生する。
|
|
719
757
|
JSONL stdoutストリーミングとは独立した仕組みにすることで、どちらか一方を切り替えても他方が失われない。
|
|
@@ -198,7 +198,9 @@ pyfltr config list --all
|
|
|
198
198
|
- pre-commit-skip : SKIP環境変数に渡すhook IDの手動指定リスト(`pre-commit-auto-skip`と併用可能、既定: 空)
|
|
199
199
|
- prek-auto-skip : `.pre-commit-config.yaml`からpyfltr関連hookを自動検出してprekへ渡すSKIP環境変数に追加するか(既定: `true`)
|
|
200
200
|
- prek-skip : prekへ渡すSKIP環境変数のhook ID手動指定リスト(`prek-auto-skip`と併用可能、既定: 空)
|
|
201
|
-
- archive : 実行アーカイブの有効/無効(既定: `true`。`--no-archive
|
|
201
|
+
- archive : 実行アーカイブの有効/無効(既定: `true`。`--no-archive`で実行単位に無効化)。
|
|
202
|
+
続く`archive-max-runs`・`archive-max-size-mb`・`archive-max-age-days`の3軸による自動削除は、実行中のrunを削除しない。
|
|
203
|
+
完了したrunは完了時刻、完了記録の無いrun(強制終了したrunなど)は開始時刻の古い順に削除する
|
|
202
204
|
- archive-max-runs : 保存する最大世代数(既定: 100。0以下で世代軸の自動削除を無効化)
|
|
203
205
|
- archive-max-size-mb : アーカイブ全体の合計サイズ上限(既定: 1024 MB。0以下でサイズ軸の自動削除を無効化)
|
|
204
206
|
- archive-max-age-days : 保存期間の上限(日数。既定: 30。0以下で期間軸の自動削除を無効化)
|
|
@@ -523,7 +523,12 @@ Python系ツールは`python-runner`の既定値`uv`により`uv run`経由で
|
|
|
523
523
|
`uv run`の自動同期は、ロックファイルが選ばなくなったパッケージを仮想環境から除かない(uv 0.13.1で確認)。
|
|
524
524
|
このため検証の前に`uv sync`で仮想環境をロックファイルへ厳密に同期する。
|
|
525
525
|
`.python-version`で基準のPython版を指定するプロジェクトでは、その値を`--python`へ渡す。
|
|
526
|
-
環境変数`UV_PYTHON
|
|
526
|
+
環境変数`UV_PYTHON`などで別の版が指定された環境でも、同期は基準の版で仮想環境を再作成する。
|
|
527
|
+
|
|
528
|
+
`--python`の指定は同期だけに作用し、後続の`uvx pyfltr`と、pyfltrがPython系ツールを起動する`uv run`へは引き継がれない。
|
|
529
|
+
これらは`UV_PYTHON`を読んで版を選び直すため、別の版を継承したまま起動すると、同期済みの仮想環境をその版で再作成する。
|
|
530
|
+
そのため`format`と`test`は`env --unset=UV_PYTHON`で版の指定を外してpyfltrを起動する。
|
|
531
|
+
外すと後続の`uv run`は`.python-version`の基準版を選び、同期済みの仮想環境をそのまま使う(uv 0.13.1で確認)。
|
|
527
532
|
|
|
528
533
|
```makefile
|
|
529
534
|
export UV_FROZEN := 1
|
|
@@ -538,17 +543,18 @@ setup: sync
|
|
|
538
543
|
|
|
539
544
|
# フォーマット + 軽量lint(開発時の手動実行用。自動修正あり)
|
|
540
545
|
format: sync
|
|
541
|
-
uvx pyfltr fast
|
|
546
|
+
env --unset=UV_PYTHON uvx pyfltr fast
|
|
542
547
|
|
|
543
548
|
# 全チェック実行(これを通過すればコミット可能)
|
|
544
549
|
test: sync
|
|
545
|
-
uvx pyfltr run
|
|
550
|
+
env --unset=UV_PYTHON uvx pyfltr run
|
|
546
551
|
|
|
547
552
|
.PHONY: sync setup format test
|
|
548
553
|
```
|
|
549
554
|
|
|
550
555
|
dev依存にpyfltrを固定する運用では`UV_FROZEN`でlockfileを尊重しつつ、
|
|
551
556
|
同じ同期の後に`uv run pyfltr ...`を呼び出す形に置き換えることができる。
|
|
557
|
+
この形ではpyfltr本体を起動する`uv run`も`UV_PYTHON`を読むため、同じく`env --unset=UV_PYTHON`で版の指定を外す。
|
|
552
558
|
|
|
553
559
|
```makefile
|
|
554
560
|
export UV_FROZEN := 1
|
|
@@ -572,16 +578,18 @@ update:
|
|
|
572
578
|
|
|
573
579
|
# フォーマット + 軽量lint(開発時の手動実行用。自動修正あり)
|
|
574
580
|
format: sync
|
|
575
|
-
uv run pyfltr fast
|
|
581
|
+
env --unset=UV_PYTHON uv run pyfltr fast
|
|
576
582
|
|
|
577
583
|
# 全チェック実行(これを通過すればコミット可能)
|
|
578
584
|
test: sync
|
|
579
|
-
uv run pyfltr run
|
|
585
|
+
env --unset=UV_PYTHON uv run pyfltr run
|
|
580
586
|
|
|
581
587
|
.PHONY: help sync setup update format test
|
|
582
588
|
```
|
|
583
589
|
|
|
584
590
|
`.python-version`を置かないプロジェクトでは、`sync`ターゲットから`--python`の指定を除く。
|
|
591
|
+
この場合は同期が`UV_PYTHON`などの指定に従って版を選ぶ。
|
|
592
|
+
`format`と`test`の`env --unset=UV_PYTHON`はそのまま残せ、後続の`uv run`は同期済みの仮想環境の版を使い続ける(uv 0.13.1で確認)。
|
|
585
593
|
|
|
586
594
|
pre-commitのフックを導入済みの作業ツリーで`prek install`を実行すると、
|
|
587
595
|
既存のフックは`.git/hooks/pre-commit.legacy`へ退避され、以後のコミットではprekのフックと併せて実行される。
|
|
@@ -802,6 +802,31 @@ MCPを利用できず、エージェントがシェルコマンドを実行で
|
|
|
802
802
|
`--only-failed`は直前runのアーカイブから失敗ツール・失敗ファイルを自動抽出して再実行する。
|
|
803
803
|
直前runが無い・失敗ツールが無い・対象との交差が空の場合は終了コード0で成功終了する。
|
|
804
804
|
|
|
805
|
+
## 同時に起動した検証の待機 {#execution-slot}
|
|
806
|
+
|
|
807
|
+
同じホスト・同じOSアカウントで複数のpyfltrを起動すると、ツールを実行する区間は1つずつ順に進む。
|
|
808
|
+
この順番を管理する単位を実行枠と呼び、ツールを実行している間はその実行が実行枠を所有する。
|
|
809
|
+
別のworktree・リポジトリ・MCPサーバー・commit hookから起動した実行も同じ実行枠を共有する。
|
|
810
|
+
後から起動した実行は、対象ファイルの展開などを済ませてから先の実行の終了を待ち、待機の開始時に`execution-slot`の警告を出力する。
|
|
811
|
+
待機時間はツールのtimeoutに含まない。
|
|
812
|
+
|
|
813
|
+
- 待機をやめる場合は実行を中断する(端末ではCtrl+C、MCPでは要求の取り消し)。中断した実行はツールを実行せず、成功の結果を返さない
|
|
814
|
+
- 検証コマンドから起動した子のpyfltr(pytestから起動するpyfltrなど)は、親の実行が所有する実行枠を引き継いで待たずに実行する
|
|
815
|
+
- `PYFLTR_CACHE_DIR`で保存先を変えた実行どうしは待ち合わせない
|
|
816
|
+
|
|
817
|
+
pyfltr以外の検証を同じ実行枠で順に実行する場合は、Python APIの`pyfltr.command.execution_slot.hold`を使う。
|
|
818
|
+
|
|
819
|
+
```python
|
|
820
|
+
import subprocess
|
|
821
|
+
|
|
822
|
+
import pyfltr.command.execution_slot
|
|
823
|
+
|
|
824
|
+
with pyfltr.command.execution_slot.hold(label="my-check"):
|
|
825
|
+
subprocess.run(["my-check", "--all"], check=True)
|
|
826
|
+
```
|
|
827
|
+
|
|
828
|
+
`with`の内側が実行枠を所有する区間になる。内側で起動した子プロセスは、区間を抜ける前に終了させる。区間を抜けると次の実行がツールを実行し始めるためである。
|
|
829
|
+
|
|
805
830
|
## pre-commit・prekとの統合 {#precommit-integration}
|
|
806
831
|
|
|
807
832
|
pyfltrはpre-commit・prekのうち有効な方を内部で呼び出し、pre-commit・prekはpyfltrをフックとして呼び出す。
|
|
@@ -494,43 +494,60 @@ def _run_pipeline(
|
|
|
494
494
|
archive_store, run_id = _initialize_archive(
|
|
495
495
|
args, config, prepared.commands, prepared.all_files, start_cwd_path, archive_required=archive_required
|
|
496
496
|
)
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
497
|
+
base_ctx: pyfltr.command.core_.ExecutionBaseContext | None = None
|
|
498
|
+
try:
|
|
499
|
+
_log_runtime(start_cwd_path, run_id, launcher_prefix)
|
|
500
|
+
cache_store = _initialize_cache(args, config)
|
|
501
|
+
archive_hook = (
|
|
502
|
+
_make_archive_hook(archive_store, run_id, archive_required=archive_required)
|
|
503
|
+
if archive_store is not None and run_id is not None
|
|
504
|
+
else None
|
|
505
|
+
)
|
|
506
|
+
attach_retry_command = _make_attach_retry_command(
|
|
507
|
+
retry_args_template=retry_args_template,
|
|
508
|
+
launcher_prefix=launcher_prefix,
|
|
509
|
+
# 対象ファイルは実行起点相対で保持されるため、起動時のcwdではなく実行起点を基準に絶対化する。
|
|
510
|
+
target_base_cwd=str(start_cwd_path),
|
|
511
|
+
)
|
|
512
|
+
base_ctx = _prepare_execution_context(config, prepared, start_cwd_path, cache_store, run_id)
|
|
513
|
+
ctx = _prepare_run_output(
|
|
514
|
+
args,
|
|
515
|
+
formatter,
|
|
516
|
+
early_ctx,
|
|
517
|
+
prepared,
|
|
518
|
+
run_id,
|
|
519
|
+
launcher_prefix,
|
|
520
|
+
retry_args_template,
|
|
521
|
+
structured_stdout,
|
|
522
|
+
)
|
|
523
|
+
results, returncode, ctx = _execute_pipeline_commands(
|
|
524
|
+
args,
|
|
525
|
+
prepared.commands,
|
|
526
|
+
base_ctx,
|
|
527
|
+
formatter,
|
|
528
|
+
ctx,
|
|
529
|
+
archive_hook=archive_hook,
|
|
530
|
+
attach_retry_command=attach_retry_command,
|
|
531
|
+
only_failed_targets=prepared.only_failed_targets,
|
|
532
|
+
)
|
|
533
|
+
return _finish_pipeline(
|
|
534
|
+
args,
|
|
535
|
+
base_ctx,
|
|
536
|
+
formatter,
|
|
537
|
+
ctx,
|
|
538
|
+
results,
|
|
539
|
+
returncode,
|
|
540
|
+
archive_store,
|
|
541
|
+
prepared.unmet,
|
|
542
|
+
archive_required=archive_required,
|
|
543
|
+
)
|
|
544
|
+
finally:
|
|
545
|
+
# 例外(Ctrl+Cを含む)で抜けた経路でも一時ディレクトリと稼働中のロックを残さない。
|
|
546
|
+
# 正常終了ではロックを`finalize_run`が解放済みのため、`release_run`は何もしない。
|
|
547
|
+
if base_ctx is not None:
|
|
548
|
+
base_ctx.cleanup()
|
|
549
|
+
if archive_store is not None and run_id is not None:
|
|
550
|
+
archive_store.release_run(run_id)
|
|
534
551
|
|
|
535
552
|
|
|
536
553
|
def _initialize_output(
|
|
@@ -758,7 +775,7 @@ def _finish_pipeline(
|
|
|
758
775
|
*,
|
|
759
776
|
archive_required: bool = False,
|
|
760
777
|
) -> PipelineOutcome:
|
|
761
|
-
"""
|
|
778
|
+
"""完了判定・出力・アーカイブ保存を行う。一時資源の解放は呼出元の`finally`が行う。"""
|
|
762
779
|
# returncodeを先に確定させる (render_resultsに渡してJSONL summary.exitに埋めるため)
|
|
763
780
|
# TUIのCtrl+C協調停止は `run_commands_with_ui` から130 (SIGINT慣例) を返す。
|
|
764
781
|
# この場合は `calculate_returncode` で上書きせず、そのまま採用する。
|
|
@@ -789,8 +806,6 @@ def _finish_pipeline(
|
|
|
789
806
|
# pre-commit経由かつformatter自動修正発生時のMM状態ガイダンスを必要に応じて出力する。
|
|
790
807
|
_maybe_emit_precommit_guidance(results, structured_stdout=ctx.structured_stdout, quiet=ctx.quiet)
|
|
791
808
|
|
|
792
|
-
base_ctx.cleanup()
|
|
793
|
-
|
|
794
809
|
return PipelineOutcome(returncode, ctx.run_id, completion, tuple(results))
|
|
795
810
|
|
|
796
811
|
|
|
@@ -974,6 +989,8 @@ def _initialize_archive(
|
|
|
974
989
|
if removed:
|
|
975
990
|
logger.debug("archive: 自動削除で %d 件の古い run を削除", len(removed))
|
|
976
991
|
except OSError as e:
|
|
992
|
+
if archive_store is not None and run_id is not None:
|
|
993
|
+
archive_store.release_run(run_id)
|
|
977
994
|
pyfltr.warnings_.emit_warning(
|
|
978
995
|
source="archive",
|
|
979
996
|
message=(
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
"""検証の実行枠。
|
|
2
|
+
|
|
3
|
+
同一ホスト・同一OSアカウントで、独立した検証が外部ツールを実行する区間を同時に1つだけにする。
|
|
4
|
+
共有の一時領域・inotify上限・CPUなどの資源は起動ごとの並列設定(`jobs`など)では調停できず、
|
|
5
|
+
別worktree・別リポジトリ・MCPから起動した検証の並列数がホスト上で積み上がるためである。
|
|
6
|
+
|
|
7
|
+
pyfltrは`pyfltr.command.stage_runner.run_stages`の全区間を`hold`の内側で実行する。
|
|
8
|
+
CLI・TUI・MCPの全実行経路とcommit hookからの起動が同じ枠へ参加する。
|
|
9
|
+
pyfltr以外の検証を起動する呼出元(他のツールのスクリプトなど)も、同じ`hold`で枠を共有できる::
|
|
10
|
+
|
|
11
|
+
import pyfltr.command.execution_slot
|
|
12
|
+
|
|
13
|
+
with pyfltr.command.execution_slot.hold(label="my-check"):
|
|
14
|
+
subprocess.run([...], check=True)
|
|
15
|
+
|
|
16
|
+
取得規則:
|
|
17
|
+
|
|
18
|
+
- 同じスレッドが保持中なら入れ子として再入する
|
|
19
|
+
- 保持者記録のプロセスが呼出元プロセスの祖先なら、取得せずに所有を継承する。
|
|
20
|
+
検証コマンドから起動した子のpyfltr・pytest経由のpyfltr・API呼出が自己待機で止まらないようにするためである。
|
|
21
|
+
祖先の判定はpidとプロセス生成時刻で行い、環境変数を引き継がない子孫にも働く
|
|
22
|
+
- それ以外は保持者の解放まで`_POLL_INTERVAL`秒ごとに再試行して待つ。
|
|
23
|
+
同じプロセスの別スレッドも待つ(長寿命の呼出元が並行して受けた要求を順に実行するため)
|
|
24
|
+
|
|
25
|
+
ロックはユーザーキャッシュのルート(`pyfltr.user_cache.default_cache_root`)配下の`locks/`に置く。
|
|
26
|
+
`PYFLTR_CACHE_DIR`で保存先を変えた実行どうしは別の枠になる。
|
|
27
|
+
保持者が強制終了した場合はOSがロックを解放する。
|
|
28
|
+
"""
|
|
29
|
+
|
|
30
|
+
# psutilは実行枠の取得で初めて使う時に読み込む(PEP 810。Python 3.15未満では通常のimport)。
|
|
31
|
+
__lazy_modules__ = ["psutil"]
|
|
32
|
+
|
|
33
|
+
import collections.abc
|
|
34
|
+
import contextlib
|
|
35
|
+
import dataclasses
|
|
36
|
+
import datetime as dt
|
|
37
|
+
import json
|
|
38
|
+
import os
|
|
39
|
+
import pathlib
|
|
40
|
+
import threading
|
|
41
|
+
import time
|
|
42
|
+
import typing
|
|
43
|
+
|
|
44
|
+
import psutil
|
|
45
|
+
|
|
46
|
+
import pyfltr.file_lock
|
|
47
|
+
import pyfltr.user_cache
|
|
48
|
+
|
|
49
|
+
_LOCK_FILENAME = "execution.lock"
|
|
50
|
+
_OWNER_FILENAME = "execution.owner.json"
|
|
51
|
+
_POLL_INTERVAL = 0.2
|
|
52
|
+
"""待機中の再試行間隔(秒)。解放から次の取得までの遅れと、待機中の負荷の釣り合いで選ぶ。"""
|
|
53
|
+
_CREATE_TIME_TOLERANCE = 1.0
|
|
54
|
+
"""保持者記録とプロセスの生成時刻を同一とみなす差(秒)。pidの再利用を取り違えないための判定に使う。"""
|
|
55
|
+
|
|
56
|
+
_local = threading.local()
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
@dataclasses.dataclass(frozen=True)
|
|
60
|
+
class SlotOwner:
|
|
61
|
+
"""実行枠の保持者記録。"""
|
|
62
|
+
|
|
63
|
+
pid: int
|
|
64
|
+
create_time: float
|
|
65
|
+
cwd: str
|
|
66
|
+
acquired_at: str
|
|
67
|
+
label: str | None = None
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
class WaitAborted(Exception):
|
|
71
|
+
"""`should_abort`が真を返したため、実行枠を取得せずに待機を終えた。"""
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
def default_lock_dir() -> pathlib.Path:
|
|
75
|
+
"""実行枠のロックを置くディレクトリを返す。"""
|
|
76
|
+
return pyfltr.user_cache.default_cache_root() / "locks"
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
@contextlib.contextmanager
|
|
80
|
+
def hold(
|
|
81
|
+
*,
|
|
82
|
+
label: str | None = None,
|
|
83
|
+
should_abort: collections.abc.Callable[[], bool] | None = None,
|
|
84
|
+
on_wait: collections.abc.Callable[[SlotOwner | None], None] | None = None,
|
|
85
|
+
lock_dir: pathlib.Path | None = None,
|
|
86
|
+
) -> collections.abc.Generator[None, None, None]:
|
|
87
|
+
"""実行枠を所有する区間を開く。
|
|
88
|
+
|
|
89
|
+
Args:
|
|
90
|
+
label: 保持者記録へ残す任意の名前。待機する側の通知に使う。
|
|
91
|
+
should_abort: 待機中に再試行のたびに呼ぶ判定。真を返すと`WaitAborted`を送出する。
|
|
92
|
+
`KeyboardInterrupt`も待機を中断する。
|
|
93
|
+
on_wait: 待機を始めるときに1回だけ呼ぶ通知。保持者記録を読めない場合は`None`を渡す。
|
|
94
|
+
lock_dir: ロックを置くディレクトリ。省略時は`default_lock_dir()`。
|
|
95
|
+
|
|
96
|
+
区間の内側で起動した子プロセスは、区間を抜ける前に呼出元が終了・回収する。
|
|
97
|
+
回収前に抜けると、子プロセスの実行中に次の検証が始まる。
|
|
98
|
+
"""
|
|
99
|
+
if getattr(_local, "depth", 0):
|
|
100
|
+
_local.depth += 1
|
|
101
|
+
try:
|
|
102
|
+
yield
|
|
103
|
+
finally:
|
|
104
|
+
_local.depth -= 1
|
|
105
|
+
return
|
|
106
|
+
|
|
107
|
+
directory = lock_dir if lock_dir is not None else default_lock_dir()
|
|
108
|
+
lock = pyfltr.file_lock.FileLock(directory / _LOCK_FILENAME)
|
|
109
|
+
owner_path = directory / _OWNER_FILENAME
|
|
110
|
+
acquired = _acquire(lock, owner_path, label=label, should_abort=should_abort, on_wait=on_wait)
|
|
111
|
+
_local.depth = 1
|
|
112
|
+
try:
|
|
113
|
+
yield
|
|
114
|
+
finally:
|
|
115
|
+
_local.depth = 0
|
|
116
|
+
if acquired:
|
|
117
|
+
# 後続の取得者が記録を書く前に、子孫が古い記録で継承を判定しないよう、解放より先に空にする。
|
|
118
|
+
with contextlib.suppress(OSError):
|
|
119
|
+
owner_path.write_text("", encoding="utf-8")
|
|
120
|
+
lock.release()
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
def read_owner(lock_dir: pathlib.Path | None = None) -> SlotOwner | None:
|
|
124
|
+
"""現在の保持者記録を返す。保持者がいないか記録を読めない場合は`None`を返す。"""
|
|
125
|
+
directory = lock_dir if lock_dir is not None else default_lock_dir()
|
|
126
|
+
return _read_owner(directory / _OWNER_FILENAME)
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
def _acquire(
|
|
130
|
+
lock: pyfltr.file_lock.FileLock,
|
|
131
|
+
owner_path: pathlib.Path,
|
|
132
|
+
*,
|
|
133
|
+
label: str | None,
|
|
134
|
+
should_abort: collections.abc.Callable[[], bool] | None,
|
|
135
|
+
on_wait: collections.abc.Callable[[SlotOwner | None], None] | None,
|
|
136
|
+
) -> bool:
|
|
137
|
+
"""実行枠を取得して`True`を返す。祖先の所有を継承した場合は取得せず`False`を返す。"""
|
|
138
|
+
notified = False
|
|
139
|
+
while True:
|
|
140
|
+
if lock.try_acquire():
|
|
141
|
+
try:
|
|
142
|
+
_write_owner(owner_path, label)
|
|
143
|
+
except BaseException:
|
|
144
|
+
lock.release()
|
|
145
|
+
raise
|
|
146
|
+
return True
|
|
147
|
+
owner = _read_owner(owner_path)
|
|
148
|
+
if owner is not None and _is_ancestor(owner):
|
|
149
|
+
return False
|
|
150
|
+
if should_abort is not None and should_abort():
|
|
151
|
+
raise WaitAborted
|
|
152
|
+
if not notified:
|
|
153
|
+
notified = True
|
|
154
|
+
if on_wait is not None:
|
|
155
|
+
on_wait(owner)
|
|
156
|
+
time.sleep(_POLL_INTERVAL)
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
def _write_owner(owner_path: pathlib.Path, label: str | None) -> None:
|
|
160
|
+
current = psutil.Process()
|
|
161
|
+
owner = SlotOwner(
|
|
162
|
+
pid=current.pid,
|
|
163
|
+
create_time=current.create_time(),
|
|
164
|
+
cwd=os.getcwd(),
|
|
165
|
+
acquired_at=dt.datetime.now(dt.UTC).isoformat(),
|
|
166
|
+
label=label,
|
|
167
|
+
)
|
|
168
|
+
owner_path.write_text(json.dumps(dataclasses.asdict(owner), ensure_ascii=False), encoding="utf-8")
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
def _read_owner(owner_path: pathlib.Path) -> SlotOwner | None:
|
|
172
|
+
# 書込途中の記録は空か不完全なJSONとして読めるため、読めない記録は保持者不明として扱う。
|
|
173
|
+
try:
|
|
174
|
+
raw: typing.Any = json.loads(owner_path.read_text(encoding="utf-8"))
|
|
175
|
+
return SlotOwner(
|
|
176
|
+
pid=int(raw["pid"]),
|
|
177
|
+
create_time=float(raw["create_time"]),
|
|
178
|
+
cwd=str(raw["cwd"]),
|
|
179
|
+
acquired_at=str(raw["acquired_at"]),
|
|
180
|
+
label=None if raw.get("label") is None else str(raw["label"]),
|
|
181
|
+
)
|
|
182
|
+
except (OSError, ValueError, TypeError, KeyError, AttributeError):
|
|
183
|
+
return None
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
def _is_ancestor(owner: SlotOwner) -> bool:
|
|
187
|
+
"""保持者記録のプロセスが呼出元プロセスの祖先かを返す。"""
|
|
188
|
+
try:
|
|
189
|
+
parents = psutil.Process().parents()
|
|
190
|
+
except psutil.Error:
|
|
191
|
+
return False
|
|
192
|
+
for parent in parents:
|
|
193
|
+
if parent.pid != owner.pid:
|
|
194
|
+
continue
|
|
195
|
+
try:
|
|
196
|
+
return abs(parent.create_time() - owner.create_time) < _CREATE_TIME_TOLERANCE
|
|
197
|
+
except psutil.Error:
|
|
198
|
+
return False
|
|
199
|
+
return False
|