Iteration with indexing

Avoids off-by-one errors when human-readable 1-based numbering is needed during iteration.

Processing log files where line numbers are needed for error messages; reading configuration files and reporting line numbers; any situation where you need a human‑readable index while iterating.

Common in scripts that read text files, data‑processing pipelines, command‑line tools, and test harnesses.

for index, item in enumerate(iterable, start=1):

for ... in enumerate(..., start=1):

index: int ≥ 1, item: any object, iterable: any iterable object

• open() for file handling
• if condition inside loop
• break/continue
• processing each line with strip() or split().

• Using range(len(iterable)) and accessing by index
• using enumerate without start=1 and adding 1 manually
• using itertools.count() with zip.

Forgetting that enumerate defaults to 0, producing zero-based indices when one-based were intended; writing `for i in enumerate(iterable, start=1):` without tuple unpacking, causing i to become a (index, item) tuple instead of separate variables; passing start as a positional argument before the iterable, which swaps the arguments and raises TypeError.

while loop with manual counter (i = 1; while ...: i += 1) – more verbose; using enumerate without start=1 when zero‑based indexing is fine.

Coming from languages where loops start at 1 (e.g., MATLAB, R): you might expect enumerate to start at 1 by default and forget to set start=1.

• enumerate
• range
• zip
• itertools.count

Do not use start=1 when the consumer expects zero-based indices (e.g., for list indexing or array positions) — the mismatch will cause incorrect lookups. The start parameter adds no runtime overhead; enumerate remains lazy regardless of start value. If downstream code needs the original zero-based position for slicing, you must subtract 1 from the counter, reintroducing the off-by-one risk you were trying to avoid.

Makes line numbers explicit and reduces off‑by‑one errors when reporting positions.

Like numbering the pages of a book starting from 1 instead of 0 — enumerate with start=1 gives you the page number humans expect.

Using start=1 yields 1‑based indices useful for line numbers; omitting start yields 0‑based indices.

for index, item in enumerate(itertools.islice(iterable, limit), start=1):