Creating Directories

In Python, you can use the os module's mkdir or makedirs functions to create directories. The mkdir function can only create a single-level directory, while makedirs can recursively create multi-level directories.

Using mkdir to Create a Directory

import os

directory_path = 'example/directory'

# Create the directory if it does not exist
if not os.path.exists(directory_path):
    os.mkdir(directory_path)

print(f"Directory '{directory_path}' has been created")

Using makedirs to Create Nested Directories

import os

nested_path = 'example/nested/directories'

# Recursively create directories if they do not exist
if not os.path.exists(nested_path):
    os.makedirs(nested_path)

print(f"Directory '{nested_path}' has been created")

Handling Exceptions During Directory Creation

In practical applications, you may need to handle failures due to insufficient permissions, invalid paths, or other issues. You can use a try-except block to catch and manage these exceptions.

import os

target_path = 'example/directory'

try:
    if not os.path.exists(target_path):
        os.makedirs(target_path)
    print(f"Directory '{target_path}' has been created")
except OSError as error:
    print(f"Error creating directory '{target_path}': {error}")

Creating Files

In Python, you can use the built-in open function to create files. If the file does not exist, open will automatically create it when data is written. You must specify the file mode, such as 'w' for write mode (overwrites existing files) or 'a' for append mode (adds data to the end of existing files).

Creating and Writing to a File

file_location = 'example/file.txt'

# Open file in write mode; creates file if it does not exist
with open(file_location, 'w') as file_handle:
    file_handle.write("This is some text content.")

print(f"File '{file_location}' has been created and written to")

Appending Content to a File

file_location = 'example/file.txt'

# Open file in append mode; creates file if it does not exist, otherwise appends
with open(file_location, 'a') as file_handle:
    file_handle.write("\nThis is appended text content.")

print(f"Content has been appended to file '{file_location}'")

Note: When creating files or directories, ensure you have sufficient permissions and that the specified path is valid. Operations may fail if the path contains illegal characters or exceeds the operating system's maximum depth.

Using Context Managers to Ensure Proper File Closure

In the examples above, we used the with statement to open files. This context manager automatically closes the file after the block executes, even if an exception occurs. This is a best practice to prevent files from remaining open when no longer needed.

Writing Binary Data to a File

In addition to text data, you can use the 'wb' mode of the open function to write binary data. This is useful for handling images, audio, or other non-text files.

binary_file_path = 'example/binary_file'
raw_data = b'\x00\x01\x02\x03'  # Example binary data

with open(binary_file_path, 'wb') as file_handle:
    file_handle.write(raw_data)

print(f"Binary file '{binary_file_path}' has been created and written to")

Reading File Content

While this article focuses on creating files and directories, understanding how to read file content is also important. You can use the 'r' mode of the open function to read file content.

file_location = 'example/file.txt'

try:
    with open(file_location, 'r') as file_handle:
        file_content = file_handle.read()
        print(f"Content of file '{file_location}':\n{file_content}")
except FileNotFoundError:
    print(f"File '{file_location}' does not exist")

Summary

Python provides extensive functionality for file and directory operations, allowing you to create, read, write, and delete files and directoreis. When writing code that involves these operations, ensure you handle potential exceptions appropriately and always use context managers to guarantee files are closed correctly when no longer needed.