SWAMPy

✎ CARVE FLESH

EDITING: _parser.py

# -*- test-case-name: twisted.protocols.haproxy.test.test_parser -*-
# Copyright (c) Twisted Matrix Laboratories.
# See LICENSE for details.

"""
Parser for 'haproxy:' string endpoint.
"""
from typing import Mapping, Tuple

from zope.interface import implementer

from twisted.internet import interfaces
from twisted.internet.endpoints import (
    IStreamServerEndpointStringParser,
    _WrapperServerEndpoint,
    quoteStringArgument,
    serverFromString,
)
from twisted.plugin import IPlugin
from . import proxyEndpoint

def unparseEndpoint(args: Tuple[object, ...], kwargs: Mapping[str, object]) -> str:
    """
    Un-parse the already-parsed args and kwargs back into endpoint syntax.

@param args: C{:}-separated arguments

@param kwargs: C{:} and then C{=}-separated keyword arguments

@return: a string equivalent to the original format which this was parsed
        as.
    """

description = ":".join(
        [quoteStringArgument(str(arg)) for arg in args]
        + sorted(
            "{}={}".format(
                quoteStringArgument(str(key)), quoteStringArgument(str(value))
            )
            for key, value in kwargs.items()
        )
    )
    return description

@implementer(IPlugin, IStreamServerEndpointStringParser)
class HAProxyServerParser:
    """
    Stream server endpoint string parser for the HAProxyServerEndpoint type.

@ivar prefix: See L{IStreamServerEndpointStringParser.prefix}.
    """

prefix = "haproxy"

def parseStreamServer(
        self, reactor: interfaces.IReactorCore, *args: object, **kwargs: object
    ) -> _WrapperServerEndpoint:
        """
        Parse a stream server endpoint from a reactor and string-only arguments
        and keyword arguments.

@param reactor: The reactor.

@param args: The parsed string arguments.

@param kwargs: The parsed keyword arguments.

@return: a stream server endpoint
        @rtype: L{IStreamServerEndpoint}
        """
        subdescription = unparseEndpoint(args, kwargs)
        wrappedEndpoint = serverFromString(reactor, subdescription)
        return proxyEndpoint(wrappedEndpoint)

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📁 __pycache__/	DIR	—	2026-06-05 06:59
📁 test/	DIR	—	2026-06-05 06:59
📄 __init__.py	PY	243 B	2026-05-22 14:58	EDIT
📄 _exceptions.py	PY	1.2 KB	2026-05-22 14:58	EDIT
📄 _info.py	PY	917 B	2026-05-22 14:58	EDIT
📄 _interfaces.py	PY	1.8 KB	2026-05-22 14:58	EDIT
📄 _parser.py	PY	2.1 KB	2026-05-22 14:58	EDIT
📄 _v1parser.py	PY	4.4 KB	2026-05-22 14:58	EDIT
📄 _v2parser.py	PY	6.5 KB	2026-05-22 14:58	EDIT
📄 _wrapper.py	PY	3.6 KB	2026-05-22 14:58	EDIT