Python map(): Transform Readings and Understand Consumption

Start with a small, explicit task

Convert three synthetic readings by adding a calibration offset. Keep a trace of the values actually processed. Then pair those readings with only two offsets to expose the missing third pair. This is a small in-memory experiment; it makes no claim about real sensor calibration or measurement precision.

Run the complete example

This original example was checked with Python 3.12.14. Save it as python_map.py and run it with Python 3.12. It uses only the standard library. The assertions check the stated results.

seen = []
def adjust(reading):
    seen.append(reading)
    return reading + 2
readings = [10, 13, 16]
adjusted = map(adjust, readings)
assert seen == []
first = next(adjusted)
assert first == 12 and seen == [10]
remaining = list(adjusted)
assert remaining == [15, 18]
assert list(adjusted) == []
paired = list(map(lambda value, offset: value + offset,
                  readings, [1, 2]))
assert paired == [11, 15]
print(first, remaining)
print(seen)
print(paired)

Explain the result

Creating adjusted does not call adjust: the first assertion finds an empty trace. next requests one result and processes only 10. Converting the remainder to a list consumes the remaining readings. A second list conversion is empty because it asks the same exhausted iterator for more values; it does not replay the source.

The two-input call produces two sums rather than three because only two offsets exist. That behavior can be convenient for deliberate truncation, but it is a data-quality bug if every reading requires a corresponding offset. Validate the input contract or use an explicit strict pairing step when unequal lengths must be rejected.

Avoid these mistakes

Pass the callable itself, not the result of calling it without an item. Avoid hiding important side effects inside a transformation merely to save lines. A list comprehension may be easier to read when the operation is a short expression and you want a materialized result immediately.