add type hints for _util

This commit is contained in:
Nulano 2023-12-27 00:17:57 +01:00
parent d4fd04982a
commit 6bcf807fe2
2 changed files with 22 additions and 4 deletions

View File

@ -37,6 +37,9 @@ classifiers = [
dynamic = [
"version",
]
dependencies = [
'typing-extensions; python_version < "3.10"',
]
[project.optional-dependencies]
docs = [
"furo",

View File

@ -1,21 +1,36 @@
from __future__ import annotations
import os
import sys
from pathlib import Path
from typing import Any, NoReturn
if sys.version_info >= (3, 10):
from typing import TypeGuard
else:
from typing_extensions import TypeGuard
def is_path(f):
def is_path(f: Any) -> TypeGuard[bytes | str | Path]:
return isinstance(f, (bytes, str, Path))
def is_directory(f):
def is_directory(f: Any) -> TypeGuard[bytes | str | Path]:
"""Checks if an object is a string, and that it points to a directory."""
return is_path(f) and os.path.isdir(f)
class DeferredError:
def __init__(self, ex):
def __init__(self, ex: BaseException):
self.ex = ex
def __getattr__(self, elt):
def __getattr__(self, elt: str) -> NoReturn:
raise self.ex
@staticmethod
def new(ex: BaseException) -> Any:
"""
Creates an object that raises the wrapped exception ``ex`` when used,
and casts it to :py:obj:`~typing.Any` type.
"""
return DeferredError(ex)