Repository navigation
Describe transposed columns in unzip return types - #404
Merged
dgilland merged 2 commits intoNov 1, 2026
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Fixes #403.
Correct the four fixed-width tuple overloads of
unzipto describe the transposed columns. For example, three(int, str)rows produce an integer column and a string column of length three, so the result islist[tuple[int, ...] | tuple[str, ...]], rather thanlist[tuple[int, str]].unziptype expectation.Sequencevariable inzip_object_deepfor resolved columns. The corrected producer type exposes that columns can be tuples; this avoids assigning them back into the list-annotated input parameter. Its public signature and runtime behavior are unchanged.This does not change runtime transposition, tuple/list padding behavior, the generic fallback overload or
unzip_with's separate annotations.Validation
Windows / CPython 3.13.13:
6d33598, while their four runtime checks pass.git diff --check: passed.Other Python versions/platforms were not run locally. Hosted Main run 41269968401 passed on the submitted head: Python 3.10–3.14 and Finish Coveralls all succeeded.
Origin and assistance
Found by code inspection, not a production incident. Checked the current open PR inventory and all-state
unzipsearches, including the original #222 tuple API change, before reporting the distinct annotation problem.OpenAI Codex (GPT-6 family; exact deployment identifier unavailable) assisted with investigation, implementation and verification. The user requested independently useful, tested open-source fixes and explicit avoidance of duplicate contributions; no independent human review is claimed.