I’m trying out the

adhoc_tool

for generating documentation with

pdoc

. pdoc needs the target distribution installed along with it’s deps (on top of pdoc itself) to work. pex_binary seemed to be a good way to do this, but Im probably misunderstanding how to configure this. Example:

python_requirement(
    name='pdoc_req',
    requirements=[
       'pdoc'
    ]
)

pex_binary(
    name='pdoc_sdk',
    dependencies=[
       ':pdoc_req',
       ':dist'
    ],
    entry_point='pdoc'
)

adhoc_tool(
    name="build-pdoc",
    runnable=":pdoc_sdk",
    args=["pdoc", "-d", "google", "-o", "docs/", "src/my_package/"],
    execution_dependencies=[":dist"],
    output_files=["docs"],
    root_output_directory=".",
)

run_shell_command(
     name="run-build-pdoc",
     command="ls {chroot}/docs",
     execution_dependencies=[":build-pdoc",],
)

Doing

./pants run my_package:run-build-pdoc

yields

Engine traceback:
  in `run` goal

ProcessExecutionFailure: Process 'the `adhoc_tool` at my_package:build-pdoc' failed with exit code 127.
stdout:

stderr:
env: python3.9: No such file or directory

:dist

is a

python_distribution

What version of pants are you using?

Trying 2.17

Does it work with 2.17.0.dev4? I vaguely recall some fixes that sounded similar going in recently

I'll give it a whirl

Do you have any custom plugins?

Nope, just standard ones. I can try disabling a bunch

The change that yanked that type is here: https://github.com/pantsbuild/pants/commit/1bced7cf2f918345f032c31f9ff3393784e6ece0 Not sure beyond that.

Commenting out toolchain plugin fixes this (I’m evaluating). is there a newer version i should use maybe? Was

0.25.0

Yup, looks like two newer releases: https://pypi.org/project/toolchain.pants.plugin/#history

All works now! Thanks for the guidance.