Allow e2e tests to use configurable executable

[asmacdo]

Summary

• Add DUCT_TEST_EXECUTABLES env var to configure which executable(s) the e2e tests use
• By default, tests run twice: once with duct and once with con-duct run
• External builds (e.g., PyInstaller) can override to test their executable

Usage

Default (tests both entry points):

pytest test/duct_main/test_e2e.py -v

External executable:

DUCT_TEST_EXECUTABLES="./dist/con-duct run" pytest test/duct_main/test_e2e.py -v

Test plan

Default test run (both entry points)

$ pytest test/duct_main/test_e2e.py::test_sanity -v
============================================= test session starts =============================================
platform linux -- Python 3.13.11, pytest-9.0.2, pluggy-1.6.0 -- /home/austin/.venvs/duct/bin/python
cachedir: .pytest_cache
rootdir: /home/austin/devel/duct
configfile: pyproject.toml (WARNING: ignoring pytest config in tox.ini!)
plugins: rerunfailures-16.1
collected 2 items                                                                                             

test/duct_main/test_e2e.py::test_sanity[duct] PASSED                                                    [ 50%]
test/duct_main/test_e2e.py::test_sanity[con-duct run] PASSED                                            [100%]

============================================== 2 passed in 0.93s ==============================================

PyInstaller executable test run

$ DUCT_TEST_EXECUTABLES="./linux-test-2 run" pytest test/duct_main/test_e2e.py::test_sanity -v
============================================= test session starts =============================================
platform linux -- Python 3.13.11, pytest-9.0.2, pluggy-1.6.0 -- /home/austin/.venvs/duct/bin/python
cachedir: .pytest_cache
rootdir: /home/austin/devel/duct
configfile: pyproject.toml (WARNING: ignoring pytest config in tox.ini!)
plugins: rerunfailures-16.1
collected 1 item                                                                                              

test/duct_main/test_e2e.py::test_sanity[./linux-test-2 run] PASSED                                      [100%]

============================================== 1 passed in 0.49s ==============================================

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR adds support for configurable executable testing in e2e tests through the DUCT_TEST_EXECUTABLES environment variable. By default, tests run with both duct and con-duct run entry points, and external builds (like PyInstaller) can override this to test their own executables.

Key changes:

• Introduced DUCT_TEST_EXECUTABLES environment variable for specifying test executables
• Created a pytest fixture duct_cmd that parametrizes tests across different executables
• Updated all e2e test functions to accept and use the duct_cmd fixture

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[asmacdo]

@CodyCBakerPhD ran against https://github.com/codycbakerphd/duct-releases/ and smoketests are green!

 duct  ~/devel/duct   configurable-e2e-executable ± DUCT_TEST_EXECUTABLES="./con-duct_v0.18.0_linux run" pytest test/duct_main/test_e2e.py -v             
============================================= test session starts =============================================
platform linux -- Python 3.13.11, pytest-9.0.2, pluggy-1.6.0 -- /home/austin/.venvs/duct/bin/python
cachedir: .pytest_cache
rootdir: /home/austin/devel/duct
configfile: pyproject.toml (WARNING: ignoring pytest config in tox.ini!)
plugins: rerunfailures-16.1
collected 17 items                                                                                            

test/duct_main/test_e2e.py::test_sanity[./con-duct_v0.18.0_linux run] PASSED                            [  5%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-1-plain] PASSED            [ 11%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-1-subshell] PASSED         [ 17%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-1-nohup] PASSED            [ 23%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-1-setsid] PASSED           [ 29%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-2-plain] PASSED            [ 35%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-2-subshell] PASSED         [ 41%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-2-nohup] PASSED            [ 47%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-2-setsid] PASSED           [ 52%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-10-plain] PASSED           [ 58%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-10-subshell] PASSED        [ 64%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-10-nohup] PASSED           [ 70%]
test/duct_main/test_e2e.py::test_spawn_children[./con-duct_v0.18.0_linux run-10-setsid] PASSED          [ 76%]
test/duct_main/test_e2e.py::test_session_modes[./con-duct_v0.18.0_linux run-new-session] PASSED         [ 82%]
test/duct_main/test_e2e.py::test_session_modes[./con-duct_v0.18.0_linux run-current-session] PASSED     [ 88%]
test/duct_main/test_e2e.py::test_session_mode_behavior_difference[./con-duct_v0.18.0_linux run] PASSED  [ 94%]
test/duct_main/test_e2e.py::test_logging_levels[./con-duct_v0.18.0_linux run] PASSED                    [100%]

============================================= 17 passed in 19.28s =============================================
 duct  ~/devel/duct   configurable-e2e-executable ± 

[CodyCBakerPhD]

Great to hear!

[github-actions]

🚀 PR was released in v0.20.0 🚀