Skip to content

targets

🤖 AI-Generated Content

This documentation was generated with AI assistance and is still being audited. Some, or potentially a lot, of this information may be inaccurate. Learn more.

flavor.psp.format_2025.targets

Helpers for validating workenv-relative target paths.

Functions

normalize_workenv_target 

normalize_workenv_target(slot_target: str) -> str

Normalize a slot target and reject values that escape the workenv.

Source code in flavor/psp/format_2025/targets.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
def normalize_workenv_target(slot_target: str) -> str:
    """Normalize a slot target and reject values that escape the workenv."""
    normalized_target = slot_target.strip()
    if not normalized_target:
        raise ValueError("Invalid slot target: target must not be empty")

    if normalized_target == "{workenv}":
        return "{workenv}"

    if normalized_target.startswith("{workenv}/"):
        normalized_target = normalized_target.removeprefix("{workenv}/")
        if not normalized_target:
            return "."
    elif "{workenv}" in normalized_target:
        raise ValueError(f"Invalid slot target: unsupported placeholder usage in '{slot_target}'")

    if _WINDOWS_DRIVE_PATTERN.match(normalized_target):
        raise ValueError(f"Invalid slot target: absolute paths are not allowed: '{slot_target}'")

    posix_target = normalized_target.replace("\\", "/")
    target_path = PurePosixPath(posix_target)

    if target_path.is_absolute():
        raise ValueError(f"Invalid slot target: absolute paths are not allowed: '{slot_target}'")

    if any(part == ".." for part in target_path.parts):
        raise ValueError(f"Invalid slot target: path traversal is not allowed: '{slot_target}'")

    normalized = target_path.as_posix()
    if normalized in {"", "."}:
        return normalized
    return normalized