dmyersturnbull / pocketutils

                except OSError:

                    raise WriteFailedError(f"Failed to open {path} for read", filename=str(path))

    @classmethod

    def verify_can_write_files(

        cls: type[Self],

        *paths: str | Path,

        missing_ok: bool = False,

        attempt: bool = False,

    ) -> None:

        """

        Checks that all files can be written to, to ensure atomicity before operations.

        Args:

            *paths: The files

            missing_ok: Don't raise an error if a path doesn't exist

            attempt: Actually try opening

        Returns:

            WriteFailedError: If a path is not a file (modulo existence) or doesn't have 'W' set

        """

        paths = [Path(p) for p in paths]

        for path in paths:

            if path.exists() and not path.is_file():

                raise WriteFailedError(f"Path {path} is not a file", filename=str(path))

            if (not missing_ok or path.exists()) and not os.access(path, os.W_OK):

                raise WriteFailedError(f"Cannot write to {path}", filename=str(path))

            if attempt:

                try:

                    with open(path, "a"):  # or w

                        pass

                except OSError:

                    raise WriteFailedError(f"Failed to open {path} for write", filename=str(path))

    @classmethod

    def verify_can_write_dirs(

        Some functions may be insecure.

    """

    @classmethod

    def verify_can_read_files(

        cls: type[Self],

        *paths: str | Path,

        missing_ok: bool = False,

        attempt: bool = False,

    ) -> None:

        """

        Checks that all files can be written to, to ensure atomicity before operations.

        Args:

            *paths: The files

            missing_ok: Don't raise an error if a path doesn't exist

            attempt: Actually try opening

        Returns:

            ReadFailedError: If a path is not a file (modulo existence) or doesn't have 'W' set

        """

        paths = [Path(p) for p in paths]

        for path in paths:

            if path.exists() and not path.is_file():

                raise ReadFailedError(f"Path {path} is not a file", filename=str(path))

            if (not missing_ok or path.exists()) and not os.access(path, os.R_OK):

                raise ReadFailedError(f"Cannot read from {path}", filename=str(path))

            if attempt:

                try:

                    with open(path):

                        pass

                except OSError:

                    raise WriteFailedError(f"Failed to open {path} for read", filename=str(path))

    @classmethod

    def verify_can_write_files(