2023-01-06 11:47:44 +00:00
|
|
|
from __future__ import annotations
|
|
|
|
|
|
|
|
import os
|
|
|
|
import sys
|
2023-09-17 19:40:34 +00:00
|
|
|
from contextlib import suppress
|
2023-04-12 13:51:13 +00:00
|
|
|
from errno import EACCES, EEXIST
|
2023-09-17 19:40:34 +00:00
|
|
|
from pathlib import Path
|
2023-01-06 11:47:44 +00:00
|
|
|
|
|
|
|
from ._api import BaseFileLock
|
2023-09-17 19:40:34 +00:00
|
|
|
from ._util import ensure_directory_exists, raise_on_not_writable_file
|
2023-01-06 11:47:44 +00:00
|
|
|
|
|
|
|
|
|
|
|
class SoftFileLock(BaseFileLock):
|
|
|
|
"""Simply watches the existence of the lock file."""
|
|
|
|
|
|
|
|
def _acquire(self) -> None:
|
2023-05-05 14:08:05 +00:00
|
|
|
raise_on_not_writable_file(self.lock_file)
|
2023-09-17 19:40:34 +00:00
|
|
|
ensure_directory_exists(self.lock_file)
|
2023-01-06 11:47:44 +00:00
|
|
|
# first check for exists and read-only mode as the open will mask this case as EEXIST
|
2023-04-12 13:51:13 +00:00
|
|
|
flags = (
|
2023-01-06 11:47:44 +00:00
|
|
|
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:
|
2023-05-05 14:08:05 +00:00
|
|
|
file_handler = os.open(self.lock_file, flags, self._context.mode)
|
2023-04-12 13:51:13 +00:00
|
|
|
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
|
2023-01-06 11:47:44 +00:00
|
|
|
raise
|
|
|
|
else:
|
2023-05-05 14:08:05 +00:00
|
|
|
self._context.lock_file_fd = file_handler
|
2023-01-06 11:47:44 +00:00
|
|
|
|
|
|
|
def _release(self) -> None:
|
2023-09-17 19:40:34 +00:00
|
|
|
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
|
2023-05-05 14:08:05 +00:00
|
|
|
self._context.lock_file_fd = None
|
2023-09-17 19:40:34 +00:00
|
|
|
with suppress(OSError): # the file is already deleted and that's what we want
|
|
|
|
Path(self.lock_file).unlink()
|
2023-01-06 11:47:44 +00:00
|
|
|
|
|
|
|
|
|
|
|
__all__ = [
|
|
|
|
"SoftFileLock",
|
|
|
|
]
|