October PR sweep for 26.3.0 by mahmoud · Pull Request #609 · mahmoud/boltons

mahmoud · 2026-10-25T23:04:38Z

October PR sweep for 26.3.0: re-implements 94 fixes from #484–#604 (including folded author-closed #507, #514, #518, #528, #571, #580) in one commit per module, plus a CHANGELOG 26.3.0 section. The source PRs will be closed with a pointer here after this lands; this list is the credit record.

New API (minor bump): iterutils.chunked_filter (#491), isoparse timezone suffixes (#594), wraps(expected=[(name, default, kwonly)]) (#522), BarrelList.sort(key, reverse) (#550), BarrelList.index(start, stop) (#592).

Behavior changes: cached() now honors its documented scoped=True default, so functions sharing one cache no longer read each other's entries (#498); bytes2human picks the unit after rounding, so 1048575 renders as 1M (#525); parse_timedelta raises on non-empty unparseable text (#548).

Not folded: #486, #515, #521, #533, #547, #564, #578, #582, #583, #587, #595, #597, #603 (#514 is folded with #549) (reasons in each PR's close comment).

Changes

listutils: BarrelList pickle/copy via __reduce__ (listutils: fix BarrelList copy, deepcopy and pickle #596, @simpleqt)
listutils: BarrelList rich comparisons (Fix BarrelList comparisons to use partitioned contents #544, @rusetiq)
listutils: BarrelList __add__/__radd__ (Fix BarrelList concatenation losing stored items #540, @theman6660)
listutils: BarrelList remove() (Fix BarrelList.remove to use partitioned storage #538, @harbinresearcher)
listutils: BarrelList __imul__ (Fix BarrelList in-place repetition #532, @hansu650)
listutils: BarrelList clear() (Fix BarrelList.clear to remove stored items #530, @9Kun)
listutils: BarrelList extend(self) hang (Fix unbounded BarrelList self-extension #517, @hansu650)
listutils: BarrelList pop() argument validation (Validate BarrelList pop indices before removing items #575, @ac1982)
listutils: BarrelList stepped del_slice (Fix BarrelList slice deletion #549, @9Kun)
listutils: BarrelList stepped del_slice (Fix BarrelList slice deletion semantics #514, @Eric3-jp)
listutils: BarrelList.sort(key, reverse) (Support key and reverse in BarrelList.sort #550, @9Kun)
listutils: BarrelList.index(start, stop) (Support start and stop bounds in BarrelList.index #592, @lohitredddy)
setutils: IndexedSet tail cull leaves stale dead intervals (Fix IndexedSet indices after trimming a fragmented dead tail #577, @fallenmi)
setutils: IndexedSet.pop rejects non-int indexes (Fix IndexedSet.pop integer-index validation #535, @harbinresearcher)
setutils: multi-arg difference_update/intersection_update (Fix zero- and multi-input IndexedSet updates #494, @Gonghan-Princess)
setutils: iterator operands and symmetric_difference_update duplicates (Preserve set semantics for iterator operands and repeated XOR values #503, @rupayon123)
setutils: complement set & and &= mixed branches (Fix complement set intersection membership and in-place state #516, @hansu650)
setutils: complement set ^ and ^= mixed branches (Correct complement set symmetric differences #487, @a3ylf)
dictutils: OMD equality with (None, None) items (Distinguish trailing None entries in OrderedMultiDict equality #599, @FanWu-ai)
dictutils: OMD.update repeated new keys from iterables (Preserve repeated values in OrderedMultiDict iterable updates #531, @9Kun)
dictutils: OneToOne.update iterator input (Fix OneToOne updates from one-shot iterables #523, @9Kun)
dictutils: OneToOne |= keeps inverse in sync (Fix OneToOne in-place union invariants #537, @hansu650)
dictutils: ManyToMany.add validates value before creating key (Keep rejected ManyToMany additions from changing keys #601, @Gambit-Checkmate)
dictutils: ManyToMany copy/update no longer share sets (Keep ManyToMany updates independent of their source #526, @9Kun)
dictutils: ManyToMany.replace merges into existing key (Preserve relationships when ManyToMany replacement keys collide #528, @adiazpar)
urlutils: keep port 0 in authority (Preserve explicit port zero when serializing URLs #499, @rastagan-git)
urlutils: find_all_links drops rejected URLs when with_text=False (Fix filtered links leaking into URL-only results #588, @AryanRG)
urlutils: navigate keeps IPv6 family (Preserve address families when navigating URLs #589, @theman6660)
urlutils: navigate normalizes absolute destinations (Normalize absolute destinations in URL.navigate #489, @jackwalkerlabs)
urlutils: register_scheme clears stale classification (Replace previous scheme classification when registering URLs #574, @fhgffy)
cacheutils: cached() honors scoped=True (cached(): honor scoped=True so functions don't read each other's entries #498, @Str0k)
cacheutils: falsey on_miss callables honored in LRI/LRU (Honor false-valued on_miss callbacks in LRI and LRU #593, @Alex0AI)
cacheutils: cachedmethod bound/unbound calls share cache keys (Normalize cachedmethod keys for unbound calls #541, @theman6660)
cacheutils: LRI.copy preserves order, counts, on_miss (Preserve cache behavior and source state when copying #506, @rupayon123)
cacheutils: LRI/LRU |= respects max_size (Keep LRI and LRU caches consistent during in-place union #490, @jackwalkerlabs)
cacheutils: LRI.__eq__ against non-mappings (Fix cache equality with dictionaries and unrelated objects #580, @JunaidAhamed-7777)
cacheutils: ThresholdCounter uses ceil(1/threshold) (Preserve ThresholdCounter error bounds for nonreciprocal thresholds #598, @FanWu-ai)
queueutils: peek/pop docstrings say IndexError (docs(queueutils): document IndexError for empty reads #556, @xiehuanyi)
gcutils: get_all finds subtype instances (Include subclass instances in get_all searches #560, @xiehuanyi)
gcutils: GCToggler restores prior GC state and nests (Restore garbage collection state after nested contexts #559, @xiehuanyi)
typeutils: get_all_subclasses works on metaclasses (Support metaclasses in get_all_subclasses #505, @rupayon123)
debugutils: wrap_trace hook-suppressed raise returns None (Return None when a trace hook suppresses a method exception #584, @Harshil-1603)
tbutils: ParsedException parses 3.13+ multiline source blocks (Parse multiline source blocks in Python 3.13 tracebacks #520, @SAY-5)
excutils: ExceptionCauseMixin str() outside a handler (Render wrapped causes when no traceback was captured #562, @xiehuanyi)
ioutils: SpooledStringIO rollover keeps position after readline (Fix #581: SpooledStringIO.rollover() skips unread text after readline() #591, @RudraBhaskar9439)
ioutils: truncate leaves position unchanged (Preserve spooled stream positions during truncation #545, @harbinresearcher)
ioutils: SpooledStringIO seek SEEK_END direction (Correct SpooledStringIO end-relative seek offsets #543, @theman6660)
ioutils: SpooledBytesIO readline(0) (Honor explicit zero sizes in SpooledBytesIO.readline #542, @theman6660)
ioutils: SpooledStringIO len preserves position (Keep SpooledStringIO length queries from moving the cursor #527, @9Kun)
ioutils: MultiFileReader read(0)/read(-1)/seek(0) (Correct MultiFileReader read and rewind behavior #512, @rupayon123)
ioutils docs: SpooledStringIO example (docs(ioutils): use text streams in the StringIO example #555, @xiehuanyi)
jsonutils: reverse_iter_lines on text streams (Fix reverse line iteration over StringIO streams #488, @jokrasno)
jsonutils: reverse_iter_lines with leading blank lines (Fix reverse JSONL iteration with leading empty lines #536, @riottt)
jsonutils: JSONLIterator cur_byte_pos on text files (Fix JSONLIterator position queries on text streams #519, @theman6660)
socketutils: read_ns timeout for payload and comma (Apply netstring read timeouts to payload and terminator #602, @Ghoscro)
socketutils: recv_size(0) returns immediately (Return immediately for zero-length BufferedSocket reads #572, @Larry-Labs)
strutils: slugify/split_punct_ws backslash (Escape the punctuation class so slugify() actually strips backslash #492, @mathewOracle)
strutils: strip_ansi non-UTF-8 bytes (strip_ansi: decode bytes as latin-1 so non-UTF-8 (cp437/latin-1) input does not crash #501, @Sreekant13)
strutils: html2text trailing ampersand text (Preserve buffered trailing text in html2text #571, @FanWu-ai)
strutils: pluralize z endings (Fix pluralize for words ending in z #586, @Debasishhh)
strutils: gunzip_bytes multi-member gzip (Decode every member in concatenated gzip data #576, @ac1982)
strutils: MultiReplace keeps precompiled pattern flags (Retain compiled pattern flags in MultiReplace #567, @Gambit-Checkmate)
strutils: bytes2human rejects nan/inf (Reject non-finite nbytes in bytes2human #508, @Pitchfork-and-Torch)
strutils: bytes2human picks unit after rounding (Pick the bytes2human unit after rounding #525, @TheNetherWatcher)
mathutils: Bits rejects negative length (Reject negative explicit lengths in Bits #604, @boogu2005)
mathutils: Bits right shift past width (Keep Bits length non-negative after oversized right shifts #495, @Gonghan-Princess)
timeutils: isoparse timezone suffixes (Parse ISO 8601 timezones in isoparse #594, @Siddharth-singla)
timeutils: dt_to_timestamp uses utcoffset() for awareness (Determine datetime awareness from its UTC offset #568, @Gambit-Checkmate)
timeutils: parse_timedelta raises on unparseable text (Reject nonempty duration text without a time component #548, @harbinresearcher)
timeutils: daterange month-step day clamping (daterange: clamp month steps to the target month's last day (fixes #500) #546, @simpleqt)
timeutils: daterange month-step day clamping (Clamp day-of-month when a daterange step overflows into a shorter month #507, @afonsojanu)
funcutils: wraps keeps the positional-only marker (Preserve positional-only signatures in funcutils wrappers #511, @ZelinZhu-Richard)
funcutils: get_func honors an empty execdict (Preserve an explicitly supplied empty FunctionBuilder execution scope #590, @UmitGUL1)
funcutils: wraps expected kwonly triples (Allow wraps expected arguments to be keyword-only #522, @chessing234)
iterutils: remap namedtuples and range/memoryview (Fix remap crashing on namedtuples, ranges and memoryviews #585, @Debasishhh)
iterutils: chunk_ranges empty input and overlap validation (Fix empty and non-advancing chunk ranges #569, @ac1982)
iterutils: bucketize iterator src with list key (Accept source iterators when bucketize uses a key list #563, @xiehuanyi)
iterutils: redundant falsey callable key (Honor falsey callable keys in redundant #554, @Gambit-Checkmate)
iterutils: untyped_sorted calls key once per item (Evaluate untyped_sorted keys once per item #552, @Gambit-Checkmate)
iterutils: split negative maxsplit (Treat negative split limits as unlimited #502, @rupayon123)
iterutils: backoff fractional stop with zero start (Fix inferred backoff count for zero starts and fractional stops #496, @emme1t)
iterutils: new chunked_filter (Add chunked_filter for batch predicates #491, @vzer200)
statsutils: sorted measures no longer reorder data (Keep Stats.mode tie-breaking stable after sorted measures #534, @rioyu123)
statsutils: clear_cache resets is_sorted (Invalidate the presorted hint when clearing Stats caches #570, @ac1982)
statsutils: all-zero histogram counts (Fix histogram formatting for zero counts #529, @saime428)
tableutils: bottom metadata outside main table HTML (Render bottom metadata after the main HTML table #558, @xiehuanyi)
tableutils: iterator headers (Materialize table header iterables before reading rows #561, @xiehuanyi)
tableutils: headerless extend recalculates width (Recalculate headerless table width when extending rows #497, @vitalivo)
fileutils: FilePerms.from_int with zero leading groups (Preserve empty permission fields in FilePerms.from_int #484, @oyeong011)
fileutils: FilePerms clears field bits on reassignment (fileutils: fix FilePerms silently keeping revoked permission bits #518, @afonsojanu)
fileutils: iter_find_files depth with trailing separator (Fix iter_find_files depth with trailing path separators #485, @Yananix)
fileutils: AtomicSaver cleanup on flush/fsync/close failure (Clean up AtomicSaver after finalization failures #539, @harbinresearcher)
pathutils: shrinkuser when home is / (Shrink paths correctly when the user home is a filesystem root #504, @rupayon123)
namedutils: reject non-identifier alphanumeric names (Validate Python identifiers before generating named records #573, @xiehuanyi)
packaging: include docs/ in sdist (Include documentation sources in source distributions #557, @xiehuanyi)

Verification

Full local suite including doctests: 771 passed on CPython 3.14.7 and 3.9, 770 + 1 skip on 3.8 (baseline 678). No local 3.7; every module and test file parses with ast.parse(..., feature_version=(3, 7)), and posonly test functions are built via exec with a 3.8 skip, like the existing ones.
Every module still imports standalone (the docs conf.py imports them that way), and the Sphinx build succeeds with only pre-existing warnings.
Every commit on the branch passes the full suite on its own (checked in a scratch worktree).
Each new regression test fails against master (4e5faa3) and passes here; tests that were pinning buggy behavior (test_unscoped_cached_dec, the bytes2human 1024.0K case, the namedtuple remap TODO) were updated.
Ran the plan's behavior checks (pickle/copy/compare on BarrelList, IndexedSet/complement identities over a small universe, OMD/QueryParamDict mirrors, cache scoping, SpooledStringIO positions, reverse_iter_lines on bytes and text, isoparse offsets, URL navigation, remap namedtuples, and more): all hold.
uv build --sdist now includes docs/.

… and index(start, stop) (#596, #544, #540, #538, #532, #530, #517, #575, #549, #514, #550, #592)

…tor set ops, complement & and ^ (#577, #535, #494, #503, #516, #487)

…update/replace (#599, #531, #523, #537, #601, #526, #528)

…|=, eq, ThresholdCounter width (#498, #593, #541, #506, #490, #580, #598)

…ate, support metaclasses, fix suppressed raise (#560, #559, #505, #584)

…rsor, readline(0), MultiFileReader.read(0) (#591, #545, #543, #542, #527, #512, #555)

…r_lines, keep tell() usable in JSONLIterator (#488, #536, #519)

… payload (#602, #572)

…tail, z plurals, multi-member gunzip, MultiReplace flags, bytes2human (#492, #501, #571, #586, #576, #567, #508, #525)

…495)

…e timedeltas, month-end dateranges (#594, #568, #548, #546, #507)

…d keep IPv6 in navigate, reclassify re-registered schemes (#499, #588, #589, #489, #574)

…, accept kwonly expected triples (#511, #590, #522)

…ize, falsey keys, key-once untyped_sorted, negative maxsplit, fractional backoff; add chunked_filter (#585, #569, #563, #554, #552, #502, #496, #491)

…lear_cache, handle all-zero histograms (#534, #570, #529)

…n extend, close table before bottom metadata (#561, #497, #558)

…520)

…micSaver cleanup, root-home shrinkuser, non-identifier names; include docs in sdist (#484, #518, #485, #539, #504, #573, #557)

Workstream-Session-Id: 01a1743e-7af6-7000-999f-e3695b3279ef Workstream-Plan-Id: 2026-10-25-7167a83d96

mahmoud added 21 commits October 25, 2026 16:01

listutils: fix BarrelList list-compat methods; add sort(key, reverse)…

3fe7b94

… and index(start, stop) (#596, #544, #540, #538, #532, #530, #517, #575, #549, #514, #550, #592)

setutils: fix IndexedSet tail culling, pop index, multi-arg and itera…

40fffc5

…tor set ops, complement & and ^ (#577, #535, #494, #503, #516, #487)

dictutils: fix OMD eq/update, OneToOne update and |=, ManyToMany add/…

bbadc7a

…update/replace (#599, #531, #523, #537, #601, #526, #528)

cacheutils: honor scoped caching, falsey on_miss, method keys, copy, …

8408ab5

…|=, eq, ThresholdCounter width (#498, #593, #541, #506, #490, #580, #598)

queueutils: document IndexError from peek and pop on empty queues (#556)

2061906

gcutils, typeutils, debugutils: find subtype instances, restore GC st…

f898d8f

…ate, support metaclasses, fix suppressed raise (#560, #559, #505, #584)

ioutils: fix SpooledStringIO len/seek/rollover positions, truncate cu…

d885f05

…rsor, readline(0), MultiFileReader.read(0) (#591, #545, #543, #542, #527, #512, #555)

jsonutils: handle leading blank lines and text streams in reverse_ite…

e604f5a

…r_lines, keep tell() usable in JSONLIterator (#488, #536, #519)

socketutils: return early from recv_size(0), apply read_ns timeout to…

6e0ab7b

… payload (#602, #572)

strutils: fix backslash punctuation, non-UTF-8 strip_ansi, html2text …

f387b64

…tail, z plurals, multi-member gunzip, MultiReplace flags, bytes2human (#492, #501, #571, #586, #576, #567, #508, #525)

mathutils: reject negative Bits lengths and clamp right shifts (#604, #…

59bd0fb

…495)

timeutils: parse isoparse timezone suffixes, fix naive tzinfo, garbag…

1e6c795

…e timedeltas, month-end dateranges (#594, #568, #548, #546, #507)

urlutils: keep port 0, drop rejected links without text, normalize an…

9511902

…d keep IPv6 in navigate, reclassify re-registered schemes (#499, #588, #589, #489, #574)

funcutils: keep positional-only marker in wraps, honor empty execdict…

37ba6b2

…, accept kwonly expected triples (#511, #590, #522)

iterutils: fix remap namedtuples, chunk_ranges edges, iterator bucket…

6270b5e

…ize, falsey keys, key-once untyped_sorted, negative maxsplit, fractional backoff; add chunked_filter (#585, #569, #563, #554, #552, #502, #496, #491)

statsutils: keep data order for sorted measures, reset sort hint in c…

2873144

…lear_cache, handle all-zero histograms (#534, #570, #529)

tableutils: materialize iterator headers, rewiden headerless tables o…

76e9209

…n extend, close table before bottom metadata (#561, #497, #558)

tbutils: parse multiline source blocks from Python 3.13+ tracebacks (#…

69a1214

…520)

excutils: render causes wrapped outside an exception handler (#562)

2ecf547

fileutils, pathutils, namedutils: fix FilePerms bits, find depth, Ato…

922e7b2

…micSaver cleanup, root-home shrinkuser, non-identifier names; include docs in sdist (#484, #518, #485, #539, #504, #573, #557)

CHANGELOG: add 26.3.0 section for the October PR sweep

405a6b0

Workstream-Session-Id: 01a1743e-7af6-7000-999f-e3695b3279ef Workstream-Plan-Id: 2026-10-25-7167a83d96

mahmoud force-pushed the pr-sweep-oct26 branch from 89dabef to 405a6b0 Compare October 25, 2026 23:09

mahmoud merged commit fe1ce8b into master Oct 25, 2026
12 checks passed

mahmoud deleted the pr-sweep-oct26 branch October 25, 2026 23:11

ShahadatTest mentioned this pull request Oct 26, 2026

Handle leading inline flags in MultiReplace compiled patterns #627

Open

simpleqt mentioned this pull request Oct 26, 2026

dictutils: make OneToOne copyable and picklable #628

Open

This was referenced Oct 27, 2026

OneToOne.update consumes one-shot key/value pairs during validation #659

Open

Preserve one-shot pairs during OneToOne updates #661

Open

Initialize BarrelList without truth-testing iterable inputs #662

Open

ShahadatTest mentioned this pull request Oct 27, 2026

Return logical sizes from spooled stream truncation #663

Open

Gambit-Checkmate mentioned this pull request Oct 28, 2026

Validate buffered socket read lengths before consuming data #676

Open

UmitGUL1 mentioned this pull request Oct 28, 2026

Honor falsey callable options #678

Open

Sskift mentioned this pull request Nov 2, 2026

Keep shallow cache copies independent of their sources #715

Open

Gambit-Checkmate mentioned this pull request Nov 11, 2026

Preserve ManyToMany relationships across subclasses #760

Open

wjt150 mentioned this pull request Nov 11, 2026

find_all_links drops uppercase HTTPS links when filtering by scheme #761

Open

Navigation Menu

Repository navigation

October PR sweep for 26.3.0 - #609

October PR sweep for 26.3.0#609
mahmoud merged 21 commits into
masterfrom
pr-sweep-oct26

mahmoud commented Oct 25, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

mahmoud commented Oct 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Verification

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

mahmoud commented Oct 25, 2026 •

edited

Loading