project-migration

Path Encoding Rules

BAD - Naive path encoding (breaks on spaces, drives, symlinks):

encoded = path.replace("/", "-").replace("\\", "-")
# C:\My Projects\app → C:-My Projects-app (WRONG: space, colon)

GOOD - Handle all edge cases:

path = str(Path(path).resolve())          # Resolve symlinks
path = path.replace('\\', '-').replace('/', '-')
if len(path) > 1 and path[1] == ':':     # Windows drive letter
    path = path[0].lower() + '-' + path[2:]
path = path.lstrip('-').replace(' ', '-') # Normalize
# C:\My Projects\app → c--My-Projects-app (CORRECT)