Working with Files & the Filesystem in Python: Reference and Examples

Last updated:

WIP Alert This is a work in progress. Current information is correct but more content will probably be added in the future.

Manipulating filesystem paths is a very common need in most if not all applications; most problems can be solved using either os.path or pathlib modules.

Pathlib is used in some examples here; it comes by default with Python 3 but you can also use it in Python 2 via Pip: pip install pathlib

Write string to file

# will be overwritten if it already exists!
with open("filename.txt","w") as f:
    f.write("foo bar")

Relative to Absolute Path

Use os.path.abspath. But remember that the relative path is calculated with respect to your current working directory.

Note that this will not warn you if you supply a path that resolves to a file/dir that doesn't exist

If you want the relative path to be calculated with respect to the current file location, don't forget to prepend __file__+"/" to the relative path!

import os

# path is relative to the current WORKING directory!
abs_path = abspath("../../other-dir")

# path is relative to the directory where THIS file
# is located!
abs_path = abspath(__file__+"/"+"../../other-dir")

Get current working directory

The current working directory (or cwd) is the directory the user that first called the script was located.

import os


Get the directory where this (current) file is located

Note that this is not at all the same thing as the current working directory (seen above)

import os

# __file__ points to the where the current file is located

List all files in a directory

import os


To list all files recursively under some path (i.e. including subdirectories):

import os

# you may omit trailing slashes
# i.e. '/tmp' works too
path = '/tmp/'

for root, directories, filenames in os.walk(path):
    for directory in directories:
        # in python 3 print needs parens    
        print(os.path.join(root, directory))
    for filename in filenames:
        # in python 3 print needs parens

Read a file line-by-line, without loading it all to memory (buffered reading)

This is easy with python:

with open("path/to/file") as f:
    for line in f:
        # process the line

You can also use f.readline() to read a whole line (be careful if the file has no line breaks) or, which takes an argument indicating the maximum number of bytes to be read into memory.

For a CSV file:

import csv

with open("path/to/file") as f:
    reader = csv.reader(f)
    for line in reader:
        # line is an array of strings

See also

Dialogue & Discussion