Release/3.0.0

[HungKNguyen]

Apply similar changes to PSPDFKit-labs/nutrient-dws-client-typescript#8

Cutting for release under v3.0

[nickwinder]

Quick pass. Worth answering my comment before I look again

[nickwinder]

Code review

Found 2 issues:

1. delete_pages() raises the wrong error when called with only negative indices (e.g., delete_pages(pdf, [-1])). The algorithm at line 1671 skips all negative indices with if delete_index >= 0, leaving page_ranges empty. The guard at line 1684 then also short-circuits because any(i >= 0 for i in delete_indices) is False, so no suffix range is appended. The result is that delete_pages(pdf, [-1]) raises ValidationError("You cannot delete all pages from a document") instead of deleting the last page. The docstring at line 1625 explicitly documents negative index support with the example [0, -1, -2].

nutrient-dws-client-python/src/nutrient_dws/client.py

Lines 1669 to 1692 in 211377e

	for delete_index in delete_indices:
	# Skip negative indices in this calculation - they represent "from end"
	if delete_index >= 0:
	if current_page < delete_index:
	page_ranges.append(
	normalize_page_params(
	{"start": current_page, "end": delete_index - 1}
	)
	)
	current_page = delete_index + 1
	# Add remaining pages to end (use -1 for last page) add if we have positive indices processed
	if (
	current_page >= 0
	and len(delete_indices) > 0
	and any(i >= 0 for i in delete_indices)
	):
	page_ranges.append(
	normalize_page_params({"start": current_page, "end": -1})
	)
	if len(page_ranges) == 0:
	raise ValidationError("You cannot delete all pages from a document")

2. rotate() drops all pages before the rotation range when start is negative. The check if start > 0 at line 1426 fails for negative values (e.g., start = -3), so the "pages before the rotation range" part is never added to the workflow. For a 10-page document, rotate(pdf, 90, {'start': -3, 'end': -1}) produces a 3-page PDF (only the rotated pages) instead of a 10-page PDF with the last 3 pages rotated. The docstring at line 1381 states the method returns "The entire document with specified pages rotated" and includes this exact negative-index pattern as an example.

nutrient-dws-client-python/src/nutrient_dws/client.py

Lines 1424 to 1435 in 211377e

	# Add pages before the rotation range
	if start > 0:
	part_options = cast(
	"FilePartOptions",
	{"pages": {"start": 0, "end": start - 1}},
	)
	workflow = workflow.add_file_part(pdf, part_options)
	# Add the rotation range
	part_options = cast(
	"FilePartOptions", {"pages": {"start": start, "end": end}}

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}