feat: Implement --annotation-style parameter for uv pip compile

[DrJackilD]

Summary

Hello there! The motivation for this feature is described here #1678

Test Plan

I've added unit tests and also tested this manually on my work project by comparing it to the original pip-compile output - it looks much like the pip-compile generated lock file.

[zanieb]

Thanks for contributing! Welcome to the project :)

I'm not entirely sure we want to accept more configuration here, I'll need to check with @charliermarsh.

It looks like the Windows snapshots are failing. We automatically filter out some Windows-only dependencies, but it's failing since they're not separated by a newline anymore. You'll need to adjust the regex at

uv/crates/uv/tests/common/mod.rs

Lines 261 to 264 in ad12d97

	let windows_only_deps = [
	("( [+-] )?colorama==\\d+(\\.[\\d+])+\n( # via .*\n)?"),
	("( [+-] )?tzdata==\\d+(\\.[\\d+])+\n( # via .*\n)?"),
	];

[DrJackilD]

@zanieb I hope you'll accept this one :) Regarding the tests - fixed!

[charliermarsh]

Can you walk me through line:24 here?

[DrJackilD]

Sure! I'm trying to keep the same logic, as pip-tools, to minimize the diff in the output file. The align 24 is something they use in the pip-tools as a reasonable number to align the annotation comments: https://github.com/jazzband/pip-tools/blob/main/piptools/writer.py#L318 and I agree with them. Most of the time annotation will be aligned except for some extra-long dependencies.

monotonic==1.6            # via analytics-python
oauthlib==2.1.0           # via pyproject.toml
opentelemetry-api==1.22.0  # via ddtrace
packaging==21.3           # via gunicorn, pyproject.toml
prompt-toolkit==3.0.43    # via click-repl
protobuf==4.25.3          # via ddsketch, ddtrace

[charliermarsh]

Ahh okay, thank you, perfect!

I'm wondering if we should just put more of this method within a match on the annotation style. I might find the logic easier to follow, but I'd need to see it to know for sure.

[DrJackilD]

Do you mean to extract annotation_line and annotation_split onto the match statement? I could do this, they're not very big, should be fine

[DrJackilD]

Yeah, you're right, it's easier to read without those function calls :)

[charliermarsh]

I'm happy to include this.

[DrJackilD]

I have no idea, why it's failing 🤔

UPD: Fixed 😊

[charliermarsh]

Will review and merge tonight, hopefully.

[charliermarsh]

@DrJackilD -- I just tweaked this to couple the presence of the comment and separator.

[charliermarsh]

Thank you! Great contribution.

[DrJackilD]

Thank you! Great contribution.

Thank you for accepting it so quick!