Skip to content

Conversation

ansible-documentation-bot[bot]
Copy link
Contributor

No description provided.

@ansible-documentation-bot ansible-documentation-bot bot added no_backport This PR should not be backported. devel only. dependency_update PR to update pinned dependencies tooling This PR affects tooling (CI, pr_labeler, noxfile, linters, etc.) but not the docs builds themselves. labels Sep 21, 2025
# by the following command:
#
# pip-compile --allow-unsafe --output-file=tests/formatters.txt --strip-extras tests/formatters.in
# pip-compile --allow-unsafe --cert=None --client-cert=None --index-url=None --output-file=tests/formatters.txt --pip-args=None --strip-extras tests/formatters.in
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@webknjaz Hi, could you take a look at this please? I'm somewhat stumped why pip-compile seems to be explicitly disabling some configuration.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My guess is that a new release of pip-compile now puts all arguments into this command line, even the None ones. Whether this is a bug or a feature I don't know.

(The latest release of pip-tools is from July 2025, so I'm a bit curious why this didn't happen between then and now already...)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @felixfontein I was guessing the same but also saw that about the pip-tools release. And I didn't really see anything that would make pip-compile act differently.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is actually being generated by uv pip compile now, so you'd want to look at the uv changelog, but it any case, the changes to this header indeed seem inconsequential.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

stable-2.18's noxfile still runs pip-compile. It installs it with session.install("pip-tools >= 7", "pip < 24.3"), so there's no version locking as for newer branches.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm. I guess the constraints file that we're using applies to the docs-build packages so it seems like a hack to pin click there. Adding a new constraints file for the formatters and other checks seems like overkill.

I guess we can just merge these dep refreshes and ignore the broken check. It affects only stable-2.18 and stable-2.17 so we can keep an eye on it.

The next scheduled dep refresh probably won't fail this check again. We'd probably notice the pip-tools fix added when the check next fails. Hopefully that will remove the explicitly set config.

What do you think?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, given the responses here, I think that approach makes sense.

I created jazzband/pip-tools#2238.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Adding a new constraints file for the formatters and other checks seems like overkill.

I would disagree. You're commenting on a problem cause by insufficient pinning that would've been better reproducible/stable if the tool wad pinned.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I meant just for this specific case, as we're on the stable-2.18 branch. Although I take your point.

If we add a new constraints file it should first go on the devel branch. It seems wrong to me to introduce a constraints file in stable-2.18. However there is nothing to pin on devel. Should we just have an empty constrains file until we get to stable-2.18?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about just changing https://github.com/ansible/ansible-documentation/blob/stable-2.18/noxfile.py#L161 to

    session.install("pip-tools >= 7", "pip < 24.3", "click < 8.3.0")

for now?

For devel, stable-2.20, and stable-2.19, we already have tests/pip-compile.in and tests/pip-compile.txt, so there's nothing to do there. (They also use uv.)

@felixfontein
Copy link
Collaborator

I think you need to re-run the workflow so it pushes a new version of the lock files to this brnach.

@oraNod
Copy link
Contributor

oraNod commented Sep 30, 2025

I think you need to re-run the workflow so it pushes a new version of the lock files to this brnach.

Thanks, I did try that.

@felixfontein
Copy link
Collaborator

felixfontein commented Sep 30, 2025

I mean the workflow which pushes to this branch and creates the PR (https://github.com/ansible/ansible-documentation/actions/workflows/pip-compile-dev.yml), not the workflows that run when something has been pushed to this PR (these have been re-run by closing and re-opening).

@felixfontein
Copy link
Collaborator

@oraNod
Copy link
Contributor

oraNod commented Sep 30, 2025

Ah, thank you @felixfontein 🎉

@oraNod oraNod merged commit 7488615 into stable-2.18 Sep 30, 2025
11 checks passed
@oraNod oraNod deleted the pip-compile/stable-2.18/dev branch September 30, 2025 19:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dependency_update PR to update pinned dependencies no_backport This PR should not be backported. devel only. tooling This PR affects tooling (CI, pr_labeler, noxfile, linters, etc.) but not the docs builds themselves.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants