Altcademy - a Forbes magazine logo Best Coding Bootcamp 2023

What is a directory in Python

Understanding Directories in Python

When you're starting to learn programming, it's like learning how to navigate a new city. In this new city, directories are like neighborhoods. Just as a neighborhood contains houses and buildings, a directory in Python contains files and other directories. In the simplest terms, a directory is a folder on your computer where you can store and organize your files.

What Exactly is a Directory?

Think of your computer's storage as a giant filing cabinet. Each drawer in that cabinet is like a directory. It's a way to keep related documents together in one place so you can find them easily later on. In Python, when we talk about directories, we're referring to these same "drawers" or folders on your computer.

How Python Interacts with Directories

Python, like a helpful assistant, has a built-in library called os that allows it to interact with the operating system. This means Python can create new directories, list the contents of directories, and even change which directory it's currently "looking at." Let's take a look at how this works with some actual code examples.

Creating a Directory

To create a new directory, you can use the os.mkdir() function. Here's how it works:

import os

# Create a new directory called 'new_directory'

This code tells Python to make a new folder in the current directory called 'new_directory'. If you run this code and then look in the folder where your Python script is, you should see a new folder with that name.

Listing Directory Contents

Just as you might open a drawer to see what's inside, you can ask Python to list the contents of a directory using the os.listdir() function:

import os

# List the contents of the current directory
contents = os.listdir('.')

The '.' is a special name that refers to the current directory (think of it as saying "here"). This code will print out a list of everything in the current directory.

Changing the Current Directory

Sometimes, you'll want to change which directory Python is "looking at." This is like walking from one neighborhood to another. You can do this with the os.chdir() function:

import os

# Change the current directory to 'new_directory'
print("Now in:", os.getcwd())

The os.getcwd() function tells you the current directory (like asking "where am I?"). After running this code, Python is now "inside" the 'new_directory' folder.

Why Use Directories in Python?

Organizing your files into directories is crucial when you're working on larger projects. Imagine if every house in a city was just plopped down randomly. It would be a nightmare to find anything! In programming, it's the same. Directories help you keep your code, data files, and other resources neat and manageable.

Dealing with Directories Safely

When you're working with directories, it's important to handle errors gracefully. For example, what if you try to create a directory that already exists? Or change into a directory that isn't there? Python will raise an exception, which is like an error message that tells you something went wrong.

Here's how you can handle these situations:

import os

# Try to create a directory and handle any errors
except FileExistsError:
    print("The directory already exists!")

# Try to change the current directory and handle any errors
except FileNotFoundError:
    print("The directory does not exist!")

Real-World Examples

Imagine you're writing a program that processes photos. You might have a directory for original photos and another for edited ones. With Python's directory-handling capabilities, you could write a script that automatically sorts photos into the right folders.

Analogies to Help Understand

If you're struggling to grasp the concept of directories, think about them as chapters in a book. Each chapter (directory) contains various sections (files and subdirectories). Just as a well-organized book is easier to read, well-organized directories make your programming life much easier.


As you embark on your programming journey, mastering the art of directory management in Python is like learning to navigate the streets of a new city. With the tools and examples provided, you're now equipped to create, explore, and organize the neighborhoods of your computer's storage. Just like a seasoned traveler, you'll be able to find your way through the complexities of file systems, turning the once daunting task into a familiar and manageable routine. So go ahead, start exploring and building, one directory at a time, and watch as your coding projects become as organized and welcoming as a well-planned cityscape.