File Paths and Operating System Differences in Python

Windows-Specific Path Challenges

Windows paths have some unique challenges that developers should be aware of:

Long Path Support

# File: examples/windows_long_paths.py
from pathlib import Path
import os

# Windows traditionally has a 260 character path limit
# Modern versions of Windows with correct settings can handle longer paths

def enable_long_paths_in_code():
    """
    Enable long path support in Python code.
    Note: This requires Windows 10 or later with long path support enabled at the OS level.
    """
    if os.name == 'nt':
        try:
            # Try to use extended-length path prefix
            long_prefix = '\\\\?\\'
            return long_prefix + str(Path.cwd().absolute())
        except Exception as e:
            print(f"Error enabling long paths: {e}")
            return str(Path.cwd().absolute())
    else:
        # Non-Windows systems don't need this
        return str(Path.cwd().absolute())

# Usage
if os.name == 'nt':
    print("On Windows, demonstrating long path handling...")
    base_path = enable_long_paths_in_code()
    print(f"Base path with long path support: {base_path}")
    
    # Creating a deep path structure
    # This is for demonstration - uncomment to actually create the paths
    """
    deep_path = Path(base_path)
    for i in range(30):  # Create a very deep path
        deep_path = deep_path / f"subfolder_{i:02d}"
        deep_path.mkdir(exist_ok=True)
        print(f"Created: {deep_path}")
        
        # Create a file in each folder
        test_file = deep_path / "test.txt"
        test_file.write_text(f"Test file at depth {i}")
        print(f"Created file: {test_file}")
    """
else:
    print("Not on Windows, long path handling not needed.")
                

Reserved Names and Device Paths

# File: examples/windows_reserved_names.py
from pathlib import Path
import os

def is_windows_reserved_name(name):
    """Check if a name is reserved on Windows."""
    # Windows reserved device names
    reserved_names = {
        'CON', 'PRN', 'AUX', 'NUL',
        'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9',
        'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9'
    }
    
    # Check the name without extension
    base_name = name.split('.')[0].upper()
    return base_name in reserved_names

def safe_filename_for_windows(original_name):
    """Create a safe filename for Windows by avoiding reserved names."""
    if not os.name == 'nt':
        # Not on Windows, no need to check
        return original_name
    
    if is_windows_reserved_name(original_name):
        # Add an underscore to avoid the reserved name
        name_parts = original_name.split('.')
        if len(name_parts) > 1:
            # Has extension
            extension = name_parts[-1]
            base_name = '.'.join(name_parts[:-1])
            return f"{base_name}_{os.urandom(2).hex()}.{extension}"
        else:
            # No extension
            return f"{original_name}_{os.urandom(2).hex()}"
    
    return original_name

# Usage
test_names = ['normal.txt', 'CON', 'con.txt', 'COM1.csv', 'prn.log', 'file.txt']

for name in test_names:
    safe_name = safe_filename_for_windows(name)
    reserved = is_windows_reserved_name(name)
    print(f"Original: {name}, Reserved: {reserved}, Safe name: {safe_name}")