Skip to content

Shorten the comments of the tests - #101

Merged
ml31415 merged 1 commit into
masterfrom
trim-test-comments
Oct 8, 2026
Merged

ml31415 merged 1 commit into
masterfrom
trim-test-comments

Conversation

@ml31415

@ml31415 ml31415 commented Oct 8, 2026

Copy link
Copy Markdown
Owner

Sixteen comment blocks of three or more lines - mostly in the tests of the complex input - are now of at most two lines, 63 lines of comment became 26.

Only comment lines changed (git diff contains no line that is not a comment), ruff and pre-commit are happy, the two issue links are kept.

What the long versions argued is not lost: the commits that added those tests carry it. What a reader needs to read the test with stayed in the comment - which value a wrong order would produce, that the extreme of a complex dtype is inf+infj and not inf+0j, why a nan value is built with complex() rather than by multiplying with 1j.

Two other branches are open in the meantime, both touch test_generic.py: #100 adds a test there (whose own comment I will shorten in that PR), and this one shortens comments around it. Whichever of the two lands second needs a rebase over a few lines of comment.

Sixteen comment blocks of three or more lines, mostly in the tests of the
complex input, are now of at most two lines: 63 lines of comment became 26.
What they said is not lost, it is in the commits that added them.

Only comment lines changed. The two issue links are kept, and so is every
number a trap test needs to be read with - which value a wrong order would
produce, what the extreme of a complex dtype is, why a nan value is built
with complex() rather than by multiplying with 1j.
@ml31415
ml31415 merged commit 77ccd17 into master Oct 8, 2026
10 checks passed
@ml31415
ml31415 deleted the trim-test-comments branch October 14, 2026 11:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant