?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 1.67 KB

/opt/hc_python/lib/python3.12/site-packages/filelock/_util.py

Text Base64

from __future__ import annotations

import os
import stat
import sys
from errno import EACCES, EISDIR
from pathlib import Path

def raise_on_not_writable_file(filename: str) -> None:
    """
    Raise an exception if attempting to open the file for writing would fail.

This is done so files that will never be writable can be separated from files that are writable but currently
    locked.

:param filename: file to check
    :raises OSError: as if the file was opened for writing.

"""
    try:  # use stat to do exists + can write to check without race condition
        file_stat = os.stat(filename)  # noqa: PTH116
    except OSError:
        return  # swallow does not exist or other errors

if file_stat.st_mtime != 0:  # if os.stat returns but modification is zero that's an invalid os.stat - ignore it
        if not (file_stat.st_mode & stat.S_IWUSR):
            raise PermissionError(EACCES, "Permission denied", filename)

if stat.S_ISDIR(file_stat.st_mode):
            if sys.platform == "win32":  # pragma: win32 cover
                # On Windows, this is PermissionError
                raise PermissionError(EACCES, "Permission denied", filename)
            else:  # pragma: win32 no cover # noqa: RET506
                # On linux / macOS, this is IsADirectoryError
                raise IsADirectoryError(EISDIR, "Is a directory", filename)

def ensure_directory_exists(filename: Path | str) -> None:
    """
    Ensure the directory containing the file exists (create it if necessary).

:param filename: file.

"""
    Path(filename).parent.mkdir(parents=True, exist_ok=True)

__all__ = [
    "ensure_directory_exists",
    "raise_on_not_writable_file",
]

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
__pycache__ DIR	-	drwxr-xr-x	2025-04-04 08:02:00	Edit Download recursive recursive
asyncio.py	12.16 KB	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
py.typed	0 B	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
version.py	513 B	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
_api.py	14.20 KB	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
_error.py	787 B	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
_soft.py	1.67 KB	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
_unix.py	2.30 KB	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
_util.py	1.67 KB	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
_windows.py	2.13 KB	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive
__init__.py	1.73 KB	lrw-r--r--	2025-04-04 08:02:00	Edit Download recursive recursive

Directory Contents