hmdev-cli 1.0.0 → 1.0.2

package/python/.venv/Lib/site-packages/anyio/abc/_sockets.py

@@ -1,399 +0,0 @@
-from __future__ import annotations
-
-import errno
-import socket
-from abc import abstractmethod
-from collections.abc import Callable, Collection, Mapping
-from contextlib import AsyncExitStack
-from io import IOBase
-from ipaddress import IPv4Address, IPv6Address
-from socket import AddressFamily
-from typing import Any, TypeAlias, TypeVar
-
-from .._core._eventloop import get_async_backend
-from .._core._typedattr import (
-    TypedAttributeProvider,
-    TypedAttributeSet,
-    typed_attribute,
-)
-from ._streams import ByteStream, Listener, UnreliableObjectStream
-from ._tasks import TaskGroup
-
-IPAddressType: TypeAlias = str | IPv4Address | IPv6Address
-IPSockAddrType: TypeAlias = tuple[str, int]
-SockAddrType: TypeAlias = IPSockAddrType | str
-UDPPacketType: TypeAlias = tuple[bytes, IPSockAddrType]
-UNIXDatagramPacketType: TypeAlias = tuple[bytes, str]
-T_Retval = TypeVar("T_Retval")
-
-
-def _validate_socket(
-    sock_or_fd: socket.socket | int,
-    sock_type: socket.SocketKind,
-    addr_family: socket.AddressFamily = socket.AF_UNSPEC,
-    *,
-    require_connected: bool = False,
-    require_bound: bool = False,
-) -> socket.socket:
-    if isinstance(sock_or_fd, int):
-        try:
-            sock = socket.socket(fileno=sock_or_fd)
-        except OSError as exc:
-            if exc.errno == errno.ENOTSOCK:
-                raise ValueError(
-                    "the file descriptor does not refer to a socket"
-                ) from exc
-            elif require_connected:
-                raise ValueError("the socket must be connected") from exc
-            elif require_bound:
-                raise ValueError("the socket must be bound to a local address") from exc
-            else:
-                raise
-    elif isinstance(sock_or_fd, socket.socket):
-        sock = sock_or_fd
-    else:
-        raise TypeError(
-            f"expected an int or socket, got {type(sock_or_fd).__qualname__} instead"
-        )
-
-    try:
-        if require_connected:
-            try:
-                sock.getpeername()
-            except OSError as exc:
-                raise ValueError("the socket must be connected") from exc
-
-        if require_bound:
-            try:
-                if sock.family in (socket.AF_INET, socket.AF_INET6):
-                    bound_addr = sock.getsockname()[1]
-                else:
-                    bound_addr = sock.getsockname()
-            except OSError:
-                bound_addr = None
-
-            if not bound_addr:
-                raise ValueError("the socket must be bound to a local address")
-
-        if addr_family != socket.AF_UNSPEC and sock.family != addr_family:
-            raise ValueError(
-                f"address family mismatch: expected {addr_family.name}, got "
-                f"{sock.family.name}"
-            )
-
-        if sock.type != sock_type:
-            raise ValueError(
-                f"socket type mismatch: expected {sock_type.name}, got {sock.type.name}"
-            )
-    except BaseException:
-        # Avoid ResourceWarning from the locally constructed socket object
-        if isinstance(sock_or_fd, int):
-            sock.detach()
-
-        raise
-
-    sock.setblocking(False)
-    return sock
-
-
-class SocketAttribute(TypedAttributeSet):
-    """
-    .. attribute:: family
-        :type: socket.AddressFamily
-
-        the address family of the underlying socket
-
-    .. attribute:: local_address
-        :type: tuple[str, int] | str
-
-        the local address the underlying socket is connected to
-
-    .. attribute:: local_port
-        :type: int
-
-        for IP based sockets, the local port the underlying socket is bound to
-
-    .. attribute:: raw_socket
-        :type: socket.socket
-
-        the underlying stdlib socket object
-
-    .. attribute:: remote_address
-        :type: tuple[str, int] | str
-
-        the remote address the underlying socket is connected to
-
-    .. attribute:: remote_port
-        :type: int
-
-        for IP based sockets, the remote port the underlying socket is connected to
-    """
-
-    family: AddressFamily = typed_attribute()
-    local_address: SockAddrType = typed_attribute()
-    local_port: int = typed_attribute()
-    raw_socket: socket.socket = typed_attribute()
-    remote_address: SockAddrType = typed_attribute()
-    remote_port: int = typed_attribute()
-
-
-class _SocketProvider(TypedAttributeProvider):
-    @property
-    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
-        from .._core._sockets import convert_ipv6_sockaddr as convert
-
-        attributes: dict[Any, Callable[[], Any]] = {
-            SocketAttribute.family: lambda: self._raw_socket.family,
-            SocketAttribute.local_address: lambda: convert(
-                self._raw_socket.getsockname()
-            ),
-            SocketAttribute.raw_socket: lambda: self._raw_socket,
-        }
-        try:
-            peername: tuple[str, int] | None = convert(self._raw_socket.getpeername())
-        except OSError:
-            peername = None
-
-        # Provide the remote address for connected sockets
-        if peername is not None:
-            attributes[SocketAttribute.remote_address] = lambda: peername
-
-        # Provide local and remote ports for IP based sockets
-        if self._raw_socket.family in (AddressFamily.AF_INET, AddressFamily.AF_INET6):
-            attributes[SocketAttribute.local_port] = lambda: (
-                self._raw_socket.getsockname()[1]
-            )
-            if peername is not None:
-                remote_port = peername[1]
-                attributes[SocketAttribute.remote_port] = lambda: remote_port
-
-        return attributes
-
-    @property
-    @abstractmethod
-    def _raw_socket(self) -> socket.socket:
-        pass
-
-
-class SocketStream(ByteStream, _SocketProvider):
-    """
-    Transports bytes over a socket.
-
-    Supports all relevant extra attributes from :class:`~SocketAttribute`.
-    """
-
-    @classmethod
-    async def from_socket(cls, sock_or_fd: socket.socket | int) -> SocketStream:
-        """
-        Wrap an existing socket object or file descriptor as a socket stream.
-
-        The newly created socket wrapper takes ownership of the socket being passed in.
-        The existing socket must already be connected.
-
-        :param sock_or_fd: a socket object or file descriptor
-        :return: a socket stream
-
-        """
-        sock = _validate_socket(sock_or_fd, socket.SOCK_STREAM, require_connected=True)
-        return await get_async_backend().wrap_stream_socket(sock)
-
-
-class UNIXSocketStream(SocketStream):
-    @classmethod
-    async def from_socket(cls, sock_or_fd: socket.socket | int) -> UNIXSocketStream:
-        """
-        Wrap an existing socket object or file descriptor as a UNIX socket stream.
-
-        The newly created socket wrapper takes ownership of the socket being passed in.
-        The existing socket must already be connected.
-
-        :param sock_or_fd: a socket object or file descriptor
-        :return: a UNIX socket stream
-
-        """
-        sock = _validate_socket(
-            sock_or_fd, socket.SOCK_STREAM, socket.AF_UNIX, require_connected=True
-        )
-        return await get_async_backend().wrap_unix_stream_socket(sock)
-
-    @abstractmethod
-    async def send_fds(self, message: bytes, fds: Collection[int | IOBase]) -> None:
-        """
-        Send file descriptors along with a message to the peer.
-
-        :param message: a non-empty bytestring
-        :param fds: a collection of files (either numeric file descriptors or open file
-            or socket objects)
-        """
-
-    @abstractmethod
-    async def receive_fds(self, msglen: int, maxfds: int) -> tuple[bytes, list[int]]:
-        """
-        Receive file descriptors along with a message from the peer.
-
-        :param msglen: length of the message to expect from the peer
-        :param maxfds: maximum number of file descriptors to expect from the peer
-        :return: a tuple of (message, file descriptors)
-        """
-
-
-class SocketListener(Listener[SocketStream], _SocketProvider):
-    """
-    Listens to incoming socket connections.
-
-    Supports all relevant extra attributes from :class:`~SocketAttribute`.
-    """
-
-    @classmethod
-    async def from_socket(
-        cls,
-        sock_or_fd: socket.socket | int,
-    ) -> SocketListener:
-        """
-        Wrap an existing socket object or file descriptor as a socket listener.
-
-        The newly created listener takes ownership of the socket being passed in.
-
-        :param sock_or_fd: a socket object or file descriptor
-        :return: a socket listener
-
-        """
-        sock = _validate_socket(sock_or_fd, socket.SOCK_STREAM, require_bound=True)
-        return await get_async_backend().wrap_listener_socket(sock)
-
-    @abstractmethod
-    async def accept(self) -> SocketStream:
-        """Accept an incoming connection."""
-
-    async def serve(
-        self,
-        handler: Callable[[SocketStream], Any],
-        task_group: TaskGroup | None = None,
-    ) -> None:
-        from .. import create_task_group
-
-        async with AsyncExitStack() as stack:
-            if task_group is None:
-                task_group = await stack.enter_async_context(create_task_group())
-
-            while True:
-                stream = await self.accept()
-                task_group.start_soon(handler, stream)
-
-
-class UDPSocket(UnreliableObjectStream[UDPPacketType], _SocketProvider):
-    """
-    Represents an unconnected UDP socket.
-
-    Supports all relevant extra attributes from :class:`~SocketAttribute`.
-    """
-
-    @classmethod
-    async def from_socket(cls, sock_or_fd: socket.socket | int) -> UDPSocket:
-        """
-        Wrap an existing socket object or file descriptor as a UDP socket.
-
-        The newly created socket wrapper takes ownership of the socket being passed in.
-        The existing socket must be bound to a local address.
-
-        :param sock_or_fd: a socket object or file descriptor
-        :return: a UDP socket
-
-        """
-        sock = _validate_socket(sock_or_fd, socket.SOCK_DGRAM, require_bound=True)
-        return await get_async_backend().wrap_udp_socket(sock)
-
-    async def sendto(self, data: bytes, host: str, port: int) -> None:
-        """
-        Alias for :meth:`~.UnreliableObjectSendStream.send` ((data, (host, port))).
-
-        """
-        return await self.send((data, (host, port)))
-
-
-class ConnectedUDPSocket(UnreliableObjectStream[bytes], _SocketProvider):
-    """
-    Represents an connected UDP socket.
-
-    Supports all relevant extra attributes from :class:`~SocketAttribute`.
-    """
-
-    @classmethod
-    async def from_socket(cls, sock_or_fd: socket.socket | int) -> ConnectedUDPSocket:
-        """
-        Wrap an existing socket object or file descriptor as a connected UDP socket.
-
-        The newly created socket wrapper takes ownership of the socket being passed in.
-        The existing socket must already be connected.
-
-        :param sock_or_fd: a socket object or file descriptor
-        :return: a connected UDP socket
-
-        """
-        sock = _validate_socket(
-            sock_or_fd,
-            socket.SOCK_DGRAM,
-            require_connected=True,
-        )
-        return await get_async_backend().wrap_connected_udp_socket(sock)
-
-
-class UNIXDatagramSocket(
-    UnreliableObjectStream[UNIXDatagramPacketType], _SocketProvider
-):
-    """
-    Represents an unconnected Unix datagram socket.
-
-    Supports all relevant extra attributes from :class:`~SocketAttribute`.
-    """
-
-    @classmethod
-    async def from_socket(
-        cls,
-        sock_or_fd: socket.socket | int,
-    ) -> UNIXDatagramSocket:
-        """
-        Wrap an existing socket object or file descriptor as a UNIX datagram
-        socket.
-
-        The newly created socket wrapper takes ownership of the socket being passed in.
-
-        :param sock_or_fd: a socket object or file descriptor
-        :return: a UNIX datagram socket
-
-        """
-        sock = _validate_socket(sock_or_fd, socket.SOCK_DGRAM, socket.AF_UNIX)
-        return await get_async_backend().wrap_unix_datagram_socket(sock)
-
-    async def sendto(self, data: bytes, path: str) -> None:
-        """Alias for :meth:`~.UnreliableObjectSendStream.send` ((data, path))."""
-        return await self.send((data, path))
-
-
-class ConnectedUNIXDatagramSocket(UnreliableObjectStream[bytes], _SocketProvider):
-    """
-    Represents a connected Unix datagram socket.
-
-    Supports all relevant extra attributes from :class:`~SocketAttribute`.
-    """
-
-    @classmethod
-    async def from_socket(
-        cls,
-        sock_or_fd: socket.socket | int,
-    ) -> ConnectedUNIXDatagramSocket:
-        """
-        Wrap an existing socket object or file descriptor as a connected UNIX datagram
-        socket.
-
-        The newly created socket wrapper takes ownership of the socket being passed in.
-        The existing socket must already be connected.
-
-        :param sock_or_fd: a socket object or file descriptor
-        :return: a connected UNIX datagram socket
-
-        """
-        sock = _validate_socket(
-            sock_or_fd, socket.SOCK_DGRAM, socket.AF_UNIX, require_connected=True
-        )
-        return await get_async_backend().wrap_connected_unix_datagram_socket(sock)

package/python/.venv/Lib/site-packages/anyio/abc/_streams.py

@@ -1,233 +0,0 @@
-from __future__ import annotations
-
-from abc import ABCMeta, abstractmethod
-from collections.abc import Callable
-from typing import Any, Generic, TypeAlias, TypeVar
-
-from .._core._exceptions import EndOfStream
-from .._core._typedattr import TypedAttributeProvider
-from ._resources import AsyncResource
-from ._tasks import TaskGroup
-
-T_Item = TypeVar("T_Item")
-T_co = TypeVar("T_co", covariant=True)
-T_contra = TypeVar("T_contra", contravariant=True)
-
-
-class UnreliableObjectReceiveStream(
-    Generic[T_co], AsyncResource, TypedAttributeProvider
-):
-    """
-    An interface for receiving objects.
-
-    This interface makes no guarantees that the received messages arrive in the order in
-    which they were sent, or that no messages are missed.
-
-    Asynchronously iterating over objects of this type will yield objects matching the
-    given type parameter.
-    """
-
-    def __aiter__(self) -> UnreliableObjectReceiveStream[T_co]:
-        return self
-
-    async def __anext__(self) -> T_co:
-        try:
-            return await self.receive()
-        except EndOfStream:
-            raise StopAsyncIteration from None
-
-    @abstractmethod
-    async def receive(self) -> T_co:
-        """
-        Receive the next item.
-
-        :raises ~anyio.ClosedResourceError: if the receive stream has been explicitly
-            closed
-        :raises ~anyio.EndOfStream: if this stream has been closed from the other end
-        :raises ~anyio.BrokenResourceError: if this stream has been rendered unusable
-            due to external causes
-        """
-
-
-class UnreliableObjectSendStream(
-    Generic[T_contra], AsyncResource, TypedAttributeProvider
-):
-    """
-    An interface for sending objects.
-
-    This interface makes no guarantees that the messages sent will reach the
-    recipient(s) in the same order in which they were sent, or at all.
-    """
-
-    @abstractmethod
-    async def send(self, item: T_contra) -> None:
-        """
-        Send an item to the peer(s).
-
-        :param item: the item to send
-        :raises ~anyio.ClosedResourceError: if the send stream has been explicitly
-            closed
-        :raises ~anyio.BrokenResourceError: if this stream has been rendered unusable
-            due to external causes
-        """
-
-
-class UnreliableObjectStream(
-    UnreliableObjectReceiveStream[T_Item], UnreliableObjectSendStream[T_Item]
-):
-    """
-    A bidirectional message stream which does not guarantee the order or reliability of
-    message delivery.
-    """
-
-
-class ObjectReceiveStream(UnreliableObjectReceiveStream[T_co]):
-    """
-    A receive message stream which guarantees that messages are received in the same
-    order in which they were sent, and that no messages are missed.
-    """
-
-
-class ObjectSendStream(UnreliableObjectSendStream[T_contra]):
-    """
-    A send message stream which guarantees that messages are delivered in the same order
-    in which they were sent, without missing any messages in the middle.
-    """
-
-
-class ObjectStream(
-    ObjectReceiveStream[T_Item],
-    ObjectSendStream[T_Item],
-    UnreliableObjectStream[T_Item],
-):
-    """
-    A bidirectional message stream which guarantees the order and reliability of message
-    delivery.
-    """
-
-    @abstractmethod
-    async def send_eof(self) -> None:
-        """
-        Send an end-of-file indication to the peer.
-
-        You should not try to send any further data to this stream after calling this
-        method. This method is idempotent (does nothing on successive calls).
-        """
-
-
-class ByteReceiveStream(AsyncResource, TypedAttributeProvider):
-    """
-    An interface for receiving bytes from a single peer.
-
-    Iterating this byte stream will yield a byte string of arbitrary length, but no more
-    than 65536 bytes.
-    """
-
-    def __aiter__(self) -> ByteReceiveStream:
-        return self
-
-    async def __anext__(self) -> bytes:
-        try:
-            return await self.receive()
-        except EndOfStream:
-            raise StopAsyncIteration from None
-
-    @abstractmethod
-    async def receive(self, max_bytes: int = 65536) -> bytes:
-        """
-        Receive at most ``max_bytes`` bytes from the peer.
-
-        .. note:: Implementers of this interface should not return an empty
-            :class:`bytes` object, and users should ignore them.
-
-        :param max_bytes: maximum number of bytes to receive
-        :return: the received bytes
-        :raises ~anyio.EndOfStream: if this stream has been closed from the other end
-        """
-
-
-class ByteSendStream(AsyncResource, TypedAttributeProvider):
-    """An interface for sending bytes to a single peer."""
-
-    @abstractmethod
-    async def send(self, item: bytes) -> None:
-        """
-        Send the given bytes to the peer.
-
-        :param item: the bytes to send
-        """
-
-
-class ByteStream(ByteReceiveStream, ByteSendStream):
-    """A bidirectional byte stream."""
-
-    @abstractmethod
-    async def send_eof(self) -> None:
-        """
-        Send an end-of-file indication to the peer.
-
-        You should not try to send any further data to this stream after calling this
-        method. This method is idempotent (does nothing on successive calls).
-        """
-
-
-#: Type alias for all unreliable bytes-oriented receive streams.
-AnyUnreliableByteReceiveStream: TypeAlias = (
-    UnreliableObjectReceiveStream[bytes] | ByteReceiveStream
-)
-#: Type alias for all unreliable bytes-oriented send streams.
-AnyUnreliableByteSendStream: TypeAlias = (
-    UnreliableObjectSendStream[bytes] | ByteSendStream
-)
-#: Type alias for all unreliable bytes-oriented streams.
-AnyUnreliableByteStream: TypeAlias = UnreliableObjectStream[bytes] | ByteStream
-#: Type alias for all bytes-oriented receive streams.
-AnyByteReceiveStream: TypeAlias = ObjectReceiveStream[bytes] | ByteReceiveStream
-#: Type alias for all bytes-oriented send streams.
-AnyByteSendStream: TypeAlias = ObjectSendStream[bytes] | ByteSendStream
-#: Type alias for all bytes-oriented streams.
-AnyByteStream: TypeAlias = ObjectStream[bytes] | ByteStream
-
-
-class Listener(Generic[T_co], AsyncResource, TypedAttributeProvider):
-    """An interface for objects that let you accept incoming connections."""
-
-    @abstractmethod
-    async def serve(
-        self, handler: Callable[[T_co], Any], task_group: TaskGroup | None = None
-    ) -> None:
-        """
-        Accept incoming connections as they come in and start tasks to handle them.
-
-        :param handler: a callable that will be used to handle each accepted connection
-        :param task_group: the task group that will be used to start tasks for handling
-            each accepted connection (if omitted, an ad-hoc task group will be created)
-        """
-
-
-class ObjectStreamConnectable(Generic[T_co], metaclass=ABCMeta):
-    @abstractmethod
-    async def connect(self) -> ObjectStream[T_co]:
-        """
-        Connect to the remote endpoint.
-
-        :return: an object stream connected to the remote end
-        :raises ConnectionFailed: if the connection fails
-        """
-
-
-class ByteStreamConnectable(metaclass=ABCMeta):
-    @abstractmethod
-    async def connect(self) -> ByteStream:
-        """
-        Connect to the remote endpoint.
-
-        :return: a bytestream connected to the remote end
-        :raises ConnectionFailed: if the connection fails
-        """
-
-
-#: Type alias for all connectables returning bytestreams or bytes-oriented object streams
-AnyByteStreamConnectable: TypeAlias = (
-    ObjectStreamConnectable[bytes] | ByteStreamConnectable
-)

package/python/.venv/Lib/site-packages/anyio/abc/_subprocesses.py

@@ -1,79 +0,0 @@
-from __future__ import annotations
-
-from abc import abstractmethod
-from signal import Signals
-
-from ._resources import AsyncResource
-from ._streams import ByteReceiveStream, ByteSendStream
-
-
-class Process(AsyncResource):
-    """An asynchronous version of :class:`subprocess.Popen`."""
-
-    @abstractmethod
-    async def wait(self) -> int:
-        """
-        Wait until the process exits.
-
-        :return: the exit code of the process
-        """
-
-    @abstractmethod
-    def terminate(self) -> None:
-        """
-        Terminates the process, gracefully if possible.
-
-        On Windows, this calls ``TerminateProcess()``.
-        On POSIX systems, this sends ``SIGTERM`` to the process.
-
-        .. seealso:: :meth:`subprocess.Popen.terminate`
-        """
-
-    @abstractmethod
-    def kill(self) -> None:
-        """
-        Kills the process.
-
-        On Windows, this calls ``TerminateProcess()``.
-        On POSIX systems, this sends ``SIGKILL`` to the process.
-
-        .. seealso:: :meth:`subprocess.Popen.kill`
-        """
-
-    @abstractmethod
-    def send_signal(self, signal: Signals) -> None:
-        """
-        Send a signal to the subprocess.
-
-        .. seealso:: :meth:`subprocess.Popen.send_signal`
-
-        :param signal: the signal number (e.g. :data:`signal.SIGHUP`)
-        """
-
-    @property
-    @abstractmethod
-    def pid(self) -> int:
-        """The process ID of the process."""
-
-    @property
-    @abstractmethod
-    def returncode(self) -> int | None:
-        """
-        The return code of the process. If the process has not yet terminated, this will
-        be ``None``.
-        """
-
-    @property
-    @abstractmethod
-    def stdin(self) -> ByteSendStream | None:
-        """The stream for the standard input of the process."""
-
-    @property
-    @abstractmethod
-    def stdout(self) -> ByteReceiveStream | None:
-        """The stream for the standard output of the process."""
-
-    @property
-    @abstractmethod
-    def stderr(self) -> ByteReceiveStream | None:
-        """The stream for the standard error output of the process."""