import sys

from _typeshed import StrPath

from collections.abc import Iterator

from os import PathLike

from typing import Any, Protocol, overload

from typing_extensions import TypeVar

_T = TypeVar("_T")

_T_co = TypeVar("_T_co", covariant=True, default=Any)

class PackageMetadata(Protocol):

def __len__(self) -> int: ...

def __contains__(self, item: str) -> bool: ...

def __getitem__(self, key: str) -> str: ...

def __iter__(self) -> Iterator[str]: ...

@property

def json(self) -> dict[str, str | list[str]]: ...

@overload

def get_all(self, name: str, failobj: None = None) -> list[Any] | None: ...

@overload

def get_all(self, name: str, failobj: _T) -> list[Any] | _T: ...

if sys.version_info >= (3, 12):

@overload

def get(self, name: str, failobj: None = None) -> str | None: ...

@overload

def get(self, name: str, failobj: _T) -> _T | str: ...

if sys.version_info >= (3, 13):

class SimplePath(Protocol):

def joinpath(self, other: StrPath, /) -> SimplePath: ...

def __truediv__(self, other: StrPath, /) -> SimplePath: ...

# Incorrect at runtime

@property

def parent(self) -> PathLike[str]: ...

def read_text(self, encoding: str | None = None) -> str: ...

def read_bytes(self) -> bytes: ...

def exists(self) -> bool: ...

elif sys.version_info >= (3, 12):

class SimplePath(Protocol[_T_co]):

# At runtime this is defined as taking `str | _T`, but that causes trouble.

# See #11436.

def joinpath(self, other: str, /) -> _T_co: ...

@property

def parent(self) -> _T_co: ...

def read_text(self) -> str: ...

# As with joinpath(), this is annotated as taking `str | _T` at runtime.

def __truediv__(self, other: str, /) -> _T_co: ...

else:

class SimplePath(Protocol):

# Actually takes only self at runtime, but that's clearly wrong

def joinpath(self, other: Any, /) -> SimplePath: ...

# Not defined as a property at runtime, but it should be

@property

def parent(self) -> Any: ...

def read_text(self) -> str: ...

# There was a bug in `SimplePath` definition in cpython, see #8451

# Strictly speaking `__div__` was defined in 3.10, not __truediv__,

# but it should have always been `__truediv__`.

# Also, the runtime defines this method as taking no arguments,

# which is obviously wrong.

def __truediv__(self, other: Any, /) -> SimplePath: ...