Working with Current Directory

The operating system module allows you to query and modify the current working directory seamlessly across different platforms.

#!/usr/bin/env python3
import os

# Retrieve and display the current working directory
current_path = os.getcwd()
print(f"Current directory: {current_path}")

# Change to parent directory
result = os.chdir("..")
print(f"Change directory result: {result}")

# Navigate to root directory on Windows
result = os.chdir('c:\\')
print(f"After moving to C: drive: {os.getcwd()}")

# Change to a specific directory path
result = os.chdir(r'F:\development\projects\python\samples\data')
print(f"After custom path: {os.getcwd()}")

When executing these commands, the program outputs the current directory path, returns None for successful directory changes, and reflects the updated location after each navigation operation.

Directory Constants and Navigation

Python provides convenient constants representing common directory references used in path operations.

import os

# Display current directory marker
print(f"Current directory symbol: '{os.curdir}'")

# Display parent directory marker
print(f"Parent directory symbol: '{os.pardir}'")

The output shows the dot notation where . represents the current directory and .. indicates the parent directory in path hierarchies.

Creating and Removing Directories

The module offers multiple functions for directory management, from simple single-level creation to recursive multi-level directory structures.

import os

# Create nested directories recursively
print(os.makedirs(r'F:\data\output\results\subfolder'))

# Remove empty directories recursively
print(os.removedirs(r'F:\data\output\results\subfolder'))

# Create a single directory in current location
os.mkdir('sample_folder')
print("Directory created successfully")

# Remove a single directory from current location
os.rmdir('sample_folder')
print("Directory removed successfully")

# List all items in current directory
contents = os.listdir()
print(f"Directory contents: {contents}")

The makedirs() function creates all intermediate directories in the path, while removedirs() removes empty parent directories in sequence. Single-level operations use mkdir() and rmdir() for direct children of the current directory.

System Path Separators

Understanding platform-specific separators is crucial for writing portable code that works across different operating systems.

import os

# Path separator (platform-specific)
print(f"Path separator: '{os.sep}'")

# Line separator (platform-specific)
print(f"Line separator: '{repr(os.linesep)}'")

# Environment variable separator (platform-specific)
print(f"Path separator for env vars: '{os.pathsep}'")

On Windows systems, the path separator is backslash (\), while Unix-based systems use forward slash (/). The environment variable separator differs aswell—semicolon on Windows versus colon on Unix systems.

Environment Variables

Accessing system environment variables allows your application to adapt to different runtime configurations.

import os

# Access all environment variables
enviro = os.environ
print(f"Environment variables dictionary contains {len(enviro)} entries")

# Retrieve specific environment variable
python_path = os.environ.get('PYTHONPATH', 'Not set')
print(f"PYTHONPATH: {python_path[:80]}...")

# Check operating system type
system_name = os.name
print(f"Operating system: {system_name}")

The environ dictionary provides read-write access to environment variables. The os.name returns 'nt' for Windows and 'posix' for Unix-like systems including Linux and macOS.

Path Manipulation Functions

The os.path submodule provides extensive utilities for path analysis and manipulation without actually accessing the filesystem.

import os

# Get absolute path from relative path
file_path = os.path.abspath('document.txt')
print(f"Absolute path: {file_path}")

# Split path into directory and filename components
full_path = r'F:\development\projects\python\samples\data\sample.txt'
directory, filename = os.path.split(full_path)
print(f"Directory: {directory}")
print(f"Filename: {filename}")

# Extract directory name only
dir_name = os.path.dirname(full_path)
print(f"Dirname result: {dir_name}")

# Extract base name only
base_name = os.path.basename(full_path)
print(f"Basename result: {base_name}")

# Join path components correctly
joined = os.path.join('c:\\', 'users', 'admin', 'documents')
print(f"Joined path: {joined}")

The path.split() function separates the last path component, while dirname() and basename() extract each part individually. The join() function intelligently combines path segments regardless of whether trailing separators are present.

Path Validation Functions

Before performing file operations, it's often necessary to verify the existence and nature of paths.

import os

test_path = r'F:\development\projects\python\samples\data\config.json'

# Check if path exists
print(f"Path exists: {os.path.exists(test_path)}")

# Check if path is absolute
print(f"Path is absolute: {os.path.isabs(test_path)}")

# Check if path represents a file
print(f"Path is file: {os.path.isfile(test_path)}")

# Check if path represents a directory
print(f"Path is directory: {os.path.isdir(test_path)}")

# Sample folder path
sample_dir = r'F:\development\projects\python\samples\data'
print(f"Sample folder exists: {os.path.exists(sample_dir)}")
print(f"Sample folder is directory: {os.path.isdir(sample_dir)}")

These validation functions perform lightweight checks without actually accessing the filesystem, returning boolean values that indicate path characteristics.

File Timestamps

The module provides access to file metadata including access and modification timestamps.

import os

target_file = r'F:\development\projects\python\samples\main.py'

# Get last access time (Unix timestamp)
access_timestamp = os.path.getatime(target_file)
print(f"Last access time: {access_timestamp}")

# Get last modification time (Unix timestamp)
mod_timestamp = os.path.getmtime(target_file)
print(f"Last modification time: {mod_timestamp}")

# Convert to readable format
import datetime
access_readable = datetime.datetime.fromtimestamp(access_timestamp)
mod_readable = datetime.datetime.fromtimestamp(mod_timestamp)
print(f"Access time (readable): {access_readable}")
print(f"Modification time (readable): {mod_readable}")

Both getatime() and getmtime() return Unix timestamps (seconds since epoch). These values can be converted to human-readable formats using the datetime module for display purposes.