PHP 8.2.30
Preview: _soft.py Size: 1.67 KB
/opt/hc_python/lib64/python3.12/site-packages/filelock/_soft.py

from __future__ import annotations

import os
import sys
from contextlib import suppress
from errno import EACCES, EEXIST
from pathlib import Path

from ._api import BaseFileLock
from ._util import ensure_directory_exists, raise_on_not_writable_file


class SoftFileLock(BaseFileLock):
    """Simply watches the existence of the lock file."""

    def _acquire(self) -> None:
        raise_on_not_writable_file(self.lock_file)
        ensure_directory_exists(self.lock_file)
        # first check for exists and read-only mode as the open will mask this case as EEXIST
        flags = (
            os.O_WRONLY  # open for writing only
            | os.O_CREAT
            | os.O_EXCL  # together with above raise EEXIST if the file specified by filename exists
            | os.O_TRUNC  # truncate the file to zero byte
        )
        try:
            file_handler = os.open(self.lock_file, flags, self._context.mode)
        except OSError as exception:  # re-raise unless expected exception
            if not (
                exception.errno == EEXIST  # lock already exist
                or (exception.errno == EACCES and sys.platform == "win32")  # has no access to this lock
            ):  # pragma: win32 no cover
                raise
        else:
            self._context.lock_file_fd = file_handler

    def _release(self) -> None:
        assert self._context.lock_file_fd is not None  # noqa: S101
        os.close(self._context.lock_file_fd)  # the lock file is definitely not None
        self._context.lock_file_fd = None
        with suppress(OSError):  # the file is already deleted and that's what we want
            Path(self.lock_file).unlink()


__all__ = [
    "SoftFileLock",
]

Directory Contents

Dirs: 1 × Files: 10

Name Size Perms Modified Actions
- drwxr-xr-x 2025-04-04 08:02:00
Edit Download
12.16 KB lrw-r--r-- 2025-04-04 08:02:00
Edit Download
0 B lrw-r--r-- 2025-04-04 08:02:00
Edit Download
513 B lrw-r--r-- 2025-04-04 08:02:00
Edit Download
14.20 KB lrw-r--r-- 2025-04-04 08:02:00
Edit Download
787 B lrw-r--r-- 2025-04-04 08:02:00
Edit Download
1.67 KB lrw-r--r-- 2025-04-04 08:02:00
Edit Download
2.30 KB lrw-r--r-- 2025-04-04 08:02:00
Edit Download
1.67 KB lrw-r--r-- 2025-04-04 08:02:00
Edit Download
2.13 KB lrw-r--r-- 2025-04-04 08:02:00
Edit Download
1.73 KB lrw-r--r-- 2025-04-04 08:02:00
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).