Skip to content

file_utils

file_utils

Secure file and directory creation helpers.

All OpenJarvis data files under ~/.openjarvis/ should be created through these helpers to ensure consistent, restrictive permissions.

Functions

secure_mkdir 

secure_mkdir(path: Path, mode: int = 448) -> Path

Create a directory with restrictive permissions.

Creates parent directories as needed, then sets mode on the target directory (even if it already exists).

Source code in src/openjarvis/security/file_utils.py 
13
14
15
16
17
18
19
20
21
def secure_mkdir(path: Path, mode: int = 0o700) -> Path:
    """Create a directory with restrictive permissions.

    Creates parent directories as needed, then sets *mode* on the
    target directory (even if it already exists).
    """
    path.mkdir(parents=True, exist_ok=True)
    os.chmod(path, mode)
    return path

secure_create 

secure_create(path: Path, mode: int = 384) -> Path

Ensure a file exists with restrictive permissions.

Creates the parent directory with 0o700 if needed, touches the file if it doesn't exist, and sets mode on it.

Source code in src/openjarvis/security/file_utils.py 
24
25
26
27
28
29
30
31
32
33
34
def secure_create(path: Path, mode: int = 0o600) -> Path:
    """Ensure a file exists with restrictive permissions.

    Creates the parent directory with ``0o700`` if needed, touches the
    file if it doesn't exist, and sets *mode* on it.
    """
    secure_mkdir(path.parent, mode=0o700)
    if not path.exists():
        path.touch()
    os.chmod(path, mode)
    return path