import datetime
from _typeshed import Incomplete
from re import Pattern
from types import TracebackType
from typing import Any, NamedTuple

class SizeUnit(NamedTuple):
    divider: int
    symbol: str
    name: str

class CombinedUnit(NamedTuple):
    decimal: SizeUnit
    binary: SizeUnit

disk_size_units: Any
length_size_units: Any
time_units: Any

def coerce_boolean(value: object) -> bool: ...
def coerce_pattern(value: str | Pattern[str], flags: int = 0) -> Pattern[str]: ...
def coerce_seconds(value: float | datetime.timedelta) -> float: ...
def format_size(num_bytes: float, keep_width: bool = False, binary: bool = False) -> str: ...
def parse_size(size: str, binary: bool = False) -> int: ...
def format_length(num_metres: float, keep_width: bool = False) -> str: ...
def parse_length(length: str) -> float: ...
def format_number(number: float, num_decimals: int = 2) -> str: ...
def round_number(count: float, keep_width: bool = False) -> str: ...
def format_timespan(num_seconds: float | datetime.timedelta, detailed: bool = False, max_units: int = 3) -> str: ...
def parse_timespan(timespan: str) -> float: ...
def parse_date(datestring: str) -> tuple[int, int, int, int, int, int]: ...
def format_path(pathname: str) -> str: ...
def parse_path(pathname: str) -> str: ...

class Timer:
    monotonic: bool
    resumable: bool
    start_time: float
    total_time: float
    def __init__(self, start_time: Incomplete | None = None, resumable: bool = False) -> None: ...
    def __enter__(self): ...
    def __exit__(
        self,
        exc_type: type[BaseException] | None = None,
        exc_value: BaseException | None = None,
        traceback: TracebackType | None = None,
    ) -> None: ...
    def sleep(self, seconds: float) -> None: ...
    @property
    def elapsed_time(self): ...
    @property
    def rounded(self): ...

class InvalidDate(Exception): ...
class InvalidSize(Exception): ...
class InvalidLength(Exception): ...
class InvalidTimespan(Exception): ...