Skip to main content

How to Check If a Path Is a Directory in Python

When working with file systems in Python, it is crucial to distinguish between files and directories. Attempting to open a directory as if it were a file can lead to errors (such as IsADirectoryError), and trying to list the contents of a file as if it were a directory will fail.

This guide explores the two primary methods to verify if a specific path points to a directory: the traditional os.path module and the modern, object-oriented pathlib module.

Understanding Files vs. Directories​

Before performing file operations (like reading text) or directory operations (like listing contents), you must verify the target type.

  • File: A container for data (e.g., text.txt, script.py).
  • Directory: A container for files and other directories (e.g., /home/user/projects).

If you try to open() a path that turns out to be a directory, Python will raise an exception. Therefore, checking the type beforehand is a defensive programming best practice.

Method 1: Using os.path.isdir() (Standard)​

The os.path module is the traditional way to handle file paths in Python. The isdir() function returns True if the path exists and is a directory. It returns False for files or non-existent paths.

import os

# Setup: Define paths (Assuming these exist in your environment)
dir_path = "my_directory"
file_path = "my_file.txt"
fake_path = "non_existent_folder"

# ✅ Correct: Check if path is a directory
if os.path.isdir(dir_path):
    print(f"'{dir_path}' is a directory.")
else:
    print(f"'{dir_path}' is NOT a directory.")

# Checking a file
if os.path.isdir(file_path):
    print(f"'{file_path}' is a directory.")
else:
    print(f"'{file_path}' is NOT a directory (it might be a file).")

# Checking a non-existent path
if os.path.isdir(fake_path):
    print(f"'{fake_path}' is a directory.")
else:
    print(f"'{fake_path}' is NOT a directory (does not exist).")

Output:

'my_directory' is a directory.
'my_file.txt' is NOT a directory (it might be a file).
'non_existent_folder' is NOT a directory (does not exist).
note

To check specifically if a path is a file, you can use os.path.isfile(path).

Method 2: Using pathlib.Path.is_dir() (Modern)​

Introduced in Python 3.4, pathlib offers an object-oriented approach to filesystem paths. It is generally preferred for new projects due to its readability and ease of use.

from pathlib import Path

# Create Path objects
dir_obj = Path("my_directory")
file_obj = Path("my_file.txt")

# ✅ Correct: Using the .is_dir() method
if dir_obj.is_dir():
    print(f"'{dir_obj}' is a directory.")

if file_obj.is_dir():
    print(f"'{file_obj}' is a directory.")
else:
    print(f"'{file_obj}' is NOT a directory.")

Output:

'my_directory' is a directory.
'my_file.txt' is NOT a directory.
tip

pathlib handles operating system differences (like \ vs / separators) automatically, making your code cross-platform compatible without extra effort.

Conclusion​

To determine if a path is a directory in Python:

  1. Use os.path.isdir(path) if you are working with legacy code or simple string paths.
  2. Use pathlib.Path(path).is_dir() for modern, readable, and robust file system interactions.

Both methods safely return False if the path points to a file or does not exist, preventing runtime errors during type verification.

Table of Contents