Reading Files

Opening a text stream safely

A file is data stored outside the running program. Python's built-in open() creates a file object that gives code a way to interact with that data. For an ordinary text file, a focused reading pattern is with open("names.txt", encoding="utf-8") as file: then enter an indented block. The with statement makes the file object a context manager: when the block finishes, Python closes the file, even if the block exits because of an exception. Closing is not a decorative cleanup step. It ends the program's use of that resource and helps prevent later code from accidentally relying on an open handle. This lesson concentrates on reading; Writing Files covers changing file contents, and Exceptions covers how programs deliberately respond when a file cannot be opened.

Text is not raw bytes with a universal meaning. An encoding specifies how stored bytes represent characters. Python documentation notes that a default encoding can depend on the locale, so code that expects UTF-8 text should say encoding="utf-8" rather than silently depend on the machine's default. That is especially useful when a file contains names, accented characters, or symbols and the same code runs on different systems. In normal text reading, Python also translates common platform line endings into \n; code can therefore treat a line ending consistently without guessing which operating system created the file.

Three ways to obtain text

The method should fit the next operation. file.read() obtains the remaining contents as one string. It is convenient when a file is known to be small and the program truly needs the whole text at once—for example, checking whether one short configuration note contains a phrase. Calling it again at the end of the file returns an empty string because there is no remaining content.

file.readline() obtains one line at a time. Usually its returned string retains the trailing newline character. An empty string means end of file, whereas a blank line is normally "\n"; that distinction lets a loop tell an empty line apart from no more lines. A program using readline() directly must manage that repeated step itself.

For many text-processing tasks, the clearest form is direct iteration: for line in file:. A file object is iterable, so the loop requests successive lines without building a list of all lines first. The Python tutorial describes this as memory efficient and simple. It does not make a file magically small, but it means the program can process one line, discard or summarize it, and move to the next. If code needs to compare every line later, collecting lines may be appropriate; otherwise, iteration communicates that each line is handled as it arrives.

Position, transformations, and deliberate output

A file object has a current position. Reading advances that position, so read() followed by a loop over the same object will usually leave the loop with nothing to process. Choose one reading plan or reopen the file for a separate pass. Within a loop, line includes its newline when one was present in the source. line.rstrip("\n") is a deliberate way to remove that line ending while leaving other leading and trailing spaces alone. Plain strip() is broader and may remove meaningful spaces, so it should not be used automatically.

Consider a short attendee list with a deliberately blank line. Iteration can count nonblank names while preserving the distinction between a blank record and the end of the file. The program's output depends on three small choices: the context manager establishes the resource lifetime, encoding="utf-8" states how to decode text, and the loop reads one line at a time. This is a useful model for later data-processing code: make resource handling and transformations visible, and do not infer facts from data that have not been read.